Laravel console logger

Provides logging and email notifications for Laravel console commands.

Dependencies

• PHP >=5.5.9
• Laravel >=5.2

Usage

1. Install package through composer:

   composer require illuminated/console-logger

2. Use Illuminated\Console\Loggable trait in your console command class:

   namespace App\Console\Commands;
   
   use Illuminate\Console\Command;
   use Illuminated\Console\Loggable;
   
   class Foo extends Command
   {
       use Loggable;
   
       // ...
   }

3. Now your command is loggable!

   You have logs separated by commands and by dates, auto-rotation, global error handler, email notifications for any kind of errors (even for PHP notices in your commands), auto saving to DB, set of useful info added to each iteration, context support with nice dumps for each type of message and even more cool features right out of the box!

   These PSR-3 methods are available for you:

   • logDebug
   • logInfo
   • logNotice
   • logWarning
   • logError
   • logCritical
   • logAlert
   • logEmergency

   Here is the basic example of usage:

   class Foo extends Command
   {
       use Loggable;
   
       public function handle()
       {
           $this->logInfo('Hello World!');
       }
   
       // ...
   }

   [2016-05-11 17:19:21]: [INFO]: Command `App\Console\Commands\Foo` initialized.
   [2016-05-11 17:19:21]: [INFO]: Host: `MyHost.local` (`10.0.1.1`).
   [2016-05-11 17:19:21]: [INFO]: Database host: `MyHost.local`, port: `3306`, ip: ``.
   [2016-05-11 17:19:21]: [INFO]: Database date: `2016-05-11 17:19:21`.
   [2016-05-11 17:19:21]: [INFO]: Hello World!
   [2016-05-11 17:19:21]: [INFO]: Execution time: 0.009 sec.
   [2016-05-11 17:19:21]: [INFO]: Memory peak usage: 8 MB.
   

Location

Each command has a separate folder for it's logs. Path is generated according to the command's name. For example, command php artisan foo would have it's logs on ./storage/logs/foo/ folder, and command php artisan foo:bar on ./storage/logs/foo/bar/. Log file names are corresponding to dates, and only latest thirty files are stored.

Error handler

Each exception, error and even PHP warning or notice are handled for you. It would be automatically logged, and you'll get email notification. You'll know immediately if something went wrong while execution. Very useful for scheduled commands.

class Foo extends Command
{
    use Loggable;

    public function handle()
    {
        fatal();
    }

    // ...
}

[2016-05-11 17:19:21]: [INFO]: Command `App\Console\Commands\Foo` initialized.
[2016-05-11 17:19:21]: [INFO]: Host: `MyHost.local` (`10.0.1.1`).
[2016-05-11 17:19:21]: [INFO]: Database host: `MyHost.local`, port: `3306`, ip: ``.
[2016-05-11 17:19:21]: [INFO]: Database date: `2016-05-11 17:19:21`.
[2016-05-11 17:19:21]: [ERROR]: Call to undefined function App\Console\Commands\fatal()
array:4 [
    "code" => 0
    "message" => "Call to undefined function App\Console\Commands\fatal()"
    "file" => "/Applications/MAMP/htdocs/illuminated-console-logger-test/app/Console/Commands/Foo.php"
    "line" => 15
]
[2016-05-11 17:19:21]: [INFO]: Execution time: 0.009 sec.
[2016-05-11 17:19:21]: [INFO]: Memory peak usage: 8 MB.

Auto saving to DB

In progress...

Advanced

Custom location

Sometimes it's needed to change location of the log files, for example, you want it to be dependent on some command's argument. If that is your case, just override getLogPath method in your command class:

class Foo extends Command
{
    use Loggable;

    protected function getLogPath()
    {
        $name = Str::replaceFirst(':', '/', $this->getName());
        $baz = $this->argument('baz');
        return storage_path("logs/{$name}/{$baz}/date.log");
    }

    // ...
}

Accessing Monolog instance

This package is using Monolog logging library with all of it's power. If needed, you may access the underlying Monolog instance in a two ways:

• Using icLogger command's method:

  class Foo extends Command
  {
      use Loggable;
  
      public function handle()
      {
          $log = $this->icLogger();
      }
  
      // ...
  }

• Through Laravel service container:

  $log = $app('log.iclogger');

Troubleshooting

Trait included, but nothing happens?

Note, that Loggable trait is overriding initialize method:

trait Loggable
{
    protected function initialize(InputInterface $input, OutputInterface $output)
    {
        $this->initializeLogging();
    }

    // ...
}

If your command is overriding initialize method too, then you should call initializeLogging method by yourself:

class Foo extends Command
{
    use Loggable;

    protected function initialize(InputInterface $input, OutputInterface $output)
    {
        $this->initializeLogging();

        $this->bar = $this->argument('bar');
        $this->baz = $this->argument('baz');
    }

    // ...
}

Several traits conflict?

If you're using some other cool illuminated/console-% packages, well, then you can find yourself getting "traits conflict". For example, if you're trying to build loggable command, which is protected against overlapping:

class Foo extends Command
{
    use Loggable;
    use WithoutOverlapping;

    // ...
}

You'll get fatal error, the "traits conflict", because both of these traits are overriding initialize method:

If two traits insert a method with the same name, a fatal error is produced, if the conflict is not explicitly resolved.

But don't worry, solution is very simple. Just override initialize method by yourself, and initialize traits in required order:

class Foo extends Command
{
    use Loggable;
    use WithoutOverlapping;

    protected function initialize(InputInterface $input, OutputInterface $output)
    {
        $this->initializeMutex();
        $this->initializeLogging();
    }

    // ...
}