# 404-solution/trunk/includes/logs/LogDebugModeResolver.php

404 Solution, version trunk. 63 lines.

- Page: https://pluginprobe.com/plugins/404-solution/trunk/code/includes/logs/LogDebugModeResolver.php
- Raw: https://pluginprobe.com/plugins/404-solution/trunk/raw/includes/logs/LogDebugModeResolver.php
- Modified: 2026-06-26T14:18:00+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/404-solution/trunk/code/includes/logs/LogDebugModeResolver.php#L10-L20`.

```php
<?php

if (!defined('ABSPATH')) {
    exit;
}

/**
 * Decides whether debug logging is currently enabled.
 *
 * Resolution order: an in-memory PluginLogic `options['debug_mode']` override
 * (read reflectively so an early-boot caller that has populated PluginLogic but
 * not yet wired the options repository still gets the right answer) takes
 * precedence; otherwise the canonical answer comes from the options repository.
 *
 * Pure policy: reads configuration, makes one boolean decision, writes nothing.
 */
class ABJ_404_Solution_LogDebugModeResolver {

    /** @return bool true if debug mode is on. false otherwise. */
    public function isDebug(): bool {
        $legacyDebugMode = $this->legacyPluginLogicDebugMode();
        if ($legacyDebugMode !== null) {
            return $legacyDebugMode;
        }

        // Raw read only via the recursion-safe logging state store. isDebug()
        // is on the logging write path; reading via getOptions() runs the
        // normalize pipeline, which logs on validation failure and re-enters
        // logging -- the 4.3.0 logging<->options OOM. The store reads debug_mode
        // with the raw, non-normalizing, non-logging accessor.
        $store = abj_service_optional('logging_state_store');
        if (is_object($store) && method_exists($store, 'isDebugMode')) {
            return $store->isDebugMode();
        }

        return false;
    }

    /** @return bool|null */
    private function legacyPluginLogicDebugMode(): ?bool {
        if (!class_exists('ABJ_404_Solution_PluginLogic', false)) {
            return null;
        }
        $pluginLogic = ABJ_404_Solution_PluginLogic::peekInstance();
        if (!is_object($pluginLogic)) {
            return null;
        }
        try {
            $optionsProperty = new ReflectionProperty('ABJ_404_Solution_PluginLogic', 'options');
            $options = $optionsProperty->getValue($pluginLogic);
            if (is_array($options) && array_key_exists('debug_mode', $options)) {
                return $options['debug_mode'] == true;
            }
        } catch (\Throwable $e) {
            abj404_logPhpFallback(
                'logger-internal',
                'could not inspect PluginLogic debug_mode override: ' . $e->getMessage()
            );
        }
        return null;
    }
}

```