Laravel благодаря своему элегантному синтаксису и мощным функциям стал одним из самых популярных PHP-фреймворков для веб-разработки. При создании приложений крайне важно иметь эффективные механизмы отладки. Одним из таких механизмов является возможность протоколировать все запросы, выполняемые вашим приложением Laravel. В этой статье мы рассмотрим различные методы достижения этой цели, используя разговорный язык и примеры кода, чтобы вам было проще реализовать это в ваших собственных проектах.

Метод 1: использование панели отладки Laravel
Отладочная панель Laravel — это удобный пакет, который предоставляет полный набор инструментов отладки, включая ведение журнала запросов. Для начала установите пакет с помощью Composer:

composer require barryvdh/laravel-debugbar --dev

После установки откройте файл .envи установите для APP_DEBUGзначение true. Это активирует панель отладки Laravel для вашего приложения. Теперь при каждом запросе вы увидите подробную информацию о запросе и времени его выполнения на панели отладки в нижней части приложения.

Метод 2: включение ведения журнала запросов в конфигурации базы данных Laravel
Файл конфигурации базы данных Laravel позволяет включать ведение журнала запросов на лету. Откройте файл config/database.phpи найдите нужные настройки подключения к базе данных. Установите для параметра loggingзначение true, как показано ниже:

'mysql' => [
    'driver' => 'mysql',
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '3306'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'unix_socket' => env('DB_SOCKET', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
    'logging' => true, // Enable query logging
],

Сохраните файл, и Laravel теперь будет регистрировать все запросы, выполняемые этим подключением к базе данных. Вы можете найти журнал запросов в каталоге storage/logsвашего проекта Laravel.

Метод 3: использование прослушивателя событий запроса Laravel
Laravel предоставляет прослушиватель событий запроса, который позволяет вам подключиться к процессу выполнения запроса. Зарегистрировав прослушиватель, вы можете регистрировать запросы и соответствующие им привязки. Добавьте следующий код в свой AppServiceProvider:

use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
public function boot()
{
    DB::listen(function ($query) {
        Log::info('Query: '.$query->sql, ['bindings' => $query->bindings, 'time' => $query->time]);
    });
}

Этот код устанавливает прослушиватель событий глобального запроса, который регистрирует каждый выполненный запрос, а также его привязки и время выполнения. Записи журнала будут храниться в файле журнала Laravel по умолчанию.

Возможность регистрировать все запросы, выполняемые вашим приложением Laravel, чрезвычайно полезна для отладки и оптимизации производительности. В этой статье мы рассмотрели три метода: использование панели отладки Laravel, включение регистрации запросов в конфигурации базы данных Laravel и использование прослушивателя событий запросов Laravel. Внедрив один из этих методов, вы получите ценную информацию о взаимодействии базы данных вашего приложения, что поможет вам выявить и устранить любые потенциальные узкие места или проблемы.