Laravel 5.4默認使用utf8mb4
字符編碼,而不是以前的utf8
編碼。所以運行php artisan migrate
會出現以下錯誤:php
[Illuminate\Database\QueryException] SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too 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 too long; max key length is 767 bytes
MySql支持的utf8
編碼最大字符長度爲3字節,若是遇到4字節的寬字符就會出現插入異常。三個字節UTF-8最大能編碼的Unicode字符是0xffff,即Unicode中的基本多文種平面(BMP)。於是包括Emoji表情(Emoji是一種特殊的Unicode編碼)在內的非基本多文種平面的Unicode字符都沒法使用MySql的utf8
字符集存儲。mysql
這也應該就是Laravel 5.4改用4字節長度的utf8mb4
字符編碼的緣由之一。不過要注意的是,只有MySql 5.5.3版本之後纔開始支持utf8mb4
字符編碼(查看版本:select version();
)。若是MySql版本太低,須要進行版本更新。sql
注:若是是從Laravel 5.3升級到Laravel 5.4,不須要對字符編碼作切換。ide
手動配置遷移命令migrate
生成的默認字符串長度,在AppServiceProvider
中調用Schema::defaultStringLength
方法來實現配置:編碼
use Illuminate\Support\Facades\Schema; public function boot() { Schema::defaultStringLength(191); }