debugger.php

См. документацию.

<?php
 
namespace Bitrix\Main\Session;
 
use Bitrix\Main\Application;
use Bitrix\Main\Context;
use Bitrix\Main\Diag\Helper;
use Bitrix\Main\EventManager;
use Bitrix\Main\Security\Cipher;
use Bitrix\Main\Security\SecurityException;
 
final class Debugger
{
    public const TO_FILE   = 0b001;
    public const TO_HEADER = 0b010;
    public const TO_ALL    = self::TO_FILE | self::TO_HEADER;
 
    protected int $mode = 0;
    private array $config = [];
 
    public function __construct(int $mode = 0)
    {
        $this->setMode($mode);
 
        EventManager::getInstance()->addEventHandlerCompatible('main', 'OnPageStart', function(){
            $this->logConfiguration($this->config);
        });
    }
 
    public function setMode(int $mode): void
    {
        $this->mode = $mode;
    }
 
    public function logConfiguration(array $config): void
    {
        $mode = $config['mode'] ?? 'unknown';
        $type = $config['handlers']['general']['type'] ?? 'unknown';
 
        $this->addHeader('Conf', "{$mode}:{$type}");
    }
 
    public function detectFirstUsage(): void
    {
        $firstUsage = null;
        $traceItems = Helper::getBackTrace(10, DEBUG_BACKTRACE_IGNORE_ARGS, 4);
        foreach ($traceItems as $item)
        {
            if ($this->isInternalSessionLine($item))
            {
                continue;
            }
 
            $firstUsage = "{$item['file']}:{$item['line']}";
            break;
        }
 
        if ($firstUsage)
        {
            $this->addHeader("Usage", $firstUsage);
        }
    }

    private function isInternalSessionLine(array $item): bool
    {
        if (empty($item['class']))
        {
            return false;
        }
 
        if (strpos($item['file'], 'lib' . DIRECTORY_SEPARATOR . 'session' . DIRECTORY_SEPARATOR))
        {
            return true;
        }
        if (strpos($item['file'], 'storage' . DIRECTORY_SEPARATOR . 'nativesessionstorage'))
        {
            return true;
        }
 
        return false;
    }
 
    public function logToFile($text): void
    {
        if ($this->mode & self::TO_FILE)
        {
            $requestUri = Application::getInstance()->getContext()->getServer()->getRequestUri();
            AddMessage2Log($text . ' ' . $requestUri, 'main', 20);
        }
    }
 
    protected function addHeader(string $category, string $value): void
    {
        $context = Context::getCurrent();
        if (!($context instanceof Context))
        {
            return;
        }
 
        if ($this->mode & self::TO_HEADER)
        {
            if ($this->shouldEncryptValue())
            {
                $value = $this->encryptValue($value);
            }
 
            $response = $context->getResponse();
            $response->addHeader("X-Session-{$category}", $value);
        }
    }
 
    protected function getCryptoKey(): ?string
    {
        return $this->config['debugKey'] ?? null;
    }
 
    protected function shouldEncryptValue(): bool
    {
        return !empty($this->getCryptoKey());
    }
 
    protected function encryptValue(string $value): string
    {
        try
        {
            $cipher = new Cipher();
            $encryptedValue = $cipher->encrypt($value, $this->getCryptoKey());
 
            return $this->encodeUrlSafeB64($encryptedValue);
        }
        catch (SecurityException $securityException)
        {
            return '';
        }
    }
 
    private function encodeUrlSafeB64(string $input): string
    {
        return str_replace('=', '', strtr(base64_encode($input), '+/', '-_'));
    }
 
    public function storeConfig(array $sessionConfig): void
    {
        $this->config = $sessionConfig;
    }
}