Commit 090b1cf229f for php.net
commit 090b1cf229f502c70b90589a9f4f050cd5c4fcfa
Author: Sergey Panteleev <sergey@php.net>
Date: Thu Apr 24 18:53:11 2025 +0300
[ci skip] Update PHP Release Process (#18342)
diff --git a/docs/release-process.md b/docs/release-process.md
index eaaa8f76af8..5d603a22f07 100644
--- a/docs/release-process.md
+++ b/docs/release-process.md
@@ -74,7 +74,7 @@ releases.
> When you are unsure about anything, ask a previous RM before proceeding.
> Ideally, make sure a previous RM is available to answer questions during
> the first few releases of your version. For the steps related to the
- > `web-php`, `web-qa`, and `web-php-distributions` repositories, try to have
+ > `web-php` and `web-php-distributions` repositories, try to have
> someone from the webmaster team on hand.
5. Verify the tags to be extra sure everything was tagged properly.
@@ -360,11 +360,10 @@ slightly different steps. We'll call attention where the steps differ.
## Announcing a non-stable release (alpha/beta/RC)
-1. Switch to your local clone of the `web-qa` repository and update the
+1. Switch to your local clone of the `web-php` repository and update the
information in the `$QA_RELEASES` array in `include/release-qa.php`.
Follow the documentation in the file for editing the QA release information.
- See also [Announce 8.1.0RC3][] and [8.1.6RC1][] for examples.
Add, commit, and push your changes, when finished.
@@ -717,20 +716,7 @@ slightly different steps. We'll call attention where the steps differ.
```shell
./bin/news2html 'https://github.com/php/php-src/raw/php-X.Y.Z/NEWS' 'X.Y.Z' 'ChangeLog-X.php'
```
-
-9. Review all the changes in `web-php`, commit, and push them.
-
- ```shell
- git add -p
- git add archive/entries/*.xml releases/*.php
- git commit --gpg-sign=YOURKEYID -m "Announce PHP X.Y.Z"
- git push upstream master
- ```
-
- See [Announce PHP 8.1.6][] for an example commit.
-
-10. Switch to your local clone of the `web-qa` repository and update the
- information in the `$QA_RELEASES` array in `include/release-qa.php`.
+8. Update the information in the `$QA_RELEASES` array in `include/release-qa.php`.
The array probably contains information about the RC released two weeks ago
in preparation for the current release. Since the current release is now GA,
@@ -738,18 +724,20 @@ slightly different steps. We'll call attention where the steps differ.
It is sufficient to set the `number` property for the release to `0` to
stop displaying the RC build on the QA website. You may also remove the
- sha256 hashes for the RC tarballs, but it's not necessary. For an example,
- see [PHP 8.1.6 released][].
+ sha256 hashes for the RC tarballs, but it's not necessary.
- Add, commit, and push your changes, when finished.
+9. Review all the changes in `web-php`, commit, and push them.
```shell
git add -p
- git commit --gpg-sign=YOURKEYID -m "PHP X.Y.Z released"
+ git add archive/entries/*.xml releases/*.php
+ git commit --gpg-sign=YOURKEYID -m "Announce PHP X.Y.Z"
git push upstream master
```
-11. 🚨 **Before sending announcement emails, check to make sure the websites have
+ See [Announce PHP 8.1.6][] for an example commit.
+
+10. 🚨 **Before sending announcement emails, check to make sure the websites have
synced.**
* Make sure the tarballs are available from, e.g.,
@@ -761,8 +749,8 @@ slightly different steps. We'll call attention where the steps differ.
e.g., https://www.php.net/ChangeLog-8.php
* Is there a release page for the new version?
e.g., `https://www.php.net/releases/X_Y_Z.php`
- * Does the RC for this version still appear on the QA home page?
- https://qa.php.net
+ * Does the RC for this version still appear on the Release Candidate Builds page?
+ https://www.php.net/release-candidates.php
Keep in mind it may take up to an hour for the websites to sync.
@@ -987,21 +975,22 @@ volunteers to begin the selection process for the next release managers.
## New release manager checklist
-1. Request membership to the
+1. Fill out [the form](https://www.php.net/git-php.php)
+ to get a PHP account (if you don't already have one).
+
+2. Request membership to the
[release managers group](https://github.com/orgs/php/teams/release-managers) on GitHub.
-2. Subscribe to the php-announce@lists.php.net mailing list by emailing
+3. Subscribe to the php-announce@lists.php.net mailing list by emailing
php-announce+subscribe@lists.php.net
-3. Email systems@php.net to get setup for access to downloads.php.net, to be
+4. Email systems@php.net to get setup for access to downloads.php.net, to be
added to the release-managers@php.net distribution list, and to be added to
the moderators for php-announce@lists.php.net so you are able to moderate
your release announcements.
Provide the following information in a single email:
- - Preferred Unix username (will also become part of location to download RCs,
- such as `https://downloads.php.net/~derick/`).
- An SSH public key, preferably a new unique one for PHP systems and
projects.
- Read [Machine Access](https://wiki.php.net/systems#machine_access) to set
@@ -1022,7 +1011,7 @@ volunteers to begin the selection process for the next release managers.
> "[Send emails from a different address or alias][]."
-4. Create a [GPG key][] for your @php.net address.
+5. Create a [GPG key][] for your @php.net address.
> 💡 **Tip** \
> If you're new to GPG, follow GitHub's instructions for
@@ -1087,11 +1076,10 @@ volunteers to begin the selection process for the next release managers.
git push
```
-5. Make sure you have the following repositories cloned locally:
+6. Make sure you have the following repositories cloned locally:
* https://github.com/php/php-src
* https://github.com/php/web-php
- * https://github.com/php/web-qa
* https://github.com/php/web-php-distributions
@@ -1106,13 +1094,10 @@ volunteers to begin the selection process for the next release managers.
[Update NEWS for PHP 8.2.0RC6]: https://github.com/php/php-src/commit/4ccc414961a70200d638ca281a35f893226d74e2
[PHP 8.3 is now for PHP 8.3.21-dev]: https://github.com/php/php-src/commit/b57f425cfe20a11003253427424cc0517483550b
[GitHub command line tool]: https://cli.github.com
-[Announce 8.1.0RC3]: https://github.com/php/web-qa/commit/f264b711fd3827803b79bbb342959eae57ea502b
-[8.1.6RC1]: https://github.com/php/web-qa/commit/e6d61ad7a9d8be0b1cd159af29f3b9cbdde33384
[merged upwards as usual]: https://wiki.php.net/vcs/gitworkflow
[Update versions for PHP 8.1.7]: https://github.com/php/php-src/commit/d35e577a1bd0b35b9386cea97cddc73fd98eed6d
[Update NEWS for PHP 8.1.7]: https://github.com/php/php-src/commit/b241f07f52ca9f87bf52be81817f475e6e727439
[Announce PHP 8.1.6]: https://github.com/php/web-php/commit/9f796a96c65f07e45845ec248933bfb0010b94a9
-[PHP 8.1.6 released]: https://github.com/php/web-qa/commit/bff725f8373cf6fd9d97ba62a8517b19721a4c2e
[feature freeze]: https://en.wikipedia.org/wiki/Freeze_(software_engineering)
[Prepare for PHP 8.2]: https://github.com/php/php-src/commit/1c33ddb5e5598c5385c4c965992c6e031fd00dd6
[Prepare for PHP 8.2 (bis)]: https://github.com/php/php-src/commit/a93e12f8a6dfc23e334339317c97aa35356db821