Switching PHP versions on Debian with Apache2


How to set PHP version on Debian between multiple versions

If several PHP versions are installed on a Debian 10 and Debian 11 or Ubuntu 22.10, a PHP version can be set and activated for the system default and the Apache 2 HTTP web server.

Let’s assume that several PHP versions are installed on the Debian system. Now the active PHP version for CLI and Apache 2 web server should be changed. This tutorial shows how to switch between multiple PHP versions for Apache web server and CLI.

Enable a PHP version as default

PHP 8.2 should be set as the active PHP version for CLI and Apache 2 HTTP web server. This is done by disabling the Apache 2 modules for all other installed PHP versions and setting them from the CLI with the update-alternatives command.

$ update-alternatives --set php /usr/bin/php8.2
$ update-alternatives --set phar /usr/bin/phar8.2
$ update-alternatives --set phar.phar /usr/bin/phar.phar8.2

  Phar is a PHP extension that makes it possible to process programs or files packaged in PHAR format (PHP archive) from a compressed archive file. The archives created with the Phar PHP class are created in bzip2 and gzip compression.

For the Apache 2 web server, the corresponding module is activated with the Apache helper, by using the a2enmod command, use a2dismod to disable a module.

$ a2dismod php7.4
$ a2enmod php8.2
$ systemctl restart apache2

a2enmod is a script that enables the specified module within the apache 2 configuration. It does this by creating symlinks within /etc/apache2/mods-enabled. Likewise, a2dismod disables a module by removing those symlinks. It is not an error to enable a module which is already enabled, or to disable one which is already disabled.

Multiple PHP mudules can be disabled in one single command.

$ a2dismod php5.6 php7.1 php7.3 php7.4 php8.0 php8.1

The Apache HTTP server control interface can be used to output all PHP modules available on the system.

$ apache2ctl -M

For Red Hat or Rocky Linux and AlmaLinux (CentOS), the command is.

$ apachectl -M
Loaded Modules:
 core_module (static)
 mime_module (shared)
 php_module (shared)

Show all PHP modules installed on the system, here in abbreviated form.

a2query is a program for retrieving configuration values of Apache 2 HTTP web server, it returning feasible values even if the Apache 2 syntax validator fails.

$ a2query -m | grep php
php8.2 (enabled by site administrator)

You can also use find to call up and display the available Apache 2 PHP modules on the file system.

$ find /etc/apache2/mods-available/ -name *php*

The system-wide PHP settings can be found under /etc/php, for changes open the php.ini file in the editor of your choice.

$ vi /etc/php/8.2/apache2/php.ini

  Replace the appropriate version number in the directory path.

Check active PHP version

Which PHP version is active? can be obtained from CLI querying the PHP version set active on the system as follows.

$ php -v
PHP 8.2.3 (cli) (built: Feb 14 2023 16:53:07) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.3, Copyright (c) Zend Technologies
    with Zend OPcache v8.2.3, Copyright (c), by Zend Technologies

The current PHP version and modules for the Apache 2 web server are displayed by creating a php file with the following content.


The Apache 2 default-site has the DocumentRoot in /var/www/html, create the phpinfo.php file here, unless another DocumentRoot is chosen.

The current PHP version and modules for the Apache web server are displayed in the web browser. http://ip_or_fqdn/phpinfo.php

for example:

phpinfo query php version with browser

  On a production system, phpinfo.php should be removed from the DocumentRoot after the check is complete.

How useful was this post?

Click on a star to rate it!

Average rating 0 / 5. Vote count: 0

No votes so far! Be the first to rate this post.

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

Leave a Reply

Your email address will not be published. Required fields are marked *