Laravel框架数据库迁移操作实例详解


Posted in PHP onApril 06, 2020

很多人可能在学习Laravel框架的时候,对Laravel的数据库迁移(以下简称Migrations)存在着疑惑:

1. 什么是 Migrations?

2. 为什么要用 Migrations?

3. Migrations 到底方便在哪里?

好了,抱着这些问题,我们今天就一起来学习Migrations。

什么是 Migrations?

我们先来看一下Laravel官方文档怎么写的:

Migrations are like version control for your database, allowing your team to easily modify and share the application's database schema. Migrations are typically paired with Laravel's schema builder to easily build your application's database schema. If you have ever had to tell a teammate to manually add a column to their local database schema, you've faced the problem that database migrations solve.

简单概括起来,就是我们可以将Migrations看作一种数据库的VCS(Version Control System),即版本控制系统。

可以通过Laravel的artisan命令快速创建、修改或还原数据库结构。

为什么要用 Migrations?

使用Migrations可以有效地对数据库进行版本控制,并且遵从了Single Responsibility Principle(单一职责原则),更加方便数据库的操控。

举个例子来说,假设我们已经设计并创建好了数据库,数据已经填充进数据库了,现在我们发现需要在其中一张表里增加一个名为name的栏目(column),需要在另一张表中将author栏目的名字改为user,那么我现在进入数据库里,进行了操作。刚刚操作完,公司老板突然找我面谈。面谈完了之后,我忘记了将我在数据库里的操作记录下来或者告知给其他开发人员,那么随之而来的很可能是灾难性的结果。

如果我们使用了Migrations,并且只通过Migrations进行数据库的操作,那么所有开发人员都可以看到数据库进行了哪些操作,而不会发生上述的情况。

Migrations 到底方便在哪里?

除了上述提到的版本控制功能外,我们几乎不需要写SQL代码就能简单快速地组建起数据库结构,并且可以迅速迁移(migrate)或者回滚(Rollback),省去了大量人工操作的繁琐。

讲解完了概念,我们现在来看一下具体怎么使用Migrations。

要创建一个迁移文件,我们可以用以下artisan命令:

$ php artisan make:migration create_samples_table --create=samples

注意php artisan命令需要在项目根目录下运行。--create==samples这个选项表明我们想要建立一个名为samples的数据库表,所以artisan会自动在database\migrations目录下建立一个叫2017_03_13_061422_create_samples_table.php的文件(其中前缀是创建该文件的日期和时间,用于区分迁移文件的时间先后顺序),并且会自动填充好Schema::create这个方法,方便我们创建更多的column:

<?php        
  
use Illuminate\Support\Facades\Schema;        
use Illuminate\Database\Schema\Blueprint;        
use Illuminate\Database\Migrations\Migration;        
  
class CreateSamplesTable extends Migration        
{        
  /**        
   * Run the migrations.        
   *        
   * @return void        
   */        
  public function up()        
  {        
    Schema::create('samples', function (Blueprint $table) {        
      $table->increments('id');        
      $table->timestamps();        
    });        
  }        
  
  /**        
   * Reverse the migrations.        
   *        
   * @return void        
   */        
  public function down()        
  {        
    Schema::dropIfExists('samples');        
  }        
}

我们看到,这个类中有up和down两个方法。up中我们需要添加创建数据表的函数,以及添加各个栏目的名称及属性。而down方法中我们需要添加在回滚该迁移文件时应该有什么样的结果(这里我们直接删除这张表)。

可以看出,up和down中的操作是对应的,在up中进行了什么操作,down中就需要撤销这些操作。

现在我们详细来看一下up方法。我们看到,Schema::create这个方法是用来创建我们数据表的,在方法中,我们看到Laravel已经为我们填充了几个columns。

$table->increments('id')将创建一个名为id的column,并赋予PRIMARY KEY、UNSIGNED及AUTO INCREMENT属性。

$table->timestamps()将创建created_at和updated_at两个column(类型是DATETIME)。

注意:Laravel默认认为每个table都会存在一个id栏目,并且要求每个table都要有created_at和updated_at这两个栏目。

现在,我们要在samples表里增加一个名为name的VARCHAR类型的栏目,该怎么做呢?

很简单,只需要加上这行:

$table->string('name');

如果我们想限制VARCHAR的长度,可以在第二个参数中进行注明:

$table->string('name', 100);

好了,我们暂时就只需要这些栏目。现在我们已经有了迁移文件了,怎么样才能在数据库里建立起我们的表呢?

很简单,输入

$ php artisan migrate

等待命令完成就可以了。

现在我们在数据库里,就能看到我们的samples表了。

注意:运行php artisan migrate之前请检查你的.env文件中DB_DATABASE,DB_USERNAME,DB_PASSWORD 几项配置是否正确。如果你在Homestead下进行Laravel开发,那么DB_USERNAME默认为homestead,DB_PASSWORD默认为secret,DB_DATABASE请根据你的项目具体填入你的数据库名称。

现在问题来了,我们突然想在samples表里,添加一个名为url的栏目,该怎么做呢?我们分情况讨论。

1. 我们处于本地开发阶段,数据使用种子(Seed)文件进行填充。

对于本地开发,如果想省事,可以直接在samples表的迁移文件中,添加上我们需要的栏目:

$table->string('url', 200)->nullable();

然后我们重置数据库并做种:

$ php artisan migrate:refresh --seed

这样就完成了。打开samples表,我们会发现新的栏目已经被创建。

注意,php artisan migrate:refresh命令相当于

$ php artisan migrate:reset       

$ php artisan migrate

所以我们经常会使用到。

2. 另一种情况,我们需要详细记录每一个数据库操作,例如在production环境下进行数据库修改。

首先我们需要添加一个package:

$ composer require doctrine/dbal

要进行表的修改必须添加以上包裹。

完成后我们需要创建一个新的迁移文件:

$ php artisan make:migration add_url_field_to_samples_table --table=samples

我们想要添加一个url栏目,并且让它在name之后,我们在Schema::table函数中填入以下代码:

<?php      
  
use Illuminate\Support\Facades\Schema;      
use Illuminate\Database\Schema\Blueprint;      
use Illuminate\Database\Migrations\Migration;      
  
class ModifySamplesTable extends Migration      
{      
  /**      
   * Run the migrations.      
   *      
   * @return void      
   */      
  public function up()      
  {      
    Schema::table('samples', function (Blueprint $table) {      
      $table->string('url', 200)->after('name');   
    });      
  }      
  
  /**      
   * Reverse the migrations.      
   *      
   * @return void      
   */      
  public function down()      
  {      
    Schema::table('samples', function (Blueprint $table) {      
      $table->dropColumn('url');     
    });      
  }      
}

完成后,我们运行migrate:

$ php artisan migrate

这样,url就被添加进了sample表中,并且位置处于name之后。

我们在samples表中插入了新的url栏目,那么现在如果我们想把name这个栏目长度限制从100修改为50,该怎么做呢?

同理,我们需要先创建一个migration:

$ php artisan make:migration modify_name_column_in_samples_table --table=samples

在migration文件中,我们添加以下代码:

<?php      
  
use Illuminate\Support\Facades\Schema;      
use Illuminate\Database\Schema\Blueprint;      
use Illuminate\Database\Migrations\Migration;      
  
class ModifyNameColumnInSamplesTable extends Migration      
{      
  /**      
   * Run the migrations.      
   *      
   * @return void      
   */      
  public function up()      
  {      
    Schema::table('samples', function (Blueprint $table) {      
      $table->string('name', 50)->change();       
    });      
  }      
  
  /**      
   * Reverse the migrations.      
   *      
   * @return void      
   */      
  public function down()      
  {      
    Schema::table('samples', function (Blueprint $table) {      
      $table->string('name', 100)->change();      
    });      
  }      
}

完成后,我们再次运行migrate:

$ php artisan migrate

这样一来就完成了栏目的修改,非常的直观。

注意:如果我们想把某个栏目改成其他类型,可以采用以下语法

$table->text('name')->change();

完成之后,再次运行php artisan migrate,我们就可以看到name已经从VARCHAR变为了TEXT类型了。

好了,本文主要讲解了Laravel框架中数据库迁移操作的方法实例,更多关于Laravel框架的使用技巧请查看下面的相关链接

PHP 相关文章推荐
玩转图像函数库―常见图形操作
Sep 03 PHP
人大复印资料处理程序_输入篇
Oct 09 PHP
一步一步学习PHP(1) php开发环境配置
Feb 15 PHP
PHP5 字符串处理函数大全
Mar 23 PHP
PHPUnit PHP测试框架安装方法
Mar 23 PHP
PHP之数组学习
May 29 PHP
yiic命令时提示“php.exe”不是内部或外部命令的解决方法
Dec 18 PHP
php压缩和解压缩字符串的方法
Mar 14 PHP
利用PHP判断是手机移动端还是PC端访问的函数示例
Dec 14 PHP
PHP MVC框架中类的自动加载机制实例分析
Sep 18 PHP
Laravel框架Blade模板简介及模板继承用法分析
Dec 03 PHP
thinkphp5 redis缓存新增方法实例讲解
Mar 24 PHP
Laravel框架中队列和工作(Queues、Jobs)操作实例详解
Apr 06 #PHP
Laravel实现批量更新多条数据
Apr 06 #PHP
PHP正则之正向预查与反向预查讲解与实例
Apr 06 #PHP
TP5框架安全机制实例分析
Apr 05 #PHP
TP5框架实现自定义分页样式的方法示例
Apr 05 #PHP
TP5框架model常见操作示例小结【增删改查、聚合、时间戳、软删除等】
Apr 05 #PHP
TP5框架实现签到功能的方法分析
Apr 05 #PHP
You might like
印尼林东PWN黄金曼特宁咖啡豆:怎么冲世界上最醇厚的咖啡冲煮教程
2021/03/03 冲泡冲煮
php+html5使用FormData对象提交表单及上传图片的方法
2015/02/11 PHP
PHP实现自动对图片进行滚动显示的方法
2015/03/12 PHP
PHP观察者模式原理与简单实现方法示例
2017/08/25 PHP
javascript 获取页面的高度及滚动条的位置的代码
2010/05/06 Javascript
js实现倒计时(距离结束还有)示例代码
2013/07/24 Javascript
jQuery遍历之next()、nextAll()方法使用实例
2014/11/08 Javascript
jquery通过load获取文件的内容并跳到锚点的方法
2015/01/29 Javascript
js实现五星评价功能
2017/03/08 Javascript
JavaScript实现的搜索及高亮显示功能示例
2017/08/14 Javascript
你应该了解的JavaScript Array.map()五种用途小结
2018/11/14 Javascript
js设置鼠标悬停改变背景色实现详解
2019/06/26 Javascript
thinkjs微信中控之微信鉴权登陆的实现代码
2019/08/08 Javascript
[01:42]TI4西雅图DOTA2前线报道 第一顿早饭哦
2014/07/08 DOTA
[42:35]2018DOTA2亚洲邀请赛3月30日 小组赛A组 VG VS OpTic
2018/03/31 DOTA
跟老齐学Python之重回函数
2014/10/10 Python
详解Python中的变量及其命名和打印
2016/03/11 Python
浅谈Tensorflow模型的保存与恢复加载
2018/04/26 Python
对PyQt5基本窗口控件 QMainWindow的使用详解
2019/06/19 Python
Python监控服务器实用工具psutil使用解析
2019/12/19 Python
Python跑循环时内存泄露的解决方法
2020/01/13 Python
CSS3下的渐变文字效果实现示例
2018/03/02 HTML / CSS
canvas实现圆绘制的示例代码
2019/09/11 HTML / CSS
HTML5不支持标签和新增标签详解
2016/06/27 HTML / CSS
Blancsom美国/加拿大:服装和生活用品供应商
2018/07/27 全球购物
自荐信格式范文
2013/10/07 职场文书
葡萄牙语专业个人求职信
2013/12/10 职场文书
高中教师评语大全
2014/04/25 职场文书
学校校庆演讲稿
2014/05/22 职场文书
运动会班级口号
2014/06/09 职场文书
公司离职证明范本(5篇)
2014/09/17 职场文书
幼儿教师师德师风自我剖析材料
2014/09/29 职场文书
政风行风建设整改方案
2014/10/27 职场文书
2014年英语教研组工作总结
2014/12/06 职场文书
志愿者服务活动总结报告
2015/05/06 职场文书
2017年寒假社区服务活动总结
2016/04/06 职场文书