How to Install Nginx with PHP-FPM on CentOS 8

Written by Rahul, Updated on March 7, 2020

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

Prerequsities

The newly installed system’s recommended to follow initial server setup.
Shell access to the CentOS 8 system with sudo privileges account.

Step 1 – Install Nginx

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

sudo dnf update 
sudo dnf install nginx

After installation of packages starts Nginx service, Also enable Nginx service to auto-start on system boot.

sudo systemctl enable nginx
sudo systemctl start nginx

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:

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

Make the changes like below. The latest versions of Nginx 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 Nginx 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 = www-data
group = www-data

listen.allowed_clients = 127.0.0.1
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
pm = dynamic

; listen = 127.0.0.1:9000

listen = /run/php-fpm/www.sock

user = www-data

group = www-data

listen.allowed_clients = 127.0.0.1

listen.owner = www-data

listen.group = www-data

listen.mode = 0660

pm = dynamic

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

sudo systemctl restart php-fpm

Step 4 – Create Nginx Server Block

Now, create a server block in Nginx for your domain and configure it to use php-fpm for processing PHP files. Create a server block file and edit in a text editor:

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

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

server {
	listen       80 default_server;
	server_name  example.com www.example.com;
	root         /var/www/html;

	# Load configuration files for the default server block.
	include /etc/nginx/default.d/*.conf;

	location / {
	}

	location ~* \.php$ {
		# With php-fpm unix sockets
		fastcgi_pass unix:/run/php-fpm/www.sock;
		include         fastcgi_params;
		fastcgi_param   SCRIPT_FILENAME    $document_root$fastcgi_script_name;
		fastcgi_param   SCRIPT_NAME        $fastcgi_script_name;
	}
}

server {

listen 80 default_server;

server_name example.com www.example.com;

root /var/www/html;

# Load configuration files for the default server block.

include /etc/nginx/default.d/*.conf;

location / {

}

location ~* \.php$ {

# With php-fpm unix sockets

fastcgi_pass unix:/run/php-fpm/www.sock;

include fastcgi_params;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

fastcgi_param SCRIPT_NAME $fastcgi_script_name;

}

Save the server block configuration file and restart the Nginx service to apply changes.

sudo systemctl restart nginx

Step 5 – Enable Firewall Rules

Your server is ready to serve the application. If there is a firewall enabled on your system, make sure HTTP 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 the Nginx server block.

http://localhost/info.php

Slide down the page and check value of $_SERVER[‘SERVER_SOFTWARE’] under PHP Variables section. This will show you the Web server name running on.

Conclusion

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