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.
- For general steps to troubleshoot problems in WHMCS, see Start Troubleshooting.
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: January 8, 2025