How to Install Apache with PHP-FPM on CentOS 8

The common way to run PHP with Apache is the mod_php module. But PHP-FPM has several advantages over this. The PHP-FPM (FastCGI Process Manager) dramatically increases the performance of your Apache/PHP environment. So this is useful for high load websites. This tutorial will help you to configure PHP-FPM with Apache on CentOS 8 and RHEL 8 Linux system.

Prerequsities

• Shell access to the CentOS 8 system with sudo privileges account.
• Complete initial server setup for newly installed systems.

Step 1 – Install Apache

The Apache packages are available under the default AppStream repository. You can simply update the DNF cache and install Apache web server packages using the following commands.

sudo dnf update 
sudo dnf install httpd httpd-tools mod_ssl

The mod_ssl package provides the functionality to use an SSL certificate for secure HTTP. After installation, enable the httpd service and start.

sudo systemctl enable httpd
sudo systemctl start httpd

Step 2 – Install PHP with PHP-FPM

The Remi repository contains the latest PHP packages for the CentOS 8 Linux system. So first of all, you need to add the REMI repository to your system. Just execute the following command to add the repository.

sudo dnf install dnf-utils http://rpms.remirepo.net/enterprise/remi-release-8.rpm

Then enable the required DNF module for PHP installation. Here we are enabling the module for installing PHP 7.4. You can change this to PHP 7.3 or PHP 7.2 as per your requirements.

sudo dnf module reset php
sudo dnf module enable php:remi-7.4

Now, install the PHP on your system. As we are going to use FastCGI Process Manager (FPM) for this setup. So install the php-fpm package as well.

sudo dnf update
sudo dnf install php php-fpm  php-gd php-mysqlnd

You may also require some more PHP modules, So install them before going next. After completing PHP installation enable PHP-FPM service and start it.

sudo systemctl enable php-fpm
sudo systemctl start php-fpm

Make sure the php-fpm service is running.

sudo systemctl status php-fpm

● php-fpm.service - The PHP FastCGI Process Manager
   Loaded: loaded (/usr/lib/systemd/system/php-fpm.service; disabled; vendor preset: disabled)
   Active: active (running) since Mon 2019-12-09 21:44:57 PST; 1h 24min ago
 Main PID: 29280 (php-fpm)
   Status: "Processes active: 0, idle: 5, Requests: 3, slow: 0, Traffic: 0req/sec"
    Tasks: 6 (limit: 10321)
   Memory: 24.6M
   CGroup: /system.slice/php-fpm.service
           ├─29280 php-fpm: master process (/etc/php-fpm.conf)
           ├─29281 php-fpm: pool www
           ├─29282 php-fpm: pool www
           ├─29283 php-fpm: pool www
           ├─29284 php-fpm: pool www
           └─29285 php-fpm: pool www

Dec 09 21:44:57 tecadmin.example.com systemd[1]: Starting The PHP FastCGI Process Manager...
Dec 09 21:44:57 tecadmin.example.com systemd[1]: Started The PHP FastCGI Process Manager.

Step 3 – Configure PHP-FPM

At this step, you have installed all the required packages. Let’s start the configuration process. First, edit PHP-FPM configuration file for Apache:

sudo vim /etc/php-fpm.d/www.conf

Make the changes like below. The latest versions of Apache can connect to the socket using a proxy. So make sure listen is set to a socket file.

Then set user and group the same as Apache server using. If you need to connect FPM from a remote system change listen.allowed_clients to LAN IP instead of 127.0.0.1.

; listen = 127.0.0.1:9000 listen = /run/php-fpm/www.sock user = apache group = apache listen.allowed_clients = 127.0.0.1 listen.owner = apache listen.group = apache listen.mode = 0660 pm = dynamic1234567891011; listen = 127.0.0.1:9000listen = /run/php-fpm/www.sock user = apachegroup = apache listen.allowed_clients = 127.0.0.1listen.owner = apachelisten.group = apachelisten.mode = 0660pm = dynamic

After making changes restart the php-fpm service to apply changes.

sudo systemctl restart php-fpm

Step 4 – Create Apache VirtualHost

Now, the time is to configure Apache to use php-fpm for processing PHP files. Here is two options, Either you use FPM as default for all virtual hosts or you can specifically configure Virtual host to use FPM. In this way, other virtual hosts will not be affected.

For this example, I am configuring FPM for a specific virtual host only. So edited configuration file in text editor:

sudo vim /etc/httpd/conf.d/example.com.conf

Now added proxy configuration using a socket file. Also configured all PHP script to use fpm handler for execution.

<VirtualHost *:80> ServerAdmin [email protected] DocumentRoot /var/www/html ServerName example.com ServerAlias www.example.com # Proxy declaration <Proxy "unix:/run/php-fpm/www.sock|fcgi://php-fpm"> # we must declare a parameter in here (doesn't matter which) or # it'll not register the proxy ahead of time ProxySet disablereuse=off # Note: If you configure php-fpm to use the "pm = ondemand" #then use "ProxySet disablereuse=on" </Proxy> <FilesMatch \.php$> SetHandler proxy:fcgi://php-fpm </FilesMatch> ErrorLog logs/example.com-error.log CustomLog logs/example.com-access.log combined </VirtualHost>12345678910111213141516171819202122232425<VirtualHost *:80>    ServerAdmin admin@example.com    DocumentRoot /var/www/html     ServerName example.com    ServerAlias www.example.com     # Proxy declaration    <Proxy "unix:/run/php-fpm/www.sock|fcgi://php-fpm">       # we must declare a parameter in here (doesn't matter which) or        # it'll not register the proxy ahead of time        ProxySet disablereuse=off        # Note: If you configure php-fpm to use the "pm = ondemand"        #then use "ProxySet disablereuse=on"     </Proxy>      <FilesMatch \.php$>           SetHandler proxy:fcgi://php-fpm     </FilesMatch>     ErrorLog logs/example.com-error.log    CustomLog logs/example.com-access.log combined</VirtualHost>

Save the virtual host configuration file and reload Apache to apply changes.

sudo systemctl restart httpd

Step 5 – Enable Firewall Rules

Your server is ready to serve the application. If there is a firewall enabled on your system, make sure Apache ports are open to access from remote systems.

The following commands will open the required ports for you.

sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --zone=public --permanent --add-service=https
sudo firewall-cmd --reload

Step 6 – Test Setup

All done. To test the environment, create a PHP script with phpinfo() function. Place this file to your server document root. Use the below command to do this.

echo "<?php phpinfo(); ?>" > /var/www/html/info.php

Then access info.php using server IP address (for default VirtualHost) for your configured domain in Apache VirtualHost.

http://localhost/info.php

Conclusion

You have successfully configured an Apache with PHP-FPM on your CentOS 8 or RHEL 8 Linux system. You can now host a website from your server.