How to Install, Configure, and Manage PHP 8.4 with the WLNMP One‑Click Package

Introduction

This guide explains how to install, configure, and manage PHP 8.4 on Linux distributions supported by the WLNMP one‑click installation package.

Prerequisites

Follow the official WLNMP installation instructions at https://www.wlnmp.com/install.

1.1 Add required repositories

For non‑OpenCloudOS 9.x systems, enable the EPEL repository: yum install epel-release -y On AlmaLinux 9.x or RockyLinux 9.x, enable the CRB repository in addition to EPEL: dnf config-manager --set-enabled crb On OpenCloudOS 9.x, install the EPOL repository instead:

yum install epol-release -y

Note 1: Missing repositories can cause dependency errors such as nothing provides libiodbc.so.2()(64bit) , libsodium.so.26()(64bit) , or libtidy.so.58()(64bit) .

Note 2: OpenCloudOS 9.x is a self‑developed OS without an EPEL repository; EPOL must be used.

1.2 Add the WLNMP repository

curl -fsSL "https://sh.wlnmp.com/wlnmp.sh" | bash

1.3 Install PHP 8.4

Choose one of the following packages:

yum install wphp84 -y   # single PHP version

yum install wcphp84 -y  # side‑by‑side with an existing PHP version (e.g., wphp81)

Only one of the two packages should be installed.

1.4 Uninstall PHP 8.4

Remove the package that was installed:

yum remove wphp84 -y

yum remove wcphp84 -y

If wphp84 was removed, delete residual files: <code>rm -rf /usr/local/php/</code>

If wcphp84 was removed, delete residual files: <code>rm -rf /usr/local/php84/</code>

1.5 Upgrade PHP 8.4

Upgrade using the same package name you originally installed:

yum update wphp84 -y

yum update wcphp84 -y

Back up important data before upgrading. Configuration files are preserved, but the PHP 8.4 service will be restarted.

1.6 List installed files

Query the RPM database:

rpm -ql wphp84

rpm -ql wcphp84

PHP 8.4 Configuration

2.1 Configuration directories

Default configuration locations are: /usr/local/php/ (when wphp84 is installed) /usr/local/php84/ (when wcphp84 is installed)

2.2 Disabled functions

For security, the following functions are disabled in /usr/local/php/etc/php.ini or /usr/local/php84/etc/php.ini:

disable_functions = passthru,exec,system,chroot,chgrp,chown,shell_exec,proc_open,proc_get_status,popen,ini_alter,ini_restore,dl,openlog,syslog,readlink,symlink,popepassthru,stream_socket_server

2.3 Default extensions

List built‑in modules with php -m or php84 -m. A full list is available at https://www.wlnmp.com/php_extension.

2.4 Adding extra extensions

Additional modules can be installed after the base PHP 8.4 setup. See the guide at https://blog.whsir.com/post-7501.html for detailed steps.

Starting and Managing PHP 8.4

The WLNMP‑installed PHP 8.4 provides both traditional SysV init scripts and systemd unit files.

3.1 Check service status

For wphp84:

/etc/init.d/php-fpm84 status

systemctl status php-fpm84

For wcphp84:

/etc/init.d/php84-fpm status

systemctl status php84-fpm

3.2 Stop the service

For wphp84:

/etc/init.d/php-fpm84 stop

systemctl stop php-fpm84

For wcphp84:

/etc/init.d/php84-fpm stop

systemctl stop php84-fpm

3.3 Start the service

For wphp84:

/etc/init.d/php-fpm84 start

systemctl start php-fpm84

For wcphp84:

/etc/init.d/php84-fpm start

systemctl start php84-fpm

Note 1: The PHP 8.4 service does not start automatically after installation; use the commands above to start it.

Note 2: Either SysV or systemd can be used. SysV scripts support TAB completion.

Note 3: Compared with PHP 8.3, the default PHP 8.4 build does not include the pspell extension.

Conclusion

This document covers the complete lifecycle of PHP 8.4 on WLNMP‑enabled systems: adding required repositories, installing or uninstalling the appropriate package, configuring directories and security settings, managing the service, and upgrading or inspecting the installation. Users with basic Linux administration experience should find the steps straightforward.

For further details, consult the official PHP 8.4 documentation.