This package contains PHP attribute definitions published by the PHP Framework Interoperability Group (PHP-FIG). They are intended to have widespread applicability across the PHP ecosystem.
Any attribute proposed must be approved by a majority of the working group, and in some cases by the PHP-FIG Core Committee. Any submitted attribute must follow these guidelines:
- It MUST have applicability and relevance for more than one project or application.
- It SHOULD have two or more projects to which the attribute would be relevant that state their intent to use it if approved.
- It MUST be parsable and usable with raw PHP. No third party attribute library requirements are allowed.
- It MUST follow PER-CS coding guidelines.
- It MUST adhere to PHPStan Level 10 levels of code tidiness.
- It MUST be extensively documented through docblocks on the attribute itself.
- It MAY have functionality beyond just the constructor, if relevant.
- If the required PHP version for a specific attribute is higher than that of the package, that MUST be specified in the class docblock.
Ideally, proposals should be discussed in the PHP-FIG Discord, #per-attributes channel, prior to proposal.
Please see CONTRIBUTING for details.
If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.
The MIT License. Please see License File for more information.