DamienHarper / auditor

auditor, the missing audit log library
MIT License
164 stars 53 forks source link
audit-bundle audit-log audit-logs audit-trail auditing-services auditor audits diffs doctrine doctrine-audit doctrine2 orm

auditor Tweet

Latest Stable Version Latest Unstable Version auditor 3.x CI Scrutinizer Code Quality codecov License Total Downloads Monthly Downloads Daily Downloads

The purpose of auditor is to provide an easy and standardized way to collect audit logs.

Architecture

This library is architected around two concepts:

Those two kind of services are offered by Providers.

Default provider

A default provider is included with this library: the DoctrineProvider

DoctrineProvider offers both auditing services and sorage services. It creates audit logs for all Doctrine ORM database related changes:

DoctrineProvider supports following RDBMS

DoctrineProvider should work with any other database supported by Doctrine. Though, we can only really support the ones we can test with GitHub Actions.

Basically you can track any change of any entity from audit logs.

NOTE: DoctrineProvider cannot track DQL or direct SQL statements executions.

Official Documentation

auditor official documentation can be found here.

Version Information

Version Status Requirements Badges
3.x Active development :rocket: PHP >= 8.2, Symfony >= 5.4 auditor 3.x CI
Scrutinizer Code Quality
codecov
2.x Active support PHP >= 7.4, Symfony >= 4.4 auditor 2.x CI
Scrutinizer Code Quality
codecov
1.x EOL PHP >= 7.2, Symfony >= 3.4 auditor 1.x CI
Scrutinizer Code Quality
codecov

Changelog is available here

Contributing

auditor is an open source project. Contributions made by the community are welcome. Send us your ideas, code reviews, pull requests and feature requests to help us improve this project.

Do not forget to provide unit tests when contributing to this project. To do so, follow instructions in this dedicated README

Credits

License

auditor is free to use and is licensed under the MIT license