mirror of
https://github.com/FriendsOfTYPO3/tea.git
synced 2024-12-18 13:06:11 +01:00
29 lines
963 B
ReStructuredText
29 lines
963 B
ReStructuredText
|
.. include:: /Includes.rst.txt
|
||
|
|
|
||
|
|
.. _servicesFiles:
|
||
|
|
|
||
|
|
Services Files
|
||
|
|
==============
|
||
|
|
|
||
|
|
We choose to use :file:`Services.php` instead of :file:`Services.yaml`.
|
||
|
|
It still is completely fine to use YAML files over PHP files or even mix both.
|
||
|
|
Some things are way shorter to write with the YAML syntax.
|
||
|
|
|
||
|
|
We prefer the PHP file over YAML for the following reasons:
|
||
|
|
|
||
|
|
- Static Code Analysis
|
||
|
|
|
||
|
|
Static code analysis tools, like PHPStan, can analyse the PHP source code base.
|
||
|
|
They typically don't support other files like YAML.
|
||
|
|
Those tools report issues for not found classes, e.g. due to typos.
|
||
|
|
|
||
|
|
- Auto completion
|
||
|
|
|
||
|
|
Modern tooling like IDEs and Language Servers provide auto completion for PHP source files out of the box.
|
||
|
|
That way programmers can discover APIs and write more robust code faster.
|
||
|
|
|
||
|
|
- Automatic code migration
|
||
|
|
|
||
|
|
PHP Code can be auto migrated via tools like rector.
|
||
|
|
E.g. renaming a class can be applied to PHP code, but no current tool for yaml exists.
|