Take the State of PHP 2026 Survey →

Policy Repository View as Markdown

Accepted
Authors
Derick Rethans derick@php.net
Date
2023-12-04
Version
0.9
Source
wiki.php.net/rfc/policy-repository

Vote

Do we want all the policies in one place in a Git repository? closed
yes
31
no
0
31 voters
alcaeus yes 2024-01-09 08:14
ashnazg yes 2024-01-10 17:07
beberlei yes 2024-01-14 17:39
bukka yes 2024-01-15 10:58
crell yes 2024-01-05 16:48
derick yes 2024-01-05 16:47
devnexen yes 2024-01-16 17:01
geekcom yes 2024-01-09 14:05
girgias yes 2024-01-05 17:10
heiglandreas yes 2024-01-05 20:39
ilutov yes 2024-01-05 19:40
jimw yes 2024-01-07 05:47
kocsismate yes 2024-01-06 12:49
marandall yes 2024-01-05 18:12
mbeccati yes 2024-01-09 08:31
nicolasgrekas yes 2024-01-11 19:48
nielsdos yes 2024-01-05 17:00
petk yes 2024-01-05 18:48
pierrick yes 2024-01-16 19:35
ramsey yes 2024-01-06 05:27
saki yes 2024-01-15 15:24
santiagolizardo yes 2024-01-20 13:20
sebastian yes 2024-01-13 06:20
sergey yes 2024-01-05 16:49
stas yes 2024-01-07 00:37
svpernova09 yes 2024-01-22 15:30
theodorejb yes 2024-01-22 16:24
thorstenr yes 2024-01-29 10:00
timwolla yes 2024-01-05 17:58
trowski yes 2024-01-17 05:47
weierophinney yes 2024-01-07 13:36

Discussions on the mailing list

[RFC] [VOTE] Add 4 new rounding modes to round() function
by Jorg Sowa · 10 messages
[RFC] Collecting All Policies Into One Repository
by Derick Rethans · 7 messages
[VOTE] [RFC] Collecting All Policies Into One Repository
by Derick Rethans · 2 messages
[RFC] Consolidate Coding Standards Policy Document
by Derick Rethans · 5 messages

RFC text

Copied from wiki.php.net, last synchronized Oct 13, 2026 11:50 UTC

Introduction

Currently, policies in regard to RFC Voting, the Release Process, security classification, and naming guidelines are all recorded in different places. In RFCs, through amending RFCs (think “Abolish Short Votes”), etc. This makes it sometimes hard to find out what is expected, and how things are supposed to be.

Proposal

This proposal suggests to set up a new Git repository to collect all the policies that we have.

Similarly, the canonical security classification will move from https://github.com/php/php-src/blob/master/SECURITY.md to the new repository, with the former only explaining how to file security issues instead.

To amend a policy a Pull Request must be raised against this repository. An RFC with considerations and arguments, as we have for all changes, are then created to approve the Pull Request. The text of the policy change rests solely in the Pull Request, with the RFC providing explanatory notes.

Changes to the policy repository should only be made through a new RFC, unless it is for fixing spelling mistakes or grammar.

Proposed PHP Version(s)

As this is not for a specific PHP version, it is not targeting one either.

Backwards Compatibility Breaks

None in code, but PHP RFC: Release cycle update needs to be partially redone to work with this new policy repository.

Future Scope

Once (and if) this RFC is accepted, a first new step would be to rephrase the text so that it reads like a policy document, instead of an RFC. The wording is currently exactly as in the used RFCs, without modification.

Integrate https://github.com/php/php-src/blob/master/CODING_STANDARDS.md into the coding-standards policy file.

Both of these will be implemented through a separate PR to the policy repository. After comment integration, an RFC will be created to confirm these changes.

Voting Choices

2/3rds majority required. Voting runs until January 22nd, 2024, 08:00 UTC.

Vote: Do we want all the policies in one place in a Git repository? — yes: 31 · no: 0 (closed)

Patches and Tests

A preliminary repository has been set up at https://github.com/php/policies

It currently contains information from the following documents:

Releases and Security

RFC Votes

Support Timelines

Naming Things

References

Links to external references, discussions or RFCs