So the site you have running through Reclaim Cloud isn't behaving quite right, maybe it's a bit slow, or you've gotten an error code, or, as can happen with WordPress sites, you're confronted with the dreaded white screen of death. You need to know what's going on so you can fix it; that's where error, or, debugging logs come into play. These logs will show you exactly what's going on with your site, from plugin failures to imperfect code, giving you someplace to start your troubleshooting efforts.
For folks who have historically used the cPanel dashboard to manage debugging efforts, attempting to map those same techniques to their favorite applications in the Reclaim Cloud environment might seem confusing at first, if not a big daunting. This article will take you through the steps necessary to set up debugging and enable error logging in some of our more popular Reclaim Cloud applications like WordPress, Omeka S, and Omeka Classic.
WordPress
We'll need to add some PHP to our wp-config.php file to enable error logging/debugging within our WordPress install.
1. Navigate to your wp-config.php file in your Reclaim Cloud dashboard; you'll find this in /var/www/webroot/ROOT/wp-config.php
2. Search for the /* That's all, stop editing! Happy publishing. */
comment and right above it paste in the following code:
define( 'WP_DEBUG', true );
You may see this line already in your wp-config.php file, but the true
value is replaced with false
. Simply switch false
to true
to enable debugging.
3. Click the (anachronistic) Save icon on the top left of your AppServer screen.
Great! Debugging is enabled.
You could be done here, but you'll likely notice that your WordPress dashboard has error/warning displays at the top of the page. That can be annoying, but in the worst of cases, you might see the same thing happen at the top of your public page, which is annoying and a security risk.
Follow the next step to get rid of these pesky notifications.
Disabling public error and warning display
4. Beneath the last line of code we changed, paste the following code block:
// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', true );
// Disable display of errors and warnings
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
Again, if this base code is already in your file, just make sure that the true
/false
values match the above code block.
Omeka S
Conceptually, completing this process in Omeka S is pretty much the same as in WordPress. You'll be locating a PHP file and making some small tweaks to the code. If you'd like your Omeka S errors to be displayed publicly when there's an issue— a more detailed error page than the generic, "Omeka S has encountered an error"— you'd have to edit the .htaccess file. While is certainly an option, keep in mind that enabling error logs through .htaccess will show public errors to any user that visits your site.
Display error messages via .htaccess
1. Navigate to the root folder of your Omeka S installation and open its .htaccess file.
2. In line 1, replace the production
value with the development
value.
3. Click the (anachronistic) Save icon on the top left of your AppServer screen.
Now when your Omeka S encounters an error, it will be detailed on the error page when attempting to load in the browser.
Enabling an error log
1. Navigate to your site's local.config.php file; you'll find this in /var/www/webroot/ROOT/config/local.config.php
2. In line 4, replace the false
value with true
.
3. Click the (anachronistic) Save icon on the top left of your AppServer screen.
You'll find your error logs in log/application.log
.
Omeka Classic
There are a few key differences to note when attempting to retrieve error messages in Omeka Classic when compared to Omeka S. While you still have the option of displaying error messages directly on the screen in your browser as well as activating error logging, these steps and files look somewhat different.
Display error messages via .htaccess
1. Navigate to line 14 of your Omeka Classic .htaccess file, which you can find at /var/www/webroot/ROOT/.htaccess, and uncomment by removing the hash (#) in front of SetEnv APPLICATION_ENV development
.
2. Click the (anachronistic) Save icon on the top left of your AppServer screen.
Enabling an error log
1. Navigate to line 87 of the config.ini file located in /var/www/webroot/ROOT/application/config/config.ini.
2. Change the value of log.errors
to true
.
3. Click the (anachronistic) Save icon on the top left of your AppServer screen.
You'll find your error logs in the errors.log
file.
Interested in enabling error logs for another application not listed above? Let us know by contacting Reclaim Hosting Support.