Fix WP_DEBUG_LOG custom paths not being respected

[Copilot]

Fix WP-CLI not logging to custom WP_DEBUG_LOG path

• Understand the issue: wp_debug_mode() doesn't check if WP_DEBUG is defined before using it
• Fix the bug in php/utils-wp.php by adding defined() check
• Create a test case to validate the fix
• Run linter, phpcs, and phpstan - all passing
• Run PHPUnit tests - 323 tests pass (3 unrelated network failures)
• Run code review - no issues found
• Run security scan - no issues found
• Manual testing confirms fix works correctly
• Simplified WP_DEBUG_DISPLAY logic per code review feedback

Original prompt

---

This section details on the original issue you should resolve

<issue_title>WP-CLI does not log errors to the path set in WP_DEBUG_LOG</issue_title>
<issue_description>## Bug Report

• Yes, I reviewed the contribution guidelines.
• Yes, more specifically, I reviewed the guidelines on how to write clear bug reports.

Describe the current, buggy behavior

I have this set in my wp-config.php file:

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', false);
define('WP_DEBUG_LOG', '/tmp/debug_staging.log');

I have experienced that when I do error_log() through WP-CLI, the log goes to the standard log path of /wp-content/debug.log. This does not happen when errors are triggered by visiting pages and running functions from the browser.

Describe how other contributors can replicate this bug

1. Register the following command for use through WP-CLI:

public function check_debug()
{
    error_log(WP_DEBUG_LOG);
}

2. Define WP_DEBUG as true and set a specific path for WP_DEBUG_LOG in wp-config.php

3. Run check_debug() through WP-CLI

You will see your path from WP_DEBUG_LOG be logged in /wp-content/debug.log

Describe what you expect as the correct outcome

I expect the path of WP_DEBUG_LOG to be logged in the path set in WP_DEBUG_LOG.

Let us know what environment you are running this on

OS:     Linux 5.4.72 wp-cli/wp-cli#3 SMP Sun Oct 25 11:14:45 UTC 2020 x86_64
Shell:  /bin/sh
PHP binary:     /usr/app/php/7.4.22/bin/php
PHP version:    7.4.22
php.ini used:   /etc/app/php/php.ini
WP-CLI root dir:        phar://wp-cli.phar/vendor/wp-cli/wp-cli
WP-CLI vendor dir:      phar://wp-cli.phar/vendor
WP_CLI phar path:       [REDACTED]
WP-CLI packages dir:
WP-CLI global config:
WP-CLI project config:
WP-CLI version: 2.4.0

Provide additional context

I have looked through the code here:

wp-cli/php/utils-wp.php

Line 43 in 0b22dee

function wp_debug_mode() {

If I paste the function wp_debug_mode() into check_debug() and then error_log $log_path on line 64, I get '/tmp/debug_staging.log' in the log file on the default location. I get nothing in /tmp/debug_staging.log.

I, therefore, do not know where this goes wrong and I have no idea how to fix it.
</issue_description>

Comments on the Issue (you are @copilot in this section)

@ernilambar Some how, the value of `WP_DEBUG` is always false. https://github.com/wp-cli/wp-cli/blob/0b22dee2eabcfc9f9f84671003900155b0722543/php/utils-wp.php#L51

• Fixes WP-CLI does not log errors to the path set in WP_DEBUG_LOG #5601

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[codecov]

Codecov Report

❌ Patch coverage is 83.33333% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
php/utils-wp.php	83.33%	2 Missing ⚠️

📢 Thoughts on this report? Let us know!