PHP 8.1 is the current latest PHP version released on 2021. In this guide you are going to learn how to install the latest PHP version which is currently 8.1 on your Ubuntu 22.04 system or server and configure it with Apache and Nginx. By default Ubuntu 22.04 ships with PHP 8.1, you can install it easily. You will also learn how to install a different version of PHP and downgrade or upgrade your PHP version to latest or a previous one.
This tutorial also guides you to configure PHP INI settings, FPM settings, Pools, etc which is more useful for your application to run smooth.
This installation is tested on Google Cloud Platform with a Compute Compute Engine VM Instance with Ubuntu 22.04 OS. This set up will work on all Linux servers.
Prerequisites
Basic knowledge of using SSH Terminal on Linux.
Getting Started
Make sure your Ubuntu server is having the latest packages by running the following command.
sudo apt update
sudo apt upgrade
This will update the package index and update the installed packages to the latest version.
Add PHP PPA
This is an optional setup if you wish to install PHP 8.1. But you are about to install any lower versions of PHP versions like 7.4 you need to add this PPA.
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
Only add this if you are about to install a PHP version other than version 8.1.
Install PHP 8.1 for Apache
Execute the following command to install PHP 8.1.
sudo apt install php8.1
After the installation has completed, you can confirm the installation using the following command
php -v
Install PHP 8.1 FPM for Nginx
For Nginx you need to install FPM. Execute the following command to install PHP 8.1 FPM
sudo apt install php8.1-fpm
After the installation has completed, confirm that PHP 8.1 FPM has installed correctly with this command
php-fpm8.1 -v
Install PHP 8.1 Extensions
Installing PHP extensions are simple with the following syntax.
sudo apt install php8.1-extension_name
Now, install some commonly used php-extensions with the following command.
sudo apt install php8.1-common php8.1-mysql php8.1-xml php8.1-xmlrpc php8.1-curl php8.1-gd php8.1-imagick php8.1-cli php8.1-dev php8.1-imap php8.1-mbstring php8.1-opcache php8.1-soap php8.1-zip php8.1-redis php8.1-intl -y
Verify PHP Version
You can easily verify PHP version using the below command.
php -v
Output
PHP 8.1.5 (cli) (built: Apr 21 2022 10:32:13) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.5, Copyright (c) Zend Technologies
with Zend OPcache v8.1.5, Copyright (c), by Zend Technologies
Configure PHP 8.1
Now we configure PHP for Web Applications by changing some values in php.ini file.
For PHP 8.1 with Apache the php.ini location will be in following directory.
sudo nano /etc/php/8.1/apache2/php.ini
For PHP 8.1 FPM with Nginx the php.ini location will be in following directory.
sudo nano /etc/php/8.1/fpm/php.ini
Hit F6 for search inside the editor and update the following values for better performance.
upload_max_filesize = 32M
post_max_size = 48M
memory_limit = 256M
max_execution_time = 600
max_input_vars = 3000
max_input_time = 1000
Once you have modified your PHP settings you need to restart your Apache for the changes to take effect.
For users with Nginx to who use PHP-FPM, you need to restart PHP-FPM.
sudo service php8.1-fpm restart
Configure PHP 8.1 FPM Pools
PHP-FPM allows you to configure the user and group that the service will run under. You can modify these with these commands
sudo nano /etc/php/8.1/fpm/pool.d/www.conf
If you want to change the username name you can change the following lines by replacing the www-data with your username.
user = username group = username listen.owner = username listen.group = username
Hit CTRL+X and Y to save the configuration and check if the configuration is correct and restart PHP.
Restart PHP 8.1 FPM
Once you have updated your PHP FPM settings you need to restart it to apply the changes.
sudo php-fpm8.1 -t sudo service php8.1-fpm restart
Now you are having PHP 8.1 Installed and configured.
Prepare yourself for a role working as an Information Technology Professional with Linux operating system
Upgrade/Downgrade PHP in CLI
As you are switching PHP version for your web applications you will also need to change the PHP version in your CLI (Command Line Interface).
Execute the below command to change PHP version on your CLI. You will be prompted with an interactive mode to choose your PHP version.
There are 3 choices for the alternative php (providing /usr/bin/php). Selection Path Priority Status ------------------------------------------------------------ * 0 /usr/bin/php8.1 81 auto mode 1 /usr/bin/php7.4 74 manual mode 2 /usr/bin/php8.0 80 manual mode 3 /usr/bin/php8.1 81 manual mode Press <enter> to keep the current choice[*], or type selection number:
Enter you choice and hit ENTER.
Upgrade/Downgrade PHP for Apache
If you want to use a different PHP version you can upgrade or downgrade to the other PHP version as shown below..
You need to tell Apache to use the correct PHP version you installed right now. Disable the old PHP module (below I have mentioned php 8.1, you need to use your other php version used by Apache) and enable the new PHP module using the following command.
Replace the current enabled PHP version with your version.
sudo a2dismod php8.1 sudo a2enmod php7.4
Restart Apache for the changes to take effect.
sudo service apache2 restart
Upgrade/Downgrade PHP for Nginx
For Nginx you need to update or downgrade the PHP-FPM socket in your Nginx configration located inside the sites-available directory. This will be located inside the location block location ~ .php$
Edit your configuration…
sudo nano /etc/nginx/sites-available/your.conf
The line you need to modify will look like this…
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
You need to replace the old PHP version with the new version.
fastcgi_pass unix:/run/php/php7.4-fpm.sock;
Test your configration.
sudo nginx -t
Save the file and exit the editor and restart Nginx for the changes to take effect.
sudo service nginx restart
Conclusion
Now you have learned how to install PHP 8.1 on your Ubuntu 22.04 server for Apache and Nginx and also how to upgrade or downgrade to a different PHP version.
Thanks for your time. If you face any problem or any feedback, please leave a comment below.
