First, determine: do you need to „install an extension“ or „load a Loader“?
When a WordPress plugin or theme reports a missing PHP feature, there are usually two cases: first, a missing Debian/PHP package, such as Imagick, SOAP, or BCMath; second, a commercial theme, plugin, or encrypted component that provides its own.soLoader, which must be loaded in the PHP-FPM configuration. Neither case can be resolved by modifying WordPress database settings.
PHP 8.3 components installed by default with WP Panel
The official WP Panel installation script installs the following common PHP 8.3 extensions by default:
mysql、curl、gd、exifmbstring、xml、zip、intlredis、opcache
Also installedphp8.3-fpm 和 php8.3-cliare runtime components. The default environment is sufficient to run most blogs, corporate sites, and common WordPress plugins, but it does not preinstall all PHP extensions for a few edge cases.
Extensions installable from the panel in v1.10.0
imagick: Advanced image processing, commonly used by commercial themes, image optimization, and media processing plugins.soap: Payment, logistics, and third-party SOAP service interfaces.bcmath: High-precision monetary calculations and payment/e-commerce plugins.gmp: Some encryption and mathematical computation components.memcached: Memcached object cache client.
Open „Software Management → PHP Extensions“ to view the complete list of extensions currently loaded by PHP-FPM, as well as the package status of the five extensions above. The panel only provides installation, not removal; extensions are server-level shared capabilities, and other websites and system dependencies must be assessed before removal.
How to install extensions not supported by the panel yourself
If an extension is not in the panel's five-item installation list, first confirm whether a trusted package is available for PHP 8.3 and Debian 13. Install it via SSH as root or a sudo administrator, for example:
sudo apt update
sudo apt install -y php8.3-xxx
sudo systemctl reload php8.3-fpm
php-fpm8.3 -m
把 xxxReplace with the actual extension name. Package naming is not a fixed rule; before installation, refer to the extension's official documentation and the current software sources. PECL, source-compiled extensions, ionCube, SourceGuardian, and theme-bundled Loaders cannot use the above command directly.
Configuration of third-party Loaders
If the official documentation requires usingextension=/path/to/module.so 或 zend_extension=/path/to/loader.so, you can enter it in the custom configuration area under „Software Management → PHP“. This configuration applies to PHP-FPM and is not automatically synchronized to the CLI.
If.soIf it is located in the website WebRoot or a directory writable by the website user, the panel will display a high-risk warning when saving, and explicit confirmation by the administrator is required. Do not download Loaders from unknown sources, and do not interpret „syntax check passed“ as meaning the third-party extension is secure or that every parameter is valid.
Post-installation checks
- Check the extensions loaded by PHP-FPM under „Software Management → PHP Extensions“.
- If an extension is installed but not loaded, check the PHP 8.3-FPM configuration and error logs.
- Confirm that the theme or plugin requirements match the current PHP 8.3 version, then clear the WordPress, Redis, or OPcache caches.
- When a PHP-FPM reload is involved, it is recommended to perform it during off-peak hours, as it is a server-level service and may briefly affect all websites.
If you only need to install Imagick, SOAP, BCMath, GMP, or Memcached, use the panel entry first; for other extensions or commercial Loaders, handle them manually according to the vendor's documentation and keep a recoverable configuration.