Managing WordPress DEBUG Flags

WordPress can output debug information to a file called debug.log. However, for this to occur, certain flags need to be set in the WordPress wp-config.php file.

Enable WordPress Debug Flags in WP-CONFIG.PHP #

Go to WpCloudDeploy->All Apps
Click on the site for which this action will apply
Click on the TOOLS tab
Scroll down to the MANAGE DEBUG LOG section
Click the ENABLE IT button
Click the OK option on the confirmation popup

After a while the screen will refresh – if the operation is successful. If the operation fails, you’ll get a popup message.

You can see a full log of the operation under the SSH LOG screen.

Disable WordPress Debug Flags in WP-CONFIG.PHP #

Go to WpCloudDeploy->All Apps
Click on the site for which this action will apply
Click on the TOOLS tab
Scroll down to the MANAGE DEBUG LOG section
Click the DISABLE IT button
Click the OK option on the confirmation popup

View the debug logs for site #

Go to WpCloudDeploy->All Apps
Click on the site for which this action will apply
Click on the LOGS tab
Select debug.log from the drop-down
Click the DOWNLOAD button

Important Notes #

Do not manually delete the debug.log file from the wp-content folder unless you are ready to turn off the debug flags. Once the file is deleted, the permissions set for the file will NOT allow WordPress to re-create the file. Instead, you will need to turn off the flags and turn them back on (which will create a new blank debug file that WordPress can write to).

OpenLiteSpeed Servers #

For OpenLiteSpeed servers, you MUST use the steps described above to enable or disable WP_DEBUG. If you manually edit the wp-config.php file to add or edit the WP_DEBUG entry, the debug.log file will NOT be located in the expected location (wp-content/). Additionally, you will not be able to download log files unless the above steps are followed to enable the debug logs for a site.

Additional Resources #

Debugging In WordPress