9.8 | Add support to either Symfony Components 6.4 LTS or 7.4 LTS

[llaville]

In waiting major release 10.0 that will be re-written from scratch with vendor-agnostic mindset (see explains at #220), I've a good new for all users that wants to keep uses of the Symfony 6.4 LTS components rather than 7.4 LTS

By default PHPLint 9.8.0 will have minimal dependencies :

bamarni/composer-bin-plugin               1.8.3  No conflicts for your bin dependencies
jetbrains/phpstorm-stubs                  2024.3 PHP runtime & extensions header files for PhpStorm
php-parallel-lint/php-console-color       1.0.1  Simple library for creating colored console ouput.
php-parallel-lint/php-console-highlighter 1.0.0  Highlight PHP code in terminal

After installing these basic packages, if you try to run bin/phplint binary command, following message will be displayed

You should install first the Symfony Components, with :
either - composer bin symfony-6.4LTS update
or     - composer bin symfony-7.4LTS update

Depending of your Symfony installation choices, you will be then able to run PHPLint as usual !

Hope you will like the compromised with a long wait ... before v10.0 ;-)

/cc @gnutix
/cc @overtrue

Symfony 6.4 LTS

container  [Docker] > composer bin symfony-6.4LTS show
[bamarni-bin] Checking namespace vendor-bin/symfony-6.4LTS
psr/cache                          3.0.0  Common interface for caching libraries
psr/container                      2.0.2  Common Container Interface (PHP FIG PSR-11)
psr/event-dispatcher               1.0.0  Standard interfaces for event handling.
psr/log                            3.0.2  Common interface for logging libraries
symfony/cache                      6.4.31 Provides extended PSR-6, PSR-16 (and tags) implementations
symfony/cache-contracts            3.6.0  Generic abstractions related to caching
symfony/console                    6.4.31 Eases the creation of beautiful and testable command line interfaces
symfony/deprecation-contracts      3.6.0  A generic function and convention to trigger deprecation notices
symfony/event-dispatcher           6.4.25 Provides tools that allow your application components to communicate with each other by dispatchi...
symfony/event-dispatcher-contracts 3.6.0  Generic abstractions related to dispatching event
symfony/finder                     6.4.31 Finds files and directories via an intuitive fluent interface
symfony/options-resolver           6.4.30 Provides an improved replacement for the array_replace PHP function
symfony/polyfill-ctype             1.33.0 Symfony polyfill for ctype functions
symfony/polyfill-intl-grapheme     1.33.0 Symfony polyfill for intl's grapheme_* functions
symfony/polyfill-intl-normalizer   1.33.0 Symfony polyfill for intl's Normalizer class and related functions
symfony/polyfill-mbstring          1.33.0 Symfony polyfill for the Mbstring extension
symfony/process                    6.4.31 Executes commands in sub-processes
symfony/service-contracts          3.6.1  Generic abstractions related to writing services
symfony/string                     7.4.0  Provides an object-oriented API to strings and deals with bytes, UTF-8 code points and grapheme c...
symfony/var-exporter               7.4.0  Allows exporting any serializable PHP data structure to plain PHP code
symfony/yaml                       6.4.30 Loads and dumps YAML files

Symfony 7.4 LTS

container  [Docker] > composer bin symfony-7.4LTS show
[bamarni-bin] Checking namespace vendor-bin/symfony-7.4LTS
psr/cache                          3.0.0  Common interface for caching libraries
psr/container                      2.0.2  Common Container Interface (PHP FIG PSR-11)
psr/event-dispatcher               1.0.0  Standard interfaces for event handling.
psr/log                            3.0.2  Common interface for logging libraries
symfony/cache                      7.4.3  Provides extended PSR-6, PSR-16 (and tags) implementations
symfony/cache-contracts            3.6.0  Generic abstractions related to caching
symfony/console                    7.4.3  Eases the creation of beautiful and testable command line interfaces
symfony/deprecation-contracts      3.6.0  A generic function and convention to trigger deprecation notices
symfony/event-dispatcher           7.4.0  Provides tools that allow your application components to communicate with each other by dispatchi...
symfony/event-dispatcher-contracts 3.6.0  Generic abstractions related to dispatching event
symfony/finder                     7.4.3  Finds files and directories via an intuitive fluent interface
symfony/options-resolver           7.4.0  Provides an improved replacement for the array_replace PHP function
symfony/polyfill-ctype             1.33.0 Symfony polyfill for ctype functions
symfony/polyfill-intl-grapheme     1.33.0 Symfony polyfill for intl's grapheme_* functions
symfony/polyfill-intl-normalizer   1.33.0 Symfony polyfill for intl's Normalizer class and related functions
symfony/polyfill-mbstring          1.33.0 Symfony polyfill for the Mbstring extension
symfony/process                    7.4.3  Executes commands in sub-processes
symfony/service-contracts          3.6.1  Generic abstractions related to writing services
symfony/string                     7.4.0  Provides an object-oriented API to strings and deals with bytes, UTF-8 code points and grapheme c...
symfony/var-exporter               7.4.0  Allows exporting any serializable PHP data structure to plain PHP code
symfony/yaml                       7.4.1  Loads and dumps YAML files

[llaville]

Branch 9.8 that will propose the solution will be soon available.
Of course all feedbacks are welcome, especially for users that needs PHP 8.1 and Symfony 6.4 LTS components.

YES, PHP 8.1 will be back and supported again ! So I'll mark v9.6 as End-Of-Life

TODO list :

• update Dockerfile and support
• update GitHub Workflows
• upgrade Documentation

and all others stuff I've probably missed

• update Git Hooks with CaptainHooks (especially PHPStan)

Tip

Disable Git Hooks temporary with git push --no-verify

[llaville]

Branch 9.8 is available, and all users are greatly welcome to gave us their feedback !

Be aware that I'll continue to fix all stuffs (I've identified in my previous TODO list) tomorrow ...

Use following command to test it !

composer require overtrue/phplint 9.8.x-dev --dev

[llaville]

• End-to-End tests fixed by commit 99274d8 (Symfony 6.4 or greater Compatibility)
• Custom Autoloader fixed by commit 6cf20ff (to allow PHPStan analysis)
• Custom Autoloader in effect for PHPBenchmarks by commit 906cf07
• Custom Autoloader in effect for PHPStan by commit 6adc32f

[llaville]

• Dockerfile was fixed to support both Symfony 6.4 LTS or 7.4 LTS (and by extension any future Symfony versions) by commit 76c60f2

Explains

By default the container built will have for target : PHP 8.4 and Symfony Components 8.0

Symfony Components 8.0 or 7.4 LTS

docker build . --no-cache --progress plain

Build sample

#15 [stage-0 7/7] RUN composer global require --no-progress   overtrue/phplint "9.8.x-dev"   php-parallel-lint/php-console-highlighter "^1.0"   symfony/cache "^7.4 || ^8.0"   symfony/console "^7.4 || ^8.0"   symfony/event-dispatcher "^7.4 || ^8.0"   symfony/finder "^7.4 || ^8.0"   symfony/options-resolver "^7.4 || ^8.0"   symfony/process "^7.4 || ^8.0"   symfony/yaml "^7.4 || ^8.0"
#15 0.509 Changed current directory to /home/appuser/.composer
#15 0.565 ./composer.json has been created
#15 0.575 Running composer update overtrue/phplint php-parallel-lint/php-console-highlighter symfony/cache symfony/console symfony/event-dispatcher symfony/finder symfony/options-resolver symfony/process symfony/yaml
#15 0.578 Loading composer repositories with package information
#15 0.856 Updating dependencies
#15 0.862 Lock file operations: 24 installs, 0 updates, 0 removals
#15 0.862   - Locking overtrue/phplint (9.8.x-dev 76c60f2)
#15 0.862   - Locking php-parallel-lint/php-console-color (v1.0.1)
#15 0.862   - Locking php-parallel-lint/php-console-highlighter (v1.0.0)
#15 0.862   - Locking psr/cache (3.0.0)
#15 0.862   - Locking psr/container (2.0.2)
#15 0.862   - Locking psr/event-dispatcher (1.0.0)
#15 0.862   - Locking psr/log (3.0.2)
#15 0.862   - Locking symfony/cache (v8.0.3)
#15 0.862   - Locking symfony/cache-contracts (v3.6.0)
#15 0.862   - Locking symfony/console (v8.0.3)
#15 0.862   - Locking symfony/deprecation-contracts (v3.6.0)
#15 0.862   - Locking symfony/event-dispatcher (v8.0.0)
#15 0.862   - Locking symfony/event-dispatcher-contracts (v3.6.0)
#15 0.862   - Locking symfony/finder (v8.0.3)
#15 0.862   - Locking symfony/options-resolver (v8.0.0)
#15 0.862   - Locking symfony/polyfill-ctype (v1.33.0)
#15 0.862   - Locking symfony/polyfill-intl-grapheme (v1.33.0)
#15 0.862   - Locking symfony/polyfill-intl-normalizer (v1.33.0)
#15 0.862   - Locking symfony/polyfill-mbstring (v1.33.0)
#15 0.862   - Locking symfony/process (v8.0.3)
#15 0.862   - Locking symfony/service-contracts (v3.6.1)
#15 0.862   - Locking symfony/string (v8.0.1)
#15 0.862   - Locking symfony/var-exporter (v8.0.0)
#15 0.862   - Locking symfony/yaml (v8.0.1)
#15 0.863 Writing lock file
#15 0.863 Installing dependencies from lock file (including require-dev)
#15 0.865 Package operations: 24 installs, 0 updates, 0 removals
#15 0.870   - Downloading symfony/polyfill-mbstring (v1.33.0)
#15 0.871   - Downloading overtrue/phplint (9.8.x-dev 76c60f2)
#15 0.872   - Downloading php-parallel-lint/php-console-color (v1.0.1)
#15 0.873   - Downloading php-parallel-lint/php-console-highlighter (v1.0.0)
#15 0.874   - Downloading symfony/var-exporter (v8.0.0)
#15 0.874   - Downloading symfony/deprecation-contracts (v3.6.0)
#15 0.876   - Downloading psr/container (2.0.2)
#15 0.876   - Downloading symfony/service-contracts (v3.6.1)
#15 0.877   - Downloading psr/cache (3.0.0)
#15 0.878   - Downloading symfony/cache-contracts (v3.6.0)
#15 0.879   - Downloading psr/log (3.0.2)
#15 0.880   - Downloading symfony/cache (v8.0.3)
#15 0.881   - Downloading symfony/polyfill-intl-normalizer (v1.33.0)
#15 0.881   - Downloading symfony/polyfill-intl-grapheme (v1.33.0)
#15 0.882   - Downloading symfony/polyfill-ctype (v1.33.0)
#15 0.882   - Downloading symfony/string (v8.0.1)
#15 0.883   - Downloading symfony/console (v8.0.3)
#15 0.883   - Downloading psr/event-dispatcher (1.0.0)
#15 0.884   - Downloading symfony/event-dispatcher-contracts (v3.6.0)
#15 0.884   - Downloading symfony/event-dispatcher (v8.0.0)
#15 0.884   - Downloading symfony/finder (v8.0.3)
#15 0.885   - Downloading symfony/options-resolver (v8.0.0)
#15 0.885   - Downloading symfony/process (v8.0.3)
#15 0.886   - Downloading symfony/yaml (v8.0.1)
#15 1.913   - Installing symfony/polyfill-mbstring (v1.33.0): Extracting archive
#15 1.919   - Installing overtrue/phplint (9.8.x-dev 76c60f2): Extracting archive
#15 1.921   - Installing php-parallel-lint/php-console-color (v1.0.1): Extracting archive
#15 1.923   - Installing php-parallel-lint/php-console-highlighter (v1.0.0): Extracting archive
#15 1.924   - Installing symfony/var-exporter (v8.0.0): Extracting archive
#15 1.925   - Installing symfony/deprecation-contracts (v3.6.0): Extracting archive
#15 1.926   - Installing psr/container (2.0.2): Extracting archive
#15 1.928   - Installing symfony/service-contracts (v3.6.1): Extracting archive
#15 1.929   - Installing psr/cache (3.0.0): Extracting archive
#15 1.930   - Installing symfony/cache-contracts (v3.6.0): Extracting archive
#15 1.931   - Installing psr/log (3.0.2): Extracting archive
#15 1.932   - Installing symfony/cache (v8.0.3): Extracting archive
#15 1.933   - Installing symfony/polyfill-intl-normalizer (v1.33.0): Extracting archive
#15 1.933   - Installing symfony/polyfill-intl-grapheme (v1.33.0): Extracting archive
#15 1.935   - Installing symfony/polyfill-ctype (v1.33.0): Extracting archive
#15 1.936   - Installing symfony/string (v8.0.1): Extracting archive
#15 1.938   - Installing symfony/console (v8.0.3): Extracting archive
#15 1.939   - Installing psr/event-dispatcher (1.0.0): Extracting archive
#15 1.940   - Installing symfony/event-dispatcher-contracts (v3.6.0): Extracting archive
#15 1.941   - Installing symfony/event-dispatcher (v8.0.0): Extracting archive
#15 1.942   - Installing symfony/finder (v8.0.3): Extracting archive
#15 1.944   - Installing symfony/options-resolver (v8.0.0): Extracting archive
#15 1.945   - Installing symfony/process (v8.0.3): Extracting archive
#15 1.946   - Installing symfony/yaml (v8.0.1): Extracting archive
#15 2.168 2 package suggestions were added by new dependencies, use `composer suggest` to see details.
#15 2.170 Generating autoload files
#15 2.184 18 packages you are using are looking for funding.
#15 2.184 Use the `composer fund` command to find out more!
#15 2.206 No security vulnerability advisories found.
#15 DONE 2.3s

#16 exporting to image
#16 exporting layers
#16 exporting layers 0.2s done
#16 writing image sha256:2f19db0c53a80d12713b0621ba04dbb726b0e366ac62d2165ec85077fdf4be11 done
#16 DONE 0.2s

Running example with previous container build :

docker run --rm -t -v "${PWD}":/workdir 2f19db0c53a80d12713b0621ba04dbb726b0e366ac62d2165ec85077fdf4be11 ./ --exclude=vendor --no-configuration --no-cache -v

Gave us, something like :

If you want to use SF 7.4 LTS rather than latest SF 8.0, build the container with accordingly constraint.

docker build . --no-cache --progress plain --build-arg SYMFONY_CONSTRAINT="^7.4"

Symfony Components 6.4 LTS

docker build . --no-cache --progress plain --build-arg SYMFONY_CONSTRAINT="^6.4 || ^8.0" --build-arg PHP_VERSION=8.1

Build sample

#15 [stage-0 7/7] RUN composer global require --no-progress   overtrue/phplint "9.8.x-dev"   php-parallel-lint/php-console-highlighter "^1.0"   symfony/cache "^6.4 || ^8.0"   symfony/console "^6.4 || ^8.0"   symfony/event-dispatcher "^6.4 || ^8.0"   symfony/finder "^6.4 || ^8.0"   symfony/options-resolver "^6.4 || ^8.0"   symfony/process "^6.4 || ^8.0"   symfony/yaml "^6.4 || ^8.0"
#15 0.471 Changed current directory to /home/appuser/.composer
#15 0.538 ./composer.json has been created
#15 0.554 Running composer update overtrue/phplint php-parallel-lint/php-console-highlighter symfony/cache symfony/console symfony/event-dispatcher symfony/finder symfony/options-resolver symfony/process symfony/yaml
#15 0.557 Loading composer repositories with package information
#15 0.839 Updating dependencies
#15 0.845 Lock file operations: 24 installs, 0 updates, 0 removals
#15 0.845   - Locking overtrue/phplint (9.8.x-dev 76c60f2)
#15 0.845   - Locking php-parallel-lint/php-console-color (v1.0.1)
#15 0.845   - Locking php-parallel-lint/php-console-highlighter (v1.0.0)
#15 0.845   - Locking psr/cache (3.0.0)
#15 0.845   - Locking psr/container (2.0.2)
#15 0.845   - Locking psr/event-dispatcher (1.0.0)
#15 0.845   - Locking psr/log (3.0.2)
#15 0.845   - Locking symfony/cache (v6.4.31)
#15 0.845   - Locking symfony/cache-contracts (v3.6.0)
#15 0.845   - Locking symfony/console (v6.4.31)
#15 0.845   - Locking symfony/deprecation-contracts (v3.6.0)
#15 0.845   - Locking symfony/event-dispatcher (v6.4.25)
#15 0.845   - Locking symfony/event-dispatcher-contracts (v3.6.0)
#15 0.845   - Locking symfony/finder (v6.4.31)
#15 0.845   - Locking symfony/options-resolver (v6.4.30)
#15 0.845   - Locking symfony/polyfill-ctype (v1.33.0)
#15 0.846   - Locking symfony/polyfill-intl-grapheme (v1.33.0)
#15 0.846   - Locking symfony/polyfill-intl-normalizer (v1.33.0)
#15 0.846   - Locking symfony/polyfill-mbstring (v1.33.0)
#15 0.846   - Locking symfony/process (v6.4.31)
#15 0.846   - Locking symfony/service-contracts (v3.6.1)
#15 0.846   - Locking symfony/string (v6.4.30)
#15 0.846   - Locking symfony/var-exporter (v6.4.26)
#15 0.846   - Locking symfony/yaml (v6.4.30)
#15 0.847 Writing lock file
#15 0.847 Installing dependencies from lock file (including require-dev)
#15 0.849 Package operations: 24 installs, 0 updates, 0 removals
#15 0.854   - Downloading symfony/polyfill-mbstring (v1.33.0)
#15 0.856   - Downloading overtrue/phplint (9.8.x-dev 76c60f2)
#15 0.857   - Downloading php-parallel-lint/php-console-color (v1.0.1)
#15 0.857   - Downloading php-parallel-lint/php-console-highlighter (v1.0.0)
#15 0.858   - Downloading symfony/deprecation-contracts (v3.6.0)
#15 0.859   - Downloading symfony/var-exporter (v6.4.26)
#15 0.860   - Downloading psr/container (2.0.2)
#15 0.861   - Downloading symfony/service-contracts (v3.6.1)
#15 0.862   - Downloading psr/cache (3.0.0)
#15 0.863   - Downloading symfony/cache-contracts (v3.6.0)
#15 0.863   - Downloading psr/log (3.0.2)
#15 0.864   - Downloading symfony/cache (v6.4.31)
#15 0.865   - Downloading symfony/polyfill-intl-normalizer (v1.33.0)
#15 0.865   - Downloading symfony/polyfill-intl-grapheme (v1.33.0)
#15 0.866   - Downloading symfony/polyfill-ctype (v1.33.0)
#15 0.867   - Downloading symfony/string (v6.4.30)
#15 0.867   - Downloading symfony/console (v6.4.31)
#15 0.867   - Downloading psr/event-dispatcher (1.0.0)
#15 0.868   - Downloading symfony/event-dispatcher-contracts (v3.6.0)
#15 0.869   - Downloading symfony/event-dispatcher (v6.4.25)
#15 0.869   - Downloading symfony/finder (v6.4.31)
#15 0.870   - Downloading symfony/options-resolver (v6.4.30)
#15 0.870   - Downloading symfony/process (v6.4.31)
#15 0.871   - Downloading symfony/yaml (v6.4.30)
#15 1.746   - Installing symfony/polyfill-mbstring (v1.33.0): Extracting archive
#15 1.759   - Installing overtrue/phplint (9.8.x-dev 76c60f2): Extracting archive
#15 1.763   - Installing php-parallel-lint/php-console-color (v1.0.1): Extracting archive
#15 1.765   - Installing php-parallel-lint/php-console-highlighter (v1.0.0): Extracting archive
#15 1.768   - Installing symfony/deprecation-contracts (v3.6.0): Extracting archive
#15 1.770   - Installing symfony/var-exporter (v6.4.26): Extracting archive
#15 1.773   - Installing psr/container (2.0.2): Extracting archive
#15 1.775   - Installing symfony/service-contracts (v3.6.1): Extracting archive
#15 1.778   - Installing psr/cache (3.0.0): Extracting archive
#15 1.785   - Installing symfony/cache-contracts (v3.6.0): Extracting archive
#15 1.788   - Installing psr/log (3.0.2): Extracting archive
#15 1.789   - Installing symfony/cache (v6.4.31): Extracting archive
#15 1.790   - Installing symfony/polyfill-intl-normalizer (v1.33.0): Extracting archive
#15 1.790   - Installing symfony/polyfill-intl-grapheme (v1.33.0): Extracting archive
#15 1.791   - Installing symfony/polyfill-ctype (v1.33.0): Extracting archive
#15 1.792   - Installing symfony/string (v6.4.30): Extracting archive
#15 1.793   - Installing symfony/console (v6.4.31): Extracting archive
#15 1.793   - Installing psr/event-dispatcher (1.0.0): Extracting archive
#15 1.794   - Installing symfony/event-dispatcher-contracts (v3.6.0): Extracting archive
#15 1.794   - Installing symfony/event-dispatcher (v6.4.25): Extracting archive
#15 1.795   - Installing symfony/finder (v6.4.31): Extracting archive
#15 1.796   - Installing symfony/options-resolver (v6.4.30): Extracting archive
#15 1.796   - Installing symfony/process (v6.4.31): Extracting archive
#15 1.797   - Installing symfony/yaml (v6.4.30): Extracting archive
#15 2.023 2 package suggestions were added by new dependencies, use `composer suggest` to see details.
#15 2.024 Generating autoload files
#15 2.030 18 packages you are using are looking for funding.
#15 2.030 Use the `composer fund` command to find out more!
#15 2.050 No security vulnerability advisories found.
#15 DONE 2.2s

#16 exporting to image
#16 exporting layers
#16 exporting layers 0.2s done
#16 writing image sha256:19712e157675aac3ed34d38c195b143234b8c66c2b0290e0117e9030c389745d done
#16 DONE 0.2s

Running example with previous container build :

docker run --rm -t -v "${PWD}":/workdir 19712e157675aac3ed34d38c195b143234b8c66c2b0290e0117e9030c389745d ./ --exclude=vendor --no-configuration --no-cache -v

Gave us, something like :

Note

Of course any PHP versions from 8.1 to 8.5 are supported, and you should specify it when you build the container (--build-arg PHP_VERSION=8.5) if you don't want the default PHP 8.4

[llaville]

• Documentation was fixed by commit 7287ae6
• Examples were fixed by commit c5636c1

[llaville]

No feedback received by community since a month now !

Should I consider that the backported Symfony 6.4 LTS support is un-appropriated ?

I will publish the last version (9.8.0) of branch v9 in next 48 hours. I hope it will let again a chance to reply ... before it's too late ;-)