fig-standards README

The project's README from github.com/php-fig/fig-standards. As one markdown file: README.md.

PHP Framework Interoperability Group

The idea behind the group is for project representatives to talk about the commonalities between our projects and find ways we can work together. Our main audience is each other, but we’re very aware that the rest of the PHP community is watching. If other folks want to adopt what we’re doing they are welcome to do so, but that is not the aim.

Proposing a Standard Recommendation

To propose a PHP Standard Recommendation (PSR):

GitHub usage

All discussion regarding a PSR happens on the mailing list. Issues filed in GitHub are rarely monitored, and PRs are likely to be missed unless a message is sent to the mailing list regarding them. Reviews of a proposed PSR should be conducted on the mailing list, not through PR comments for the same reason.

Please do not simply file an issue or PR and walk-away. The most likely outcome is that it will never get seen or addressed.

Requesting Membership

You do not need to be a voting member to participate in discussion on the mailing list.

To become a voting member, you must send an email to the mailing list.

Do not combine separate membership requests in a single thread; one request per thread, please.

Language & Translations

All PSRs are written in British English or American English (Different specifications may vary, but it is consistent within the same specification). The PHP FIG does not offer official translations into other languages but other external entities are free to translate the specifications in accordance with the license.

Voting Members

The current list of voting members is available on the project website.

fig-standards (php-fig/fig-standards)

Searching Database…

12.5K ·GitHub
Fig-standards
What is this?This is the PHP-FIG repository holding the PSR (PHP Standard Recommendations) specifications, proposed and approved by the PHP Framework Interoperability Group to standardize common patterns across PHP frameworks and libraries.
Is this a library or just documents?It is a collection of specification documents (the PSRs themselves), not code you install or run.
How do I propose a new standard?Fork the repo, create a branch, add your PSR under the proposed/ directory, push the branch, and send a pull request, or open a GitHub ticket or start a discussion on the mailing list.
Do I need to be a member to discuss a proposal?No, anyone can participate in discussion on the mailing list without being a voting member; only becoming a voting member requires a formal membership request.
Will filing a PR or GitHub issue get my proposal reviewed?No — GitHub issues and PRs are rarely monitored, so all real discussion and review of a PSR must happen on the mailing list instead.
Who is this group really talking to?The group's main audience is other PHP project representatives, though the wider PHP community is welcome to watch and adopt the standards.
How do I become a voting member of PHP-FIG?Send an email to the mailing list with the subject 'Membership Request: {yourname} ({projectname})', including your name and project link; current members then vote on the request.
What language are the PSRs written in?All PSRs are written in British or American English (consistent within a single specification), and PHP-FIG does not offer official translations, though external entities can translate them under the license.
What are similar projects?toml, fantasy-land, agents.md, api-guidelines, swift-evolution, design, spec, rfcs
Which topics is it in?standards, specification, php, documentation, free, open-source
Creator
php-fig
Size
3.4 MB
Stars
12.5K
Updated
CommitJul 03
Age
15y
Commits · 90 Days