Changeset 44453 for trunk/src/wp-includes/load.php

Timestamp:

01/08/2019 03:41:38 AM (6 years ago)

Author:

pento

Message:

Bootstrap: Allow WP_DEBUG_LOG to override the debug.log location.

Setting WP_DEBUG_LOG to a file path will now cause the debug log to be written to that file, rather than the default WP_CONTENT_DIR/debug.log.

Props SergeyBiryukov, ethitter, sebastian.pisula, nacin.
Fixes #18391.

File:

• trunk/src/wp-includes/load.php (modified) (2 diffs)

trunk/src/wp-includes/load.php

@@ -308 +308 @@
  * as false will force errors to be hidden.
  *
- * When `WP_DEBUG_LOG` is true, errors will be logged to debug.log in the content
- * directory.
+ * When `WP_DEBUG_LOG` is true, errors will be logged to `wp-content/debug.log`.
+ * When `WP_DEBUG_LOG` is a valid path, errors will be logged to the specified file.
  *
  * Errors are never displayed for XML-RPC, REST, and Ajax requests.
  *
  * @since 3.0.0
+ * @since 5.1.0 `WP_DEBUG_LOG` can be a file path.
  * @access private
  */
@@ -342 +343 @@
         }
 
-        if ( WP_DEBUG_LOG ) {
+        if ( in_array( strtolower( (string) WP_DEBUG_LOG ), array( 'true', '1' ), true ) ) {
+            $log_path = WP_CONTENT_DIR . '/debug.log';
+        } elseif ( is_string( WP_DEBUG_LOG ) ) {
+            $log_path = WP_DEBUG_LOG;
+        } else {
+            $log_path = false;
+        }
+
+        if ( $log_path ) {
             ini_set( 'log_errors', 1 );
-            ini_set( 'error_log', WP_CONTENT_DIR . '/debug.log' );
+            ini_set( 'error_log', $log_path );
         }
     } else {