Laravel Pail 公式ログ追跡ツール

Laravel Pail とは

2023年11月にリリースされた新しめのログ追跡ツールです。
Pail(ペイル)はロゴのデザイン通り、バケツを意味します。

Laravel Pail のインストール

$ composer require laravel/pail

開発環境にしか入れたくない場合は --dev オプションを付けてください。

$ composer require laravel/pail --dev

Laravel Pail の使い方

$ php artisan pail

Pailはフォアグラウンドで起動してログが流れてくるのを待ちます。

こんな感じで表示されます。

過去のログファイルは表示しません。
Pailを停止したらバケツの中のログは捨て去られます。

laravel-dump-serverのログ版みたいな感じです。

オプション

$ php artisan pail -h
Description:
  Tails the application logs.

Usage:
  pail [options]

Options:
      --filter[=FILTER]    Filter the logs by the given value
      --message[=MESSAGE]  Filter the logs by the given message
      --level[=LEVEL]      Filter the logs by the given level
      --auth[=AUTH]        Filter the logs by the given authenticated ID
      --user[=USER]        Filter the logs by the given authenticated ID (alias for --auth)
  -h, --help               Display help for the given command. When no command is given display help for the list command
  -q, --quiet              Do not output any message
  -V, --version            Display this application version
      --ansi|--no-ansi     Force (or disable --no-ansi) ANSI output
  -n, --no-interaction     Do not ask any interactive question
      --env[=ENV]          The environment the command should run under
  -v|vv|vvv, --verbose     Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

フィルタリング指定して起動できます。

$ php artisan pail --filter="QueryException"
$ php artisan pail --message="User created"
$ php artisan pail --level=error
$ php artisan pail --user=1

_debugbar とかを除外したいけど、設定ファイルとか exclude オプションはなさそう？
今後のアップデートに期待しておきます。