Laravel实现数据库迁移与支持中文的填充-巨人网络通讯

Laravel实现数据库迁移与支持中文的填充

前言

数据库迁移实际上就是对数据库库表的结构变化做版本控制,之前对数据库库表结构做修改的方式比较原始,比如说对某张库表新增了一个字段,都是直接在库表中执行alter table xxx add .. 的方式直接修改,但是这么做有些弊端,比如在开发阶段,你自己的库表修改了,还要把这句sql语句传给别人再执行一遍,这在多人协同开发时不是一种好的方式.那有没有一种方式能让我们对数据库库表的修改做一些简单的版本控制,同时能让其他人很方便的同步我们对数据库的修改呢?

答案是我们可以使用Laravel 内置的Migrations .

对数据库的管理包括哪些部分?

其实Laravel对数据库的版本管理主要包括两部门: 数据库结构的管理和数据的管理.

数据库结构的管理: 主要是对数据库结构进行管理,比如新增了一张表,某张表增加了一个字段等等.
数据的管理: 这个主要是管理表中的数据,生成一些填充数据,解决我们开发调试时没有测试数据的问题.

经常我们做项目都团队协作开发，每个人都在自己本地的数据库，如果你曾经出现过让同事手动在数据库结构中添加字段的情况，数据库迁移可以解决你这个问题。

不仅如此，在线上部署的时候，也避免了手动导入数据库或手动修改数据结构的麻烦，数据迁移帮你方便的维护着数据结构。

数据填充，让我们测试的时候需要大量的假数据不再一条一条的去造数据，可以轻松的批量填充大量数据。

本文基于Laravel5.5，其他版本大同小异。

数据迁移

假如我们需要一张学生表，我们不再使用原生SQl语句去创建表。

创建迁移文件

前提是已经配置好了数据库连接信息

php artisan make:migration create_students_table

此命令会在database/migrations/目录生成类似2017_10_28_035802_create_students_table.php的文件

我们在里边添加students表的数据结构

?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateStudentsTable extends Migration
{
 /**
 * Run the migrations.
 *
 * @return void
 */
 public function up()
 {
 // students为表名称
 Schema::create('students', function (Blueprint $table) {
  // 存储引擎
  $table->engine = 'InnoDB';
  // id自增
  $table->increments('id');
  // 学生名称
  $table->string('name');
  // 性别
  $table->string('sex');
  // 邮箱
  $table->string('email');
  // 喜爱的颜色
  $table->string('favorite_color');
  // 手机号
  $table->string('phone');
  // 地址
  $table->string('addr');
  // 自动维护时间戳
  $table->timestamps();
 });
 }

 /**
 * Reverse the migrations.
 *
 * @return void
 */
 public function down()
 {
 Schema::dropIfExists('students');
 }
}

更多用法，请参考官方手册。

运行迁移

php artisan migrate

这样会运行database/migrations/目录的所有迁移文件，并自动创建migrations表，来记录已经运行过的迁移文件，防止重复运行。

我们看一下数据库是不是自动创建了students表了呢。

如果出现以下错误：

[Illuminate\Database\QueryException]
SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was t
oo long; max key length is 767 bytes (SQL: alter table users add unique users_email_unique(email))

[PDOException]
SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was t
oo long; max key length is 767 bytes

在database/migrations/目录里会有laravel自带的用户和重置密码的两个迁移文件，会一并运行。
在这里我们这样解决，修改数据库配置文件config/database.php里的mysql下的字符集为utf8即可

'charset' => 'utf8',
'collation' => 'utf8_unicode_ci',

想知道为什么，可猛戳：https://www.jb51.net/article/127319.htm

数据填充（支持中文）

创建学生表Eloquent模型

在app目录下创建Student.php

?php
namespace App;

use Illuminate\Database\Eloquent\Model;

/**
 * 学生模型
 */
class Student extends Model
{
 
}

创建填充文件

php artisan make:seed StudentsTableSeeder

这条命令会在database/seeds/目录下生成StudentsTableSeeder.php填充文件

?php

use Illuminate\Database\Seeder;

class StudentsTableSeeder extends Seeder
{
 /**
 * Run the database seeds.
 *
 * @return void
 */
 public function run()
 {
 // 调用模型工厂 生成10000条数据
 factory(App\Student::class, 10000)->create();
 }
}

调用该 Seeders

我们打开database/seeds/DatabaseSeeder.php文件，修改为

?php

use Illuminate\Database\Seeder;

class DatabaseSeeder extends Seeder
{
 /**
 * Run the database seeds.
 *
 * @return void
 */
 public function run()
 {
 // 调用学生表填充文件
 $this->call(StudentsTableSeeder::class);
 }
}

创建模型工厂填充

php artisan make:factory StudentsFactory -m Student

此命令会在database/factories/目录下生成StudentsFactory.php文件,我们定义一下要填充的数据格式

?php

use Faker\Generator as Faker;

/* @var Illuminate\Database\Eloquent\Factory $factory */

$factory->define(App\Student::class, function (Faker $faker) {
 $sex = rand(1, 1000);
 return [
 'name'  => $faker->name,
 'sex'  => $sex % 2 == 0 ? '男' : '女',
 'email'  => $faker->unique()->safeEmail,
 'favorite_color' => $faker->safeColorName,
 'phone'  => $faker->phoneNumber,
 'addr'  => $faker->address,
 ];
});

更多配置请查阅 vendor/fzaninotto/faker/src/Faker/Generator.php文件

让faker填充中文

 public function boot()
 {
 // 填充中文数据
 $this->app->singleton(\Faker\Generator::class, function () {
  return \Faker\Factory::create('zh_CN');
 });
 }

开始填充

首先我们执行一下：

composer dump-autoload

自动加载一下我们在database/seeds/目录创建的填充文件，以避免出现以下错误：

[ReflectionException]
Class StudentsTableSeeder does not exist

接着我们运行填充命令：

php artisan db:seed

由于我们填充的是一万条数据，可以时间稍长，可以刷新数据库看着逐条增加的数据。

大功告成

如果以上操作都没有报错的话，来看一下我们的数据库表students表是否有数据了呢？

id	name	sex	email	favorite_color	phone	addr	created_at	updated_at
10000	谈英	男	cum_et@example.com	白色	17642207316	贵阳海陵区	2017-10-28 05:19:10	2017-10-28 05:19:10
9999	汤淑珍	男	qlaudantium@example.net	黑色	18239453935	南宁友好区	2017-10-28 05:19:10	2017-10-28 05:19:10
9998	贾春梅	男	ea35@example.com	粟色	17103645128	长沙萧山区	2017-10-28 05:19:10	2017-10-28 05:19:10
9997	季志明	男	cdeleniti@example.com	灰色	17002359608	天津花溪区	2017-10-28 05:19:10	2017-10-28 05:19:10
9996	成燕	男	aspernatur.aut@example.com	黄色	17181193397	贵阳锡山区 2017-10-28 05:19:	10	2017-10-28 05:19:10
9995	米博	男	reprehenderit_autem@example.com	紫	17187328893	广州东丽区	2017-10-28 05:19:10	2017-10-28 05:19:10
9994	兰淑兰	女	et_ea@example.com	绿色	18592254358	兰州经济开发新区	2017-10-28 05:19:10	2017-10-28 05:19:10
9993	乐瑶	女	vel.vitae@example.org	藏青	15891490007	香港龙潭区 2017-10-28 05:19:	10	2017-10-28 05:19:10
9992	叶志新	女	lcumque@example.net	藏青	15564391466	北京高明区	2017-10-28 05:19:10	2017-10-28 05:19:10
9991	胥杨	男	voluptatem00@example.com	黄色	17097722096	郑州新城区	2017-10-28 05:19:10	2017-10-28 05:19:10
9990	凌敏	女	magni22@example.org	鲜绿色	13021578051	杭州涪城区	2017-10-28 05:19:10	2017-10-28 05:19:10
9989	席建	女	fugiat_accusantium@example.net	紫	18070573726	南昌海陵区	2017-10-28 05:19:10	2017-10-28 05:19:10
9988	聂新华	女	debitis_sapiente@example.com	水色	17004061646	成都南长区	2017-10-28 05:19:10	2017-10-28 05:19:10