Take the State of PHP 2026 Survey →

Consolidate Coding Standards Policy Document View as Markdown

Accepted
Authors
Derick Rethans derick@php.net
Date
2014-12-16
Version
0.9
Source
wiki.php.net/rfc/consolidate-coding-standard-policy-document

Vote

Rewrite Coding Standards and Naming Document with Suggested Patch? closed
yes
13
no
0
13 voters
ashnazg yes 2025-01-15 14:26
bukka yes 2025-01-14 13:41
cpriest yes 2025-01-23 14:06
derick yes 2025-01-13 18:43
galvao yes 2025-01-16 15:33
girgias yes 2025-01-15 16:11
ilutov yes 2025-01-14 17:15
kalle yes 2025-01-13 20:28
kguest yes 2025-01-15 12:37
mbeccati yes 2025-01-23 07:19
ramsey yes 2025-01-14 18:56
sergey yes 2025-01-20 07:51
theodorejb yes 2025-01-15 04:32

Discussions on the mailing list

[RFC] Consolidate Coding Standards Policy Document
by Derick Rethans · 5 messages
[VOTE] [RFC] Consolidate Coding Standards Policy Document
by Derick Rethans · 2 messages

RFC text

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

Introduction

This RFC is the follow-up on the Policy Repository RFC. That RFC created the Policies Repository, but made no changes to existing documents. An item under “Future Scope” indicated that in the future these documents would be rewritten into an actual document, instead of a collection of RFCs.

Proposal

This proposal suggests adopting the changes to the Coding Standards and Naming document, and to integrate the CODING_STANDARDS.md file from the php-src repository.

The patch is available at https://github.com/php/policies/pull/11 for review. It has been converted to use BCP 14/RFC 2119 terminology (SHOULD, MUST, etc), mimicking as close as possible the original intended meaning of the text from “Coding Standards and Naming”. Specifically, the original document used “should” a lot, where it really meant MUST. Preliminary review by a select few has tweaked the terms to be as close as possible. '' The integration of the'' CODING_STANDARDS.md file followed, and only includes minor changes to the text, again, specifically to use the BCP 14/RFC 2119 terminology. In addition, a separate commit modifies some CODING_STANDARD.md language to document certain current behaviour, which the original document was never updated for, in a specific commit: https://github.com/php/policies/pull/11/commits/f534be73970355c1cffc4be17078795ee5cab5b9

As part of the RFC process, wording in the associated Pull Request can be updated, up until the vote opens. Deviations to currently documented guidelines will remain in a separate commit before merging.

Proposed Voting Choices

2/3rds majority required. The vote runs until January 28th, 16:00 UTC.

Vote: Rewrite Coding Standards and Naming Document with Suggested Patch? — yes: 13 · no: 0 (closed)

Patches and Tests

- The patch is at https://github.com/php/policies/pull/11, and includes previous changes to the text as found by early contributors.

References

- The original Policy Repository RFC: https://externals.io/rfc/policy-repository