譯注: 期待 Laravel 5.0 已經很久很久了, 之前跳票說要到今年一月份發布. 從一月份就一直在刷新官網和博客, 始終沒有更新的消息, 前幾天終于看到官網文檔切換到了 5.0 版. 新版本帶來了眾多令人激動的新特性, 尤其是定時任務隊列和表單請求兩個特性, 光看一下更新說明中的簡單介紹都忍不住要上手嘗試了. 今天總算抽出一點時間把官方的新特性說明文檔簡單地翻譯了一下, 希望所有喜歡 Laravel 框架的朋友都能感受到這個版本帶來的激動人心的改變. 當然, 如果你需要的是 Phalcon 那樣的性能, 那它肯定不是你需要的. 如果你是因為虛擬主機不支持 php 5.4 而不能享受 Laravel, 那你還不扔了你的虛擬主機??? 阿里云/騰訊云/linode... VPS的選擇不要太多...
Laravel 5.0
Laravel 5.0 引入了全新的項目目錄結構. 新的目錄結構更有利于用 Laravel 來創建應用. 5.0 版從頭到尾都采用了新的 PSR-4 自動加載標準. 以下是 5.0 版主要的新特性:
目錄結構
以前版本中的 app/models 目錄被整個移除. 如今你可以直接把代碼放在 app 目錄下, 該目錄下的所有代碼默認會被組織到 app 命名空間. 這個命名空間是可以通過新增加的 Artisan 命令 app:name 來修改的.
Controllers, middleware 和 requests (Laravel 5.0 新增加的一種類) 被組織到 app/Http 目錄, 因為他們都是與你應用的 HTTP 傳輸層相關的類. 與之前把所有路由過濾器放到單一的 filters 文件下不同, 現在所有的 middleware (類似之前的 route filter) 被分別存放到各自自己的類文件中.
新版本中增加了一個 app/Providers 目錄來代替之前 4.x 版本的 app/start 文件. 這些 service providers 為應用提供各種各樣的引導方法, 比如錯誤處理, 日志記錄, 路由加載等. 除此之外你當然也可以創建額外的 service providers.
應用的語言文件和視圖被移到了 resources 目錄.
Contracts
Laravel 的所有主要組件都實現了存放在 illuminate/contracts 倉庫中的接口. 該倉庫沒有額外的依賴項. 擁有這樣一個方便的, 集中存放的接口集合, 你就可以很容易地通過它來對 Laravel Facades 進行解耦和依賴注入方面的選擇和修改.
了解有關 contracts 的更多信息, 可以查看它的完整文檔.
路由緩存
如果你的應用由各種各樣的控制器路由 (controller routes) 組成, 你可以利用新增的 Artisan 命令 route:cache 大幅度提升路由的注冊速度. 這在路由數量超過 100 個的應用中尤其有效, 可以 大幅度 提升整個應用在路由部分的速度.
路由中間件 (Route Middleware)
在 4.0 版風格的路由 "過濾器" 基礎上, 新版 5.0 已經支持 HTTP 中間件, Laravel 自帶的 "authentication" 和 "filters" 已經被轉換成中間件. 中間件為所有類型的過濾器提供了單一接口, 你可以很容易地對請求進行審查和拒絕.
了解有關中間件的更多信息, 可以查看它的完整文檔.
控制器方法注入
除了現有的構造器注入以外, 在新版本中還可以在控制器方法中的依賴項進行類型約束. IoC container 會自動注入依賴項, 即使在路由包含其它參數的時候也是.
public function createPost(Request $request, PostRepository $posts)
{
//
}
認證腳手架
用戶注冊, 認證以及密碼重置控制器已經內置在 5.0 版的網站框架中, 除了控制器以外, 還有簡單的視圖, 存放在 resources/views/auth 目錄. 除此之外, 網站初始框架中還包含了一個 "users" 表的 migration 文件. 這些簡單的資源幫助開發者不用在用戶認證功能上耗費大量時間. 認證相關的頁面可以通過 auth/login 和 auth/register 這兩個路由訪問. App/Services/Auth/Registrar 服務負責處理創建和認證用戶.
事件對象
在新版本中, 你可以把事件定義成對象而不是字符串. 看下面的例子:
class PodcastWasPurchased {
public $podcast;
public function __construct(Podcast $podcast)
{
$this->podcast = $podcast;
}
}
這個事件可以這樣調用:
Event::fire(new PodcastWasPurchased($podcast));
當然, 你的事件處理程序收到的也不再是一個數據列表, 而是一個事件對象:
class ReportPodcastPurchase {
public function handle(PodcastWasPurchased $event)
{
//
}
}
了解有關事件的更多信息, 可以查看它的完整文檔.
命令/隊列
在 4.0 版支持的任務隊列基礎上, 5.0 支持把任務隊列定義為簡單的命令對象. 這些命令存放在 app/Commands 目錄. 下面是一個簡單的命令示例:
class PurchasePodcast extends Command implements SelfHandling, ShouldBeQueued {
use SerializesModels;
protected $user, $podcast;
/**
* 創建新的命令實例
*
* @return void
*/
public function __construct(User $user, Podcast $podcast)
{
$this->user = $user;
$this->podcast = $podcast;
}
/**
* 執行命令
*
* @return void
*/
public function handle()
{
// 處理購買播客視頻的邏輯
event(new PodcastWasPurchased($this->user, $this->podcast));
}
}
Laravel 的基礎控制器 (base controller) 使用了新的 DispatchesCommands 特性, 允許你很方便地監控命令的執行:
$this->dispatch(new PurchasePodcastCommand($user, $podcast));
當然, 你不僅可以把命令用于任務隊列(非同步執行), 也可以用于同步任務. 事實上, 把你的應用需要執行的復雜任務封裝成命令是一個很好的選擇. 了解有關命令的更多信息, 可以查看命令橋的詳細文檔.
數據庫隊列
新版 Laravel 包含 database 隊列驅動, 提供簡單的, 本地的隊列驅動, 無需安裝額外的包. (譯注:比如讓不支持事務的數據庫進行類似事務的數據操作)
Laravel 定時任務
在過去, 為了定時執行控制臺任務, 開發者必須依賴 Cron 任務. 這帶來很大不便. 因為定時任務并不包括在網站的源代碼中, 而且必須通過 SSH 登陸到服務器去添加 Cron 任務. 新版 Laravel 的定時任務允許開發者在 Laravel 框架內來定義定時執行的命令, 然后只需要在服務器上定義一個總的 Cron 任務即可.
比如:
$schedule->command('artisan:command')->dailyAt('15:00');
同樣的, 了解更多有關定時任務的信息, 可以查閱完整文檔.
Tinker / Psysh
php artisan tinker 命令在新版本中借助了 Justin Heleman 開發的 Psysh. 如果你喜歡 Laravel 4.0 里的 Boris, 你肯定會喜歡 Psysh. Boris 在 Windows 下運行得不好, Psysh 完全支持 Windows! 使用方法和以前一樣:
php artisan tinker
DotEnv
在 Laravel 5.0 中, 用 Vance Lucas 實現的 DotEnv 替代了以前版本中的嵌套結構, 容易讓人困惑的環境配置目錄. 這個框架提供了一種非常簡單的管理環境配置的方式. 在 Laravel 5.0 中檢測和區分不同的運行環境變得輕而易舉. 了解更多詳情, 請訪問完整的配置文檔.
Laravel Elixir
由 Jeffrey Way 提供的 Laravel Elixir 提供了簡明易懂的合并, 編譯資源文件的接口. 如果你曾經對配置 Grunt 或者 Gulp 感到很頭大, 那么現在你得到解放了. Elixir 讓你可以輕松地借助 Gulp 來編譯你的 Less, Sass 和 CoffeeScript 文件. 它甚至可以替你執行測試.
了解 Elixir 的更多詳情, 請訪問完整文檔.
Laravel Socialite
Laravel Socialite 只兼容 Laravel 5.0 以上版本的可選包, 它提供了完整而且上手毫無難度的 OAuth 解決方案. 目前, Socialite 支持 Facebook, Twitter, Google 和 Github. 它看起來是這個樣子的:
public function redirectForAuth()
{
return Socialize::with('twitter')->redirect();
}
public function getUserFromProvider()
{
$user = Socialize::with('twitter')->user();
}
所以你不用再耗費大量的時間來編寫 OAuth 認證流程, 分分鐘輕松搞定. 完整文檔 包含有關這個可選包的全部細節.
Flysystem 集成
新版 Laravel 還包含了強大的 Flysystem 文件處理靜態庫. 通過這個庫, 開發者可以輕易上手, 使用完全一致的 API 來實現本地, Amazon S3 或者 Rackspace 進行文件存儲. 比如, 在 Amazon S3 存儲一個文件, 可以簡單到這樣:
Storage::put('file.txt', 'contents');
了解有關 Laravel Flysystem 集成的更多細節, 可以查看它的完整文檔
表單請求
Laravel 5.0 帶來了全新的 form requests, 它擴展自 Illuminate/Foundation/Http/FormRequest 類. 這些請求對象可以和控制器方法注入相結合, 提供一種全新的驗證用戶輸入的方法. 簡單舉一個 FormRequest 的示例:
namespace App/Http/Requests;
class RegisterRequest extends FormRequest {
public function rules()
{
return [
'email' => 'required|email|unique:users',
'password' => 'required|confirmed|min:8',
];
}
public function authorize()
{
return true;
}
}
定義好對應的 FormRequest 擴展類之后, 在控制器方法中可以獲得類型提示:
public function register(RegisterRequest $request)
{
var_dump($request->input());
}
當 Laravel 的 IoC container 識別到方法變量的類型時, 它會自動注入 FormRequest 的實例, 于是這個請求會被 自動驗證. 這意味著當你的控制器被調用時, 你可以安全地使用該請求中包含的輸入數據, 因為他們已經被你在表單請求類中指定的規則進行過驗證了. 不僅如此, 如果該請求驗證失敗, 系統還會自動重定向到你預定義好的路由, 并且包含有錯誤提示的信息(根據需要寫入session, 或者轉換為 JSON 格式.) 表單驗證從未如此簡單過. 了解有關 FormRequest 驗證的更多細節, 請查閱文檔.
控制器請求簡單驗證
Laravel 5.0 的控制器基類還包含了一個 ValidatesRequests 的 trait. 該 trait 提供了簡單的 validate 方法, 用于驗證請求. 如果 FormRequests 對于你的應用來說太重了, 那你就可以用這個輕量版的:
public function createPost(Request $request)
{
$this->validate($request, [
'title' => 'required|max:255',
'body' => 'required',
]);
}
如果驗證失敗, 系統會拋出一個異常, 對應的 HTTP 請求會被自動發送給瀏覽器. 驗證錯誤也會同時寫入 session. 如果請求是用 AJAX 方式發起, Larave 會自動發送一個 JSON 形式的驗證錯誤信息.
了解有關 FormRequest 驗證的更多細節, 請查閱文檔.
全新的生成器
為了方便生成新的默認應用結構, 全新的 Artisan 生成命令已經被添加到框架中. 你可以通過 php artisan list 查看詳細命令.
配置緩存
通過 config:cache 命令, 可以把所有的配置項寫入一個緩存文件中.
Symfony VarDumper
用于輸出變量信息進行調試的輔助方法 dd, 在新版本中進行了升級, 使用強大的 Symfony VarDumper. 它可以輸出帶有顏色高亮和數組折疊功能的調試信息. 你可以嘗試一下:
dd([1, 2, 3]);
