Easily stream your Laravel application logs to the frontend in real-time using server-sent event (SSE)
- Easily stream your Backend events from your Controllers \ Events \ Models \ Etc... .
- Easily stream your Logs (
storage/logs/laravel.log
). - Print Backend logs and events to Frontend browser
console.log(data)
- PHP >= 7
- Laravel >= 5
Via Composer - Not recommended for production environment
$ composer require --dev saasscaleup/laravel-stream-log
Add Service Provider to config/app.php
in providers
section
Saasscaleup\LSL\LSLServiceProvider::class,
Add Facade to config/app.php
in aliases
section
'LSL' => Saasscaleup\LSL\Facades\LSLFacade::class,
Publish package's config, migration and view files by running below command:
$ php artisan vendor:publish --provider="Saasscaleup\LSL\LSLServiceProvider"
Run php artisan migrate
to create stream_logs
table.
$ php artisan migrate
Aadd this in your main view/layout (usually layout/app.blade.php
) file:
@include('lsl::view')
Configuration is done via environment variables or directly in the configuration file (config/lsl.php
).
<?php
return [
// enable or disable LSL
'enabled' => env('LSL_ENABLED', true),
// enable or disable laravel log listener
'log_enabled' => env('LSL_LOG_ENABLED', true),
// log listener for specific log type
'log_type' => env('LSL_LOG_TYPE', 'info,error,warning,alert,critical,debug'), // Without space
// log listener for specific word inside log messages
'log_specific' => env('LSL_LOG_SPECIFIC', ''), // 'test' or 'foo' or 'bar' or leave empty '' to disable this feature
// echo data loop in LSLController
'interval' => env('LSL_INTERVAL', 1),
// append logged user id in LSL response
'append_user_id' => env('LSL_APPEND_USER_ID', true),
// keep events log in database
'keep_events_logs' => env('LSL_KEEP_EVENTS_LOGS', false),
// Frontend pull invoke interval
'server_event_retry' => env('LSL_SERVER_EVENT_RETRY', '2000'),
// every 10 minutes cache expired, delete logs on next request
'delete_log_interval' => env('LSL_DELETE_LOG_INTERVAL', 600),
/******* Frontend *******/
// eanlbed console log on browser
'js_console_log_enabled' => env('LSL_JS_CONSOLE_LOG_ENABLED', true),
// js notification toast library
'js_notification_library' => env('LSL_JS_NOTIFICATION_LIBRARY', 'noty'), // 'izitoast' or 'noty'
// notification settings
'js_position' => 'bottomRight', // topLeft, topCenter, topRight, center, bottomLeft, bottomCenter, bottomRight
'js_timeout' => 5000, // false, 1000, 3000, 3500, etc. Delay for closing event in milliseconds (ms). Set 'false' for sticky notifications.
];
Syntax:
/**
* @param string $message : notification message
* @param string $type : alert, success, error, warning, info, debug, critical, etc...
* @param string $event : Type of event such as "EmailSent", "UserLoggedIn", etc
*/
LSLFacade::notify($message, $type = 'info', $event = 'stream')
To show popup notifications on the screen, in your controllers/event classes, you can do:
use Saasscaleup\LSL\Facades\LSLFacade;
public function myFunction()
{
LSLFacade::notify('Invoke stream log via Facade 1');
// Some code here
LSLFacade::notify('Invoke stream log via Facade 2');
// Some code here
LSLFacade::notify('Invoke stream log via Facade 3');
// or via helper
stream_log('Invoke stream log via helper 1');
stream_log('Invoke stream log via helper 2');
stream_log('Invoke stream log via helper 3');
}
By default, package uses noty for showing notifications.
You can switch to izitoast by updating config file config/lsl.php
// js notification toast library
'js_notification_library' => env('LSL_JS_NOTIFICATION_LIBRARY', 'izitoast'), // 'izitoast' or 'noty'
You can also, customize this by modifying code in resources/views/vendor/lsl/view.blade.php
file.
By default, pacakge uses stream
event type for streaming response:
LSLFacade::notify($message, $type = 'info', $event = 'message')
Notice $event = 'stream'
. You can customize this, let's say you want to use UserPurchase
as SSE event type:
use Saasscaleup\LSL\Facades\LSLFacade;
public function myMethod()
{
SSEFacade::notify('User purchase plan - step 1', 'info', 'UserPurchase');
// or via helper
stream_log('User purchase plan - step 1', 'info', 'UserPurchase');
}
Then you need to handle this in your view yourself like this:
<script>
var es = new EventSource("{{route('lsl-stream-log')}}");
es.addEventListener("UserPurchase", function (e) {
var data = JSON.parse(e.data);
alert(data.message);
}, false);
</script>
Please see the MIT for more information.
If you Like the tutorial and you want to support my channel so I will keep releasing amzing content that will turn you to a desirable Developer with Amazing Cloud skills... I will realy appricite if you:
Thanks for your support :)