What's Changed

Default docker image improvements

phpDocumentor is now running by default on PHP 8.4 via the official Docker image. As usual older code is still processed correctly. No matter which PHP version you project is written for.

• Docker Optimizations by @NabeelKhanYYC in https://github.com/phpDocumentor/phpDocumentor/pull/3945
• Restrict dependency of php:8.1 to 8.1-bookworm. This is due to missin? by @jaymeh in https://github.com/phpDocumentor/phpDocumentor/pull/3961
• PHP version in docker to 8.4 by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/4011

PHP 8.5

Our CI ppipelines are now also testing against PHP 8.5. Which allows you to run phpDocumentor on PHP 8.5 as well. PHP 8.5 does not have any additional changes that affect phpDocumentor at this time.

• Test against php 8.5 by @sergiy-petrov in https://github.com/phpDocumentor/phpDocumentor/pull/3978

Expression Support

phpDocumentor now supports default expressions in parameters, properties and constants. The used types in these expressions are also parsed and used in the type resolution. So types within expressions are now linked correctly.

In this examle the Sauce type is linked correctly in the constructor parameter.

function __construct(Sauce $sauce = new Sauce('tomato')) {
    // ...
}

Extension Finder

The extension finder allows users to install extensions using composer. As an alternative to regular packages we do support phar extensions, which can be scoped to avoid conflicts with the main phpdocumentor application. The finder script is trying to avoid collisions between phpdocumentor and the classes within the project being processed. This might be the case when packages used by phpDocumentor are also used in the project.

• Add extension finder by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/3900

Other Changes

• GH Actions: remove GH Token set via env by @jrfnl in https://github.com/phpDocumentor/phpDocumentor/pull/3954
• Fix typo to make it uniform to the rest of the docs by @michaelKaefer in https://github.com/phpDocumentor/phpDocumentor/pull/3982
• Fix the reference doc about visibilities by @stof in https://github.com/phpDocumentor/phpDocumentor/pull/3996
• Silence deprecation notices produced on PHP 8.4+ by @pavetheway91 in https://github.com/phpDocumentor/phpDocumentor/pull/4005
• Add support for default expressions by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/4009
• Fix issue on rendering of attributes in file template by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/4008
• Fix use-cache config option by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/4010

New Contributors

• @jaymeh made their first contribution in https://github.com/phpDocumentor/phpDocumentor/pull/3961
• @michaelKaefer made their first contribution in https://github.com/phpDocumentor/phpDocumentor/pull/3982
• @sergiy-petrov made their first contribution in https://github.com/phpDocumentor/phpDocumentor/pull/3978
• @stof made their first contribution in https://github.com/phpDocumentor/phpDocumentor/pull/3996
• @pavetheway91 made their first contribution in https://github.com/phpDocumentor/phpDocumentor/pull/4005

Full Changelog: https://github.com/phpDocumentor/phpDocumentor/compare/v3.8.1...v3.9.0