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

1891 lines
66 KiB
PHP

<?php
/**
* @copyright 2010 Sourcefabric O.P.S.
* @license https://www.gnu.org/licenses/gpl.txt
*/
class Application_Model_Block implements Application_Model_LibraryEditable
{
/**
* propel connection object.
*/
private $con;
/**
* unique id for the block.
*/
private $id;
private $block;
/**
* info needed to insert a new block element.
*/
private $blockItem = [
'id' => '',
'pos' => '',
'cliplength' => '',
'cuein' => '00:00:00',
'cueout' => '00:00:00',
'fadein' => '0.0',
'fadeout' => '0.0',
'crossfadeDuration' => 0,
];
// using propel's phpNames.
private $categories = [
'dc:title' => 'Name',
'dc:creator' => 'Creator',
'dc:description' => 'Description',
'dcterms:extent' => 'Length',
];
private static $modifier2CriteriaMap = [
CriteriaModifier::CONTAINS => Criteria::ILIKE,
CriteriaModifier::DOES_NOT_CONTAIN => Criteria::NOT_ILIKE,
CriteriaModifier::IS => Criteria::EQUAL,
CriteriaModifier::IS_NOT => Criteria::NOT_EQUAL,
CriteriaModifier::STARTS_WITH => Criteria::ILIKE,
CriteriaModifier::ENDS_WITH => Criteria::ILIKE,
CriteriaModifier::IS_GREATER_THAN => Criteria::GREATER_THAN,
CriteriaModifier::IS_LESS_THAN => Criteria::LESS_THAN,
CriteriaModifier::IS_IN_THE_RANGE => Criteria::CUSTOM,
CriteriaModifier::BEFORE => Criteria::CUSTOM,
CriteriaModifier::AFTER => Criteria::CUSTOM,
CriteriaModifier::BETWEEN => Criteria::CUSTOM,
];
public function __construct($id = null, $con = null)
{
if (isset($id)) {
$this->block = CcBlockQuery::create()->findPk($id);
if (is_null($this->block)) {
throw new BlockNotFoundException();
}
} else {
$this->block = new CcBlock();
$this->block->setDbUTime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save();
}
$this->blockItem['fadein'] = Application_Model_Preference::GetDefaultFadeIn();
$this->blockItem['fadeout'] = Application_Model_Preference::GetDefaultFadeOut();
$this->blockItem['crossfadeDuration'] = Application_Model_Preference::GetDefaultCrossfadeDuration();
$this->con = isset($con) ? $con : Propel::getConnection(CcBlockPeer::DATABASE_NAME);
$this->id = $this->block->getDbId();
}
/**
* Return local ID of virtual file.
*
* @return int
*/
public function getId()
{
return $this->id;
}
/**
* Rename stored virtual block.
*
* @param string $p_newname
*/
public function setName($p_newname)
{
$this->block->setDbName($p_newname);
$this->block->setDbMtime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save($this->con);
}
/**
* Get mnemonic block name.
*
* @return string
*/
public function getName()
{
return $this->block->getDbName();
}
public function setDescription($p_description)
{
$this->block->setDbDescription($p_description);
$this->block->setDbMtime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save($this->con);
}
public function getDescription()
{
return $this->block->getDbDescription();
}
public function getCreator()
{
return $this->block->getCcSubjs()->getDbLogin();
}
public function getCreatorId()
{
return $this->block->getCcSubjs()->getDbId();
}
public function setCreator($p_id)
{
$this->block->setDbCreatorId($p_id);
$this->block->setDbMtime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save($this->con);
}
public function getLastModified($format = null)
{
return $this->block->getDbMtime($format);
}
public function getSize()
{
return $this->block->countCcBlockcontentss();
}
/**
* Get the entire block as a two dimensional array, sorted in order of play.
*
* @param bool $filterFiles if this is true, it will only return files that has
* file_exists flag set to true
*
* @return array
*/
public function getContents($filterFiles = false)
{
$sql = <<<'SQL'
SELECT pc.id AS id,
pc.position,
pc.cliplength AS LENGTH,
pc.cuein,
pc.cueout,
pc.fadein,
pc.fadeout,
pc.trackoffset,
bl.type,
f.LENGTH AS orig_length,
f.id AS item_id,
f.track_title,
f.artist_name AS creator,
f.file_exists AS EXISTS,
f.filepath AS path,
f.mime as mime
FROM cc_blockcontents AS pc
LEFT JOIN cc_files AS f ON pc.file_id=f.id
LEFT JOIN cc_block AS bl ON pc.block_id = bl.id
WHERE pc.block_id = :block_id
SQL;
if ($filterFiles) {
$sql .= <<<'SQL'
AND f.file_exists = :file_exists
SQL;
}
$sql .= <<<'SQL'
ORDER BY pc.position
SQL;
$params = [':block_id' => $this->id];
if ($filterFiles) {
$params[':file_exists'] = $filterFiles;
}
$rows = Application_Common_Database::prepareAndExecute($sql, $params);
$offset = 0;
foreach ($rows as &$row) {
$clipSec = Application_Common_DateHelper::playlistTimeToSeconds($row['length']);
$row['trackSec'] = $clipSec;
$row['cueInSec'] = Application_Common_DateHelper::playlistTimeToSeconds($row['cuein']);
$row['cueOutSec'] = Application_Common_DateHelper::playlistTimeToSeconds($row['cueout']);
$trackoffset = $row['trackoffset'];
$offset += $clipSec;
$offset -= $trackoffset;
$offset_cliplength = Application_Common_DateHelper::secondsToPlaylistTime($offset);
// format the length for UI.
$formatter = new LengthFormatter($row['length']);
$row['length'] = $formatter->format();
$formatter = new LengthFormatter($offset_cliplength);
$row['offset'] = $formatter->format();
// format the fades in format 00(.0)
$fades = $this->getFadeInfo($row['position']);
$row['fadein'] = $fades[0];
$row['fadeout'] = $fades[1];
// format the cues in format 00:00:00(.0)
// we need to add the '.0' for cues and not fades
// because propel takes care of this for us
// (we use propel to fetch the fades)
$row['cuein'] = str_pad(substr($row['cuein'], 0, 10), 10, '.0');
$row['cueout'] = str_pad(substr($row['cueout'], 0, 10), 10, '.0');
// format original length
$formatter = new LengthFormatter($row['orig_length']);
$row['orig_length'] = $formatter->format();
// XSS exploit prevention
$row['track_title'] = htmlspecialchars($row['track_title'] ?? '');
$row['creator'] = htmlspecialchars($row['creator'] ?? '');
}
return $rows;
}
/**
* The database stores fades in 00:00:00 Time format with optional millisecond resolution .000000
* but this isn't practical since fades shouldn't be very long usually 1 second or less. This function
* will normalize the fade so that it looks like 00.000000 to the user.
*
* @param mixed $fade
*/
public function normalizeFade($fade)
{
// First get rid of the first six characters 00:00: which will be added back later for db update
$fade = substr($fade, 6);
// Second add .000000 if the fade does't have milliseconds format already
$dbFadeStrPos = strpos($fade, '.');
if ($dbFadeStrPos === false) {
$fade .= '.000000';
} else {
while (strlen($fade) < 9) {
$fade .= '0';
}
}
// done, just need to set back the formated values
return $fade;
}
public function getUnformatedLength()
{
$this->block->reload();
if ($this->isStatic()) {
$length = $this->block->getDbLength();
} else {
$length = $this->getDynamicBlockLength();
}
return $length;
}
public function getLength()
{
$this->block->reload();
$prepend = '';
if ($this->isStatic()) {
$length = $this->block->getDbLength();
} else {
$length = $this->getDynamicBlockLength();
if (!$this->hasItemLimit()) {
$prepend = '~';
}
}
$formatter = new LengthFormatter($length);
return $prepend . $formatter->format();
}
public function getDynamicBlockLength()
{
[$value, $modifier] = $this->getLimitValueAndModifier();
if ($modifier == 'items') {
$length = $value . ' ' . _('items');
} else {
$hour = '00';
$mins = '00';
if ($modifier == 'minutes') {
$mins = $value;
if ($value > 59) {
$hour = intval($value / 60);
$mins = $value % 60;
}
} elseif ($modifier == 'hours') {
$mins = $value * 60;
if ($mins > 59) {
$hour = intval($mins / 60);
$hour = str_pad($hour, 2, '0', STR_PAD_LEFT);
$mins %= 60;
}
}
$hour = str_pad($hour, 2, '0', STR_PAD_LEFT);
$mins = str_pad($mins, 2, '0', STR_PAD_LEFT);
$length = $hour . ':' . $mins . ':00';
}
return $length;
}
public function getLimitValueAndModifier()
{
$result = CcBlockcriteriaQuery::create()->filterByDbBlockId($this->id)
->filterByDbCriteria('limit')->findOne();
if ($result) {
$modifier = $result->getDbModifier();
$value = $result->getDbValue();
return [$value, $modifier];
}
}
// this function returns sum of all track length under this block.
public function getStaticLength()
{
$sql = <<<'SQL'
SELECT SUM(cliplength) AS LENGTH
FROM cc_blockcontents as bc
JOIN cc_files as f ON bc.file_id = f.id
WHERE block_id = :block_id
AND f.file_exists = true
SQL;
$result = Application_Common_Database::prepareAndExecute($sql, [':block_id' => $this->id], 'all', PDO::FETCH_NUM);
return $result[0][0];
}
private function insertBlockElement($info)
{
$row = new CcBlockcontents();
$row->setDbBlockId($this->id);
$row->setDbFileId($info['id']);
$row->setDbPosition($info['pos']);
$row->setDbCliplength($info['cliplength']);
$row->setDbCuein($info['cuein']);
$row->setDbCueout($info['cueout']);
$row->setDbFadein(Application_Common_DateHelper::secondsToPlaylistTime($info['fadein']));
$row->setDbFadeout(Application_Common_DateHelper::secondsToPlaylistTime($info['fadeout']));
$row->setDbTrackOffset($info['crossfadeDuration']);
$row->save($this->con);
// above save result update on cc_block table on length column.
// but $this->block doesn't get updated automatically
// so we need to manually grab it again from DB so it has updated values
// It is something to do FORMAT_ON_DEMAND( Lazy Loading )
$this->block = CcBlockQuery::create()->findPK($this->id);
}
private function buildEntry($p_item, $pos)
{
$file = CcFilesQuery::create()->findPK($p_item, $this->con);
if (isset($file) && $file->visible()) {
$entry = $this->blockItem;
$entry['id'] = $file->getDbId();
$entry['pos'] = $pos;
$entry['cueout'] = $file->getDbCueout();
$entry['cuein'] = $file->getDbCuein();
$cue_out = Application_Common_DateHelper::calculateLengthInSeconds($entry['cueout']);
$cue_in = Application_Common_DateHelper::calculateLengthInSeconds($entry['cuein']);
$entry['cliplength'] = Application_Common_DateHelper::secondsToPlaylistTime($cue_out - $cue_in);
return $entry;
}
throw new Exception('trying to add a file that does not exist.');
}
public function isStatic()
{
return $this->block->getDbType() == 'static';
}
/*
* @param array $p_items
* an array of audioclips to add to the block
* @param int|null $p_afterItem
* item which to add the new items after in the block, null if added to the end.
* @param string (before|after) $addAfter
* whether to add the clips before or after the selected item.
*/
public function addAudioClips($p_items, $p_afterItem = null, $addType = 'after')
{
$this->con->beginTransaction();
$contentsToUpdate = [];
try {
if (is_numeric($p_afterItem)) {
Logging::info("Finding block content item {$p_afterItem}");
$afterItem = CcBlockcontentsQuery::create()->findPK($p_afterItem);
$index = $afterItem->getDbPosition();
Logging::info("index is {$index}");
$pos = ($addType == 'after') ? $index + 1 : $index;
$contentsToUpdate = CcBlockcontentsQuery::create()
->filterByDbBlockId($this->id)
->filterByDbPosition($pos, Criteria::GREATER_EQUAL)
->orderByDbPosition()
->find($this->con);
Logging::info('Adding to block');
Logging::info("at position {$pos}");
} else {
// add to the end of the block
if ($addType == 'after') {
$pos = $this->getSize();
}
// add to the beginning of the block.
else {
$pos = 0;
$contentsToUpdate = CcBlockcontentsQuery::create()
->filterByDbBlockId($this->id)
->orderByDbPosition()
->find($this->con);
}
$contentsToUpdate = CcBlockcontentsQuery::create()
->filterByDbBlockId($this->id)
->filterByDbPosition($pos, Criteria::GREATER_EQUAL)
->orderByDbPosition()
->find($this->con);
Logging::info('Adding to block');
Logging::info("at position {$pos}");
}
foreach ($p_items as $ac) {
// Logging::info("Adding audio file {$ac[0]}");
try {
if (is_array($ac) && $ac[1] == 'audioclip') {
$res = $this->insertBlockElement($this->buildEntry($ac[0], $pos));
// update is_playlist flag in cc_files to indicate the
// file belongs to a playlist or block (in this case a block)
$db_file = CcFilesQuery::create()->findPk($ac[0], $this->con);
$db_file->setDbIsPlaylist(true)->save($this->con);
++$pos;
} elseif (!is_array($ac)) {
$res = $this->insertBlockElement($this->buildEntry($ac, $pos));
++$pos;
$db_file = CcFilesQuery::create()->findPk($ac, $this->con);
$db_file->setDbIsPlaylist(true)->save($this->con);
}
} catch (Exception $e) {
Logging::info($e->getMessage());
}
}
// reset the positions of the remaining items.
for ($i = 0; $i < count($contentsToUpdate); ++$i) {
$contentsToUpdate[$i]->setDbPosition($pos);
$contentsToUpdate[$i]->save($this->con);
++$pos;
}
$this->block->setDbMtime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save($this->con);
$this->con->commit();
$this->updateBlockLengthInAllPlaylist();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
/**
* Move audioClip to the new position in the block.
*
* @param array $p_items
* array of unique ids of the selected items
* @param int $p_afterItem
* unique id of the item to move the clip after
*/
public function moveAudioClips($p_items, $p_afterItem = null)
{
$this->con->beginTransaction();
try {
$contentsToMove = CcBlockcontentsQuery::create()
->filterByDbId($p_items, Criteria::IN)
->orderByDbPosition()
->find($this->con);
$otherContent = CcBlockcontentsQuery::create()
->filterByDbId($p_items, Criteria::NOT_IN)
->filterByDbBlockId($this->id)
->orderByDbPosition()
->find($this->con);
$pos = 0;
// moving items to beginning of the block.
if (is_null($p_afterItem)) {
Logging::info('moving items to beginning of block');
foreach ($contentsToMove as $item) {
Logging::info("item {$item->getDbId()} to pos {$pos}");
$item->setDbPosition($pos);
$item->save($this->con);
++$pos;
}
foreach ($otherContent as $item) {
Logging::info("item {$item->getDbId()} to pos {$pos}");
$item->setDbPosition($pos);
$item->save($this->con);
++$pos;
}
} else {
Logging::info("moving items after {$p_afterItem}");
foreach ($otherContent as $item) {
Logging::info("item {$item->getDbId()} to pos {$pos}");
$item->setDbPosition($pos);
$item->save($this->con);
++$pos;
if ($item->getDbId() == $p_afterItem) {
foreach ($contentsToMove as $move) {
Logging::info("item {$move->getDbId()} to pos {$pos}");
$move->setDbPosition($pos);
$move->save($this->con);
++$pos;
}
}
}
}
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
$this->block = CcBlockQuery::create()->findPK($this->id);
$this->block->setDbMtime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save($this->con);
}
/**
* Remove audioClip from block.
*
* @param array $p_items
* array of unique item ids to remove from the block..
*/
public function delAudioClips($p_items)
{
$this->con->beginTransaction();
try {
// we need to get the file id of the item we are deleting
// before the item gets deleted from the block
$itemsToDelete = CcBlockcontentsQuery::create()
->filterByPrimaryKeys($p_items)
->filterByDbFileId(null, Criteria::NOT_EQUAL)
->find($this->con);
CcBlockcontentsQuery::create()
->findPKs($p_items)
->delete($this->con);
// now that the items have been deleted we can update the
// is_playlist flag in cc_files
Application_Model_StoredFile::setIsPlaylist($itemsToDelete, 'block', false);
$contents = CcBlockcontentsQuery::create()
->filterByDbBlockId($this->id)
->orderByDbPosition()
->find($this->con);
// reset the positions of the remaining items.
for ($i = 0; $i < count($contents); ++$i) {
$contents[$i]->setDbPosition($i);
$contents[$i]->save($this->con);
}
$this->block->setDbMtime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save($this->con);
$this->con->commit();
$this->updateBlockLengthInAllPlaylist();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
public function getFadeInfo($pos)
{
// Logging::info("Getting fade info for pos {$pos}");
$row = CcBlockcontentsQuery::create()
->joinWith(CcFilesPeer::OM_CLASS)
->filterByDbBlockId($this->id)
->filterByDbPosition($pos)
->findOne();
// Propel returns values in form 00.000000 format which is for only seconds.
// We only want to display 1 decimal
$fadeIn = substr($row->getDbFadein(), 0, 4);
$fadeOut = substr($row->getDbFadeout(), 0, 4);
return [$fadeIn, $fadeOut];
}
/*
* create a crossfade from item in cc_playlist_contents with $id1 to item $id2.
*
* $fadeOut length of fade out in seconds if $id1
* $fadeIn length of fade in in seconds of $id2
* $offset time in seconds from end of $id1 that $id2 will begin to play.
*/
public function createCrossfade($id1, $fadeOut, $id2, $fadeIn, $offset)
{
$this->con->beginTransaction();
if (!isset($offset)) {
$offset = Application_Model_Preference::GetDefaultCrossfadeDuration();
}
try {
if (isset($id1)) {
$this->changeFadeInfo($id1, null, $fadeOut);
}
if (isset($id2)) {
$this->changeFadeInfo($id2, $fadeIn, null, $offset);
}
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
}
/**
* Change fadeIn and fadeOut values for block Element.
*
* @param string $fadeIn
* new value in ss.ssssss or extent format
* @param string $fadeOut
* new value in ss.ssssss or extent format
* @param mixed $id
* @param null|mixed $offset
*
* @return bool
*/
public function changeFadeInfo($id, $fadeIn, $fadeOut, $offset = null)
{
// See issue CC-2065, pad the fadeIn and fadeOut so that it is TIME compatable with the DB schema
// For the top level PlayList either fadeIn or fadeOut will sometimes be Null so need a gaurd against
// setting it to nonNull for checks down below
$fadeIn = $fadeIn ? '00:00:' . $fadeIn : $fadeIn;
$fadeOut = $fadeOut ? '00:00:' . $fadeOut : $fadeOut;
$this->con->beginTransaction();
try {
$row = CcBlockcontentsQuery::create()->findPK($id);
if (is_null($row)) {
throw new Exception('Block item does not exist.');
}
$clipLength = $row->getDbCliplength();
if (!is_null($fadeIn)) {
$sql = 'SELECT :fade_in::INTERVAL > :clip_length::INTERVAL';
$params = [
':fade_in' => $fadeIn,
':clip_length' => $clipLength,
];
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
if ($result) {
// "Fade In can't be larger than overall playlength.";
$fadeIn = $clipLength;
}
$row->setDbFadein($fadeIn);
if (!is_null($offset)) {
$row->setDbTrackOffset($offset);
Logging::info("Setting offset {$offset} on item {$id}");
$row->save($this->con);
}
}
if (!is_null($fadeOut)) {
$sql = 'SELECT :fade_out::INTERVAL > :clip_length::INTERVAL';
$params = [
':fade_out' => $fadeOut,
':clip_length' => $clipLength,
];
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
if ($result) {
// "Fade Out can't be larger than overall playlength.";
$fadeOut = $clipLength;
}
$row->setDbFadeout($fadeOut);
}
$row->save($this->con);
$this->block->setDbMtime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save($this->con);
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
return ['fadeIn' => $fadeIn, 'fadeOut' => $fadeOut];
}
public function setfades($fadein, $fadeout)
{
if (isset($fadein)) {
Logging::info("Setting block fade in {$fadein}");
$row = CcBlockcontentsQuery::create()
->filterByDbBlockId($this->id)
->filterByDbPosition(0)
->findOne($this->con);
$this->changeFadeInfo($row->getDbId(), $fadein, null);
}
if (isset($fadeout)) {
Logging::info("Setting block fade out {$fadeout}");
$row = CcBlockcontentsQuery::create()
->filterByDbBlockId($this->id)
->filterByDbPosition($this->getSize() - 1)
->findOne($this->con);
$this->changeFadeInfo($row->getDbId(), null, $fadeout);
}
}
/**
* Change cueIn/cueOut values for block element.
*
* @param string $cueIn
* new value in ss.ssssss or extent format
* @param string $cueOut
* new value in ss.ssssss or extent format
* @param mixed $id
*
* @return bool or pear error object
*/
public function changeClipLength($id, $cueIn, $cueOut)
{
$this->con->beginTransaction();
$errArray = [];
try {
if (is_null($cueIn) && is_null($cueOut)) {
$errArray['error'] = _('Cue in and cue out are null.');
return $errArray;
}
$row = CcBlockcontentsQuery::create()
->joinWith(CcFilesPeer::OM_CLASS)
->filterByPrimaryKey($id)
->findOne($this->con);
if (is_null($row)) {
throw new Exception('Block item does not exist.');
}
$oldCueIn = $row->getDBCuein();
$oldCueOut = $row->getDbCueout();
$fadeIn = $row->getDbFadein();
$fadeOut = $row->getDbFadeout();
$file = $row->getCcFiles($this->con);
$origLength = $file->getDbLength();
if (!is_null($cueIn) && !is_null($cueOut)) {
if ($cueOut === '') {
$cueOut = $origLength;
}
$sql = 'SELECT :cue_out::INTERVAL > :orig_length::INTERVAL';
$params = [
':cue_out' => $cueOut,
':orig_length' => $origLength,
];
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
if ($result) {
$errArray['error'] = _("Can't set cue out to be greater than file length.");
return $errArray;
}
$sql = 'SELECT :cue_in::INTERVAL > :cue_out::INTERVAL';
$params = [
':cue_in' => $cueIn,
':cue_out' => $cueOut,
];
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
if ($result) {
$errArray['error'] = _("Can't set cue in to be larger than cue out.");
return $errArray;
}
$sql = 'SELECT :cue_out::INTERVAL - :cue_in::INTERVAL';
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
$cliplength = $result;
$row->setDbCuein($cueIn);
$row->setDbCueout($cueOut);
$row->setDBCliplength($cliplength);
} elseif (!is_null($cueIn)) {
$sql = 'SELECT :cue_in::INTERVAL > :old_cue_out::INTERVAL';
$params = [
':cue_in' => $cueIn,
':old_cue_out' => $oldCueOut,
];
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
if ($result) {
$errArray['error'] = _("Can't set cue in to be larger than cue out.");
return $errArray;
}
$sql = 'SELECT :old_cue_out::INTERVAL - :cue_in::INTERVAL';
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
$cliplength = $result;
$row->setDbCuein($cueIn);
$row->setDBCliplength($cliplength);
} elseif (!is_null($cueOut)) {
if ($cueOut === '') {
$cueOut = $origLength;
}
$sql = 'SELECT :cue_out::INTERVAL > :orig_length::INTERVAL';
$params = [
':cue_out' => $cueOut,
':orig_length' => $origLength,
];
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
if ($result) {
$errArray['error'] = _("Can't set cue out to be greater than file length.");
return $errArray;
}
$sql = 'SELECT :cue_out::INTERVAL < :old_cue_in::INTERVAL';
$params = [
':cue_out' => $cueOut,
':old_cue_in' => $oldCueIn,
];
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
if ($result) {
$errArray['error'] = _("Can't set cue out to be smaller than cue in.");
return $errArray;
}
$sql = 'SELECT :cue_out::INTERVAL - :old_cue_in::INTERVAL';
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
$cliplength = $result;
$row->setDbCueout($cueOut);
$row->setDBCliplength($cliplength);
}
$cliplength = $row->getDbCliplength();
$sql = 'SELECT :fade_in::INTERVAL > :clip_length::INTERVAL';
$params = [
':fade_in' => $fadeIn,
':clip_length' => $cliplength,
];
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
if ($result) {
$fadeIn = $cliplength;
$row->setDbFadein($fadeIn);
}
$sql = 'SELECT :fade_out::INTERVAL > :clip_length::INTERVAL';
$params = [
':fade_out' => $fadeOut,
':clip_length' => $cliplength,
];
$result = Application_Common_Database::prepareAndExecute($sql, $params, 'column');
if ($result) {
$fadeOut = $cliplength;
$row->setDbFadein($fadeOut);
}
$row->save($this->con);
$this->block->setDbMtime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save($this->con);
$this->con->commit();
} catch (Exception $e) {
$this->con->rollback();
throw $e;
}
return [
'cliplength' => $cliplength, 'cueIn' => $cueIn, 'cueOut' => $cueOut, 'length' => $this->getUnformatedLength(),
'fadeIn' => $fadeIn, 'fadeOut' => $fadeOut,
];
}
public function getAllPLMetaData()
{
$categories = $this->categories;
$md = [];
foreach ($categories as $key => $val) {
$method = 'get' . $val;
$md[$key] = $this->{$method}();
}
return $md;
}
public function getMetaData($category)
{
$cat = $this->categories[$category];
$method = 'get' . $cat;
return $this->{$method}();
}
public function setMetadata($category, $value)
{
$cat = $this->categories[$category];
$method = 'set' . $cat;
$this->{$method}($value);
}
public static function getBlockCount()
{
$sql = 'SELECT count(*) as cnt FROM cc_playlist';
return Application_Common_Database::prepareAndExecute(
$sql,
[],
Application_Common_Database::COLUMN
);
}
/**
* Delete the file from all blocks.
*
* @param string $p_fileId
*/
public static function DeleteFileFromAllBlocks($p_fileId)
{
CcBlockcontentsQuery::create()->filterByDbFileId($p_fileId)->delete();
}
/**
* Delete blocks that match the ids..
*
* @param array $p_ids
* @param mixed $p_userId
*/
public static function deleteBlocks($p_ids, $p_userId)
{
$userInfo = Zend_Auth::getInstance()->getStorage()->read();
$user = new Application_Model_User($userInfo->id);
$isAdminOrPM = $user->isUserType([UTYPE_SUPERADMIN, UTYPE_ADMIN, UTYPE_PROGRAM_MANAGER]);
// get only the files from the blocks
// we are about to delete
$itemsToDelete = CcBlockcontentsQuery::create()
->filterByDbBlockId($p_ids)
->filterByDbFileId(null, Criteria::NOT_EQUAL)
->find();
$updateIsPlaylistFlag = false;
if (!$isAdminOrPM) {
$leftOver = self::blocksNotOwnedByUser($p_ids, $p_userId);
if (count($leftOver) == 0) {
CcBlockQuery::create()->findPKs($p_ids)->delete();
$updateIsPlaylistFlag = true;
} else {
throw new BlockNoPermissionException();
}
} else {
CcBlockQuery::create()->findPKs($p_ids)->delete();
$updateIsPlaylistFlag = true;
}
if ($updateIsPlaylistFlag) {
// update is_playlist flag in cc_files
Application_Model_StoredFile::setIsPlaylist(
$itemsToDelete,
'block',
false
);
}
}
// This function returns that are not owen by $p_user_id among $p_ids
private static function blocksNotOwnedByUser($p_ids, $p_userId)
{
$ownedByUser = CcBlockQuery::create()->filterByDbCreatorId($p_userId)->find()->getData();
$selectedPls = $p_ids;
$ownedPls = [];
foreach ($ownedByUser as $pl) {
if (in_array($pl->getDbId(), $selectedPls)) {
$ownedPls[] = $pl->getDbId();
}
}
return array_diff($selectedPls, $ownedPls);
}
/**
* Delete all files from block.
*/
public function deleteAllFilesFromBlock()
{
// get only the files from the playlist
// we are about to clear out
$itemsToDelete = CcBlockcontentsQuery::create()
->filterByDbBlockId($this->id)
->filterByDbFileId(null, Criteria::NOT_EQUAL)
->find();
CcBlockcontentsQuery::create()->findByDbBlockId($this->id)->delete();
// update is_playlist flag in cc_files
Application_Model_StoredFile::setIsPlaylist(
$itemsToDelete,
'block',
false
);
// $this->block->reload();
$this->block->setDbMtime(new DateTime('now', new DateTimeZone('UTC')));
$this->block->save($this->con);
$this->con->commit();
}
// smart block functions start
public function shuffleSmartBlock()
{
// if it here that means it's static pl
$this->saveType('static');
$contents = CcBlockcontentsQuery::create()
->filterByDbBlockId($this->id)
->orderByDbPosition()
->find();
$shuffledPos = range(0, count($contents) - 1);
shuffle($shuffledPos);
foreach ($contents as $item) {
$item->setDbPosition(array_shift($shuffledPos));
$item->save();
}
return ['result' => 0];
}
public function saveType($p_blockType)
{
// saving dynamic/static flag
CcBlockQuery::create()->findPk($this->id)->setDbType($p_blockType)->save();
}
public function setLength($value)
{
$this->block->setDbLength($value);
$this->block->save($this->con);
$this->updateBlockLengthInAllPlaylist();
}
/**
* Saves smart block criteria.
*
* @param array $p_criteria
*/
public function saveSmartBlockCriteria($p_criteria)
{
$data = $this->organizeSmartPlaylistCriteria($p_criteria);
// saving dynamic/static flag
$blockType = $data['etc']['sp_type'] == 0 ? 'dynamic' : 'static';
$this->saveType($blockType);
$this->storeCriteriaIntoDb($data);
// if the block is dynamic, put null to the length
// as it cannot be calculated
if ($blockType == 'dynamic') {
if ($this->hasItemLimit()) {
$this->setLength(null);
} else {
$this->setLength($this->getDynamicBlockLength());
}
} else {
$length = $this->getStaticLength();
if (!$length) {
$length = '00:00:00';
}
$this->setLength($length);
}
$this->updateBlockLengthInAllPlaylist();
}
public function hasItemLimit()
{
[$value, $modifier] = $this->getLimitValueAndModifier();
return $modifier == 'items';
}
public function storeCriteriaIntoDb($p_criteriaData)
{
// delete criteria under $p_blockId
CcBlockcriteriaQuery::create()->findByDbBlockId($this->id)->delete();
// Logging::info($p_criteriaData);
// insert modifier rows
if (isset($p_criteriaData['criteria'])) {
$critKeys = array_keys($p_criteriaData['criteria']);
for ($i = 0; $i < count($critKeys); ++$i) {
// in order to maintain separation of different criteria to preserve AND statements for criteria
// that might contradict itself we group them based upon their original position on the form
$criteriaGroup = $i;
foreach ($p_criteriaData['criteria'][$critKeys[$i]] as $d) {
$field = $d['sp_criteria_field'];
$value = $d['sp_criteria_value'];
$modifier = $d['sp_criteria_modifier'];
if (isset($d['sp_criteria_extra'])) {
$extra = $d['sp_criteria_extra'];
}
if (isset($d['sp_criteria_datetime_select'])) {
$datetimeunit = $d['sp_criteria_datetime_select'];
}
if (isset($d['sp_criteria_extra_datetime_select'])) {
$extradatetimeunit = $d['sp_criteria_extra_datetime_select'];
}
if ($field == 'utime' || $field == 'mtime' || $field == 'lptime') {
// if the date isn't relative we want to convert the value to a specific UTC date
if (!in_array($modifier, ['before', 'after', 'between'])) {
$value = Application_Common_DateHelper::UserTimezoneStringToUTCString($value);
} else {
$value = $value . ' ' . $datetimeunit . ' ago';
// Logging::info($value);
}
}
$qry = new CcBlockcriteria();
$qry->setDbCriteria($field)
->setDbModifier($d['sp_criteria_modifier'])
->setDbValue($value)
->setDbBlockId($this->id);
if (isset($d['sp_criteria_extra'])) {
if ($field == 'utime' || $field == 'mtime' || $field == 'lptime') {
// if the date isn't relative we want to convert the value to a specific UTC date
if (!in_array($modifier, ['before', 'after', 'between'])) {
$extra = Application_Common_DateHelper::UserTimezoneStringToUTCString($extra);
} else {
$extra = $extra . ' ' . $extradatetimeunit . ' ago';
}
}
$qry->setDbExtra($extra);
}
// save the criteria group so separation via new modifiers AND can be preserved vs. lumping
// them all into a single or later on
if (isset($criteriaGroup)) {
$qry->setDbCriteriaGroup($criteriaGroup);
}
$qry->save();
}
}
}
// insert sort info
$qry = new CcBlockcriteria();
$qry->setDbCriteria('sort')
->setDbModifier('N/A')
->setDbValue($p_criteriaData['etc']['sp_sort_options'])
->setDbBlockId($this->id)
->save();
// insert limit info
$qry = new CcBlockcriteria();
$qry->setDbCriteria('limit')
->setDbModifier($p_criteriaData['etc']['sp_limit_options'])
->setDbValue($p_criteriaData['etc']['sp_limit_value'])
->setDbBlockId($this->id)
->save();
// insert repeat track option
$qry = new CcBlockcriteria();
$qry->setDbCriteria('repeat_tracks')
->setDbModifier('N/A')
->setDbValue($p_criteriaData['etc']['sp_repeat_tracks'])
->setDbBlockId($this->id)
->save();
// insert overflow track option
$qry = new CcBlockcriteria();
$qry->setDbCriteria('overflow_tracks')
->setDbModifier('N/A')
->setDbValue($p_criteriaData['etc']['sp_overflow_tracks'])
->setDbBlockId($this->id)
->save();
}
/**
* generate list of tracks. This function saves criteria and generate
* tracks.
*
* @param array $p_criteria
* @param mixed $returnList
*/
public function generateSmartBlock($p_criteria, $returnList = false)
{
$this->saveSmartBlockCriteria($p_criteria);
$insertList = $this->getListOfFilesUnderLimit();
$this->deleteAllFilesFromBlock();
// construct id array
$ids = [];
foreach ($insertList as $ele) {
$ids[] = $ele['id'];
}
$this->addAudioClips(array_values($ids));
// update length in playlist contents.
$this->updateBlockLengthInAllPlaylist();
return ['result' => 0];
}
public function updateBlockLengthInAllPlaylist()
{
$blocks = CcPlaylistcontentsQuery::create()->filterByDbBlockId($this->id)->find();
$blocks->getFirst();
$iterator = $blocks->getIterator();
while ($iterator->valid()) {
$length = $this->getUnformatedLength();
if (!preg_match('/^[0-9]{2}:[0-9]{2}:[0-9]{2}/', $length)) {
$iterator->current()->setDbClipLength(null);
} else {
$iterator->current()->setDbClipLength($length);
}
$iterator->current()->save();
$iterator->next();
}
}
public function getListOfFilesUnderLimit($show = null, $showStartTime = null)
{
$info = $this->getListofFilesMeetCriteria($show, $showStartTime);
$files = $info['files'];
$limit = $info['limit'];
$repeat = $info['repeat_tracks'] == 1;
$overflow = $info['overflow_tracks'] == 1;
$isRandomSort = $info['sort_type'] == 'random';
$blockTime = $limit['time'];
$blockItems = $limit['items'];
if ($files->isEmpty()) {
return [];
}
// this moves the pointer to the first element in the collection
$files->getFirst();
$iterator = $files->getIterator();
/**
* @var Track[] $tracks
*/
$tracks = [];
$maxItems = 500;
while ($iterator->valid() && count($tracks) < $maxItems) {
$id = $iterator->current()->getDbId();
$fileLength = $iterator->current()->getCueLength();
$length = Application_Common_DateHelper::calculateLengthInSeconds($fileLength);
$tracks[] = new Track($id, $length);
$iterator->next();
}
/**
* @var Track[] $insertList
*/
$insertList = [];
$totalTime = 0;
if ($isRandomSort && !$overflow && $blockItems === null) {
$minTrackLength = min(array_map(fn (Track $item) => $item->length, $tracks));
do {
$solution = SSPSolution::solve($tracks, $blockTime - $totalTime);
$insertList = array_merge($insertList, $solution->tracks);
$totalTime += $solution->sum;
} while ($repeat && ($blockTime - $totalTime) > $minTrackLength);
shuffle($insertList);
} else {
$isFull = function () use (&$blockItems, &$insertList, &$totalTime, &$blockTime) {
return $blockItems !== null && count($insertList) >= $blockItems || $totalTime > $blockTime;
};
$addTrack = function (Track $track) use ($overflow, $blockTime, &$insertList, &$totalTime) {
if ($overflow) {
$insertList[] = $track;
$totalTime += $track->length;
} else {
$projectedTime = $totalTime + $track->length;
if ($projectedTime <= $blockTime) {
$insertList[] = $track;
$totalTime += $track->length;
}
}
};
foreach ($tracks as $track) {
$addTrack($track);
if ($isFull()) {
break;
}
}
$sizeOfInsert = count($insertList);
while (!$isFull() && $repeat && $sizeOfInsert > 0) {
Logging::debug('adding repeated tracks.');
Logging::debug('total time = ' . $totalTime);
$track = $insertList[array_rand(array_slice($insertList, 0, $sizeOfInsert))];
$addTrack($track);
}
}
return array_map(fn (Track $track) => ['id' => $track->id, 'length' => $track->length], $insertList);
}
/**
* Parses each row in the database for the criteria associated with this block and renders human readable labels.
* Returns it as an array with each criteria_name and modifier_name added based upon options array lookup.
*/
public function getCriteria()
{
$allCriteria = BlockCriteria::criteriaMap();
$allOptions = CriteriaModifier::mapToDisplay();
// Load criteria from db
$out = CcBlockcriteriaQuery::create()->orderByDbCriteria()->findByDbBlockId($this->id);
$storedCrit = [];
foreach ($out as $crit) {
$criteria = $crit->getDbCriteria();
$modifier = $crit->getDbModifier();
$value = $crit->getDbValue();
$extra = $crit->getDbExtra();
$criteriagroup = $crit->getDbCriteriaGroup();
if ($criteria == 'limit') {
$storedCrit['limit'] = [
'value' => $value,
'modifier' => $modifier,
'display_modifier' => _($modifier),
];
} elseif ($criteria == 'repeat_tracks') {
$storedCrit['repeat_tracks'] = ['value' => $value];
} elseif ($criteria == 'overflow_tracks') {
$storedCrit['overflow_tracks'] = ['value' => $value];
} elseif ($criteria == 'sort') {
$storedCrit['sort'] = ['value' => $value];
} else {
$c = $allCriteria[$criteria];
$storedCrit['crit'][$criteria][] = [
'criteria' => $criteria,
'value' => $value,
'modifier' => $modifier,
'extra' => $extra,
'criteria_group' => $criteriagroup,
'display_name' => $c->display,
'display_modifier' => $allOptions[$modifier],
];
}
}
return $storedCrit;
}
/**
* Parses each row in the database for the criteria associated with this block and renders human readable labels.
* Returns it as an array with each criteria_name and modifier_name added based upon options array lookup.
* Maintains original separation of similar criteria that were separated by and statements.
*/
public function getCriteriaGrouped()
{
$criteriaOptions = BlockCriteria::displayCriteria();
$modifierOptions = CriteriaModifier::mapToDisplay();
// Load criteria from db
$out = CcBlockcriteriaQuery::create()->orderByDbCriteria()->findByDbBlockId($this->id);
$storedCrit = [];
foreach ($out as $crit) {
$criteria = $crit->getDbCriteria();
$modifier = $crit->getDbModifier();
$value = $crit->getDbValue();
$extra = $crit->getDbExtra();
$criteriagroup = $crit->getDbCriteriaGroup();
if ($criteria == 'limit') {
$storedCrit['limit'] = [
'value' => $value,
'modifier' => $modifier,
'display_modifier' => _($modifier),
];
} elseif ($criteria == 'repeat_tracks') {
$storedCrit['repeat_tracks'] = ['value' => $value];
} elseif ($criteria == 'overflow_tracks') {
$storedCrit['overflow_tracks'] = ['value' => $value];
} elseif ($criteria == 'sort') {
$storedCrit['sort'] = ['value' => $value];
} else {
$storedCrit['crit'][$criteria . $criteriagroup][] = [
'criteria' => $criteria,
'value' => $value,
'modifier' => $modifier,
'extra' => $extra,
'display_name' => $criteriaOptions[$criteria],
'display_modifier' => $modifierOptions[$modifier],
];
}
}
return $storedCrit;
}
private function resolveDate($value, ?DateTime $resolveTo, string $timeZone)
{
if (!is_string($value)) {
return $value;
}
$dt = $resolveTo ?: new DateTime('now');
$dt->setTimezone(new DateTimeZone($timeZone));
return preg_replace_callback(
'/now{(.*?)}/',
fn ($matches) => $dt->format($matches[1]),
$value
);
}
// this function return list of propel object
public function getListofFilesMeetCriteria($showLimit = null, $showStartTime = null)
{
$storedCrit = $this->getCriteria();
$qry = CcFilesQuery::create();
$qry->useFkOwnerQuery('subj', 'left join');
$allCriteria = BlockCriteria::criteriaMap();
$timeZone = Application_Model_Preference::GetDefaultTimezone();
// Logging::info($storedCrit);
if (isset($storedCrit['crit'])) {
foreach ($storedCrit['crit'] as $crit) {
$i = 0;
$prevgroup = null;
$group = null;
// now we need to sort based upon extra which contains the and grouping from the form
usort($crit, function ($a, $b) {
return $a['criteria_group'] - $b['criteria_group'];
});
// we need to run the following loop separately for each criteria group inside of each array
foreach ($crit as $criteria) {
$group = $criteria['criteria_group'];
$spCriteria = $criteria['criteria'];
$spCriteriaModifier = $criteria['modifier'];
$column = CcFilesPeer::getTableMap()->getColumnByPhpName($allCriteria[$spCriteria]->peer);
// data should already be in UTC, do we have to do anything special here anymore?
if ($column->getType() == PropelColumnTypes::TIMESTAMP) {
$spCriteriaValue = $criteria['value'];
if (isset($criteria['extra'])) {
$spCriteriaExtra = $criteria['extra'];
}
} elseif ($spCriteria == 'bit_rate' || $spCriteria == 'sample_rate') {
// multiply 1000 because we store only number value
// e.g 192kps is stored as 192000
$spCriteriaValue = $criteria['value'] * 1000;
if (isset($criteria['extra'])) {
$spCriteriaExtra = $criteria['extra'] * 1000;
}
/*
* If user is searching for an exact match of length we need to
* search as if it starts with the specified length because the
* user only sees the rounded version (i.e. 4:02.7 is 4:02.761625
* in the database)
*/
} elseif (in_array($spCriteria, ['length', 'cuein', 'cueout']) && $spCriteriaModifier == 'is') {
$spCriteriaModifier = 'starts with';
$spCriteria .= '::text';
$spCriteriaValue = $criteria['value'];
} else {
/* Propel does not escape special characters properly when using LIKE/ILIKE
* We have to add extra slashes in these cases
*/
$tempModifier = trim(self::$modifier2CriteriaMap[$spCriteriaModifier]);
if ($tempModifier == 'ILIKE') {
$spCriteriaValue = addslashes($criteria['value']);
// addslashes() does not esapce '%' so we have to do it manually
$spCriteriaValue = str_replace('%', '\%', $spCriteriaValue);
} else {
$spCriteriaValue = $criteria['value'];
}
$spCriteriaExtra = $criteria['extra'];
}
$spCriteriaValue = $this->resolveDate($spCriteriaValue, $showStartTime, $timeZone);
if ($spCriteriaModifier == CriteriaModifier::STARTS_WITH) {
$spCriteriaValue = "{$spCriteriaValue}%";
} elseif ($spCriteriaModifier == CriteriaModifier::ENDS_WITH) {
$spCriteriaValue = "%{$spCriteriaValue}";
} elseif ($spCriteriaModifier == CriteriaModifier::CONTAINS || $spCriteriaModifier == CriteriaModifier::DOES_NOT_CONTAIN) {
$spCriteriaValue = "%{$spCriteriaValue}%";
} elseif ($spCriteriaModifier == CriteriaModifier::IS_IN_THE_RANGE) {
$spCriteriaValue = "{$spCriteria} >= '{$spCriteriaValue}' AND {$spCriteria} <= '{$spCriteriaExtra}'";
} elseif ($spCriteriaModifier == CriteriaModifier::BEFORE) {
// need to pull in the current time and subtract the value or figure out how to make it relative
$relativedate = new DateTime($spCriteriaValue);
$dt = $relativedate->format(DateTime::ISO8601);
$spCriteriaValue = "COALESCE({$spCriteria}, DATE '-infinity') <= '{$dt}'";
} elseif ($spCriteriaModifier == CriteriaModifier::AFTER) {
$relativedate = new DateTime($spCriteriaValue);
$dt = $relativedate->format(DateTime::ISO8601);
$spCriteriaValue = "COALESCE({$spCriteria}, DATE '-infinity') >= '{$dt}'";
} elseif ($spCriteriaModifier == CriteriaModifier::BETWEEN) {
$fromrelativedate = new DateTime($spCriteriaValue);
$fdt = $fromrelativedate->format(DateTime::ISO8601);
$torelativedate = new DateTime($spCriteriaExtra);
$tdt = $torelativedate->format(DateTime::ISO8601);
$spCriteriaValue = "COALESCE({$spCriteria}, DATE '-infinity') >= '{$fdt}' AND COALESCE({$spCriteria}, DATE '-infinity') <= '{$tdt}'";
}
$spCriteriaModifier = self::$modifier2CriteriaMap[$spCriteriaModifier];
try {
if ($spCriteria == 'owner_id') {
$spCriteria = 'subj.login';
}
if ($spCriteria == 'filepath') {
$spCriteria = "reverse(split_part(reverse(filepath), '/', 1))";
}
if ($i > 0 && $prevgroup == $group) {
$qry->addOr($spCriteria, $spCriteriaValue, $spCriteriaModifier);
} else {
$qry->addAnd($spCriteria, $spCriteriaValue, $spCriteriaModifier);
}
// only add this NOT LIKE null if you aren't also matching on another criteria
if ($i == 0) {
if ($spCriteriaModifier == Criteria::NOT_ILIKE || $spCriteriaModifier == Criteria::NOT_EQUAL) {
$qry->addOr($spCriteria, null, Criteria::ISNULL);
}
}
} catch (Exception $e) {
Logging::info($e);
}
$prevgroup = $group;
++$i;
}
}
}
// check if file exists
$qry->add('file_exists', 'true', Criteria::EQUAL);
$qry->add('hidden', 'false', Criteria::EQUAL);
$sortTracks = 'random';
if (isset($storedCrit['sort'])) {
$sortTracks = $storedCrit['sort']['value'];
}
if ($sortTracks == 'newest') {
$qry->addDescendingOrderByColumn('utime');
} elseif ($sortTracks == 'oldest') {
$qry->addAscendingOrderByColumn('utime');
} elseif ($sortTracks == 'mostrecentplay') {
$qry->addAscendingOrderByColumn('lptime DESC NULLS LAST, filepath');
} elseif ($sortTracks == 'leastrecentplay') {
$qry->addAscendingOrderByColumn('lptime ASC NULLS FIRST, filepath');
} elseif ($sortTracks == 'random') {
$qry->addAscendingOrderByColumn('random()');
} else {
Logging::warning('Unimplemented sortTracks type in ' . __FILE__);
}
// construct limit restriction
$limits = [];
if (isset($storedCrit['limit'])) {
if ($storedCrit['limit']['modifier'] == 'items') {
$limits['time'] = 1440 * 60;
$limits['items'] = $storedCrit['limit']['value'];
} elseif ($storedCrit['limit']['modifier'] == 'remaining') {
// show will be null unless being called inside a show instance
if (!is_null($showLimit)) {
$limits['time'] = $showLimit;
$limits['items'] = null;
} else {
$limits['time'] = 60 * 60;
$limits['items'] = null;
}
} else {
$limits['time'] = $storedCrit['limit']['modifier'] == 'hours'
? intval(floatval($storedCrit['limit']['value']) * 60 * 60)
: intval($storedCrit['limit']['value'] * 60);
$limits['items'] = null;
}
}
$repeatTracks = 0;
$overflowTracks = 0;
if (isset($storedCrit['repeat_tracks'])) {
$repeatTracks = $storedCrit['repeat_tracks']['value'];
}
if (isset($storedCrit['overflow_tracks'])) {
$overflowTracks = $storedCrit['overflow_tracks']['value'];
}
try {
$out = $qry->setFormatter(ModelCriteria::FORMAT_ON_DEMAND)->find();
return ['files' => $out, 'limit' => $limits, 'repeat_tracks' => $repeatTracks, 'overflow_tracks' => $overflowTracks, 'count' => $out->count(), 'sort_type' => $sortTracks];
} catch (Exception $e) {
Logging::info($e);
}
}
public static function organizeSmartPlaylistCriteria($p_criteria)
{
$fieldNames = ['sp_criteria_field', 'sp_criteria_modifier', 'sp_criteria_value', 'sp_criteria_extra', 'sp_criteria_datetime_select', 'sp_criteria_extra_datetime_select'];
$output = [];
foreach ($p_criteria as $ele) {
$index = strrpos($ele['name'], '_');
/* Strip field name of modifier index
* Ex: sp_criteria_field_0_0 -> sp_criteria_field_0
*/
$fieldName = substr($ele['name'], 0, $index);
// Get criteria row index.
$tempName = $ele['name'];
// Get the last digit in the field name
preg_match('/^\D*(?=\d)/', $tempName, $r);
if (isset($r[0])) {
$critIndexPos = strlen($r[0]);
$critIndex = $tempName[$critIndexPos];
}
$lastChar = substr($ele['name'], -1);
// If lastChar is an integer we should strip it off
if (!preg_match('/^[a-zA-Z]$/', $lastChar)) {
/* Strip field name of criteria index
* Ex: sp_criteria_field_0 -> sp_criteria_field
* We do this to check if the field name is a criteria
* or the block type
*/
$n = strrpos($fieldName, '_');
$fieldName = substr($fieldName, 0, $n);
}
if (in_array($fieldName, $fieldNames)) {
$output['criteria'][$critIndex][$lastChar][$fieldName] = trim($ele['value']);
} else {
$output['etc'][$ele['name']] = $ele['value'];
}
}
return $output;
}
public static function getAllBlockFiles()
{
$sql = <<<'SQL'
SELECT distinct(file_id)
FROM cc_blockcontents
SQL;
$files = Application_Common_Database::prepareAndExecute($sql, []);
$real_files = [];
foreach ($files as $f) {
$real_files[] = $f['file_id'];
}
return $real_files;
}
// smart block functions end
}
class Track
{
public int $id;
public float $length;
public function __construct($id, $length)
{
$this->id = $id;
$this->length = $length;
}
public function __toString(): string
{
return (string) $this->id;
}
}
/**
* Using a randomized greedy with local improvement approximation solution for the Subset Sum Problem.
*
* https://web.stevens.edu/algebraic/Files/SubsetSum/przydatek99fast.pdf
*/
class SSPSolution
{
/**
* @var Track[]
*/
public array $tracks;
public float $sum = 0.0;
public function __construct($tracks = [], $sum = null)
{
$this->tracks = $tracks;
if ($sum !== null) {
$this->sum = $sum;
} else {
foreach ($this->tracks as $track) {
$this->sum += $track->length;
}
}
}
public function add(Track $track): SSPSolution
{
$new = $this->tracks;
$new[] = $track;
return new SSPSolution($new, $this->sum + $track->length);
}
public function replace(Track $old, Track $new): SSPSolution
{
return new SSPSolution(array_map(fn (Track $it) => $it === $old ? $new : $it, $this->tracks));
}
public static function isCloseEnough(float $delta): bool
{
return $delta < 0.25;
}
public static function maxByOrNull(array $array, callable $callback)
{
$max = null;
$v = null;
foreach ($array as $item) {
$value = $callback($item);
if ($max === null || $v < $value) {
$max = $item;
$v = $value;
}
}
return $max;
}
/**
* @param Track[] $tracks
*/
public static function solve(array $tracks, float $target, int $trials = 50): SSPSolution
{
$best = new SSPSolution();
for ($trial = 0; $trial < $trials; ++$trial) {
shuffle($tracks);
$initial = array_reduce($tracks, function (SSPSolution $solution, Track $track) use ($target) {
$new = $solution->add($track);
if ($new->sum <= $target) {
return $new;
}
return $solution;
}, new SSPSolution());
if (count($initial->tracks) == count($tracks)) {
return $initial;
}
$acceptedItems = $initial->tracks;
shuffle($acceptedItems);
$localImprovement = array_reduce($acceptedItems, function (SSPSolution $solution, Track $track) use ($target, $tracks) {
$delta = $target - $solution->sum;
if (self::isCloseEnough($delta)) {
return $solution;
}
$replacement = self::maxByOrNull(
array_filter(
array_diff($tracks, $solution->tracks),
fn (Track $it) => $it->length > $track->length && $it->length - $track->length <= $delta,
),
fn (Track $it) => $it->length,
);
if ($replacement === null) {
return $solution;
}
return $solution->replace($track, $replacement);
}, $initial);
if ($localImprovement->sum > $best->sum) {
$best = $localImprovement;
}
if ($best->sum === 0.0) {
return $best;
}
}
return $best;
}
}
class BlockNotFoundException extends Exception {}
class BlockNoPermissionException extends Exception {}
class BlockOutDatedException extends Exception {}
class BlockDyanmicException extends Exception {}