There are two ways to install PHP packages with XBPS:
- Using the versioned packages (recommended).
- Using the meta-packages.
It is generally recommended to use versioned PHP packages (e.g.
php8.1-apcu, etc.) for most use cases as this ensures a consistent environment
on updates with minimal or no intervention required.
In Void, the
php package is a meta-package that points to the latest upstream
PHP version. This convention is followed by all packages prefixed with
php-fpm, as well as
composer. See the
for a complete list. It is recommended to only use these meta-packages for
When using a PHP meta-package, be warned that updating may require manual
intervention if a new major PHP version has been added to the repository. As a
part of the version change, the configuration location will change to reflect
the new version. For example, upgrading from 8.0 to 8.1 would result in the
configuration path changing from
customizations that have been made need to be manually applied to the new
php-fpm updates require special care since they include a runit service. In
this case, ensure that the new runit service is started and that applications
using the previous version of
php-fpm can access the new
In particular, make sure any applications accessing the FPM instance have the
correct TCP/unix socket address.