phpDocumentor Files

3.7.0

This release is mostly a maintenance release. With some small improvements on the output of phpDoc on the cli. And internal upgrades of a number of dependencies. Most note worthy changes are listed in these release notes.

Clean template refactoring

Thanks to @omegamvc the clean template has been updated to work better on mobile devices and new features added to the default template for api docs have been added. This is a huge step forward in the clean template. The work has not been finished yet. So more will follow in the future.

• Complete refactoring clean template - First Steep by @omegamvc in https://github.com/phpDocumentor/phpDocumentor/pull/3846
• Fix CSS to improve display on mobile devices by @omegamvc in https://github.com/phpDocumentor/phpDocumentor/pull/3847

PHP 8.3 and PHP 8.4 support

phpDocumentor is now executable on php 8.3 and 8.4 This does not mean we have support for all language additions yet. As we told in the previous release notes the impact of php 8.4 is very big. A lot of changes have to be done to be able to support php 8.4 language features.

• Add php 8.2+ builds by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/3843

Improved config options for plantuml

Since a few releases phpDocumentor is using plantuml to generate diagrams. However some users did experience issues when using the phar install of phpDocumentor. While to docker based installations did work as expected. To make it possible again to generate diagrams using the phar based installations we did add some new options. These new options will allow you to install plantuml on your system and point phpdocumentor to the correct location. The options are added to the docs: https://docs.phpdoc.org/guide/guides/generate-diagrams.html#generate-diagrams

• Add better options to configure plantuml by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/3854

[BETA] Custom twig extensions

We did introduce an extension system to phpDocumentor a few releases ago. However there was no real working use-case for extensions yet. In this release we did add an example on how to extend phpDocumentor with a custom twig extension. More extension points will be added in the future. If you want to create your own twig extension read the guide on how to do that: https://docs.phpdoc.org/guide/features/extensions/twig-extension.html#twig-extension

• Add support for custom twig extensions by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/3868

Other changes

• Improve output formating by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/3870
• Bump guides to v1.7 by @jaapio in https://github.com/phpDocumentor/phpDocumentor/pull/3871
• Docs: fix link in generating-documentation.rst by @ThatsJustCheesy in https://github.com/phpDocumentor/phpDocumentor/pull/3851

New Contributors

• @omegamvc made their first contribution in https://github.com/phpDocumentor/phpDocumentor/pull/3846
• @ThatsJustCheesy made their first contribution in https://github.com/phpDocumentor/phpDocumentor/pull/3851

Full Changelog: https://github.com/phpDocumentor/phpDocumentor/compare/v3.6.0...v3.7.0