README

Laravel Schema Events

Track and respond to database schema changes in your Laravel application through a simple event system.

Installation
Quick Start
Configuration
Usage
Contributing
Credits
License
Security Vulnerabilities
About Plank

Installation

You can install the package via composer:

composer require plank/laravel-schema-events

You can publish the config file with:

php artisan vendor:publish --tag="schema-events-config"

Quick Start

Install the package
Set up an event listener:

<?php

namespace App\Listeners;

use Plank\LaravelSchemaEvents\Events\TableCreated;

class LogTableCreation
{
    public function handle(TableCreated $event)
    {
        \Log::info("Table {$event->table} was created with columns: " . implode(', ', $event->columns->toArray()));
    }
}

protected $listen = [
    TableCreated::class => [
        LogTableCreation::class,
    ],
];

Configuration

The configuration file allows you to customize:

Which migration events to listen for
Which commands are tracked for different schema operations

return [
    'listeners' => [
        'ran' => MigrationRan::class,
        'finished' => MigrationsFinished::class,
    ],
    
    'commands' => [
        'renamed_columns' => ['renameColumn'],
        'dropped_columns' => ['dropColumn'],
        'added_indexes' => [
            'primary',
            'unique',
            'index',
            'fulltext',
            'spatialIndex',
        ],
        // ... additional commands
    ],
];

Usage

Available Events

The package provides four main events:

TableCreated - Emitted when a new table is created
TableChanged - Emitted when an existing table is modified
TableDropped - Emitted when a table is dropped
TableRenamed - Emitted when a table is renamed

Event Properties

Each event includes basic connection information:

connection - The name of the database connection
databaseName - The name of the database
driverName - The database driver being used

TableCreated Event

public readonly string $table;
public readonly Collection $columns;      // Added columns
public readonly Collection $indexes;      // Added indexes
public readonly Collection $foreignKeys;  // Added foreign keys

TableChanged Event

public readonly string $table;
public readonly Collection $addedColumns;
public readonly Collection $droppedColumns;
public readonly Collection $renamedColumns;     // Contains [from => x, to => y]
public readonly Collection $modifiedColumns;
public readonly Collection $addedIndexes;
public readonly Collection $droppedIndexes;
public readonly Collection $renamedIndexes;     // Contains [from => x, to => y]
public readonly Collection $addedForeignKeys;
public readonly Collection $droppedForeignKeys;

TableDropped Event

public readonly string $table;

TableRenamed Event

public readonly string $from;
public readonly string $to;

Repository

The event repository collects the schema events that occur during the migrations which can be retrieved after the MigrationsEnded event is fired by the Migrator.

If your application wants to handle dispatching and flushing the events, you can set the schema-events.listeners.finished listener to null and listen to the MigrationsEnded event in your application.

The schema event repository can be controlled using the SchemaEvents facade.

get()

Retrieve all schema events that were fired during the course of the migrations.

created()

Retrieve all TableCreated events that were fired during the course of the migrations.

changed()

Retrieve all TableChanged events that were fired during the course of the migrations.

renamed()

Retrieve all TableRenamed events that were fired during the course of the migrations.

dropped()

Retrieve all TableDropped events that were fired during the course of the migrations.

flush()

Clear all schema events stored in the schema event repository.

Contributing

Please see CONTRIBUTING for details.

Credits

License

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

Security Vulnerabilities

If you discover a security vulnerability within siren, please send an e-mail to security@plank.co. All security vulnerabilities will be promptly addressed.

Check Us Out!

Plank focuses on impactful solutions that deliver engaging experiences to our clients and their users. We're committed to innovation, inclusivity, and sustainability in the digital space. Learn more about our mission to improve the web.

plank / laravel-schema-events

Maintainers

Details