PHPC-2381: Allow releasing pre-release versions through the release automation

[alcaeus]

PHPC-2381

This PR adds support for alpha and beta releases in the automated release tool. Note that since PECL doesn't have a stability constant for release candidates, so I haven't yet added support for them. However, it should be easy enough to add in case we want to do so.

This changes the version flow in phongo_version.h slightly. When setting the version information for a release (i.e. the "Package x.y.z" commit), the update-version tool exclusively uses the version given in the prompt. This version needs to be in valid PEAR version format, which omits a dash before the stability (e.g. 1.20.0alpha1 instead of 1.20.0-alpha1). The update-version tool also expects the release version to match the information already in phongo_version.h. For example, if the version is 1.19.4dev, it will only be able to release 1.19.4 including its pre-releases. Any other versions will yield an error.

After the release is done, the version is updated to the next version depending on the stability. For stable releases, the version is bumped to the next patch release. For all other stabilities, the release version is set back to a dev version of the same number, but the build number is increased. For example:

• 1.19.4 becomes 1.19.5dev, with the build number reset to 0
• 1.19.4alpha1 or 1.19.4beta1 become 1.19.4dev with the build number increased

I've tested creating an alpha and a beta release and things work as expected 👍

[jmikola]

Shouldn't release candidates also be considered a prerelease? Those historically used "beta" stability in PECL.

[alcaeus]

Note that since PECL doesn't have a stability constant for release candidates, so I haven't yet added support for them. However, it should be easy enough to add in case we want to do so.

I'll take this as a "yes, let's support release candidates". I'll update the tooling accordingly 👍

[alcaeus]

Added support for release candidates. To be consistent with previous releases, release candidates use an upper-cased RC suffix, unlike alpha and beta which are lowercased.

The action also includes a sanity check for the version format, and I've removed the manual release instructions as these do not allow publishing any SSDLC assets.