PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);

$original = error_reporting(E_ALL);
$previous = error_reporting(E_ALL & ~E_USER_NOTICE);
try {
    echo ($previous & E_USER_NOTICE) !== 0 ? "previous:notice-on\n" : "previous:notice-off\n";
    echo (error_reporting() & E_USER_NOTICE) !== 0 ? "now:notice-on\n" : "now:notice-off\n";
} finally {
    error_reporting($previous);
}
echo error_reporting() === E_ALL ? "restored\n" : "changed\n";
error_reporting($original);

previous:notice-on
now:notice-off
restored

Это демонстрация временной маски, а не совет скрыть проблемы старого кода навсегда. ~ исключает бит notice, & ограничивает результат действующими E_ALL. Возвращённое число важно сохранить до установки нового значения.

<?php
declare(strict_types=1);

$original = error_reporting(E_ALL);
set_error_handler(function ($level, $message) {
    if ((error_reporting() & $level) === 0) {
        return false;
    }
    echo 'record:' . $message . "\n";
    return true;
});
try {
    @trigger_error('hidden-test', E_USER_WARNING);
    trigger_error('visible-test', E_USER_WARNING);
} finally {
    restore_error_handler();
    error_reporting($original);
}

record:visible-test

PHP всё равно вызывает callback при подавленной диагностике. Проверка конкретного бита пропускает suppressed warning в стандартный обработчик, где он также подавлен. В PHP 8 проверка error_reporting() === 0 не является корректным общим тестом для @. @ показан для совместимости со старой зависимостью; явная обработка ожидаемого отказа понятнее постоянного подавления.

<?php
declare(strict_types=1);

set_error_handler(function ($level, $message) {
    echo 'diagnostic:' . $message . "\n";
    return true;
}, E_USER_NOTICE);
try {
    $row = ['name' => 'Desk'];
    $currency = $row['currency'] ?? 'RUB';
    if (!array_key_exists('currency', $row)) {
        $reported = trigger_error('currency-defaulted');
        echo $reported ? "diagnostic:sent\n" : "diagnostic:not-sent\n";
    }
    echo 'currency:' . $currency . "\n";
} finally {
    restore_error_handler();
}

diagnostic:currency-defaulted
diagnostic:sent
currency:RUB

Правило импорта заранее разрешает RUB как значение по умолчанию. Диагностика поясняет решение, а не легализует произвольную валюту. Если валюта обязательна для расчёта, нужно отклонить строку валидацией вместо подстановки.

<?php
declare(strict_types=1);

function calculateDelivery($weight) {
    return $weight <= 1 ? 300 : 500;
}
function oldDeliveryPrice($weight) {
    trigger_error('Use calculateDelivery()', E_USER_DEPRECATED);
    return calculateDelivery($weight);
}
set_error_handler(function ($level, $message) {
    echo 'migration:' . $message . "\n";
    return true;
}, E_USER_DEPRECATED);
try {
    echo 'price:' . oldDeliveryPrice(2) . "\n";
} finally {
    restore_error_handler();
}

migration:Use calculateDelivery()
price:500

Разработчик видит, какой вызов заменить, а старый код пока получает прежний результат. Срок удаления и изменения контракта публикуют в документации библиотеки. Массовый вызов старого API может создать много записей: обновите клиентский код, а не добавляйте синхронную отправку письма на каждое предупреждение.

<?php
declare(strict_types=1);

try {
    trigger_error('Wrong level in library', E_WARNING);
} catch (ValueError $error) {
    echo "configuration:invalid-level\n";
}

configuration:invalid-level

catch ловит ошибку самого вызова trigger_error. E_WARNING — уровень движка, E_USER_WARNING — допустимый уровень, который создаёт приложение.

<?php
declare(strict_types=1);

function legacyImportImage($image) {
    if ($image === '') {
        user_error('catalog-image-skipped', E_USER_WARNING);
        return false;
    }
    return true;
}
set_error_handler(function ($level, $message) {
    echo 'import:' . $message . "\n";
    return true;
}, E_USER_WARNING);
try {
    $saved = legacyImportImage('');
    echo $saved ? "saved\n" : "not-saved\n";
} finally {
    restore_error_handler();
}

import:catalog-image-skipped
not-saved

Диагностика и результат функции разделены: возврат false явно сообщает, что изображение не сохранено. Продолжение работы определяется импортом, а не названием user_error.

<?php
declare(strict_types=1);

$events = [];
set_error_handler(function ($level, $message) use (&$events) {
    $events[] = [$level, $message];
    return true;
}, E_USER_DEPRECATED);
try {
    user_error('old-field-name', E_USER_DEPRECATED);
    trigger_error('old-field-name', E_USER_DEPRECATED);
    echo $events[0] === $events[1] ? "same-contract\n" : "different\n";
} finally {
    restore_error_handler();
}

same-contract

use (&$events) позволяет callback дописывать внешний учебный массив. В тесте сравниваем именно контракт события, а не изменяющиеся номера строк. В новом коде trigger_error обычно яснее сообщает действие; менять имя ради производительности оснований нет.

<?php
declare(strict_types=1);

function reportRow($level, $message) {
    echo 'row:' . $message . "\n";
    return true;
}
set_error_handler('reportRow', E_USER_WARNING);
try {
    echo "registered\n";
    trigger_error('missing-sku', E_USER_WARNING);
    echo "continued\n";
} finally {
    restore_error_handler();
}

registered
row:missing-sku
continued

Имя reportRow передано строкой без круглых скобок. PHP вызывает его только на третьей строке внутри try, после события trigger_error. Сам callback не доказывает, что строка товара корректна: импорт решает, пропустить её или остановиться.

<?php
declare(strict_types=1);

set_error_handler(function ($level, $message, $file, $line) {
    if ((error_reporting() & $level) === 0) {
        return false;
    }
    throw new ErrorException($message, 0, $level, $file, $line);
}, E_WARNING);
try {
    $data = file_get_contents(__DIR__ . '/missing-rates.json');
    echo 'bytes:' . strlen($data) . "\n";
} catch (ErrorException $error) {
    echo "delivery-rates:unavailable\n";
} finally {
    restore_error_handler();
}
echo "request-boundary\n";

delivery-rates:unavailable
request-boundary

Каталог примера изолирован, файл намеренно отсутствует. ErrorException переносит уровень, исходный файл и строку в исключение. Сырой текст содержит путь, поэтому посетителю отдаём собственный код. Обработчик действует только вокруг выбранной операции; нельзя без согласования менять модель ошибок всего чужого приложения.

<?php
declare(strict_types=1);

set_error_handler(function ($level, $message, $file, $line) {
    echo 'base:' . $message . "\n";
    return true;
}, E_USER_WARNING);
$count = 0;
$previous = null;
$previous = set_error_handler(function ($level, $message, $file, $line) use (&$count, &$previous) {
    $count++;
    return $previous !== null ? $previous($level, $message, $file, $line) : false;
}, E_USER_WARNING);
try {
    trigger_error('rate-row-skipped', E_USER_WARNING);
    echo 'count:' . $count . "\n";
} finally {
    restore_error_handler();
    restore_error_handler();
}

base:rate-row-skipped
count:1

false сам по себе не вызывает предыдущий пользовательский callback: поэтому здесь он вызывается явно. Маски двух слоёв намеренно одинаковы. Для произвольного чужого обработчика прежняя маска недоступна через getter, и прозрачное автоматическое объединение требует отдельного договора. Две регистрации требуют двух восстановлений.

<?php
declare(strict_types=1);

set_error_handler(function ($level, $message) {
    echo 'application:' . $message . "\n";
    return true;
}, E_USER_WARNING);
try {
    set_error_handler(function ($level, $message) {
        echo 'import:' . $message . "\n";
        return true;
    }, E_USER_WARNING);
    try {
        trigger_error('row-1', E_USER_WARNING);
    } finally {
        restore_error_handler();
    }
    trigger_error('after-import', E_USER_WARNING);
} finally {
    restore_error_handler();
}

import:row-1
application:after-import

Стек похож на стопку временных инструкций: снимается последняя установленная. Первый restore возвращает общий обработчик, второй — окружение до всего примера. Такая структура не накапливает настройки при тысячах задач worker.

<?php
declare(strict_types=1);

$original = error_reporting(0);
$seen = [];
set_error_handler(function ($level, $message) use (&$seen) {
    $seen[] = $message;
    return true;
}, E_USER_WARNING);
set_error_handler(function () { return true; }, E_ALL);
restore_error_handler();
try {
    trigger_error('notice', E_USER_NOTICE);
    trigger_error('warning', E_USER_WARNING);
    echo implode(',', $seen) . "\n";
} finally {
    restore_error_handler();
    error_reporting($original);
    error_clear_last();
}

warning

Нулевая маска стандартной диагностики нужна только для чистого учебного вывода: notice не перехватывается восстановленным callback и не показывается PHP. Warning приходит в callback независимо от error_reporting. Результат подтверждает восстановление E_USER_WARNING, а не только адреса функции.

<?php
declare(strict_types=1);

$handler = function () {
    echo "handler-called\n";
    return true;
};
set_error_handler($handler, E_USER_WARNING);
try {
    echo get_error_handler() === $handler ? "same-handler\n" : "other-handler\n";
} finally {
    restore_error_handler();
}

same-handler

Строки handler-called нет: чтение возвращает само замыкание, но не выполняет его тело. === сравнивает идентичность сохранённого callable. В диагностике интеграции это помогает понять, установлена ли ваша обёртка.

<?php
declare(strict_types=1);

$application = function () { return true; };
set_error_handler($application, E_USER_WARNING);
try {
    $before = get_error_handler();
    set_error_handler(null);
    try {
        echo get_error_handler() === null ? "temporary:built-in\n" : "temporary:custom\n";
    } finally {
        restore_error_handler();
    }
    echo get_error_handler() === $before ? "application:restored\n" : "application:changed\n";
} finally {
    restore_error_handler();
}

temporary:built-in
application:restored

Даже set_error_handler(null) сохраняет прежнюю настройку в стеке. Getter наблюдает результат; восстановление выполняет restore_error_handler. Для теста библиотеки такой контроль полезнее предположения, что глобальные настройки никто не меняет.

<?php
declare(strict_types=1);
set_exception_handler(function (Throwable $problem): void {
    echo 'failed:' . $problem::class . "\n";
});
throw new RuntimeException('demo operation failed');
echo "must-not-run\n";

Сохраните как worker.php в отдельной учебной папке. Это содержимое дочернего процесса; его запуск и проверяемый результат показаны ниже.

<?php
declare(strict_types=1);

$command = [PHP_BINARY, '-n', '-d', 'display_errors=0', '-d', 'log_errors=0', __DIR__ . '/worker.php'];
$process = proc_open($command, [1 => ['pipe', 'w'], 2 => ['pipe', 'w']], $pipes);
if (!is_resource($process)) {
    throw new RuntimeException('Cannot start isolated worker');
}
$output = stream_get_contents($pipes[1]);
$errors = stream_get_contents($pipes[2]);
fclose($pipes[1]);
fclose($pipes[2]);
$status = proc_close($process);
echo $output;
echo 'exit:' . $status . "\n";
echo $errors === '' ? "stderr:empty\n" : "stderr:present\n";

failed:RuntimeException
exit:0
stderr:empty

Пример специально не вызывает exit: на проверенном CLI PHP 8.5.11 обработчик, который нормально вернулся, оставил код завершения 0. Планировщик может ошибочно считать такое задание успешным. Не полагайтесь на автоматическое превращение печати ошибки в неуспешный статус. Родитель нужен лаборатории, чтобы увидеть статус дочернего процесса. Команда задана массивом без shell; пользовательские команды не выполняются. Вывод примеров мал, поэтому последовательное чтение двух каналов допустимо здесь; это не универсальный исполнитель процессов с неограниченным выводом.

<?php
declare(strict_types=1);
set_exception_handler(function (Throwable $problem): void {
    echo "import:failed request=demo-42\n";
    exit(1);
});
strlen([]);
echo "import:complete\n";

Сохраните как worker.php в отдельной учебной папке. Это содержимое дочернего процесса; его запуск и проверяемый результат показаны ниже.

<?php
declare(strict_types=1);

$command = [PHP_BINARY, '-n', '-d', 'display_errors=0', '-d', 'log_errors=0', __DIR__ . '/worker.php'];
$process = proc_open($command, [1 => ['pipe', 'w'], 2 => ['pipe', 'w']], $pipes);
if (!is_resource($process)) {
    throw new RuntimeException('Cannot start isolated worker');
}
$output = stream_get_contents($pipes[1]);
$errors = stream_get_contents($pipes[2]);
fclose($pipes[1]);
fclose($pipes[2]);
$status = proc_close($process);
echo $output;
echo 'exit:' . $status . "\n";
echo $errors === '' ? "stderr:empty\n" : "stderr:present\n";

import:failed request=demo-42
exit:1
stderr:empty

strlen с массивом создаёт TypeError; он тоже Throwable. Политика worker явно выбирает exit(1). Текст не раскрывает аргументы, системные пути и секреты. В рабочем CLI сообщение об отказе обычно пишут в stderr, а в stdout оставляют машиночитаемый успешный результат. Родитель нужен лаборатории, чтобы увидеть статус дочернего процесса. Команда задана массивом без shell; пользовательские команды не выполняются. Вывод примеров мал, поэтому последовательное чтение двух каналов допустимо здесь; это не универсальный исполнитель процессов с неограниченным выводом.

<?php
declare(strict_types=1);

$application = function (Throwable $problem): void {};
set_exception_handler($application);
try {
    set_exception_handler(function (Throwable $problem): void {});
    try {
        echo "test:temporary-handler\n";
    } finally {
        restore_exception_handler();
    }
    echo get_exception_handler() === $application ? "application:restored\n" : "application:changed\n";
} finally {
    restore_exception_handler();
}

test:temporary-handler
application:restored

Тест проверяет настройку, поэтому здесь нет непойманного исключения. Getter требует PHP 8.5; само восстановление работает и на предыдущих поддерживаемых версиях.

<?php
declare(strict_types=1);
set_exception_handler(function (Throwable $problem): void {
    echo "application:fallback\n";
    exit(2);
});
set_exception_handler(function (Throwable $problem): void {
    echo "temporary:wrong-owner\n";
    exit(3);
});
restore_exception_handler();
throw new RuntimeException('demo');

Сохраните как worker.php в отдельной учебной папке. Это содержимое дочернего процесса; его запуск и проверяемый результат показаны ниже.

<?php
declare(strict_types=1);

$command = [PHP_BINARY, '-n', '-d', 'display_errors=0', '-d', 'log_errors=0', __DIR__ . '/worker.php'];
$process = proc_open($command, [1 => ['pipe', 'w'], 2 => ['pipe', 'w']], $pipes);
if (!is_resource($process)) {
    throw new RuntimeException('Cannot start isolated worker');
}
$output = stream_get_contents($pipes[1]);
$errors = stream_get_contents($pipes[2]);
fclose($pipes[1]);
fclose($pipes[2]);
$status = proc_close($process);
echo $output;
echo 'exit:' . $status . "\n";
echo $errors === '' ? "stderr:empty\n" : "stderr:present\n";

application:fallback
exit:2
stderr:empty

По выводу и статусу видно, какой слой получил событие после восстановления. Исходный поток не возвращается к throw. Чтобы снять ещё и application, это пришлось бы сделать до выбрасывания исключения. Родитель нужен лаборатории, чтобы увидеть статус дочернего процесса. Команда задана массивом без shell; пользовательские команды не выполняются. Вывод примеров мал, поэтому последовательное чтение двух каналов допустимо здесь; это не универсальный исполнитель процессов с неограниченным выводом.

<?php
declare(strict_types=1);

$boundary = function (Throwable $problem): void {
    echo "boundary-executed\n";
};
set_exception_handler($boundary);
try {
    echo get_exception_handler() === $boundary ? "boundary:registered\n" : "boundary:missing\n";
} finally {
    restore_exception_handler();
}

boundary:registered

Проверка запуска не должна намеренно ронять задачу. Здесь читается регистрация, а для проверки поведения используют отдельный дочерний процесс, как в карточке set_exception_handler.

<?php
declare(strict_types=1);

$boundary = function (Throwable $problem): void {};
set_exception_handler($boundary);
try {
    $before = get_exception_handler();
    set_exception_handler(null);
    try {
        echo get_exception_handler() === null ? "temporary:default\n" : "temporary:custom\n";
    } finally {
        restore_exception_handler();
    }
    echo get_exception_handler() === $before ? "owner:unchanged\n" : "owner:changed\n";
} finally {
    restore_exception_handler();
}

temporary:default
owner:unchanged

Это локальная диагностика тестового стенда, не рекомендация временно снимать обработчик вокруг непроверенного рабочего запроса. В возвращённом замыкании могут храниться зависимости; не сериализуйте и не дампите его в публичный журнал.

<?php
declare(strict_types=1);

$path = tempnam(sys_get_temp_dir(), 'php-error-lesson-');
if ($path === false) {
    throw new RuntimeException('Temporary file unavailable');
}
try {
    $written = error_log("catalog-import-started\n", 3, $path);
    echo $written ? "write:accepted\n" : "write:failed\n";
    echo file_get_contents($path);
} finally {
    unlink($path);
}

write:accepted
catalog-import-started

Режим 3 дописывает данные; перевод строки добавляет наш код. tempnam создаёт отдельный файл в системной временной папке, finally удаляет только его. В production путь выбирает конфигурация приложения, а не поле HTTP-запроса.

<?php
declare(strict_types=1);

$request = ['request_id' => 'demo-42', 'token' => 'not-a-real-token', 'card' => 'demo-private'];
$event = [
    'event' => 'bank-timeout',
    'request_id' => $request['request_id'],
    'retry_allowed' => false,
];
$line = json_encode($event, JSON_THROW_ON_ERROR);
$path = tempnam(sys_get_temp_dir(), 'php-safe-event-');
if ($path === false) {
    throw new RuntimeException('Temporary file unavailable');
}
try {
    if (!error_log($line . "\n", 3, $path)) {
        throw new RuntimeException('Event write failed');
    }
    $saved = json_decode(file_get_contents($path), true, 512, JSON_THROW_ON_ERROR);
    echo $saved['event'] . ':' . $saved['request_id'] . "\n";
    echo array_key_exists('token', $saved) ? "secret:present\n" : "secret:absent\n";
} finally {
    unlink($path);
}

bank-timeout:demo-42
secret:absent

Журнал собирается из нового массива с разрешёнными ключами. Мы не пытаемся потом вычистить неизвестные секреты из огромного дампа. Реальный request_id создавайте и ограничивайте по формату на входе; JSON экранирует переносы строк, но не проверяет смысл полей. retry_allowed=false поясняет, что таймаут банковского вызова не доказывает отсутствие списания.

<?php
declare(strict_types=1);

$path = tempnam(sys_get_temp_dir(), 'php-default-log-');
if ($path === false) {
    throw new RuntimeException('Temporary file unavailable');
}
$previous = ini_set('error_log', $path);
if ($previous === false) {
    unlink($path);
    throw new RuntimeException('Cannot change local error_log');
}
try {
    echo error_log('worker-ready') ? "return:true\n" : "return:false\n";
    echo str_contains(file_get_contents($path), 'worker-ready') ? "file:contains-event\n" : "file:missing-event\n";
} finally {
    ini_set('error_log', $previous);
    unlink($path);
}

return:true
file:contains-event

Настроенный журнал может добавить время и служебный префикс, поэтому не сравниваем весь текст с постоянной строкой. Настройка изменяется только в изолированном процессе и возвращается обратно. Для боевого сервера нужна проверка маршрута журнала при развёртывании, а не доверие true.

<?php
declare(strict_types=1);

error_clear_last();
$contents = @file_get_contents(__DIR__ . '/optional-local-label.txt');
$last = error_get_last();
echo $contents === false ? "file:unavailable\n" : "file:read\n";
echo $last !== null && $last['type'] === E_WARNING ? "diagnostic:warning\n" : "diagnostic:other\n";
echo $last !== null && $last['line'] > 0 ? "location:available\n" : "location:missing\n";
error_clear_last();

file:unavailable
diagnostic:warning
location:available

В изолированной папке нет optional-local-label.txt. @ подавляет стандартный показ ожидаемого warning, но не устраняет отказ. false — отказ чтения; пустая строка могла быть успешным чтением пустого файла. error_get_last вызван немедленно: посторонняя диагностика между операцией и чтением могла бы заменить запись. Полный путь не выводится посетителю.

<?php
declare(strict_types=1);

error_clear_last();
$events = [];
set_error_handler(function ($level, $message) use (&$events) {
    $events[] = $message;
    return true;
}, E_USER_WARNING);
try {
    trigger_error('row-rejected', E_USER_WARNING);
    echo 'events:' . count($events) . "\n";
    echo error_get_last() === null ? "last:none\n" : "last:present\n";
} finally {
    restore_error_handler();
}

events:1
last:none

Наш callback полностью обработал событие. Его собственный список содержит предупреждение, а стандартная последняя запись пуста. Если нужен полный журнал импорта, ведите его явно; error_get_last не заменяет коллекцию событий.

<?php
declare(strict_types=1);
ini_set('fatal_error_backtraces', '1');
register_shutdown_function(function (): void {
    $last = error_get_last();
    echo $last !== null ? "shutdown:diagnostic\n" : "shutdown:clean\n";
    echo isset($last['trace']) && is_array($last['trace']) ? "trace:available\n" : "trace:unavailable\n";
});
function loadRules(): void {
    require __DIR__ . '/broken-definition.php';
}
loadRules();

Сохраните как worker.php в отдельной учебной папке. Это содержимое дочернего процесса; его запуск и проверяемый результат показаны ниже.

<?php
class BaseRule { final public function run() {} }
class InvalidRule extends BaseRule { public function run() {} }

Этот файл входит только в изолированный опыт; не подключайте его к рабочему приложению.

<?php
declare(strict_types=1);

$command = [PHP_BINARY, '-n', '-d', 'display_errors=0', '-d', 'log_errors=0', __DIR__ . '/worker.php'];
$process = proc_open($command, [1 => ['pipe', 'w'], 2 => ['pipe', 'w']], $pipes);
if (!is_resource($process)) {
    throw new RuntimeException('Cannot start isolated worker');
}
$output = stream_get_contents($pipes[1]);
$errors = stream_get_contents($pipes[2]);
fclose($pipes[1]);
fclose($pipes[2]);
$status = proc_close($process);
echo $output;
echo 'exit:' . $status . "\n";
echo $errors === '' ? "stderr:empty\n" : "stderr:present\n";

shutdown:diagnostic
trace:available
exit:255
stderr:empty

Внешний worker успевает зарегистрировать shutdown-функцию до подключения неверного определения. Ошибка намеренная; статус 255 зафиксирован для проверенного CLI. Shutdown не восстанавливает выполнение и не гарантирован после остановки процесса ОС или при нехватке ресурсов. Если синтаксис сломан в самом первом файле до регистрации, этот callback не существует. В рабочем обработчике фильтруйте фатальные type и не считайте любое последнее notice аварией. Родитель нужен лаборатории, чтобы увидеть статус дочернего процесса. Команда задана массивом без shell; пользовательские команды не выполняются. Вывод примеров мал, поэтому последовательное чтение двух каналов допустимо здесь; это не универсальный исполнитель процессов с неограниченным выводом.

<?php
declare(strict_types=1);

@trigger_error('old-import-notice', E_USER_NOTICE);
echo error_get_last() !== null ? "before:present\n" : "before:none\n";
error_clear_last();
echo error_get_last() === null ? "after:none\n" : "after:present\n";

before:present
after:none

Создано безвредное учебное notice; @ оставляет вывод примера чистым. Очистка относится только к последней записи. Уже записанное событие в настроенном журнале она не удаляет.

<?php
declare(strict_types=1);

@trigger_error('previous-job-had-warning', E_USER_WARNING);
$sum = 120 + 30;
echo error_get_last() !== null ? "after-success:old-warning-still-present\n" : "after-success:clean\n";
error_clear_last();
$nextResult = json_decode('{"total":150}', true, 512, JSON_THROW_ON_ERROR);
echo 'next-total:' . $nextResult['total'] . "\n";
echo error_get_last() === null ? "next-diagnostic:none\n" : "next-diagnostic:present\n";

after-success:old-warning-still-present
next-total:150
next-diagnostic:none

Успешное сложение не сбросило старую запись. На границе следующей изолированной задачи мы очистили её намеренно. JSON при отказе в этом режиме бросил бы JsonException: состояние error_get_last всё равно нельзя использовать как универсальный bool успеха.

<?php
declare(strict_types=1);

function writeDeliveryLabel() {
    $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
    foreach ($trace as $frame) {
        echo ($frame['function'] ?? 'main') . "\n";
    }
}
function shipOrder() {
    writeDeliveryLabel();
}
shipOrder();

writeDeliveryLabel
shipOrder

shipOrder вызывает writeDeliveryLabel; в момент снимка оба вызова ещё выполняются. Кадр 0 — ближайшая функция. foreach последовательно читает кадры, ?? даёт запасную подпись для необязательного поля. Это не история всех уже завершённых вызовов.

<?php
declare(strict_types=1);

function transportProbe($token) {
    $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
    $caller = $trace[1] ?? [];
    $name = ($caller['class'] ?? '') . ($caller['type'] ?? '') . ($caller['function'] ?? 'main');
    echo 'caller:' . $name . "\n";
    echo array_key_exists('args', $trace[0]) ? "args:present\n" : "args:omitted\n";
    echo array_key_exists('object', $caller) ? "object:present\n" : "object:omitted\n";
}
class DemoCrmClient {
    public function listDeals() {
        transportProbe('not-a-real-token');
    }
}
(new DemoCrmClient())->listDeals();

caller:DemoCrmClient->listDeals
args:omitted
object:omitted

Так разработчик может найти вызывающий клиент в общей точке, не записывая его настройки и аргументы. IGNORE_ARGS здесь также не включает object, потому что бит PROVIDE_OBJECT не передан. В production часто лучше явно передать безопасное имя операции, чем собирать стек на каждом запросе.

<?php
declare(strict_types=1);

class TraceProbe {
    public function inspect($label) {
        $frame = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT | DEBUG_BACKTRACE_IGNORE_ARGS, 1)[0];
        echo isset($frame['object']) && $frame['object'] === $this ? "object:same-instance\n" : "object:missing\n";
        echo array_key_exists('args', $frame) ? "args:present\n" : "args:omitted\n";
    }
}
(new TraceProbe())->inspect('demo');

object:same-instance
args:omitted

object — ссылка на реальный экземпляр, а не безопасное текстовое имя класса. Этот вариант нужен для локального исследования. Не выводите объект в журнал: его приватные настройки могут содержать секреты, а удержание объекта в трассировке продлевает его жизнь.

<?php
declare(strict_types=1);

function labelTrace() {
    ob_start();
    try {
        debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1);
        $text = ob_get_contents();
    } finally {
        ob_end_clean();
    }
    echo str_contains($text, 'labelTrace()') ? "trace:labelTrace\n" : "trace:missing\n";
}
labelTrace();

trace:labelTrace

ob_start создаёт наш буфер вывода, ob_get_contents читает его, ob_end_clean удаляет вместе с содержимым, не отправляя его дальше. Мы показываем стабильную проверку наличия кадра; полный текст намеренно не печатается. Такой приём подходит для собственного локального буфера, а не произвольного закрытия буферов фреймворка.

<?php
declare(strict_types=1);

function callDemoCrm($token) {
    ob_start();
    try {
        debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
        $text = ob_get_contents();
    } finally {
        ob_end_clean();
    }
    echo str_contains($text, 'demo-secret-marker') ? "token:leaked\n" : "token:not-in-trace\n";
    echo str_contains($text, 'buildReport') ? "caller:buildReport\n" : "caller:missing\n";
}
function buildReport() {
    callDemoCrm('demo-secret-marker');
}
buildReport();

token:not-in-trace
caller:buildReport

Маркер вымышленный; реальный токен для проверки не нужен. Отсутствие одного маркера — узкая проверка этого опыта, не сертификация безопасности всего логирования. Путь файла и имена функций в трассе остаются.