libretime/legacy/application/services/HistoryService.php
renovate[bot] eb9b8bdf81
chore(deps): update dependency friendsofphp/php-cs-fixer to <3.85.2 (#3188)
This PR contains the following updates:

| Package | Change | Age | Confidence |
|---|---|---|---|
|
[friendsofphp/php-cs-fixer](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer)
| `<3.64.1` -> `<3.85.2` |
[![age](https://developer.mend.io/api/mc/badges/age/packagist/friendsofphp%2fphp-cs-fixer/3.85.1?slim=true)](https://docs.renovatebot.com/merge-confidence/)
|
[![confidence](https://developer.mend.io/api/mc/badges/confidence/packagist/friendsofphp%2fphp-cs-fixer/3.64.0/3.85.1?slim=true)](https://docs.renovatebot.com/merge-confidence/)
|

---

### Release Notes

<details>
<summary>PHP-CS-Fixer/PHP-CS-Fixer (friendsofphp/php-cs-fixer)</summary>

###
[`v3.85.1`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3851)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.85.0...v3.85.1)

- chore: update legacy deps
([#&#8203;8902](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8902))

###
[`v3.85.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3850)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.84.0...v3.85.0)

- feat: `ArrayIndentationFixer` - handle closures inside attributes
([#&#8203;8888](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8888))
- feat: `NullableTypeDeclarationFixer` - support final promoted
properties
([#&#8203;8885](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8885))
- feat: `OperatorLinebreakFixer` - support pipe operator
([#&#8203;8891](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8891))
- feat: `PhpdocTypesFixer` - support multiline array shapes
([#&#8203;8893](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8893))
- fix: always reach 100% of checked files
([#&#8203;8861](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8861))
- fix: `BracesPositionFixer` - handle property hooks correctly
([#&#8203;8886](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8886))
- fix: `NullableTypeDeclarationFixer` - handle abstract and final
properties
([#&#8203;8876](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8876))
- fix: `PhpdocLineSpanFixer` - handle promoted properties
([#&#8203;8897](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8897))
- fix: `PhpUnitDataProviderNameFixer` - fix for multiple providers
defined by attributes for one test method
([#&#8203;8849](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8849))
- fix: `TernaryOperatorSpacesFixer` - handle `instanceof static`
([#&#8203;8879](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8879))
- fix: `TypeDeclarationSpacesFixer` - handle asymmetric visibility and
final properties
([#&#8203;8900](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8900))
- chore: add initial PHP 8.5 integration test
([#&#8203;8871](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8871))
- chore: add tests for public API methods
([#&#8203;8895](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8895))
- chore: apply changes from `PhpdocTypesFixer` for multiline array
shapes
([#&#8203;8894](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8894))
- chore: baseline files without error count
([#&#8203;8870](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8870))
- chore: cleanup `PhpCsFixer\DocBlock\Annotation`
([#&#8203;8892](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8892))
- chore: Command name/descriptions - use attribute and static properties
([#&#8203;8862](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8862))
- chore: Commands - unify way to define help content
([#&#8203;8881](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8881))
- chore: ConfigurationResolver - add few missing v4 TODOs
([#&#8203;8882](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8882))
- chore: fix `booleanNot.exprNotBoolean` errors
([#&#8203;8869](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8869))
- chore: fix/optimize some phpdocs
([#&#8203;8889](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8889))
- chore: more unification of PHP CS Fixer naming
([#&#8203;8854](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8854))
- chore: PHPStan baseline - use
`shipmonk/phpstan-baseline-per-identifier`
([#&#8203;8844](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8844))
- chore: remove dead code
([#&#8203;8896](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8896))
- chore: remove unused constants
([#&#8203;8864](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8864))
- chore: remove useless `@var` annotations
([#&#8203;8867](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8867))
- chore: simplify `ClassDefinitionFixer`
([#&#8203;8868](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8868))
- chore: unify usage of image versions to not mention minor
([#&#8203;8860](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8860))
- chore: update PHPStan
([#&#8203;8898](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8898))
- chore: update PHPStan extension for `Preg::match`
([#&#8203;8872](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8872))
- chore: wrong return values in `ErrorsManager`
([#&#8203;8863](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8863))
- chore: `OrderedInterfacesFixer` - make code more PHPStan friendly
([#&#8203;8866](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8866))
- chore: `Token` - add `@phpstan-assert-if-true`
([#&#8203;8865](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8865))
- deps: bump phpstan/phpstan from 2.1.17 to 2.1.18 in /dev-tools in the
phpstan group
([#&#8203;8859](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8859))
- deps: bump the phpstan group in /dev-tools with 4 updates
([#&#8203;8890](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8890))
- docs: better document reprecated rule sets
([#&#8203;8878](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8878))
- docs: cleanup docs for PHP 7
([#&#8203;8873](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8873))
- docs: cleanup docs for PHP < 7.4
([#&#8203;8855](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8855))
- docs: ListSetsCommand,FixCommand - document possible formats in
Command's definitions
([#&#8203;8880](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8880))
- DX: Explicitly prevent touching non-monolithic files
([#&#8203;6517](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/6517))

###
[`v3.84.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3840)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.83.0...v3.84.0)

- feat: Introduce `NoUselessPrintfFixer`
([#&#8203;8820](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8820))
- feat: `CastSpacesFixer` - support `(void)` cast
([#&#8203;8851](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8851))
- feat: `NewExpressionParenthesesFixer` - add to `PHP84MigrationSet`
([#&#8203;8788](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8788))
- feat: `VisibilityRequiredFixer` - support final promoted properties
([#&#8203;8835](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8835))
- fix: `PhpdocToParamTypeFixer` - do not convert types from
`phpstan-type`, `phpstan-import-type`, `psalm-type` and
`psalm-import-type`
([#&#8203;8842](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8842))
- fix: `PhpdocToPropertyTypeFixer` - do not convert types from
`phpstan-type`, `phpstan-import-type`, `psalm-type` and
`psalm-import-type`
([#&#8203;8847](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8847))
- fix: `PhpdocToReturnTypeFixer` - do not convert types from
`phpstan-type`, `phpstan-import-type`, `psalm-type` and
`psalm-import-type`
([#&#8203;8846](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8846))
- chore: introduce FCT for few missing tokens
([#&#8203;8845](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8845))
- chore: remove useless static variables for const content
([#&#8203;8836](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8836))
- chore: simplify `isGivenKind`/`equals`/`equalsAll` calls
([#&#8203;8843](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8843))
- docs: Support for new PHP version
([#&#8203;8780](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8780))

###
[`v3.83.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3830)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.82.2...v3.83.0)

- feat: Suppress enable parallel runner message when only 1 core is
available
([#&#8203;8833](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8833))
- fix: BracesPositionFixer - fix performance issue for massive files
with CT::T\_CURLY\_CLOSE
([#&#8203;8830](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8830))
- fix: `NoUnreachableDefaultArgumentValueFixer` - do not crash on
property hook
([#&#8203;8838](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8838))
- chore: Add CS commit to .git-blame-ignore-revs
- chore: apply native\_constant\_invocation for build-in consts
([#&#8203;8837](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8837))
- chore: configure native\_constant\_invocation
([#&#8203;8840](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8840))
- chore: early compat check with Symfony 8
([#&#8203;8827](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8827))
- chore: `FullyQualifiedStrictTypesFixer` - reduce function calls
([#&#8203;8834](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8834))
- CI: mark jobs allow-to-fail declarative, instead of imperative check
([#&#8203;8829](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8829))

###
[`v3.82.2`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3822)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.82.1...v3.82.2)

- fix: `ClassAttributesSeparationFixer` - handle method `get` aliased in
trait import
([#&#8203;8822](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8822))
- fix: `LowercaseStaticReferenceFixer` - do not touch enum's cases
([#&#8203;8824](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8824))
- fix: `StatementIndentationFixer` - multi constant statement containing
array
([#&#8203;8825](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8825))
- fix: `VisibilityRequiredFixer` - handle promoted property with
visibility and reference, but without type
([#&#8203;8823](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8823))

###
[`v3.82.1`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3821)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.82.0...v3.82.1)

- fix: `OrderedClassElementsFixer` - handle property hooks
([#&#8203;8817](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8817))
- fix: `SingleClassElementPerStatementFixer` - fix for property hooks
([#&#8203;8816](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8816))

###
[`v3.82.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3820)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.81.0...v3.82.0)

- chore: cleanup `FCTTest`
([#&#8203;8808](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8808))
- chore: PhpdocOrderFixer.php - CPU optimization
([#&#8203;8812](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8812))
- deps: update box
([#&#8203;8795](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8795))
- docs: fix whitespace around code examples and reference sections in
rules' docs
([#&#8203;8810](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8810))
- feat: `MagicConstantCasingFixer` - support `__PROPERTY__`
([#&#8203;8809](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8809))
- feat: `PhpUnitDataProviderNameFixer` - support data providers defined
by both annotation and attribute for the same test
([#&#8203;8811](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8811))
- fix: `PhpdocToParamTypeFixer` - always handle reference in PHPDoc
([#&#8203;8813](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8813))

###
[`v3.81.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3810)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.80.0...v3.81.0)

- feat: `VisibilityRequiredFixer` - handle more than only the first
promoted property
([#&#8203;8801](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8801))
- fix: `BracesPositionFixer` - do not crash when variable is terminated
by PHP close tag
([#&#8203;8804](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8804))
- fix: `PhpUnitDataProviderMethodOrderFixer` - handle data provider
defined by both annotation and attribute
([#&#8203;8805](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8805))
- fix: `PhpUnitInternalClassFixer` - skip adding `@internal` on
instantiation of anonymous classes
([#&#8203;8807](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8807))
- fix: `VisibilityRequiredFixer` - handle promoted parameter passed by
reference
([#&#8203;8799](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8799))
- chore: add automatically to milestone "PHP 8.5 initial compatibility"
if label is "topic/PHP8.5"
([#&#8203;8806](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8806))
- chore: fail "Deployment checks" if any job from `tests` failed
([#&#8203;8792](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8792))
- docs: update docs about --allow-unsupported-php-version
([#&#8203;8796](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8796))

###
[`v3.80.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3800)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.79.0...v3.80.0)

- feat: PHP 8.4 compatibility support
([#&#8203;8300](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8300))

###
[`v3.79.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3790)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.78.1...v3.79.0)

- chore: `VisibilityRequiredFixerTest` - run tests in correct PHP
version
([#&#8203;8790](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8790))
- feat: `BracesPositionFixer` - do not touch one-line properties with
hooks
([#&#8203;8785](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8785))
- feat: `PhpUnitDataProvider(.+)Fixer` - support attributes
([#&#8203;8197](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8197))

###
[`v3.78.1`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3781)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.78.0...v3.78.1)

- fix: `VisibilityRequiredFixer` - do not add `public` incorrectly
([#&#8203;8787](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8787))

###
[`v3.78.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3780)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.77.0...v3.78.0)

- chore: `VisibilityRequiredFixer` - document behaviour for asymmetric
visibility with only set-visibility
([#&#8203;8783](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8783))
- feat: `BracesPositionFixer` - support property hooks
([#&#8203;8782](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8782))
- feat: `VisibilityRequiredFixer` - support promoted property without
visibility
([#&#8203;8773](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8773))
- fix: `NativeFunctionInvocationFixer` - fix global function `set`
called in array key
([#&#8203;8568](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8568))
- fix: `NoBreakCommentFixer` - handle function having return type
([#&#8203;8767](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8767))
- fix: `StatementIndentationFixer` - handle functions `set` and `get`
(like property hooks, but not)
([#&#8203;8576](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8576))
- fix: `StaticPrivateMethodFixer` - handle nested calls
([#&#8203;8768](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8768))

###
[`v3.77.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3770)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.76.0...v3.77.0)

- chore: add automatically to milestone "PHP 8.4 initial compatibility"
if label is "topic/PHP8.4"
([#&#8203;8770](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8770))
- chore: Add CS commit to .git-blame-ignore-revs
- chore: fix adding automatically to milestone "PHP 8.4 initial
compatibility" if label is "topic/PHP8.4"
([#&#8203;8775](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8775))
- chore: fix adding automatically to milestone "PHP 8.4 initial
compatibility" if label is "topic/PHP8.4"
([#&#8203;8776](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8776))
- chore: move all indicators to analyzers
([#&#8203;8772](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8772))
- chore: move PHP-compat integration tests
([#&#8203;8781](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8781))
- chore: partially apply NoExtraBlankLinesFixer:tokens.comma
([#&#8203;8762](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8762))
- chore: reconfigure phpdoc\_order in local config
([#&#8203;8220](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8220))
- feat: PhpdocOrderFixer - extend support for phpstan and psalm
annotations
([#&#8203;8777](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8777))
- feat: support anonymous classes extending `TestCase` in PHPUnit fixers
([#&#8203;8707](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8707))
- feat: `CommentToPhpdocFixer` and `PhpdocToCommentFixer` - support
asymmetric visibility
([#&#8203;8774](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8774))
- feat: `NoEmptyStatementFixer` - support abstract property hooks
([#&#8203;8766](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8766))
- feat: `NullableTypeDeclarationForDefaultNullValueFixer` - support
asymmetric visibility in the constructor
([#&#8203;8604](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8604))
- feat: `ProtectedToPrivateFixer` - add support for promoted properties
([#&#8203;8608](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8608))
- fix: `PhpUnitAttributesFixer` - correctly remove annotations when
configured `['keep_annotations' => false]`
([#&#8203;8577](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8577))
- fix: `ProtectedToPrivateFixer` - fix asymmetric visibility with only
set visibility
([#&#8203;8763](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8763))

###
[`v3.76.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3760)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.75.0...v3.76.0)

- chore(release): bump php ci alpine version
([#&#8203;8581](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8581))
- chore: add missing priority test for `BracesPositionFixer` and
`MultilinePromotedPropertiesFixer`
([#&#8203;8596](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8596))
- chore: add more assertions in tests
([#&#8203;8740](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8740))
- chore: bump dependencies version to maximum for non-newest MAJOR
version
([#&#8203;8753](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8753))
- chore: cast types in tests
([#&#8203;8742](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8742))
- chore: cleanup booleans use in tests
([#&#8203;8738](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8738))
- chore: cleanup code in tests
([#&#8203;8745](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8745))
- chore: cleanup PsrAutoloadingFixerTest.php keywords handling, as
always defined currently
([#&#8203;8730](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8730))
- chore: cleanup `AlignMultilineCommentFixerTest`
([#&#8203;8688](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8688))
- chore: cleanup `BinaryOperatorSpacesFixerTest`
([#&#8203;8687](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8687))
- chore: cleanup `BlankLineBeforeStatementFixerTest`
([#&#8203;8685](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8685))
- chore: cleanup `ClassDefinitionFixerTest`
([#&#8203;8684](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8684))
- chore: cleanup `ClassDefinitionFixer`
([#&#8203;8580](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8580))
- chore: cleanup `ConcatSpaceFixerTest`
([#&#8203;8683](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8683))
- chore: cleanup `DoctrineAnnotationArrayAssignmentFixerTest`
([#&#8203;8621](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8621))
- chore: cleanup `DoctrineAnnotationBracesFixerTest`
([#&#8203;8623](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8623))
- chore: cleanup `DoctrineAnnotationIndentationFixerTest`
([#&#8203;8620](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8620))
- chore: cleanup `DoctrineAnnotationSpacesFixerTest`
([#&#8203;8624](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8624))
- chore: cleanup `EchoTagSyntaxFixerTest`
([#&#8203;8681](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8681))
- chore: cleanup `file_get_contents` return types
([#&#8203;8735](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8735))
- chore: cleanup `FunctionDeclarationFixerTest`
([#&#8203;8680](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8680))
- chore: cleanup `FunctionToConstantFixerTest`
([#&#8203;8618](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8618))
- chore: cleanup `GeneralPhpdocTagRenameFixerTest`
([#&#8203;8627](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8627))
- chore: cleanup `GlobalNamespaceImportFixerTest`
([#&#8203;8679](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8679))
- chore: cleanup `HeaderCommentFixerTest`
([#&#8203;8677](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8677))
- chore: cleanup `HeaderCommentFixerTest` (restore `@requires` for PHP
8.1)
([#&#8203;8678](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8678))
- chore: cleanup `IncrementStyleFixerTest`
([#&#8203;8676](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8676))
- chore: cleanup `IndentationTypeFixerTest`
([#&#8203;8675](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8675))
- chore: cleanup `ListSyntaxFixerTest`
([#&#8203;8674](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8674))
- chore: cleanup `MethodArgumentSpaceFixerTest`
([#&#8203;8673](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8673))
- chore: cleanup `MultilineWhitespaceBeforeSemicolonsFixerTest`
([#&#8203;8614](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8614))
- chore: cleanup `NativeConstantInvocationFixerTest`
([#&#8203;8672](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8672))
- chore: cleanup `NewWithParenthesesFixerTest`
([#&#8203;8592](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8592))
- chore: cleanup `NoBlankLinesAfterPhpdocFixerTest`
([#&#8203;8671](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8671))
- chore: cleanup `NoBreakCommentFixerTest`
([#&#8203;8670](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8670))
- chore: cleanup `NoClosingTagFixerTest`
([#&#8203;8669](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8669))
- chore: cleanup `NoEmptyStatementFixerTest`
([#&#8203;8667](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8667))
- chore: cleanup `NoSpacesAroundOffsetFixerTest`
([#&#8203;8666](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8666))
- chore: cleanup `NoUnneededControlParenthesesFixerTest`
([#&#8203;8665](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8665))
- chore: cleanup `NoUselessElseFixerTest`
([#&#8203;8664](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8664))
- chore: cleanup `PhpdocAddMissingParamAnnotationFixerTest`
([#&#8203;8663](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8663))
- chore: cleanup `PhpdocNoEmptyReturnFixerTest`
([#&#8203;8662](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8662))
- chore: cleanup `PhpdocNoPackageFixerTest`
([#&#8203;8626](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8626))
- chore: cleanup `PhpdocOrderByValueFixerTest`
([#&#8203;8661](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8661))
- chore: cleanup `PhpdocOrderFixerTest`
([#&#8203;8660](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8660))
- chore: cleanup `PhpdocParamOrderFixerTest`
([#&#8203;8659](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8659))
- chore: cleanup `PhpdocReturnSelfReferenceFixerTest`
([#&#8203;8658](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8658))
- chore: cleanup `PhpdocSeparationFixerTest`
([#&#8203;8657](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8657))
- chore: cleanup `PhpdocSummaryFixerTest`
([#&#8203;8654](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8654))
- chore: cleanup `PhpdocTrimFixerTest`
([#&#8203;8653](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8653))
- chore: cleanup `PhpdocTypesOrderFixerTest`
([#&#8203;8652](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8652))
- chore: cleanup `PhpdocVarWithoutNameFixerTest`
([#&#8203;8617](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8617))
- chore: cleanup `PhpUnitConstructFixerTest`
([#&#8203;8651](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8651))
- chore: cleanup `PhpUnitDedicateAssertFixerTest`
([#&#8203;8650](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8650))
- chore: cleanup `PhpUnitTestCaseStaticMethodCallsFixerTest`
([#&#8203;8649](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8649))
- chore: cleanup `Preg` issues
([#&#8203;8720](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8720))
- chore: cleanup `ReturnAssignmentFixerTest`
([#&#8203;8648](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8648))
- chore: cleanup `ReturnTypeDeclarationFixerTest`
([#&#8203;8647](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8647))
- chore: cleanup `SingleImportPerStatementFixerTest`
([#&#8203;8645](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8645))
- chore: cleanup `SingleLineCommentStyleFixerTest`
([#&#8203;8644](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8644))
- chore: cleanup `SingleSpaceAroundConstructFixerTest`
([#&#8203;8642](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8642))
- chore: cleanup `SpaceAfterSemicolonFixerTest`
([#&#8203;8625](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8625))
- chore: cleanup `SpacesInsideParenthesesFixerTest`
([#&#8203;8641](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8641))
- chore: cleanup `StatementIndentationFixerTest`
([#&#8203;8640](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8640))
- chore: cleanup `YodaStyleFixerTest`
([#&#8203;8638](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8638))
- chore: do not check if `JSON_INVALID_UTF8_IGNORE` is defined because
it always is (since PHP 7.2)
([#&#8203;8709](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8709))
- chore: handle saveXML failures explicitly
([#&#8203;8755](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8755))
- chore: ignore remaining PHPStan (false positive) issues
([#&#8203;8746](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8746))
- chore: improve PHPDoc's types in
([#&#8203;8741](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8741))
- chore: improve PHPDocs in tests
([#&#8203;8736](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8736))
- chore: improve PHPDocs in tests
([#&#8203;8744](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8744))
- chore: improve type of `Token::equalsAny`
([#&#8203;8743](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8743))
- chore: lint yaml files
([#&#8203;8622](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8622))
- chore: MultilinePromotedPropertiesFixer - mark new fixer introduced in
[#&#8203;8595](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8595)
as experimental
([#&#8203;8758](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8758))
- chore: PHPMD - cleanup `UnusedLocalVariable` for `foreach`
([#&#8203;8637](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8637))
- chore: refactor FCT
([#&#8203;8714](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8714))
- chore: remove unused local variables in src
([#&#8203;8600](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8600))
- chore: remove unused local variables in tests
([#&#8203;8599](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8599))
- chore: remove useless test from `AliasedFixerOptionTest`
([#&#8203;8739](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8739))
- chore: remove `defined` calls from tests
([#&#8203;8708](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8708))
- chore: restore original type of Token::equalsAny, partially reverts
[#&#8203;8743](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8743)
([#&#8203;8759](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8759))
- chore: run mutation tests on PHP 8.4
([#&#8203;8594](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8594))
- chore: solve one of phpstan warnings
([#&#8203;8754](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8754))
- chore: update dev tools
([#&#8203;8737](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8737))
- chore: update PHPUnit config
([#&#8203;8721](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8721))
- chore: update `checkbashisms` to 2.25.12
([#&#8203;8694](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8694))
- chore: update `checkbashisms` to 2.25.14
([#&#8203;8731](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8731))
- chore: use PHPStan type in data providers
([#&#8203;8605](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8605))
- chore: use `foreach` values
([#&#8203;8636](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8636))
- chore: use `Preg` class everywhere
([#&#8203;8689](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8689))
- CI: add self-approved label
([#&#8203;8757](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8757))
- CI: run on PHP 8.5
([#&#8203;8713](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8713))
- deps: bump alpine from 3.21.3 to 3.22.0
([#&#8203;8724](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8724))
- deps: bump alpine from 3.21.3 to 3.22.0
([#&#8203;8726](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8726))
- deps: bump ergebnis/composer-normalize from 2.45.0 to 2.46.0 in
/dev-tools
([#&#8203;8578](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8578))
- deps: bump ergebnis/composer-normalize from 2.46.0 to 2.47.0 in
/dev-tools
([#&#8203;8584](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8584))
- deps: bump phpstan/phpstan from 2.1.11 to 2.1.12 in /dev-tools in the
phpstan group
([#&#8203;8583](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8583))
- deps: bump phpstan/phpstan-symfony from 2.0.3 to 2.0.4 in /dev-tools
in the phpstan group
([#&#8203;8557](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8557))
- deps: bump the phpstan group across 1 directory with 2 updates
([#&#8203;8682](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8682))
- deps: upgrade docker deps
([#&#8203;8566](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8566))
- docs: extend and fix links to code
([#&#8203;8639](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8639))
- docs: Update SECURITY.md
([#&#8203;8716](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8716))
- docs: VisibilityRequiredFixer - extend docs
([#&#8203;8561](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8561))
- docs: `VisibilityRequiredFixer` - update docs
([#&#8203;8563](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8563))
- DX: add `symfony/polyfill-php84`
([#&#8203;8555](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8555))
- DX: always use the latest stable `checkbashisms` package
([#&#8203;8732](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8732))
- DX: check for `preg_` functions in tests
([#&#8203;8571](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8571))
- DX: cleanup `BlankLinesBeforeNamespaceFixerTest`
([#&#8203;8573](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8573))
- DX: cleanup `NativeFunctionInvocationFixerTest`
([#&#8203;8567](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8567))
- DX: cleanup `NoUselessConcatOperatorFixerTest`
([#&#8203;8572](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8572))
- DX: cleanup `SemicolonAfterInstructionFixerTest`
([#&#8203;8570](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8570))
- DX: fix data providers
([#&#8203;8693](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8693))
- DX: introduce `FCT` class for tokens not present in the lowest
supported PHP version
([#&#8203;8706](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8706))
- DX: move `symfony/polyfill-php84` to dev deps
([#&#8203;8559](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8559))
- DX: support PHP 8.4 in local Docker development environment
([#&#8203;8564](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8564))
- DX: trim array/yield keys
([#&#8203;8460](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8460))
- DX: use `WhitespacesAwareFixerInterface` only when needed
([#&#8203;8541](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8541))
- feat: add `NewExpressionParenthesesFixer`
([#&#8203;8246](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8246))
- feat: allowUnsupportedPhpVersion
([#&#8203;8733](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8733))
- feat: introduce `MultilinePromotedPropertiesFixer`
([#&#8203;8595](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8595))
- feat: Introduce `StaticPrivateMethodFixer`
([#&#8203;4557](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/4557))
- feat: `BracesPositionFixer` - support property hooks in promoted
properties
([#&#8203;8613](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8613))
- feat: `ClassAttributesSeparationFixer` - add support for property
hooks
([#&#8203;8610](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8610))
- feat: `GlobalNamespaceImportFixer` - analyze and fix more annotations
with types
([#&#8203;8593](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8593))
- feat: `LowercaseKeywordsFixer` - support asymmetric visibility
([#&#8203;8607](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8607))
- feat: `NoExtraBlankLinesFixer` - add comma to supported tokens
([#&#8203;8655](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8655))
- feat: `NoSuperfluousPhpdocTagsFixer` - support asymmetric visibility
([#&#8203;8700](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8700))
- feat: `NullableTypeDeclarationFixer` - support asymmetric visibility
([#&#8203;8697](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8697))
- feat: `OrderedClassElementsFixer` - add support for property hooks for
abstract properties
([#&#8203;8574](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8574))
- feat: `OrderedTypesFixer` - add support for asymmetric visibility
([#&#8203;8552](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8552))
- feat: `OrderedTypesFixer` - support asymmetric visibility in promoted
property
([#&#8203;8602](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8602))
- feat: `PhpdocAddMissingParamAnnotationFixer` - support asymmetric
visibility
([#&#8203;8701](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8701))
- feat: `PhpdocLineSpanFixer` - support asymmetric visibility
([#&#8203;8702](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8702))
- feat: `PhpdocVarWithoutNameFixer` - support asymmetric visibility
([#&#8203;8704](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8704))
- feat: `ProtectedToPrivateFixer` - add support for asymmetric
visibility
([#&#8203;8569](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8569))
- feat: `SingleClassElementPerStatementFixer` - support asymmetric
visibility
([#&#8203;8696](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8696))
- feat: `SingleSpaceAroundConstructFixer` - add support for asymmetric
visibility
([#&#8203;8699](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8699))
- feat: `StaticLambdaFixer` - support functions having classy elements
with `$this`
([#&#8203;8728](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8728))
- feat: `VisibilityRequiredFixer` - support ordering set-visibility
modifier
([#&#8203;8606](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8606))
- fix(dependabot): convert time values to string types
([#&#8203;8634](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8634))
- fix: "array" type must have no prefix to be fixable to "list"
([#&#8203;8692](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8692))
- fix: "min"/"max" in int generics must never be prefixed by backslash
([#&#8203;8691](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8691))
- fix: Allow non-doc comment on opening inline brace line
([#&#8203;8690](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8690))
- fix: `ConstantCaseFixer` - do not touch namespaces starting with
`Null\`
([#&#8203;8752](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8752))
- fix: `LowercaseStaticReferenceFixer` - do not change global constants
([#&#8203;8727](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8727))
- fix: `MultilineWhitespaceBeforeSemicolonsFixer` - do not touch
multiline constants definitions
([#&#8203;8615](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8615))
- fix: `NewWithParenthesesFixer` - fix `new` without parentheses on PHP
8.4 syntax
([#&#8203;8588](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8588))
- fix: `NoMultipleStatementsPerLineFixer` - handle `set` and `get` in
different casing in property hooks
([#&#8203;8558](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8558))
- fix: `NoUnusedImportsFixer` - handle imported class name with
underscore before or after it in PHPDoc
([#&#8203;8598](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8598))
- fix: `PhpUnitDedicateAssertFixer` - fix for `assertFalse` with
`instanceof`
([#&#8203;8597](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8597))
- fix: `PhpUnitNamespacedFixer` must rune before
`NoUnneededImportAliasFixer`
([#&#8203;8579](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8579))
- fix: `PhpUnitTestClassRequiresCoversFixer` - do not add
`@coversNothing` annotation when `CoversTrait` attribute is used
([#&#8203;8734](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8734))
- fix: `VisibilityRequiredFixer` - add support for asymmetric visibility
([#&#8203;8586](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8586))
- refactor: avoid unused local variables in tests
([#&#8203;8609](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8609))
- test: add more cases to `PhpUnitMethodCasingFixerTest`
([#&#8203;8551](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8551))
- test: fix "unused local variables `$token`"
([#&#8203;8603](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8603))
- test: More verbose error output for integration test
([#&#8203;8565](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8565))
- Update SECURITY.md

###
[`v3.75.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3750)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.74.0...v3.75.0)

- feat: `ClassAttributesSeparationFixer` - add support for asymmetric
visibility
([#&#8203;8518](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8518))
- fix: `NativeFunctionInvocationFixer` - fix for property hooks
([#&#8203;8540](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8540))
- chore: add return types for data providers for fixers
([#&#8203;8542](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8542))
- chore: add return types for data providers for non-fixers
([#&#8203;8543](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8543))
- chore: add return types for remaining data providers
([#&#8203;8544](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8544))
- chore: make data providers key type `int` if all the keys are strings
([#&#8203;8550](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8550))
- chore: make data providers key type `string` if all the keys are
strings
([#&#8203;8545](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8545))
- chore: SwitchContinueToBreakFixerTest - improve test case
descriptions/typehint
([#&#8203;8546](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8546))
- chore: `FunctionsAnalyzerTest` cleanup
([#&#8203;8539](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8539))
- deps: bump the phpstan group in /dev-tools with 2 updates
([#&#8203;8537](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8537))
- test: ProjectCodeTest::testDataProvidersDeclaredReturnType - allow for
int as iterable keys
([#&#8203;8548](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8548))

###
[`v3.74.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3740)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.73.1...v3.74.0)

- feat: add `--format=@&#8203;auto`
([#&#8203;8513](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8513))
- fix: `BracesPositionFixer` - do not create two consecutive whitespace
tokens
([#&#8203;8496](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8496))
- fix: `MbStrFunctionsFixer` - fix imports with leading backslash
([#&#8203;8507](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8507))
- fix: `NoUnreachableDefaultArgumentValueFixer` - do not crash on
property hook
([#&#8203;8512](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8512))
- fix: `OrderedImportsFixer` - do not take the braces part in grouped
imports into account
([#&#8203;8459](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8459))
- fix: `OrderedImportsFixer` - fix syntax error with grouped use
statement and multiple use with comma
([#&#8203;8483](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8483))
- fix: `PhpUnitAttributesFixer` - handle parentheses after data provider
method name
([#&#8203;8510](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8510))
- fix: `PhpUnitMethodCasingFixer` - do not touch anonymous class
([#&#8203;8463](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8463))
- chore: make options that have default and allowed sets the same size
the same array
([#&#8203;8529](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8529))
- chore: update return type of `FixerOptionInterface::getAllowedValues`
([#&#8203;8530](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8530))
- chore: `Preg` - improve types
([#&#8203;8527](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8527))
- CI: fix code coverage job
([#&#8203;8520](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8520))
- CI: try MacOS job without ParaUnit
([#&#8203;8528](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8528))
- deps: update PHPStan
([#&#8203;8531](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8531))
- deps: upgrade `PHPStan/*`
([#&#8203;8524](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8524))

###
[`v3.73.1`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3731)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.73.0...v3.73.1)

- fix: `OrderedClassElementsFixer` - do not crash on property hook
([#&#8203;8517](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8517))

###
[`v3.73.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3730)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.72.0...v3.73.0)

- feat: add support for asymmetric visibility to Doctrine's fixers
([#&#8203;8415](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8415))
- fix: `GeneralPhpdocTagRenameFixer` - do not rename keys in array shape
definition
([#&#8203;8477](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8477))
- fix: `MethodArgumentSpaceFixer` - handle when nested in HTML
([#&#8203;8503](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8503))
- chore: update `checkbashisms` to 2.25.5
([#&#8203;8519](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8519))
- DX: cleanup `NoExtraBlankLinesFixerTest`
([#&#8203;8505](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8505))
- DX: for duplicated test methods check methods without parameters
([#&#8203;8508](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8508))
- DX: remove more duplicated test methods
([#&#8203;8506](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8506))
- refactor: `Tokenizer` hash metode using `xxHash`
([#&#8203;8491](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8491))
- refactor: `TokensAnalyzerTest` - better test `isArray` and
`isArrayMultiLine`
([#&#8203;8504](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8504))
- test: run code coverage on PHP 8.4
([#&#8203;8448](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8448))

###
[`v3.72.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3720)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.71.0...v3.72.0)

- feat: `StatementIndentationFixer` - handle property hooks
([#&#8203;8492](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8492))
- fix: `MbStrFunctionsFixer` - fix imports
([#&#8203;8474](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8474))
- fix: `TrailingCommaInMultilineFixer` - handle empty match body
([#&#8203;8480](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8480))
- fix: `VisibilityRequiredFixer` - handle property hooks
([#&#8203;8495](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8495))
- deps: upgrade few dev-deps
([#&#8203;8490](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8490))
- deps: Upgrade PHPStan to 2.1.8
([#&#8203;8489](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8489))
- DX: add trailing comma to multiline auto-generated types
([#&#8203;8499](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8499))
- refactor: generalize CodeHasher into Hasher
([#&#8203;8500](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8500))
- refactor: Runner - unify paths used when using parallel runner
([#&#8203;8488](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8488))
- refactor: use Hasher instead of md5 directly
([#&#8203;8501](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8501))

###
[`v3.71.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3710)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.70.2...v3.71.0)

- feat: OrderedImportsFixer - deprecate length sorting algorithm
([#&#8203;8473](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8473))
- fix: `BinaryOperatorSpacesFixer` - do not break alignment of UTF-8
array keys
([#&#8203;8484](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8484))
- fix: `PhpdocAlignFixer` - align correctly type with UTF8 characters
([#&#8203;8486](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8486))
- fix: `SingleSpaceAroundConstructFixer` - handle alternative syntax
([#&#8203;8317](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8317))
- fix: `StatementIndentationFixer` - return in braceless if
([#&#8203;8479](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8479))
- chore: update type in
`SingleSpaceAroundConstructFixerTest::provideFixWithElseIfCases`
([#&#8203;8481](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8481))
- chore: update type in
`SingleSpaceAroundConstructFixerTest::provideFixWithIfCases`
([#&#8203;8482](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8482))
- deps: bump phpstan/phpstan from 2.1.6 to 2.1.7 in /dev-tools in the
phpstan group
([#&#8203;8485](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8485))
- DX: cleanup `PhpdocNoAliasTagFixerTest`
([#&#8203;8476](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8476))
- refactor: add `FullyQualifiedNameAnalyzer`
([#&#8203;8048](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8048))
- refactor: codeHash - update when it's (re-)generated
([#&#8203;8470](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8470))
- refactor: `SwitchAnalyzer` - improve performance
([#&#8203;8407](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8407))
- test: NameQualifiedTransformerTest - correct test case
([#&#8203;8471](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8471))

###
[`v3.70.2`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3702)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.70.1...v3.70.2)

- deps: upgrade deep dev-tools deps
([#&#8203;8472](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8472))
- fix: `MbStrFunctionsFixer` must run before
`NativeFunctionInvocationFixer`
([#&#8203;8466](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8466))
- fix: `MethodArgumentSpaceFixer` - fix nested calls for
`ensure_fully_multiline` option
([#&#8203;8469](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8469))

###
[`v3.70.1`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3701)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.70.0...v3.70.1)

- fix: `PhpUnitSizeClassFixer` must run before `PhpUnitAttributesFixer`
([#&#8203;8457](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8457))
- DX: cleanup `OrderedImportsFixerTest`
([#&#8203;8458](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8458))

###
[`v3.70.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3700)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.69.1...v3.70.0)

- feat: Add `PhpUnitDataProviderMethodOrderFixer` fixer
([#&#8203;8225](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8225))
- feat: `HeaderCommentFixer` - allow validators
([#&#8203;8452](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8452))
- feat: `PhpCsFixer` ruleset: use `operator_linebreak` rule for all
operators
([#&#8203;8417](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8417))
- feat: `PhpUnitMethodCasingFixer` to support PHPUnit's `Test` attribute
([#&#8203;8451](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8451))
- feat: `TypeDeclarationSpacesFixer` - Fix whitespace between const type
and const name
([#&#8203;8442](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8442))
- chore: extend bug report template
([#&#8203;8447](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8447))
- chore: extend bug report template - more installation options
([#&#8203;8450](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8450))
- CI: phpstan-symfony - add entry point for console
([#&#8203;8292](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8292))
- deps: bump alpine from 3.21.2 to 3.21.3
([#&#8203;8454](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8454))
- deps: bump phpstan/phpstan from 2.1.5 to 2.1.6 in /dev-tools in the
phpstan group
([#&#8203;8453](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8453))
- fix: `CommentsAnalyzer` - allow other forms of assignment as valid
structural elements for PHPDocs
([#&#8203;8371](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8371))
- fix: `PhpUnitTestClassRequiresCoversFixer` must run before
`PhpUnitAttributesFixer`
([#&#8203;8444](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8444))
- test: fix `CheckCommandTest::testDryRunModeIsUnavailable` to correctly
check that option `--dry-run` is unavailable
([#&#8203;8438](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8438))

###
[`v3.69.1`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3691)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.69.0...v3.69.1)

- fix: `PhpUnitAttributesFixer` - convert correctly version constraint
([#&#8203;8439](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8439))
- test: `PhpUnitAttributesFixer` must run before `NoEmptyPhpdocFixer`
([#&#8203;8443](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8443))

###
[`v3.69.0`](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/HEAD/CHANGELOG.md#Changelog-for-v3690)

[Compare
Source](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/compare/v3.68.5...v3.69.0)

- feat: Add unsealed array shape phpdoc support
([#&#8203;8299](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8299))
- fix: `OrderedClassElementsFixer` - sort correctly typed constants
([#&#8203;8408](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8408))
- chore: do not use test class as test data
([#&#8203;8430](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8430))
- chore: update `checkbashisms` to 2.25.2
([#&#8203;8427](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8427))
- chore: use constants instead of literal strings
([#&#8203;8422](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8422))
- CI: no need to unlock deps on master
([#&#8203;8426](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8426))
- CI: run tests using PHPUnit 12
([#&#8203;8431](https://redirect.github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/8431))
- deps: bump kubawerlos/composer-s

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you
are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the
rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update
again.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/).
View the [repository job
log](https://developer.mend.io/github/libretime/libretime).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0MS41MS4xIiwidXBkYXRlZEluVmVyIjoiNDEuNTEuMSIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOlsiZGVwZW5kZW5jaWVzIiwicGhwIl19-->

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: jo <ljonas@riseup.net>
2025-08-09 15:57:06 +02:00

1447 lines
47 KiB
PHP

<?php
class Application_Service_HistoryService
{
private $con;
private $timezone;
public const TEMPLATE_TYPE_ITEM = 'item';
public const TEMPLATE_TYPE_FILE = 'file';
public function __construct()
{
$this->con = isset($con) ? $con : Propel::getConnection(CcPlayoutHistoryPeer::DATABASE_NAME);
$this->timezone = Application_Model_Preference::GetTimezone();
}
public function getSupportedTemplateTypes()
{
return [self::TEMPLATE_TYPE_ITEM, self::TEMPLATE_TYPE_FILE];
}
// opts is from datatables.
public function getPlayedItemData($startDT, $endDT, $opts, $instanceId = null)
{
$mainSqlQuery = '';
$paramMap = [];
$sqlTypes = $this->getSqlTypes();
$start = $startDT->format(DEFAULT_TIMESTAMP_FORMAT);
$end = $endDT->format(DEFAULT_TIMESTAMP_FORMAT);
$template = $this->getConfiguredItemTemplate();
$fields = $template['fields'];
$required = $this->mandatoryItemFields();
$fields_filemd = [];
$filemd_keys = [];
$fields_general = [];
$general_keys = [];
foreach ($fields as $index => $field) {
if (in_array($field['name'], $required)) {
continue;
}
if ($field['isFileMd']) {
$fields_filemd[] = $field;
$filemd_keys[] = $field['name'];
} else {
$fields_general[] = $field;
$general_keys[] = $field['name'];
}
}
// -----------------------------------------------------------------------
// Using the instance_id to filter the data.
$historyRange = '('
. 'SELECT history.starts, history.ends, history.id AS history_id, history.instance_id'
. ' FROM cc_playout_history as history';
if (isset($instanceId)) {
$historyRange .= ' WHERE history.instance_id = :instance';
$paramMap['instance'] = $instanceId;
} else {
$historyRange .= ' WHERE history.starts >= :starts and history.starts < :ends';
$paramMap['starts'] = $start;
$paramMap['ends'] = $end;
}
$historyRange .= ') AS history_range';
$manualMeta = '('
. 'SELECT %KEY%.value AS %KEY%, %KEY%.history_id'
. ' FROM ('
. ' SELECT * from cc_playout_history_metadata AS phm WHERE phm.key = :meta_%KEY%'
. ' ) AS %KEY%'
. ' ) AS %KEY%_filter';
$mainSelect = [
'history_range.starts',
'history_range.ends',
'history_range.history_id',
'history_range.instance_id',
];
$mdFilters = [];
$numFileMdFields = count($fields_filemd);
if ($numFileMdFields > 0) {
// these 3 selects are only needed if $fields_filemd has some fields.
$fileSelect = ['history_file.history_id'];
$nonNullFileSelect = ['file.id as file_id'];
$nullFileSelect = ['null_file.history_id'];
$fileMdFilters = [];
// populate the different dynamic selects with file info.
for ($i = 0; $i < $numFileMdFields; ++$i) {
$field = $fields_filemd[$i];
$key = $field['name'];
$type = $sqlTypes[$field['type']];
$fileSelect[] = "file_md.{$key}::{$type}";
$nonNullFileSelect[] = "file.{$key}::{$type}";
$nullFileSelect[] = "{$key}_filter.{$key}::{$type}";
$mainSelect[] = "file_info.{$key}::{$type}";
$fileMdFilters[] = str_replace('%KEY%', $key, $manualMeta);
$paramMap["meta_{$key}"] = $key;
}
// the files associated with scheduled playback in Airtime.
$historyFile = '('
. 'SELECT history.id AS history_id, history.file_id'
. ' FROM cc_playout_history AS history'
. ' WHERE history.file_id IS NOT NULL'
. ') AS history_file';
$fileMd = '('
. 'SELECT %NON_NULL_FILE_SELECT%'
. ' FROM cc_files AS file'
. ') AS file_md';
$fileMd = str_replace('%NON_NULL_FILE_SELECT%', implode(', ', $nonNullFileSelect), $fileMd);
// null files are from manually added data (filling in webstream info etc)
$nullFile = '('
. 'SELECT history.id AS history_id'
. ' FROM cc_playout_history AS history'
. ' WHERE history.file_id IS NULL'
. ') AS null_file';
// ----------------------------------
// building the file inner query
$fileSqlQuery
= 'SELECT ' . implode(', ', $fileSelect)
. " FROM {$historyFile}"
. " LEFT JOIN {$fileMd} USING (file_id)"
. ' UNION'
. ' SELECT ' . implode(', ', $nullFileSelect)
. " FROM {$nullFile}";
foreach ($fileMdFilters as $filter) {
$fileSqlQuery .= " LEFT JOIN {$filter} USING(history_id)";
}
}
for ($i = 0, $len = count($fields_general); $i < $len; ++$i) {
$field = $fields_general[$i];
$key = $field['name'];
$type = $sqlTypes[$field['type']];
$mdFilters[] = str_replace('%KEY%', $key, $manualMeta);
$paramMap["meta_{$key}"] = $key;
$mainSelect[] = "{$key}_filter.{$key}::{$type}";
}
$mainSqlQuery
.= 'SELECT ' . implode(', ', $mainSelect)
. " FROM {$historyRange}";
if (isset($fileSqlQuery)) {
$mainSqlQuery
.= " LEFT JOIN ( {$fileSqlQuery} ) as file_info USING(history_id)";
}
foreach ($mdFilters as $filter) {
$mainSqlQuery
.= " LEFT JOIN {$filter} USING(history_id)";
}
// ----------------------------------------------------------------------
// need to count the total rows to tell Datatables.
$stmt = $this->con->prepare($mainSqlQuery);
foreach ($paramMap as $param => $v) {
$stmt->bindValue($param, $v);
}
if ($stmt->execute()) {
$totalRows = $stmt->rowCount();
} else {
$msg = implode(',', $stmt->errorInfo());
throw new Exception("Error: {$msg}");
}
// ------------------------------------------------------------------------
// Using Datatables parameters to sort the data.
if (empty($opts['iSortingCols'])) {
$orderBys = [];
} else {
$numOrderColumns = $opts['iSortingCols'];
$orderBys = [];
for ($i = 0; $i < $numOrderColumns; ++$i) {
$colNum = $opts['iSortCol_' . $i];
$key = $opts['mDataProp_' . $colNum];
$sortDir = $opts['sSortDir_' . $i];
if (in_array($key, $required)) {
$orderBys[] = "history_range.{$key} {$sortDir}";
} elseif (in_array($key, $filemd_keys)) {
$orderBys[] = "file_info.{$key} {$sortDir}";
} elseif (in_array($key, $general_keys)) {
$orderBys[] = "{$key}_filter.{$key} {$sortDir}";
}
// throw new Exception("Error: $key is not part of the template.");
}
}
if (count($orderBys) > 0) {
$orders = implode(', ', $orderBys);
$mainSqlQuery
.= " ORDER BY {$orders}";
}
// ---------------------------------------------------------------
// using Datatables parameters to add limits/offsets
$displayLength = empty($opts['iDisplayLength']) ? -1 : intval($opts['iDisplayLength']);
// limit the results returned.
if ($displayLength !== -1) {
$mainSqlQuery
.= ' OFFSET :offset LIMIT :limit';
$paramMap['offset'] = intval($opts['iDisplayStart']);
$paramMap['limit'] = $displayLength;
}
$stmt = $this->con->prepare($mainSqlQuery);
foreach ($paramMap as $param => $v) {
$stmt->bindValue($param, $v);
}
$rows = [];
if ($stmt->execute()) {
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
} else {
$msg = implode(',', $stmt->errorInfo());
throw new Exception("Error: {$msg}");
}
// -----------------------------------------------------------------------
// processing results.
$timezoneUTC = new DateTimeZone('UTC');
$timezoneLocal = new DateTimeZone($this->timezone);
$boolCast = [];
foreach ($fields as $index => $field) {
if ($field['type'] == TEMPLATE_BOOLEAN) {
$boolCast[] = $field;
}
}
foreach ($rows as $index => &$result) {
foreach ($boolCast as $field) {
$result[$field['label']] = (bool) $result[$field['name']];
}
// need to display the results in the station's timezone.
$dateTime = new DateTime($result['starts'], $timezoneUTC);
$dateTime->setTimezone($timezoneLocal);
$result['starts'] = $dateTime->format(DEFAULT_TIMESTAMP_FORMAT);
// if ends is null we don't want it to default to "now"
if (isset($result['ends'])) {
$dateTime = new DateTime($result['ends'], $timezoneUTC);
$dateTime->setTimezone($timezoneLocal);
$result['ends'] = $dateTime->format(DEFAULT_TIMESTAMP_FORMAT);
}
if (isset($result[MDATA_KEY_DURATION])) {
$formatter = new LengthFormatter($result[MDATA_KEY_DURATION]);
$result[MDATA_KEY_DURATION] = $formatter->format();
}
// need to add a checkbox..
$result['checkbox'] = '';
// $unicodeChar = '\u2612';
// $result["new"] = json_decode('"'.$unicodeChar.'"');
// $result["new"] = "U+2612";
}
return [
'sEcho' => empty($opts['sEcho']) ? null : intval($opts['sEcho']),
// "iTotalDisplayRecords" => intval($totalDisplayRows),
'iTotalDisplayRecords' => intval($totalRows),
'iTotalRecords' => intval($totalRows),
'history' => $rows,
];
}
public function getFileSummaryData($startDT, $endDT, $opts)
{
$select = [
'summary.played',
'summary.file_id',
'summary.' . MDATA_KEY_TITLE,
'summary.' . MDATA_KEY_CREATOR,
];
$mainSqlQuery = '';
$paramMap = [];
$start = $startDT->format(DEFAULT_TIMESTAMP_FORMAT);
$end = $endDT->format(DEFAULT_TIMESTAMP_FORMAT);
$paramMap['starts'] = $start;
$paramMap['ends'] = $end;
$template = $this->getConfiguredFileTemplate();
$fields = $template['fields'];
$required = $this->mandatoryFileFields();
foreach ($fields as $index => $field) {
$key = $field['name'];
if (in_array($field['name'], $required)) {
continue;
}
$select[] = "summary.{$key}";
}
$fileSummaryTable = '((
SELECT COUNT(history.file_id) as played, history.file_id as file_id
FROM cc_playout_history AS history
WHERE history.starts >= :starts AND history.starts < :ends
AND history.file_id IS NOT NULL
GROUP BY history.file_id
) AS playout
LEFT JOIN cc_files AS file ON (file.id = playout.file_id)) AS summary';
$mainSqlQuery
.= 'SELECT ' . implode(', ', $select)
. " FROM {$fileSummaryTable}";
// -------------------------------------------------------------------------
// need to count the total rows to tell Datatables.
$stmt = $this->con->prepare($mainSqlQuery);
foreach ($paramMap as $param => $v) {
$stmt->bindValue($param, $v);
}
if ($stmt->execute()) {
$totalRows = $stmt->rowCount();
} else {
$msg = implode(',', $stmt->errorInfo());
throw new Exception("Error: {$msg}");
}
// ------------------------------------------------------------------------
// Using Datatables parameters to sort the data.
$numOrderColumns = $opts['iSortingCols'];
$orderBys = [];
for ($i = 0; $i < $numOrderColumns; ++$i) {
$colNum = $opts['iSortCol_' . $i];
$key = $opts['mDataProp_' . $colNum];
$sortDir = $opts['sSortDir_' . $i];
$orderBys[] = "summary.{$key} {$sortDir}";
}
if ($numOrderColumns > 0) {
$orders = implode(', ', $orderBys);
$mainSqlQuery
.= " ORDER BY {$orders}";
}
// ------------------------------------------------------------
// using datatables params to add limits/offsets
$displayLength = intval($opts['iDisplayLength']);
if ($displayLength !== -1) {
$mainSqlQuery
.= ' OFFSET :offset LIMIT :limit';
$paramMap['offset'] = $opts['iDisplayStart'];
$paramMap['limit'] = $displayLength;
}
$stmt = $this->con->prepare($mainSqlQuery);
foreach ($paramMap as $param => $v) {
$stmt->bindValue($param, $v);
}
$rows = [];
if ($stmt->execute()) {
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
} else {
$msg = implode(',', $stmt->errorInfo());
throw new Exception("Error: {$msg}");
}
// -----------------------------------------------------------------
// processing the results
foreach ($rows as &$row) {
if (isset($row[MDATA_KEY_DURATION])) {
$formatter = new LengthFormatter($row[MDATA_KEY_DURATION]);
$row[MDATA_KEY_DURATION] = $formatter->format();
}
}
return [
'sEcho' => intval($opts['sEcho']),
// "iTotalDisplayRecords" => intval($totalDisplayRows),
'iTotalDisplayRecords' => intval($totalRows),
'iTotalRecords' => intval($totalRows),
'history' => $rows,
];
}
public function getShowList($startDT, $endDT, $userId = null)
{
if (empty($userId)) {
$user = Application_Model_User::getCurrentUser();
} else {
$user = new Application_Model_User($userId);
}
$shows = Application_Model_Show::getShows($startDT, $endDT);
Logging::info($startDT->format(DEFAULT_TIMESTAMP_FORMAT));
Logging::info($endDT->format(DEFAULT_TIMESTAMP_FORMAT));
Logging::info($shows);
// need to filter the list to only their shows
if ((!empty($user)) && $user->isHost()) {
$showIds = [];
foreach ($shows as $show) {
$showIds[] = $show['show_id'];
}
$showIds = array_unique($showIds);
Logging::info($showIds);
$hostRecords = CcShowHostsQuery::create()
->filterByDbHost($user->getId())
->filterByDbShow($showIds)
->find($this->con);
$filteredShowIds = [];
foreach ($hostRecords as $record) {
$filteredShowIds[] = $record->getDbShow();
}
Logging::info($filteredShowIds);
$filteredShows = [];
foreach ($shows as $show) {
if (in_array($show['show_id'], $filteredShowIds)) {
$filteredShows[] = $show;
}
}
} else {
$filteredShows = $shows;
}
$timezoneUTC = new DateTimeZone('UTC');
$timezoneLocal = new DateTimeZone($this->timezone);
foreach ($filteredShows as &$result) {
// need to display the results in the station's timezone.
$dateTime = new DateTime($result['starts'], $timezoneUTC);
$dateTime->setTimezone($timezoneLocal);
$result['starts'] = $dateTime->format(DEFAULT_TIMESTAMP_FORMAT);
$dateTime = new DateTime($result['ends'], $timezoneUTC);
$dateTime->setTimezone($timezoneLocal);
$result['ends'] = $dateTime->format(DEFAULT_TIMESTAMP_FORMAT);
}
return $filteredShows;
}
public function insertWebstreamMetadata($schedId, $startDT, $data)
{
$this->con->beginTransaction();
try {
$item = CcScheduleQuery::create()->findPK($schedId, $this->con);
// TODO figure out how to combine these all into 1 query.
$showInstance = $item->getCcShowInstances($this->con);
$show = $showInstance->getCcShow($this->con);
$webstream = $item->getCcWebstream($this->con);
$metadata = [];
$metadata['showname'] = $show->getDbName();
$metadata[MDATA_KEY_TITLE] = $data->title;
$metadata[MDATA_KEY_CREATOR] = $webstream->getDbName();
$history = new CcPlayoutHistory();
$history->setDbStarts($startDT);
$history->setDbEnds(null);
$history->setDbInstanceId($item->getDbInstanceId());
foreach ($metadata as $key => $val) {
$meta = new CcPlayoutHistoryMetaData();
$meta->setDbKey($key);
$meta->setDbValue($val);
$history->addCcPlayoutHistoryMetaData($meta);
}
$history->save($this->con);
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
public function insertPlayedItem($schedId)
{
$this->con->beginTransaction();
try {
$item = CcScheduleQuery::create()->findPK($schedId, $this->con);
if (is_null($item)) {
throw new Exception('Invalid schedule id: ' . $schedId);
}
// TODO figure out how to combine these all into 1 query.
$showInstance = $item->getCcShowInstances($this->con);
$show = $showInstance->getCcShow($this->con);
$fileId = $item->getDbFileId();
// don't add webstreams
if (isset($fileId)) {
$metadata = [];
$metadata['showname'] = $show->getDbName();
$instanceEnd = $showInstance->getDbEnds(null);
$itemEnd = $item->getDbEnds(null);
$recordStart = $item->getDbStarts(null);
$recordEnd = ($instanceEnd < $itemEnd) ? $instanceEnd : $itemEnd;
// first check if this is a duplicate
// (caused by restarting liquidsoap)
$prevRecord = CcPlayoutHistoryQuery::create()
->filterByDbStarts($recordStart)
->filterByDbEnds($recordEnd)
->filterByDbFileId($fileId)
->findOne($this->con);
if (empty($prevRecord)) {
$history = new CcPlayoutHistory();
$history->setDbFileId($fileId);
$history->setDbStarts($recordStart);
$history->setDbEnds($recordEnd);
$history->setDbInstanceId($item->getDbInstanceId());
foreach ($metadata as $key => $val) {
$meta = new CcPlayoutHistoryMetaData();
$meta->setDbKey($key);
$meta->setDbValue($val);
$history->addCcPlayoutHistoryMetaData($meta);
}
$history->save($this->con);
$this->con->commit();
}
}
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
// id is an id in cc_playout_history
public function makeHistoryItemForm($id, $populate = false)
{
try {
$form = new Application_Form_EditHistoryItem();
$template = $this->getConfiguredItemTemplate();
$required = $this->mandatoryItemFields();
$form->createFromTemplate($template['fields'], $required);
if ($populate) {
$formValues = [];
$historyRecord = CcPlayoutHistoryQuery::create()->findPk($id, $this->con);
$file = $historyRecord->getCcFiles($this->con);
$instance = $historyRecord->getCcShowInstances($this->con);
if (isset($instance)) {
$show = $instance->getCcShow($this->con);
$selOpts = [];
$instance_id = $instance->getDbId();
$selOpts[$instance_id] = $show->getDbName();
$form->populateShowInstances($selOpts, $instance_id);
}
if (isset($file)) {
$f = Application_Model_StoredFile::createWithFile($file, $this->con);
$filemd = $f->getDbColMetadata();
}
$metadata = [];
$mds = $historyRecord->getCcPlayoutHistoryMetaDatas();
foreach ($mds as $md) {
$metadata[$md->getDbKey()] = $md->getDbValue();
}
$prefix = Application_Form_EditHistoryItem::ID_PREFIX;
$formValues["{$prefix}id"] = $id;
foreach ($template['fields'] as $index => $field) {
$key = $field['name'];
$value = '';
if (in_array($key, $required)) {
$method = 'getDb' . ucfirst($key);
$value = $historyRecord->{$method}();
} elseif (isset($filemd) && $field['isFileMd']) {
$value = $filemd[$key];
} elseif (isset($metadata[$key])) {
$value = $metadata[$key];
}
// need to convert to the station's local time first.
if ($field['type'] == TEMPLATE_DATETIME && !is_null($value)) {
$timezoneUTC = new DateTimeZone('UTC');
$timezoneLocal = new DateTimeZone($this->timezone);
$dateTime = new DateTime($value, $timezoneUTC);
$dateTime->setTimezone($timezoneLocal);
$value = $dateTime->format(DEFAULT_TIMESTAMP_FORMAT);
}
$formValues["{$prefix}{$key}"] = $value;
}
$form->populate($formValues);
}
return $form;
} catch (Exception $e) {
Logging::info($e);
throw $e;
}
}
// id is an id in cc_files
public function makeHistoryFileForm($id)
{
try {
$form = new Application_Form_EditHistoryFile();
$template = $this->getConfiguredFileTemplate();
$required = $this->mandatoryFileFields();
$form->createFromTemplate($template['fields'], $required);
$file = Application_Model_StoredFile::RecallById($id, $this->con);
$md = $file->getDbColMetadata();
$prefix = Application_Form_EditHistoryFile::ID_PREFIX;
$formValues = [];
$formValues["{$prefix}id"] = $id;
foreach ($template['fields'] as $index => $field) {
$key = $field['name'];
if (in_array($key, $required)) {
continue;
}
$value = $md[$key];
$formValues["{$prefix}{$key}"] = $value;
}
$form->populate($formValues);
return $form;
} catch (Exception $e) {
Logging::info($e);
throw $e;
}
}
public function populateTemplateFile($values, $id)
{
$this->con->beginTransaction();
try {
$file = Application_Model_StoredFile::RecallById($id, $this->con);
$prefix = Application_Form_EditHistoryFile::ID_PREFIX;
$prefix_len = strlen($prefix);
$templateValues = $values[$prefix . 'template'];
$md = [];
foreach ($templateValues as $index => $value) {
$key = substr($index, $prefix_len);
$md[$key] = $value;
}
$file->setDbColMetadata($md);
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
public function populateTemplateItem($values, $id = null, $instance_id = null)
{
$this->con->beginTransaction();
try {
$template = $this->getConfiguredItemTemplate();
$prefix = Application_Form_EditHistoryItem::ID_PREFIX;
if (isset($id)) {
$historyRecord = CcPlayoutHistoryQuery::create()->findPk($id, $this->con);
} else {
$historyRecord = new CcPlayoutHistory();
}
if (isset($instance_id)) {
$historyRecord->setDbInstanceId($instance_id);
}
$timezoneUTC = new DateTimeZone('UTC');
$timezoneLocal = new DateTimeZone($this->timezone);
$dateTime = new DateTime($values[$prefix . 'starts'], $timezoneLocal);
$dateTime->setTimezone($timezoneUTC);
$historyRecord->setDbStarts($dateTime->format(DEFAULT_TIMESTAMP_FORMAT));
$dateTime = new DateTime($values[$prefix . 'ends'], $timezoneLocal);
$dateTime->setTimezone($timezoneUTC);
$historyRecord->setDbEnds($dateTime->format(DEFAULT_TIMESTAMP_FORMAT));
$templateValues = $values[$prefix . 'template'];
$file = $historyRecord->getCcFiles();
$md = [];
$metadata = [];
$fields = $template['fields'];
$required = $this->mandatoryItemFields();
$phpCasts = $this->getPhpCasts();
for ($i = 0, $len = count($fields); $i < $len; ++$i) {
$field = $fields[$i];
$key = $field['name'];
// required is delt with before this loop.
if (in_array($key, $required)) {
continue;
}
$isFileMd = $field['isFileMd'];
$entry = $phpCasts[$field['type']]($templateValues[$prefix . $key]);
if ($isFileMd && isset($file)) {
Logging::info("adding metadata associated to a file for {$key} = {$entry}");
$md[$key] = $entry;
} else {
Logging::info("adding metadata for {$key} = {$entry}");
$metadata[$key] = $entry;
}
}
if (count($md) > 0) {
$f = Application_Model_StoredFile::createWithFile($file, $this->con);
$f->setDbColMetadata($md);
}
// Use this array to update existing values.
$mds = $historyRecord->getCcPlayoutHistoryMetaDatas();
foreach ($mds as $md) {
$prevmd[$md->getDbKey()] = $md;
}
foreach ($metadata as $key => $val) {
if (isset($prevmd[$key])) {
$meta = $prevmd[$key];
$meta->setDbValue($val);
} else {
$meta = new CcPlayoutHistoryMetaData();
$meta->setDbKey($key);
$meta->setDbValue($val);
$historyRecord->addCcPlayoutHistoryMetaData($meta);
}
}
$historyRecord->save($this->con);
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
// start,end timestamp strings in local timezone.
public function populateShowInstances($start, $end)
{
$timezoneLocal = new DateTimeZone($this->timezone);
$startDT = new DateTime($start, $timezoneLocal);
$endDT = new DateTime($end, $timezoneLocal);
$shows = $this->getShowList($startDT, $endDT);
$select = [];
foreach ($shows as &$show) {
$select[$show['instance_id']] = $show['name'];
}
return $select;
}
private function validateHistoryItem($instanceId, $form)
{
/*
$userService = new Application_Service_UserService();
$currentUser = $userService->getCurrentUser();
if (!$currentUser->isAdminOrPM()) {
if (empty($instance_id) ) {
}
}
*/
$valid = true;
$recordStartsEl = $form->getElement('his_item_starts');
$recordStarts = $recordStartsEl->getValue();
$recordEndsEl = $form->getElement('his_item_starts');
$recordEnds = $recordEndsEl->getValue();
$timezoneLocal = new DateTimeZone($this->timezone);
$startDT = new DateTime($recordStarts, $timezoneLocal);
$endDT = new DateTime($recordEnds, $timezoneLocal);
if ($recordStarts > $recordEnds) {
$valid = false;
$recordEndsEl->addErrorMessage('End time must be after start time');
}
if (isset($instanceId)) {
$instance = CcShowInstancesQuery::create()->findPk($instanceId, $this->con);
$inStartsDT = $instance->getDbStarts(null);
$inEndsDT = $instance->getDbEnds(null);
if ($startDT < $inStartsDT) {
$valid = false;
$form->addErrorMessage('History item begins before show.');
} elseif ($startDT > $inEndsDT) {
$valid = false;
$form->addErrorMessage('History item begins after show.');
}
}
return $valid;
}
public function createPlayedItem($data)
{
try {
$form = $this->makeHistoryItemForm(null);
$history_id = $form->getElement('his_item_id');
$instanceId = isset($data['instance_id']) ? $data['instance_id'] : null;
$json = [];
if ($form->isValid($data) && $this->validateHistoryItem($instanceId, $form)) {
$history_id->setIgnore(true);
$values = $form->getValues();
$this->populateTemplateItem($values, null, $instanceId);
} else {
$json['form'] = $form;
}
return $json;
} catch (Exception $e) {
throw $e;
}
}
// id is an id in cc_playout_history
public function editPlayedItem($data)
{
try {
$id = $data['his_item_id'];
$instanceId = isset($data['instance_id']) ? $data['instance_id'] : null;
$form = $this->makeHistoryItemForm($id);
$history_id = $form->getElement('his_item_id');
$history_id->setRequired(true);
$json = [];
if ($form->isValid($data) && $this->validateHistoryItem($instanceId, $form)) {
$history_id->setIgnore(true);
$values = $form->getValues();
$this->populateTemplateItem($values, $id, $instanceId);
} else {
$json['form'] = SecurityHelper::htmlescape_recursive($form);
}
return $json;
} catch (Exception $e) {
throw $e;
}
}
// id is an id in cc_files
public function editPlayedFile($data)
{
try {
$id = $data['his_file_id'];
$form = $form = $this->makeHistoryFileForm($id);
$history_id = $form->getElement('his_file_id');
$history_id->setRequired(true);
$json = [];
if ($form->isValid($data)) {
$history_id->setIgnore(true);
$values = $form->getValues();
$this->populateTemplateFile($values, $id);
} else {
$json['error'] = $form->getErrorMessages();
$json['error'] = SecurityHelper::htmlescape_recursive($json['error']);
}
return $json;
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
Logging::info($e);
throw $e;
}
return $json;
}
// id is an id in cc_playout_history
public function deletePlayedItem($id)
{
$this->con->beginTransaction();
try {
$record = CcPlayoutHistoryQuery::create()->findPk($id, $this->con);
$record->delete($this->con);
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
Logging::info($e);
throw $e;
}
}
// id is an id in cc_playout_history
public function deletePlayedItems($ids)
{
$this->con->beginTransaction();
try {
$records = CcPlayoutHistoryQuery::create()->findPks($ids, $this->con);
$records->delete($this->con);
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
Logging::info($e);
throw $e;
}
}
// ---------------- Following code is for History Templates --------------------------//
public function getFieldTypes()
{
return [
// TEMPLATE_DATE,
// TEMPLATE_TIME,
// TEMPLATE_DATETIME,
TEMPLATE_STRING,
TEMPLATE_BOOLEAN,
TEMPLATE_INT,
TEMPLATE_FLOAT,
];
}
private function getPhpCasts()
{
return [
TEMPLATE_DATE => 'strval',
TEMPLATE_TIME => 'strval',
TEMPLATE_DATETIME => 'strval',
TEMPLATE_STRING => 'strval',
TEMPLATE_BOOLEAN => 'intval', // boolval only exists in php 5.5+
TEMPLATE_INT => 'intval',
TEMPLATE_FLOAT => 'floatval',
];
}
private function getSqlTypes()
{
return [
TEMPLATE_DATE => 'date',
TEMPLATE_TIME => 'time',
TEMPLATE_DATETIME => 'datetime',
TEMPLATE_STRING => 'text',
TEMPLATE_BOOLEAN => 'boolean',
TEMPLATE_INT => 'integer',
TEMPLATE_FLOAT => 'float',
];
}
public function getFileMetadataTypes()
{
return [
['name' => MDATA_KEY_TITLE, 'label' => _('Title'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_CREATOR, 'label' => _('Creator'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_SOURCE, 'label' => _('Album'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_DURATION, 'label' => _('Length'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_GENRE, 'label' => _('Genre'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_MOOD, 'label' => _('Mood'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_LABEL, 'label' => _('Label'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_COMPOSER, 'label' => _('Composer'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_ISRC, 'label' => _('ISRC'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_COPYRIGHT, 'label' => _('Copyright'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_YEAR, 'label' => _('Year'), 'type' => TEMPLATE_INT],
['name' => MDATA_KEY_TRACKNUMBER, 'label' => _('Track'), 'type' => TEMPLATE_INT],
['name' => MDATA_KEY_CONDUCTOR, 'label' => _('Conductor'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_LANGUAGE, 'label' => _('Language'), 'type' => TEMPLATE_STRING],
['name' => MDATA_KEY_TRACK_TYPE, 'label' => _('Track Type'), 'type' => TEMPLATE_STRING],
];
}
public function mandatoryItemFields()
{
return ['starts', 'ends'];
}
public function mandatoryFileFields()
{
return ['played'];
}
private function defaultItemTemplate()
{
$template = [];
$fields = [];
$fields[] = ['name' => 'starts', 'label' => _('Start Time'), 'type' => TEMPLATE_DATETIME, 'isFileMd' => false];
$fields[] = ['name' => 'ends', 'label' => _('End Time'), 'type' => TEMPLATE_DATETIME, 'isFileMd' => false];
$fields[] = ['name' => MDATA_KEY_TITLE, 'label' => _('Title'), 'type' => TEMPLATE_STRING, 'isFileMd' => true]; // these fields can be populated from an associated file.
$fields[] = ['name' => MDATA_KEY_CREATOR, 'label' => _('Creator'), 'type' => TEMPLATE_STRING, 'isFileMd' => true];
$template['name'] = 'Log Sheet ' . date(DEFAULT_TIMESTAMP_FORMAT) . ' Template';
$template['fields'] = $fields;
return $template;
}
// Default File Summary Template. Taken from The Czech radio requirements (customer requested this in the past).
private function defaultFileTemplate()
{
$template = [];
$fields = [];
$fields[] = ['name' => MDATA_KEY_TITLE, 'label' => _('Title'), 'type' => TEMPLATE_STRING, 'isFileMd' => true];
$fields[] = ['name' => MDATA_KEY_CREATOR, 'label' => _('Creator'), 'type' => TEMPLATE_STRING, 'isFileMd' => true];
$fields[] = ['name' => 'played', 'label' => _('Played'), 'type' => TEMPLATE_INT, 'isFileMd' => false];
$fields[] = ['name' => MDATA_KEY_DURATION, 'label' => _('Length'), 'type' => TEMPLATE_STRING, 'isFileMd' => true];
$fields[] = ['name' => MDATA_KEY_COMPOSER, 'label' => _('Composer'), 'type' => TEMPLATE_STRING, 'isFileMd' => true];
$fields[] = ['name' => MDATA_KEY_COPYRIGHT, 'label' => _('Copyright'), 'type' => TEMPLATE_STRING, 'isFileMd' => true];
$template['name'] = 'File Summary ' . date(DEFAULT_TIMESTAMP_FORMAT) . ' Template';
$template['fields'] = $fields;
return $template;
}
public function loadTemplate($id)
{
try {
if (!is_numeric($id)) {
throw new Exception("Error: {$id} is not numeric.");
}
$template = CcPlayoutHistoryTemplateQuery::create()->findPk($id, $this->con);
if (empty($template)) {
throw new Exception("Error: Template {$id} does not exist.");
}
$c = new Criteria();
$c->addAscendingOrderByColumn(CcPlayoutHistoryTemplateFieldPeer::POSITION);
$config = $template->getCcPlayoutHistoryTemplateFields($c, $this->con);
$fields = [];
foreach ($config as $item) {
$fields[] = [
'name' => $item->getDbName(),
'label' => $item->getDbLabel(),
'type' => $item->getDbType(),
'isFileMd' => $item->getDbIsFileMD(),
'id' => $item->getDbId(),
];
}
$data = [];
$data['id'] = $template->getDbId();
$data['name'] = $template->getDbName();
$data['fields'] = $fields;
$data['type'] = $template->getDbType();
return $data;
} catch (Exception $e) {
throw $e;
}
}
public function getItemTemplate($id)
{
if (is_numeric($id)) {
Logging::info("template id is: {$id}");
$template = $this->loadTemplate($id);
} else {
Logging::info('Using default template');
$template = $this->defaultItemTemplate();
}
return $template;
}
public function getTemplates($type)
{
$list = [];
try {
$query = CcPlayoutHistoryTemplateQuery::create()
->setFormatter(ModelCriteria::FORMAT_ON_DEMAND);
if (isset($type)) {
$templates = $query->findByDbType($type);
} else {
$templates = $query->find();
}
foreach ($templates as $template) {
$list[$template->getDbId()] = $template->getDbName();
}
return $list;
} catch (Exception $e) {
throw $e;
}
}
public function getListItemTemplates()
{
return $this->getTemplates(self::TEMPLATE_TYPE_ITEM);
}
public function getFileTemplates()
{
return $this->getTemplates(self::TEMPLATE_TYPE_FILE);
}
private function datatablesColumns($fields)
{
$columns = [];
foreach ($fields as $field) {
$label = $field['label'];
$key = $field['name'];
$columns[] = [
'sTitle' => $label,
'mDataProp' => $key,
'sClass' => "his_{$key}",
'sDataType' => $field['type'],
];
}
return $columns;
}
public function getDatatablesLogSheetColumns()
{
// need to prepend a checkbox column.
$checkbox = [
'sTitle' => '',
'mDataProp' => 'checkbox',
'sClass' => 'his_checkbox',
'bSortable' => false,
];
try {
$template = $this->getConfiguredItemTemplate();
$fields = $template['fields'];
$columns = $this->datatablesColumns($fields);
array_unshift($columns, $checkbox);
return $columns;
} catch (Exception $e) {
throw $e;
}
}
public function getDatatablesFileSummaryColumns()
{
try {
$template = $this->getConfiguredFileTemplate();
return $this->datatablesColumns($template['fields']);
} catch (Exception $e) {
throw $e;
}
}
public function getConfiguredItemTemplate()
{
try {
$id = Application_Model_Preference::GetHistoryItemTemplate();
if (is_numeric($id)) {
$template = $this->loadTemplate($id);
} else {
$template = $this->defaultItemTemplate();
}
return $template;
} catch (Exception $e) {
throw $e;
}
}
public function setConfiguredItemTemplate($id)
{
try {
Application_Model_Preference::SetHistoryItemTemplate($id);
} catch (Exception $e) {
throw $e;
}
}
public function getConfiguredFileTemplate()
{
try {
$id = Application_Model_Preference::GetHistoryFileTemplate();
if (is_numeric($id)) {
$template = $this->loadTemplate($id);
} else {
$template = $this->defaultFileTemplate();
}
return $template;
} catch (Exception $e) {
throw $e;
}
}
public function setConfiguredFileTemplate($id)
{
try {
Application_Model_Preference::SetHistoryFileTemplate($id);
} catch (Exception $e) {
throw $e;
}
}
public function setConfiguredTemplate($id)
{
try {
$template = $this->loadTemplate($id);
$type = $template['type'];
$setTemplate = 'setConfigured' . ucfirst($type) . 'Template';
$this->{$setTemplate}($id);
} catch (Exception $e) {
throw $e;
}
}
public function getConfiguredTemplateIds()
{
try {
$id = Application_Model_Preference::GetHistoryItemTemplate();
$id2 = Application_Model_Preference::GetHistoryFileTemplate();
$configured = [];
if (is_numeric($id)) {
$configured[] = $id;
}
if (is_numeric($id2)) {
$configured[] = $id2;
}
return $configured;
} catch (Exception $e) {
throw $e;
}
}
public function createTemplate($config)
{
$this->con->beginTransaction();
try {
$type = $config['type'];
$method = 'default' . ucfirst($type) . 'Template';
$default = $this->{$method}();
$name = isset($config['name']) ? $config['name'] : $default['name'];
$fields = isset($config['fields']) ? $config['fields'] : $default['fields'];
$doSetDefault = isset($config['setDefault']) ? $config['setDefault'] : false;
$template = new CcPlayoutHistoryTemplate();
$template->setDbName($name);
$template->setDbType($type);
foreach ($fields as $index => $field) {
$isMd = ($field['isFileMd'] == 'true') ? true : false;
$templateField = new CcPlayoutHistoryTemplateField();
$templateField->setDbName($field['name']);
$templateField->setDbLabel($field['label']);
$templateField->setDbType($field['type']);
$templateField->setDbIsFileMD($isMd);
$templateField->setDbPosition($index);
$template->addCcPlayoutHistoryTemplateField($templateField);
}
$template->save($this->con);
if ($doSetDefault) {
$this->setConfiguredItemTemplate($template->getDbid());
}
$this->con->commit();
return $template->getDbid();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
public function updateItemTemplate($id, $name, $fields, $doSetDefault = false)
{
$this->con->beginTransaction();
try {
$template = CcPlayoutHistoryTemplateQuery::create()->findPk($id, $this->con);
$template->setDbName($name);
if (count($fields) === 0) {
$t = $this->defaultItemTemplate();
$fields = $t['fields'];
}
$template->getCcPlayoutHistoryTemplateFields()->delete($this->con);
foreach ($fields as $index => $field) {
$isMd = ($field['isFileMd'] == 'true') ? true : false;
$templateField = new CcPlayoutHistoryTemplateField();
$templateField->setDbName($field['name']);
$templateField->setDbType($field['type']);
$templateField->setDbLabel($field['label']);
$templateField->setDbIsFileMD($isMd);
$templateField->setDbPosition($index);
$template->addCcPlayoutHistoryTemplateField($templateField);
}
$template->save($this->con);
if ($doSetDefault) {
$this->setConfiguredItemTemplate($template->getDbid());
}
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
public function deleteTemplate($id)
{
$this->con->beginTransaction();
try {
$template = CcPlayoutHistoryTemplateQuery::create()->findPk($id, $this->con);
$template->delete($this->con);
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
}