Troubleshooting PHP
If you encounter errors or issues with PHP in your WHMCS installation, see the sections below to start troubleshooting and resolve the issue.
For more information, see PHP Errors and Exceptions.
PHP Configuration
You may encounter the following common issues:
| Error or Issue | Explanation | Next Steps |
|---|---|---|
Allowed memory size of xxxxx bytes exhausted (tried to allocate xxxx bytes) | WHMCS has reached maximum amount of memory available to PHP on your server. | Allowed Memory Exhausted Errors |
Fatal error: Uncaught Error: Class "Laminas\ZendFrameworkBridge\Autoloader" not found in /path/to/whmcs/vendor/laminas/laminas-zendframework-bridge/src/autoload.php:9 | The OPcache PHP extension is enabled on your server and contains stale cache data. | OPcache Warnings |
Legacy Smarty Tags: The system detected that legacy Smarty tags may be in use and that the Allow Smarty PHP Tags setting is enabled. | This error indicates that your system uses legacy Smarty PHP tags or Allow Smarty PHP Tags is enabled. | Legacy Smarty Tags Errors |
Gateway Activation Failed | This error often occurs because the OPcache PHP extension is enabled on the WHMCS installation’s server. | OPcache Warnings |
PHP Fatal error: Class 'xxxx' not found in /path/to/whmcs/vendor/whmcs/whmcs-foundation/lib/Exception/Handler/ExceptionLoggingTrait.php on line 0 | A core WHMCS file is missing. | ExceptionLoggingTrait Errors |
Required function is not available | This error indicates that a necessary function is not installed on the server or is disabled in the configuration. | Required Function Errors |
Segmentation fault | This error does not directly relate to the WHMCS software and can occur for many different reasons. | Segmentation Fault Errors |
TypeError: Return value of convertIniSize() must be of the type int Error, float returned in /path/to/whmcs/includes/functions.php | The PHP configuration that WHMCS uses contains an invalid post_max_size value. | TypeError convertIniSize Errors |
TypeError: Return value of WHMCS\File::guessFileExtension() must be of the type string, null returned in /path/to/whmcs/vendor/whmcs/whmcs-foundation/lib/File.php | The fileinfo function is missing or disabled in your server’s PHP configuration. | TypeError convertIniSize Errors |
PHP Version
For more information, see PHP Version Compatibility.
You may encounter the following common issues:
| Error or Issue | Explanation | Next Steps |
|---|---|---|
InvalidArgumentException: Data missing in /path/to/whmcs/cs/vendor/nesbot/carbon/src/Carbon/Carbon.php:425 | Your system’s PHP version is not compatible with your current WHMCS version. | InvalidArgumentException Carbon Errors |
Last modified: December 4, 2024