README

Laravel Schema Events

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

Table of Contents

• Installation
• Quick Start
• Configuration
• Usage
  • Available Events
  • Event Properties
• 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

1. Install the package
2. 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()));
    }
}

1. Register your listener in EventServiceProvider.php:

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:

1. TableCreated - Emitted when a new table is created
2. TableChanged - Emitted when an existing table is modified
3. TableDropped - Emitted when a table is dropped
4. 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;

Contributing

Please see CONTRIBUTING for details.

Credits

• Kurt Friars
• All Contributors

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.