Laravel Pail Save Abandoned

Introduction

Laravel Pail is a package that allows you to easily dive into your Laravel application's log files directly from the command line. Unlike other log tailing packages, Pail is designed to work with any log driver, including Sentry or Flare.

In addition, Pail focuses on the developer experience: it provides a sleek CLI interface with a user-friendly design and a set of useful filters to help you find what you're looking for.

Installation

Requires PHP 8.2+ with PCNTL extension.

To get started, install Pail into your project using the Composer package manager:

Note: Pail is currently in beta and is not yet ready for production use.

composer require laravel/pail:^1.0@beta

Usage

To start tailing logs, run the pail command:

php artisan pail

To increase the verbosity of the output, avoiding truncation (…), use the -v option:

php artisan pail -v

For maximum verbosity and to display exception stack traces, use the -vv option:

php artisan pail -vv

To stop tailing logs, press Ctrl+C at any time.

Filtering Logs

--filter

You may use the --filter option to filter logs by their type, file, message, and stack trace content:

php artisan pail --filter="QueryException"

--message

To filter logs by only their message, you may use the --message option:

php artisan pail --message="User created"

--level

The --level option may be used to filter logs by their log level:

php artisan pail --level=error

--user

To only display logs that were written while a given user was authenticated, you may use the --user option:

php artisan pail --user=1

Contributing

Thank you for considering contributing to Laravel Pail! The contribution guide can be found in the Laravel documentation.

Code of Conduct

In order to ensure that the Laravel community is welcoming to all, please review and abide by the Code of Conduct.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

License

Laravel Pail is open-sourced software licensed under the MIT license.