konekt/laravel-migration-compatibility

Library to help migrations to figure out whether a related field is int or bigInt

Maintainers

👁 konekt

Package info

github.com/artkonekt/laravel-migration-compatibility

pkg:composer/konekt/laravel-migration-compatibility

Statistics

Installs: 230 662

Dependents: 7

Suggesters: 0

Stars: 0

Open Issues: 2

1.11.0 2026-04-17 15:22 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT 77f5e91ed711a7adde5bdfcf7e83a6155fad3b39

databasemigrationlaravelkonektartkonekt


README

👁 Tests
👁 Packagist Stable Version
👁 Packagist downloads
👁 StyleCI
👁 MIT Software License

Laravel 5.8 And The BigInt Problem

As of Laravel 5.8, migration stubs use the bigIncrements method on ID columns by default. Previously, ID columns were created using the increments method.

Foreign key columns must be of the same type. Therefore, a column created using the increments method can not reference a column created using the bigIncrements method.

This small change is a big source of problems for packages that define references to the default Laravel user table.

This package helps to solve this problem by extending Laravel's Blueprint class by a method that can detect the actual referenced field type:

class CreateProfilesTable extends Migration
{
 public function up()
 {
 Schema::create('profiles', function (Blueprint $table) {
 $table->increments('id');

 // Make `user_id` field the same type as the `id` field of the `user` table:
 $table->intOrBigIntBasedOnRelated('user_id', Schema::connection(null), 'users.id');

 //...

 $table->foreign('user_id')
 ->references('id')
 ->on('users');
 });
 }
//...

Installation

composer require konekt/laravel-migration-compatibility

Documentation

For detailed usage and examples go to the Documentation or refer to the markdown files in the docs/ folder of this repo.

For the list of changes read the Changelog.