laravel activitylog

El paquete spatie/laravel-activitylog proporciona funciones fáciles de usar para registrar las actividades de los usuarios de su aplicación. También puede registrar automáticamente eventos del modelo. El paquete almacena toda la actividad en la tabla activity_log .

Aquí hay una demostración de cómo puede usarlo:

 activity ()-> log ( ' Look, I logged something ' );

Puede recuperar toda la actividad utilizando el modelo SpatieActivitylogModelsActivity .

Activity:: all ();

Aquí hay un ejemplo más avanzado:

 activity ()
   -> performedOn ( $ anEloquentModel )
   -> causedBy ( $ user )
   -> withProperties ([ ' customProperty ' => ' customValue ' ])
   -> log ( ' Look, I logged something ' );

$ lastLoggedActivity = Activity:: all ()-> last ();

$ lastLoggedActivity -> subject ; //returns an instance of an eloquent model
$ lastLoggedActivity -> causer ; //returns an instance of your user model
$ lastLoggedActivity -> getExtraProperty ( ' customProperty ' ); //returns 'customValue'
$ lastLoggedActivity -> description ; //returns 'Look, I logged something'

A continuación se muestra un ejemplo de registro de eventos.

 $ newsItem -> name = ' updated name ' ;
$ newsItem -> save ();

//updating the newsItem will cause the logging of an activity
$ activity = Activity:: all ()-> last ();

$ activity -> description ; //returns 'updated'
$ activity -> subject ; //returns the instance of NewsItem that was saved

Llamar $activity->changes() devolverá esta matriz:

[
   ' attributes ' => [
        ' name ' => ' updated name ' ,
        ' text ' => ' Lorum ' ,
    ],
    ' old ' => [
        ' name ' => ' original name ' ,
        ' text ' => ' Lorum ' ,
    ],
];

Apóyanos

Invertimos muchos recursos en la creación de los mejores paquetes de código abierto. Puedes apoyarnos comprando uno de nuestros productos pagos.

Apreciamos mucho que nos envíe una postal desde su ciudad natal, mencionando cuál de nuestros paquetes está utilizando. Encontrarás nuestra dirección en nuestra página de contacto. Publicamos todas las postales recibidas en nuestro muro virtual de postales.

Documentación

Encontrará la documentación en https://spatie.be/docs/laravel-activitylog/introduction.

¿Te encuentras atrapado usando el paquete? ¿Encontraste un error? ¿Tiene preguntas generales o sugerencias para mejorar el registro de actividad? No dudes en crear un problema en GitHub; intentaremos solucionarlo lo antes posible.

Instalación

Puede instalar el paquete a través del compositor:

composer require spatie/laravel-activitylog

El paquete se registrará automáticamente.

Puedes publicar la migración con:

php artisan vendor:publish --provider= " SpatieActivitylogActivitylogServiceProvider " --tag= " activitylog-migrations "

Nota : La migración predeterminada supone que está utilizando números enteros para los ID de su modelo. Si está utilizando UUID o algún otro formato, ajuste el formato de los campos sujeto_id y causar_id en la migración publicada antes de continuar.

Después de publicar la migración, puede crear la tabla activity_log ejecutando las migraciones:

php artisan migrate

Opcionalmente, puede publicar el archivo de configuración con:

php artisan vendor:publish --provider= " SpatieActivitylogActivitylogServiceProvider " --tag= " activitylog-config " 

Registro de cambios

Consulte CHANGELOG para obtener más información sobre los cambios recientes.

Actualización

Consulte ACTUALIZACIÓN para obtener más detalles.

Pruebas

composer test 

Contribuyendo

Consulte CONTRIBUCIÓN para obtener más detalles.

Seguridad

Si encuentra un error relacionado con la seguridad, envíe un correo electrónico a [email protected] en lugar de utilizar el rastreador de problemas.

Créditos

• Freek Van der Herten
• Sebastián De Deyne
• Tom Witkowski
• Todos los contribuyentes

Y un agradecimiento especial a Caneco por el logo y a Ahmed Nagi por todo el trabajo que realizó en v4 .

Licencia

La Licencia MIT (MIT). Consulte el archivo de licencia para obtener más información.