Download the PHP package mblsolutions/audit-logging without Composer

Audit Logging

Audit Logging for Laravel projects

Installation

The recommended method to install LaravelRepository is with composer

Laravel without auto-discovery

If you don't use auto-discovery, add the ServiceProvider to the providers array in config/app.php

Package configuration

Database Driver

If you would like to use the Database driver to store your audit logs, you will first need to create and run the database driver migration.

This will create a new migration in database/migrations, after creating this migration run the database migrations to create the new table.

`

Usage

The configuration and setup can be adjusted in the audit logging config file located in config/audit-logging.php. We recommend reading through the config file before enabling audit logging to ensure you have the optimum setup.

Enable/Disable Logging

Before logs are stored you will need to enable audit logging by setting the config values to true.

This can also be set in your .env file by using the corresponding environment variable

Audit Logging Middleware

To enable audit logging for routes there are multiple ways this can be achieved, middleware aliases has been created

• web-audit-logging
• api-audit-logging
• console-audit-logging

The only differences with these middleware are the log type

Single Route

You can enable audit logging for a single route by applying the middleware to the route.

Or by using the fully qualified class name

Route Groups

You can apply the middleware to a group of routes.

Excluding Routes

You can exclude specific routes in a group of middleware.

Optional Model/Trait for Log Retrieval

We have included an AuditLog Model with a BindsDynamically trait which you can use if you'd like to use an eloquent model for retrieving and formatting data.

• MBLSolutions\AuditLogging\Models\AuditLog - Implements BindsDynamically trait. Can be extended if needed.
• MBLSolutions\AuditLogging\Traids\BindsDynamically - Can be used in custom model or automatically as above.

Using Model with BindsDynamically trait

In order to use the AuditLog model (or any model implementing the BindsDynamically trait) you need to instantiate it with a connection and table as in the example below:

You can then use the $auditLog as you would any eloquent model.

Archiving Logs

If you would like to archive your logs and continue with a fresh table then you can use the archive command by running:

`

If you have installed fresh from version 1.6.0 you are good to go, otherwise if you have an existing installation from an earlier version you should run the update migration to add an index to the audit logs created_at column (if you have not already). You just need to publish the update with:

`

and then remember to run

`

This should be done as soon as possible after your archiving as the more data in the table the longer the migration will take.

License

Audit Logging is free software distributed under the terms of the MIT license.