Laravel實(shí)現(xiàn)數(shù)據(jù)庫(kù)遷移與支持中文的填充

前言

數(shù)據(jù)庫(kù)遷移實(shí)際上就是對(duì)數(shù)據(jù)庫(kù)庫(kù)表的結(jié)構(gòu)變化做版本控制,之前對(duì)數(shù)據(jù)庫(kù)庫(kù)表結(jié)構(gòu)做修改的方式比較原始,比如說(shuō)對(duì)某張庫(kù)表新增了一個(gè)字段,都是直接在庫(kù)表中執(zhí)行alter table xxx add .. 的方式直接修改,但是這么做有些弊端,比如在開(kāi)發(fā)階段,你自己的庫(kù)表修改了,還要把這句sql語(yǔ)句傳給別人再執(zhí)行一遍,這在多人協(xié)同開(kāi)發(fā)時(shí)不是一種好的方式.那有沒(méi)有一種方式能讓我們對(duì)數(shù)據(jù)庫(kù) 庫(kù)表的修改做一些簡(jiǎn)單的版本控制,同時(shí)能讓其他人很方便的同步我們對(duì)數(shù)據(jù)庫(kù)的修改呢?

答案是我們可以使用Laravel 內(nèi)置的Migrations .

對(duì)數(shù)據(jù)庫(kù)的管理包括哪些部分?

其實(shí)Laravel對(duì)數(shù)據(jù)庫(kù)的版本管理主要包括兩部門(mén): 數(shù)據(jù)庫(kù)結(jié)構(gòu)的管理 和數(shù)據(jù)的管理.

• 數(shù)據(jù)庫(kù)結(jié)構(gòu)的管理: 主要是對(duì)數(shù)據(jù)庫(kù)結(jié)構(gòu)進(jìn)行管理,比如新增了一張表,某張表增加了一個(gè)字段等等.
• 數(shù)據(jù)的管理: 這個(gè)主要是管理表中的數(shù)據(jù),生成一些填充數(shù)據(jù),解決我們開(kāi)發(fā)調(diào)試時(shí)沒(méi)有測(cè)試數(shù)據(jù)的問(wèn)題.

經(jīng)常我們做項(xiàng)目都團(tuán)隊(duì)協(xié)作開(kāi)發(fā)，每個(gè)人都在自己本地的數(shù)據(jù)庫(kù)，如果你曾經(jīng)出現(xiàn)過(guò)讓同事手動(dòng)在數(shù)據(jù)庫(kù)結(jié)構(gòu)中添加字段的情況，數(shù)據(jù)庫(kù)遷移可以解決你這個(gè)問(wèn)題。

不僅如此，在線上部署的時(shí)候，也避免了手動(dòng)導(dǎo)入數(shù)據(jù)庫(kù)或手動(dòng)修改數(shù)據(jù)結(jié)構(gòu)的麻煩，數(shù)據(jù)遷移幫你方便的維護(hù)著數(shù)據(jù)結(jié)構(gòu)。

數(shù)據(jù)填充，讓我們測(cè)試的時(shí)候需要大量的假數(shù)據(jù)不再一條一條的去造數(shù)據(jù)，可以輕松的批量填充大量數(shù)據(jù)。

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

數(shù)據(jù)遷移

假如我們需要一張學(xué)生表，我們不再使用原生SQl語(yǔ)句去創(chuàng)建表。

創(chuàng)建遷移文件

前提是已經(jīng)配置好了數(shù)據(jù)庫(kù)連接信息

php artisan make:migration create_students_table

此命令會(huì)在database/migrations/目錄生成類似2017_10_28_035802_create_students_table.php的文件

我們?cè)诶镞吿砑觭tudents表的數(shù)據(jù)結(jié)構(gòu)

?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) {
  // 存儲(chǔ)引擎
  $table->engine = 'InnoDB';
  // id自增
  $table->increments('id');
  // 學(xué)生名稱
  $table->string('name');
  // 性別
  $table->string('sex');
  // 郵箱
  $table->string('email');
  // 喜愛(ài)的顏色
  $table->string('favorite_color');
  // 手機(jī)號(hào)
  $table->string('phone');
  // 地址
  $table->string('addr');
  // 自動(dòng)維護(hù)時(shí)間戳
  $table->timestamps();
 });
 }

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

更多用法，請(qǐng)參考官方手冊(cè)。

運(yùn)行遷移

php artisan migrate

這樣會(huì)運(yùn)行database/migrations/目錄的所有遷移文件，并自動(dòng)創(chuàng)建migrations表，來(lái)記錄已經(jīng)運(yùn)行過(guò)的遷移文件，防止重復(fù)運(yùn)行。

我們看一下數(shù)據(jù)庫(kù)是不是自動(dòng)創(chuàng)建了students表了呢。

如果出現(xiàn)以下錯(cuò)誤：

[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/目錄里會(huì)有l(wèi)aravel自帶的用戶和重置密碼的兩個(gè)遷移文件，會(huì)一并運(yùn)行。
在這里我們這樣解決，修改數(shù)據(jù)庫(kù)配置文件config/database.php里的mysql下的字符集為utf8即可

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

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

數(shù)據(jù)填充（支持中文）

創(chuàng)建學(xué)生表Eloquent模型

在app目錄下創(chuàng)建Student.php

?php
namespace App;

use Illuminate\Database\Eloquent\Model;

/**
 * 學(xué)生模型
 */
class Student extends Model
{
 
}

創(chuàng)建填充文件

php artisan make:seed StudentsTableSeeder

這條命令會(huì)在database/seeds/目錄下生成StudentsTableSeeder.php填充文件

?php

use Illuminate\Database\Seeder;

class StudentsTableSeeder extends Seeder
{
 /**
 * Run the database seeds.
 *
 * @return void
 */
 public function run()
 {
 // 調(diào)用模型工廠 生成10000條數(shù)據(jù)
 factory(App\Student::class, 10000)->create();
 }
}

調(diào)用該 Seeders

我們打開(kāi)database/seeds/DatabaseSeeder.php文件，修改為

?php

use Illuminate\Database\Seeder;

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

創(chuàng)建 模型工廠 填充

php artisan make:factory StudentsFactory -m Student

此命令會(huì)在database/factories/目錄下生成StudentsFactory.php文件,我們定義一下要填充的數(shù)據(jù)格式

?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,
 ];
});

更多配置請(qǐng)查閱 vendor/fzaninotto/faker/src/Faker/Generator.php文件

讓faker填充中文

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

開(kāi)始填充

首先我們執(zhí)行一下：

composer dump-autoload

自動(dòng)加載一下我們?cè)赿atabase/seeds/目錄創(chuàng)建的填充文件，以避免出現(xiàn)以下錯(cuò)誤：

[ReflectionException]
Class StudentsTableSeeder does not exist

接著我們運(yùn)行填充命令：

php artisan db:seed

由于我們填充的是一萬(wàn)條數(shù)據(jù)，可以時(shí)間稍長(zhǎng)，可以刷新數(shù)據(jù)庫(kù)看著逐條增加的數(shù)據(jù)。

大功告成

如果以上操作都沒(méi)有報(bào)錯(cuò)的話，來(lái)看一下我們的數(shù)據(jù)庫(kù)表students表是否有數(shù)據(jù)了呢？