This repository contains a list of policies that the PHP Project has adopted through its RFC process to govern releases, voting, and naming guidelines.
It contains the following items:
- Release Process: When releases are made, how they are named, our policy on version numbers, and the process on making releases.
- Feature Proposals (RFCs): How to propose new features to PHP.
- Coding Standards: How to name new classes, methods, extensions, and functions.
- Security Classification: What we consider as security issues, their severity, and how to report issues.
- Security Policies and Process: Policies and process on how and when to update the security.txt file on https://www.php.net.
- Third-Party code: The circumstances under which the PHP project will use PHP code written by third parties in the ecosystem.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in these documents are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.
The files in this documentation are formatted using the rstfmt tool, which you can install with:
python3 -m venv ~/install/rstfmt ~/install/rstfmt/bin/pip3 install rstfmt sudo ln -s ~/install/rstfmt/bin/rstfmt /usr/local/bin/rstfmt
Please run the tool before submitting a pull request:
rstfmt -w 80 *.rst