Skip to content
Open
Changes from 1 commit
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
5e4a08c
Add changes to the release process
bukka May 9, 2025
b92c3c0
Reword minor version changes (feedback from Tim)
bukka May 9, 2025
9b9c4f2
Define BC and fix typo
bukka May 9, 2025
b338ee2
Update formatting
bukka May 12, 2025
a706a85
Address feedback and properly use key words
bukka May 13, 2025
20dc00d
Update syntaxt backward compatiblity note
bukka May 13, 2025
c897ed7
Add note about UPGRADING and extend symbol rule
bukka May 13, 2025
5a4bdb7
Move notation from coding standard and update updated by
bukka May 13, 2025
20445c7
Move source to note
bukka May 13, 2025
5510a61
Usa table for sources
bukka May 13, 2025
22cabf3
Update table formatting
bukka May 13, 2025
dfa7a39
Fix formatting a bit more
bukka May 13, 2025
6eda868
Fix table formatting
bukka May 13, 2025
e54b88b
Address feedback from Ilija and Jorg
bukka May 27, 2025
2ab125c
Update major version list
bukka May 27, 2025
7907392
Add notes about SAPI support and removal
bukka Jun 10, 2025
a6cd532
Extend recommendations for minor version breaks
bukka Jun 24, 2025
d9acb51
Use "these documents" in README
bukka Jun 24, 2025
1bc0718
Add minor changes to the rules to address latest comments
bukka Jul 16, 2025
401fde1
Fix CS
bukka Jul 16, 2025
a8512e7
Remove superfluous the
bukka Jul 16, 2025
97833c8
Update rules for security branches fixes
bukka Jul 22, 2025
66f4ed7
Update the Backward Compatibility definition
bukka Aug 1, 2025
f29eda3
Add major version bump info
bukka Aug 1, 2025
933f593
Update valid interpretation
bukka Aug 1, 2025
0f5048d
Move the BC about bugs to exception
bukka Aug 1, 2025
2081c38
Fix wording in patch version rulse
bukka Sep 9, 2025
26b7c18
Extend and improve BC breaks and some other parts
bukka Sep 9, 2025
053be25
Use maintained instead of preserved
bukka Sep 9, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions release-process.rst
Original file line number Diff line number Diff line change
Expand Up @@ -119,12 +119,14 @@ Major Version Number

- x.y.z to x+1.0.0

- It SHALL include bugfixes and new features.
- It SHOULD include bugfixes and new features.
- Extensions support MAY be ended (moved to PECL).
- SAPI support MAY be ended (removed from the php-src repository).
- Userland API backward compatibility MAY be broken.
- Internal API backward compatibility MAY be broken.
- ABI backward compatibility MAY be broken.
- Internal API backward compatibility MAY be broken.
- Userland API backward compatibility MAY be broken.
- The significant userland API backward compatibility breaks SHOULD be
preceded by the deprecation phase in the previous major version.

Minor Version Number
====================
Expand All @@ -137,6 +139,10 @@ Minor Version Number

- SAPI support is RECOMMENDED to be kept.

- Internal API compatibility breaks are NOT RECOMMENDED.

- ABI backward compatibility MAY be broken.

- Syntax backward compatibility SHOULD be preserved - every PHP program that
compiles SHOULD continue to compile.

Expand All @@ -150,12 +156,6 @@ Minor Version Number
the current and upcoming PHP versions. Such adjustments SHOULD be feasible
with basic tooling and not require complex static analysis.

- Userland API backward compatibility breaks SHOULD be limited to
extensions, or the API of functions within an extension.

- Internal API compatibility breaks are NOT RECOMMENDED.

- ABI backward compatibility MAY be broken.

Patch Version Number
====================
Expand Down
Loading