The missing tail command for Laravel 5
PHP
Latest commit eccddd7 Jan 20, 2017 @freekmurze freekmurze committed on GitHub Merge pull request #13 from spatie/analysis-qyReMj
Apply fixes from StyleCI
Permalink
Failed to load latest commit information.
src Apply fixes from StyleCI Jan 20, 2017
.gitignore fix composer error Feb 10, 2015
.styleci.yml add styleci Nov 26, 2016
CHANGELOG.md nitpicks Jan 20, 2017
CONTRIBUTING.md initial commit Feb 10, 2015
LICENSE.md nitpicks Jan 20, 2017
README.md up the Laravel requirements Jan 20, 2017
composer.json up the Laravel requirements Jan 20, 2017

README.md

The missing tail command for Laravel 5

Latest Version Software License Quality Score StyleCI Total Downloads

This package offers an Artisan command to tail the application log. It supports daily and single logs and tailing both local and remote logs.

Spatie is a webdesign agency in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.

Postcardware

You're free to use this package (it's MIT-licensed), but if it makes it to your production environment you are required to send us a postcard from your hometown, mentioning which of our package(s) you are using.

Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.

The best postcards will get published on the open source page on our website.

Install

You can install the package via composer:

composer require spatie/laravel-tail

You must install this service provider:

// config/app.php

'providers' => [
    ...
    'Spatie\Tail\TailServiceProvider',
    ...
];

If you're planning on tailing remote logs you must publish the config file with this command:

php artisan vendor:publish --provider="Spatie\Tail\TailServiceProvider"

A file named tail.php will be created in the config directory. The options you can set in the file should be self-explanatory.


return [


    'connections' => [

        /*
         * The environment name. You can use this value in the tail command.
         */
        'production' => [

            /*
             * The hostname of the server where the logs are located
             */
            'host' => '',

            /*
             * The username to be used when connecting to the server where the 
             * logs are located
             */
            'user' => '',

            /*
             * The full path to the directory where the logs are located
             */
            'logDirectory' => '',
        ],
    ],
];

Usage

To tail the local log you can use this command:

php artisan tail

By default the last 20 lines will be shown. You can change that number by using the lines-option.

php artisan tail --lines=50

To tail a remote log you must first specify hostname and logDirectory in the config-file. After you've done that you can tail the remote logs by specifify the environment as an argument.

php artisan tail production

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email freek@spatie.be instead of using the issue tracker.

Credits

About Spatie

Spatie is a webdesign agency in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.

License

The MIT License (MIT). Please see License File for more information.