Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon Laravel migration change column type
    Laravel migration change column type Laravel migrations database schema PHP Laravel schema update Laravel 9 doctrine/dbal


Laravel migration change column type


Here is how you can change the data type of a column in a Laravel migration:

1. Create a new migration:


   php artisan make:migration change_description_column_in_tasks_table
   

This will create a new migration file in the `database/migrations` directory.

2. Update the `up()` method:

php
   public function up()
   {
       Schema::table('tasks', function (Blueprint $table) {
           $table->text('description')->change();
       });
   }
   

In the `up()` method, we use the `$table->change()` method to modify the existing `description` column from its current data type to `text`.

3. Update the `down()` method:

php
   public function down()
   {
       Schema::table('tasks', function (Blueprint $table) {
           $table->string('description', 255)->change();
       });
   }
   

In the `down()` method, we revert the changes by changing the `description` column back to a `string` with a maximum length of 255 characters.

4. Run the migration:


   php artisan migrate
   

This will apply the changes to the database.

The key points are:

- Use the `$table->change()` method to modify an existing column.
- Specify the new data type in the column definition (e.g., `$table->text('description')`).
- Provide a `down()` method to revert the changes, if needed.
- For Laravel 9 and below, make sure to install the `doctrine/dbal` package before running the migration.

This approach allows you to change the data type of a column in your database schema while preserving the existing data. Remember to thoroughly test your migrations before running them in a production environment.

Citations:
[1] https://stackoverflow.com/questions/16791613/laravel-add-a-new-column-to-existing-table-in-a-migration
[2] https://laravel.com/docs/6.x/migrations
[3] https://hbgl.dev/add-columns-with-custom-types-in-laravel-migrations/
[4] https://devdojo.com/bobbyiliev/how-to-add-a-new-column-to-an-existing-table-in-a-laravel-migration
[5] https://laracoding.com/how-to-change-a-table-column-type-using-laravel-migrations/