{"id":5427,"date":"2020-03-12T15:00:35","date_gmt":"2020-03-12T14:00:35","guid":{"rendered":"https:\/\/qodeinteractive.com\/magazine\/?p=5427"},"modified":"2021-10-20T09:03:20","modified_gmt":"2021-10-20T07:03:20","slug":"how-to-turn-on-error-logs-in-wordpress","status":"publish","type":"post","link":"https:\/\/qodeinteractive.com\/magazine\/how-to-turn-on-error-logs-in-wordpress\/","title":{"rendered":"How to Turn On Error Logs in WordPress"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]Although WordPress is relatively easy to manage, troubleshooting errors are quite a common issue for its users. Dealing with them usually isn\u2019t difficult – all it takes is a little bit of practice. The first step of every WordPress error troubleshooting is retrieving the error log. [\/vc_column_text][vc_empty_space height=”28px”][vc_column_text]The error log contains all errors, warnings, and notices about the code behind your site. It can sometimes help you pinpoint the exact file and line of code that are causing the issue. The error log can also provide clues for solving the seemingly insoluble errors, such as \u201cthe white screen of death<\/a>\u201d.[\/vc_column_text][vc_empty_space height=”28px”][vc_column_text]Making sense of the error log, however, can be quite challenging if you are not tech-savvy. To become tech-savvy, you have to start somewhere – so let\u2019s begin by showing you how to turn on and acquire the error log in WordPress. [\/vc_column_text][vc_empty_space height=”50px”][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]<\/p>\n

How to Set Up WordPress Error Logs In Your WP-Config File<\/h2>\n

[\/vc_column_text][vc_column_text]The wp-config.php file<\/a> is an important WordPress configuration file. By slightly editing it, you will enable WordPress default debugging and show errors. You can do this via an FTP client or via cPanel.[\/vc_column_text][vc_empty_space height=”42px”][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]<\/p>\n

Using an FTP Client<\/h3>\n

[\/vc_column_text][vc_column_text]A prerequisite for performing any edits on your server files is to set the file permissions properly. The suggested permissions on the wp-config.php file are 440 or 400. This means you\u2019re only permitted to read the files. To be able to acquire an error log, you need to change the file permissions<\/a> temporarily to 644 or 666. For clarification,644 gives reading and writing\/editing permissions to admin users, while the rest of users get only reading permissions. The 666 value gives both of the aforementioned types of permissions to all users.[\/vc_column_text][vc_empty_space height=”28px”][vc_column_text]To proceed you need an FTP client<\/a> and the knowledge of editing the wp-config.php file<\/a>. Start by connecting to the server using your FTP credentials<\/strong>. Navigate to your root WordPress directory<\/strong>. Locate the wp-config.php file<\/strong>, right-click on it and select the \u201cFile permissions\u201d option<\/strong>.[\/vc_column_text][vc_empty_space height=”50px”]

\n
\n \"File <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]Manually insert one of the suggested numeric values (644 or 666<\/strong>) and click on \u201cOK<\/strong>\u201d.[\/vc_column_text][vc_empty_space height=”50px”]
\n
\n \"Manually <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]After changing the permissions, go back to the root directory<\/strong>, right-click on the wp-config.php file<\/strong> and select \u201cView\/Edit<\/strong>\u201d.[\/vc_column_text][vc_empty_space height=”50px”]
\n
\n \"WP <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]Open the file using a text editor and insert this line of code:<\/strong>[\/vc_column_text][vc_empty_space height=”50px”][vc_column_text]<\/p>\n
define('WP_DEBUG', true);<\/pre>\n
[\/vc_column_text][vc_column_text]<\/p>\n
above the \/* That’s all, stop editing! Happy blogging. *\/.<\/p>\n
[\/vc_column_text][vc_empty_space height=”54px”]
\n    
\n                                    \"Wp-config\"                        <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]If the define('WP_DEBUG', false);\u00a0<\/code> line is already present, only change false into true<\/strong>.[\/vc_column_text][vc_empty_space height=”28px”][vc_column_text]Save the changes and upload the edited file to your root WordPress directory<\/strong>. This will override the file that is currently on your server.[\/vc_column_text][vc_empty_space height=”42px”][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]<\/p>\n
Via cPanel<\/h3>\n
[\/vc_column_text][vc_column_text]You can also use cPanel to edit the wp-config.php file. Log in to the cPanel<\/strong> using your credentials and click on the \u201cFile Manager<\/strong>\u201d.[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"File                        <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]Navigate to the root directory<\/strong> of your WordPress installation on the left, locate the wp-config.php file<\/strong>, right-click it and select \u201cChange Permissions<\/strong>\u201d.[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"Wp-config                        <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]Make sure to enable both reading and writing permissions<\/strong> for the (admin) user by ticking off the appropriate checkbox. Then, click on \u201cChange Permissions<\/strong>\u201d.[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"Wp-config                        <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]Afterward, right-click on the wp-config.php file<\/strong> once more and select \u201cEdit<\/strong>\u201d.[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"cPanel                        <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]The file will open in the default cPanel editor, so you only need to add the<\/strong> define('WP_DEBUG', true);<\/code> above the \/* That's all, stop editing! Happy blogging. *\/<\/code> line of code within the wp-config file.[\/vc_column_text][vc_empty_space height=”28px”][vc_column_text]If the file already contains the following line<\/strong> define('WP_DEBUG', false);<\/code>\u00a0simply change the false to true and click on \u201cSave Changes\u201d in the top-right corner of your screen.<\/strong>[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"Change                        <\/div>\n<\/div>[vc_empty_space height=”59px”][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]<\/p>\n
How to Manage Displaying Errors<\/h2>\n
[\/vc_column_text][vc_column_text]Once you successfully display the errors, they will show on your pages, both on the backend and frontend. Unless your site is in development, exposing the errors live clearly isn\u2019t a good idea. Instead, you should save them as a single file and hide them from your site. This will allow you to view the file later and troubleshoot errors at any time.[\/vc_column_text][vc_empty_space height=”28px”][vc_column_text]To do this, add this code to your wp-config.php file<\/strong>.[\/vc_column_text][vc_empty_space height=”50px”][vc_column_text]<\/p>\n
define( 'WP_DEBUG_LOG', true );\r\ndefine( 'WP_DEBUG_DISPLAY', false );\r\n@ini_set( 'display_errors', 0 );<\/pre>\n
[\/vc_column_text][vc_empty_space height=”18px”][vc_column_text]Add the code below the following line define('WP_DEBUG', true);\u00a0<\/code> and above the \/* That's all, stop editing! Happy blogging. *\/<\/code> line of code.[\/vc_column_text][vc_empty_space height=”28px”][vc_column_text]You can edit the file using an FTP client or via cPanel, following the same steps we laid out in the previous section. After the edit, your wp-config.php file should look like this.[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"Managing                        <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]By adding define( ‘WP_DEBUG_LOG’, true ); we force WordPress to store all the error messages into one file. By default, that file is called debug.log and it is located in your-WordPress-root\/wp-content\/ directory. You can also store error messages in some other file that you created. In that case, change the true from \u201cdefine( ‘WP_DEBUG_LOG’, true );\u201d to the path of the file. For example:[\/vc_column_text][vc_empty_space height=”50px”][vc_column_text]<\/p>\n
define( 'WP_DEBUG_LOG', path-to-your-site\/wp-content\/error.log );<\/pre>\n
[\/vc_column_text][vc_empty_space height=”18px”][vc_column_text]Furthermore, WP_DEBUG_DISPLAY determines whether the error messages are shown or hidden on the screen<\/strong>. By adding define( ‘WP_DEBUG_DISPLAY’, false ); you tell WordPress to hide the messages from your screen, but they are still printed to the designated file. If you also add @ini_set( ‘display_errors’, 0 ); this will disable error printing for your PHP<\/strong>, making sure that users will not be able to see them on the frontend.[\/vc_column_text][vc_empty_space height=”50px”][vc_separator color=”custom” accent_color=”#f0f0f0″][vc_empty_space height=”50px”][vc_widget_sidebar sidebar_id=”top-picks-banner”][vc_empty_space height=”28px”][vc_separator color=”custom” accent_color=”#f0f0f0″][vc_empty_space height=”60px”][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]<\/p>\n
Acquiring the Error Log<\/h2>\n
[\/vc_column_text][vc_column_text]With the errors shown and successfully written in the appropriate error log file, the only thing that remains is to review the error messages and take further steps. [\/vc_column_text][vc_empty_space height=”42px”][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]<\/p>\n
Manually Downloading debug.log File<\/h3>\n
[\/vc_column_text][vc_column_text]To download the log file connect to your server, navigate to your root WordPress folder<\/strong> and click on wp-content<\/strong>. Find the debug.log<\/strong> file inside, right-click<\/strong> on it and press \u201cDownload<\/strong>\u201d.[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"Manually                        <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]Save the file on your desktop. Then, make sure to revert the previous edits. This includes removing the code you inserted and changing the permissions on the wp-config.php file to 440 or 400. If you want, you can do this after solving the errors.[\/vc_column_text][vc_empty_space height=”28px”][vc_column_text]Finally, open the saved debug.log file with a text editor and check the error messages written. Depending on your level of expertise, you can either solve the errors yourself or hire a developer<\/a>.[\/vc_column_text][vc_empty_space height=”50px”][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]<\/p>\n
More Advanced Debugging Features<\/h2>\n
[\/vc_column_text][vc_column_text]We will also take a look at some more advanced debugging possibilities. The following code should be added in wp-config.php, above the \/* That's all, stop editing! Happy blogging. *\/<\/code> line.[\/vc_column_text][vc_empty_space height=”38px”]
\n\t        
\n            1.<\/span>\n            define( ‘SCRIPT_DEBUG’, true );<\/span>        <\/div>\n    <\/div>[vc_empty_space height=”12px”][vc_column_text]This code forces WordPress to use un-minified versions of CSS and JS files<\/strong>, which is useful for debugging changes and\/or errors found specifically in your CSS and JS files.[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"SCRIPT_DEBUG\"                        <\/div>\n<\/div>[vc_empty_space height=”48px”]
\n\t        
\n            2.<\/span>\n            define( ‘CONCATENATE_SCRIPTS’, false );<\/span>        <\/div>\n    <\/div>[vc_empty_space height=”12px”][vc_column_text]By setting CONCATENATE_SCRIPTS constant to false, you force WordPress to load all scripts separately<\/strong>. This can prove useful for pinpointing faulty\/incompatible scripts.[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"CONCATENATE_SCRIPTS\"                        <\/div>\n<\/div>[vc_empty_space height=”48px”]
\n\t        
\n            2.<\/span>\n            define( ‘SAVEQUERIES’, true );<\/span>        <\/div>\n    <\/div>[vc_empty_space height=”12px”][vc_column_text]If you are experiencing database issues, analyzing the queries that are run is a good way to start debugging. By inserting the code above you will put the query content, which function called it and for how long it was run in $wpdb->queries array<\/strong>. This will allow you to dive deeper into the backend portion of the theme\u2019s code and what it is doing exactly.[\/vc_column_text][vc_empty_space height=”50px”]
\n    
\n                                    \"More                        <\/div>\n<\/div>[vc_empty_space height=”38px”][vc_column_text]You can then add the following code to show all the queries in a readable form<\/strong> and analyze them.[\/vc_column_text][vc_empty_space height=”50px”][vc_column_text]<\/p>\n
global $wpdb;\r\nprint(\"<pre>\".print_r($wpdb->queries,true).\"<\/pre>\");<\/pre>\n
[\/vc_column_text][vc_empty_space height=”18px”][vc_column_text]However, keep in mind that this code will affect your site\u2019s performance, so we recommend using it for debugging purposes only.[\/vc_column_text][vc_empty_space height=”50px”][\/vc_column][\/vc_row][vc_row][vc_column][vc_column_text]<\/p>\n
Final Thoughts<\/h2>\n
[\/vc_column_text][vc_column_text]Following this guide, you can show and safely store error logs in a file, change file permissions, and run some debugging features intended for more advanced WordPress users. This tutorial will also help you learn more about the way your website works – so keep it close because you could need these instructions in the future.[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"
The error log contains errors, warnings, and notices about the code behind your site. In this guide, learn how to turn on the error logs in WordPress.<\/p>\n","protected":false},"author":11229,"featured_media":5486,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[4,52,13],"class_list":["post-5427","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials","tag-tips","tag-troubleshooting","tag-wordpress"],"_links":{"self":[{"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/posts\/5427","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/users\/11229"}],"replies":[{"embeddable":true,"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/comments?post=5427"}],"version-history":[{"count":0,"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/posts\/5427\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/media\/5486"}],"wp:attachment":[{"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/media?parent=5427"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/categories?post=5427"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/qodeinteractive.com\/magazine\/wp-json\/wp\/v2\/tags?post=5427"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}