Skip to content

Latest commit

 

History

History
135 lines (91 loc) · 4.81 KB

README.md

File metadata and controls

135 lines (91 loc) · 4.81 KB

Logo Laravel DB Auditor

Packagist License Total Downloads

Introduction

  • This package provides to audit process of reviewing and evaluating a mysql, sqlite and postgresql database system.
  • DB Auditor scan your mysql/sqlite/postgresql database and give insights of standards, constraints and provide option to add the constraints through CLI.
  • The result of audit process shows list of tables & columns which doesn't have proper standards.

Installation & Usage

Requires PHP 8.0+ | Laravel 8.0+

Require Laravel DB Auditor using Composer:

composer require --dev vcian/laravel-db-auditor

Usage:

You can access DB Auditor using below artisan commands.

php artisan db:audit

This command give you options to select feature like check the database standards or check the constraint.

Now, you can skip tables which you don't want to check. Add skip table name in the .db-auditor.php file.

Note:

If you want to check standalone feature then you can execute below artisan command one by one.

php artisan db:constraint

This command gives you result with list of tables with primary,foreign,unique,index constraint.

You can add more constraint to the table by seeing existing constraint with table.

Below example give insights about the how to see constraints in table and how to add.

Note :-

  • SQLite does not allow to define PRIMARY KEY or FOREIGN KEY into a existing table.
  • Add constraint option is not support for PostgreSQL. Will release soon.

Logo Laravel DB Auditor

Logo Laravel DB Auditor

Logo Laravel DB Auditor

Logo Laravel DB Auditor


php artisan db:standard

This command give you result with list of table with standard follow indication.

You can also see table specific column name which doesn't have standard followed.

Below example give insights of database standards reports and suggestions.

Logo Laravel DB Auditor

Logo Laravel DB Auditor

Logo Laravel DB Auditor


php artisan db:track

This command give you the track of the database files. Like when it's created with how many field in which table or whom created. this type of information show in the result.

You can also filter with --table=, --action=, --status=. Note: "created by" return the github username and if it's not git repo than it shows system username.

Track Default

Track Default

Track Default

Track Default

Note:

You have to set your database name with DB_DATABASE parameter in you laravel .env file to use this feature.

ACCESS WEB PAGE

You can also access this feature through WEB UI. To access web UI, kindly execute below command.

php artisan vendor:publish --tag=public

select "db-auditor"

Route - To access the web UI "/laravel-db-auditor"

Laravel DB Auditor UI

Laravel DB Auditor UI

Laravel DB Auditor UI

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

   We believe in 
        👇
      ACT NOW
  PERFECT IT LATER
CORRECT IT ON THE WAY.

Security

If you discover any security-related issues, please email ruchit.patel@viitor.cloud instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.