Как правильно отлаживать PHP-скрипты: от var_dump до Xdebug

Профессиональная отладка PHP: от базовых методов до Xdebug

Вы на верном пути, но var_dump и echo — это "каменный век" отладки. Для эффективной работы нужно освоить несколько уровней инструментов. Давайте разберём вашу конкретную проблему и покажу, как её решить по-взрослому.

1. Анализ вашей проблемы через error_log

Прежде чем ставить Xdebug, можно улучшить базовый подход. Вместо echo используйте error_log() — данные уйдут в лог-файл, не засоряя вывод:

error_log(print_r($data, true)); // Пишет в лог
error_log('Статус: ' . $data['status']); // Конкретная переменная

Но в вашем случае проблема вероятнее в transformData(). Проверьте её возврат:

function processUsers($users) {
    $result = [];
    foreach ($users as $user) {
        $data = getUserData($user['id']);
        if ($data['status'] == 'active') {
            $processed = transformData($data);
            error_log('Processed result: ' . json_encode($processed)); // Логируем
            $result[] = $processed;
        }
    }
    error_log('Final result count: ' . count($result)); // Логируем итог
    return $result;
}

2. Настройка Xdebug для пошаговой отладки

Xdebug позволяет ставить точки останова (breakpoints) и смотреть состояние всех переменных в реальном времени. Вот как настроить:

Установка (OpenServer):

• В меню OpenServer выберите «Настройки» → «Модули» → поставьте галочку на Xdebug (обычно идёт в комплекте с PHP 8.2).
• Перезапустите сервер.

Настройка VS Code:

• Установите расширение "PHP Debug" от Felix Becker.
• Создайте файл .vscode/launch.json в корне проекта:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "/var/www/html": "${workspaceFolder}"
            }
        }
    ]
}

Процесс отладки:

1. Поставьте точку останова (красный кружок) слева от строки $processed = transformData($data);.
2. Нажмите F5 (Run → Start Debugging).
3. Откройте ваш скрипт в браузере. Выполнение остановится на точке останова.
4. В VS Code слева появится панель с переменными: $data, $user, $result. Наведите мышку — увидите все значения.
5. Нажмите F10 (Step Over) — выполнится строка, и вы увидите, что вернула transformData(). Если $processed оказался null или false — проблема в этой функции.
6. Нажмите F11 (Step Into) — войдёте внутрь transformData() и увидите её логику пошагово.

3. Расшифровка вашей ошибки

Судя по коду, transformData() может возвращать null при каких-то условиях. Вместо гаданий, поставьте точку останова внутри этой функции и посмотрите, какие данные приходят и что возвращается. С Xdebug это занимает 10 секунд вместо 30 минут с var_dump.

4. Дополнительные приёмы

• Watch expressions: В VS Code в панели отладки добавьте выражение count($result) — будет автоматически обновляться.
• Conditional breakpoints: Кликните правой кнопкой на точку останова → "Edit breakpoint" → введите условие: $user['id'] == 42. Остановится только для этого пользователя.
• Stack trace: При ошибке Xdebug покажет полный стек вызовов — сразу видно, откуда пришёл вызов.

После настройки Xdebug вы забудете про var_dump. Это как перейти с велосипеда на автомобиль — та же цель, но в 100 раз быстрее и комфортнее.

function debug_log($data, $label = '') {
    $log = '[' . date('Y-m-d H:i:s') . '] ';
    $log .= $label ? $label . ': ' : '';
    $log .= json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
    file_put_contents(__DIR__ . '/debug.log', $log . PHP_EOL, FILE_APPEND);
}

// Использование:
debug_log($data, 'Данные пользователя');
debug_log($processed, 'Результат transformData');

function transformData($data) {
    debug_log($data, 'Входные данные в transformData');
    // ... ваша логика ...
    debug_log($result, 'Выходные данные из transformData');
    return $result;
}