Skip to main content

Install PHP 8 by Compilation

Tested PlatformTested Software Version
warning

Compiling requires adequate memory.

If your device has less than 2GB of RAM, it is strongly recommended to create a swap partition first.

1. Install basic build tools​

dnf groupinstall "Development Tools"
dnf install libxml2-devel libicu-devel sqlite-devel libxslt-devel \
    libpng-devel libjpeg-devel freetype-devel libzip-devel git \
    systemd-devel curl-devel

2. Download & build Oniguruma​

cd oniguruma
./autogen.sh
./configure --bindir=/usr/sbin/ \
            --sbindir=/usr/sbin/ \
            --libexecdir=/usr/libexec \
            --sysconfdir=/etc/ \
            --localstatedir=/var \
            --libdir=/usr/lib64/ \
            --includedir=/usr/include/ \
            --datarootdir=/usr/share \
            --infodir=/usr/share/info \
            --localedir=/usr/share/locale \
            --mandir=/usr/share/man/ \
            --docdir=/usr/share/doc/onig
make
make install

3. Add user for PHP-FPM​

adduser www

4. Download PHP source code​

You can download suitable PHP for your application from the offical website: https://www.php.net/downloads

Example:

wget https://www.php.net/distributions/php-8.1.2.tar.gz
tar -xzf php-8.1.2.tar.gz

5. Configure PHP​

tip

You can find all available ./configure options in the official docs: https://www.php.net/manual/en/configure.about.php#configure.options.misc

Below is a recommended FPM-enabled configuration:

cd php-8.1.2
tip

Replace YOUR_WEB_USER with the actual PHP-FPM user (for example: www)

./configure --prefix=/usr/local/php/ \
            --enable-fpm \
            --with-openssl \
            --enable-bcmath \
            --with-curl \
            --enable-ftp \
            --enable-gd \
            --enable-mbstring \
            --enable-sockets \
            --enable-pcntl \
            --with-zlib \
            --enable-intl \
            --with-fpm-systemd \
            --enable-pdo \
            --enable-xml \
            --with-zip \
            --with-gettext \
            --with-freetype \
            --enable-opcache \
            --enable-shmop \
            --with-fpm-user=YOUR_WEB_USER \
            --with-fpm-group=YOUR_WEB_USER
--enable-mysqlnd \
--with-pdo-mysql=mysqlnd \
--with-mysqli \
--with-mysql-sock=/var/lib/mysql/mysql.sock

6. Compile & Install​

make && make install

7. Final configurations​

Rename the default .conf files to enable them.

cp PATH_TO_THE_SRC/php.ini-production /usr/local/php/php.ini
cp /usr/local/php/etc/php-fpm.d/www.conf.default /usr/local/php/etc/php-fpm.d/www.conf
cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf

(Optional) Add PHP-FPM to system-daemon (Recommanded)​

About the usage of systemd, Check systemd#BasicUsage

  1. Edit PID Location
# Open the File
vim /usr/local/php/etc/php-fpm.conf
# Find the part and Change into
pid = /var/run/php-fpm.pid
  1. Write the systemd script
# Create one and edit
vim /lib/systemd/system/php-fpm.service
  1. Then, add the content.
[Unit]
Description=The PHP FastCGI Process Manager
After=syslog.target network.target
[Service]
Type=forking
PIDFile=/var/run/php-fpm.pid
ExecStart=/usr/local/php/sbin/php-fpm
ExecReload=/bin/kill -USR2 $MAINPID
PrivateTmp=true
[Install]
WantedBy=multi-user.target
  1. Reload systemd
systemctl daemon-reload

Enjoy it!​