Laravel 4

我自己學習 PHP 其實都只是一年前開始,這是因為我選修了兩科關於 PHP 的科目。那時學的都是一些最基本的 PHP,製作 HTML 表單連驗證、修改、儲存到資料庫都是用同一個 PHP 檔案,內裏用幾個 if 來分隔開不同的部分,還會用 session 來重新填寫表單內容。現在回想起都覺得這種寫法非常嘔心,因為實在太長,而且夾雜着 PHP 和 HTML,自己寫完都不想再去看。所以那時就試用 CodeIgniter 這套 PHP framework 來做 project,因為這些 Framework 都會替你分好 MVC,不用自己慢慢研究怎樣分,只要跟着它的習慣去寫就不會再有一個 PHP 檔做全部的動作。 過了幾個月之後,在 Nettuts+ 看到有關 Laravel 的介紹,覺得它不錯。它提供的 function 就算不看說明文件也可以大約估計到它的意思,而且說明文件簡單明瞭,大部分要用到的功能都會在說明文件中找到,不用查 API。據介紹 Laravel 是抄 Ruby on Rails 的特色,例如有:

  • ActiveRecord:即是 Laravel 叫的 Eloquent ORM (Object Relational Mapping),可以用簡單易明的語法來做 database CRUD,無需寫 SQL statement
  • Migration:將 Database schema 的改動寫入 PHP 檔內,再用 Laravel 提供的 Artisan CLI 工具執行或者還原到上一個版本。方便和其他開發人員同步各自 database 的 schema,不用再 export SQL file
  • Generate:透過 Laravel 4 的 Artisan CLI 工具產生 PHP 檔案(例如 Controller class、Model class、View 等等,Laravel 3 可以裝第三方的 command 來補上這個功能)
  • Gems:Laravel 3 是用自家制式的 Bundle;Laravel 4 是用 Composer
  • RESTful:可以做到 RESTful controller,Laravel 4 還新加了 Resource controller
    再加上一堆常用的現成功能如 HTML 表單製作 helper class、表單驗証、登入系統、Blade template(Laravel 自家 Templating 格式)、Pagination、Routing 等等令開發時間加快。上月開站的 CityU GE 指南都是用 Laravel 3 寫的,再配 Twitter BootstrapFont Awesome 做 UI。

而 Laravel 4 (L4) 在上星期推出了 4.0.0 版,這個版本基本上是重新寫過。亦正因為它是重新寫過,大部分 Laravel 3 (L3) 的 Class 和 Function 都改了,如果要升級的話就要逐個 PHP 檔案改成 L4 的 Class 和 Function。除了加添更多新功能外,L4 最大的改變是轉用 Composer 來管理組件,整個 Framework 都是由不同的組件組合而成。如果不喜歡 Laravel 的作法可以裝原裝組件換成自己喜歡的,例如將 Blade 換做 Smarty。而 L4 本身亦用上了其他現成的組件,例如 Symfonywhoops!(L4 那個很漂亮的錯誤報告畫面就是用這個 Library 做出來的)、Swift Mailer 等等。組件的安裝和更新可以用 Composer 替你完成,不用再自己手動換檔案。另一樣比較明顯的變化是 L4 遵守 PSR-0 and PSR-1 標準,Class 名要用 StudlyCaps、Function 名要用 camelCase,和新的 PHP 5 class 或者 Java 一樣。幸好 CityU GE 指南的規模不大,三兩日就可以將原先的 code 升級成 L4。首先要大改的就是將原先的 snake_case variable / function / class 名按照 PSR-1 標準替換。其次是將 class / function 名變成 L4 的(因為有不少常用的 function 都改了 signature)。之後再到 Packagist 找尋 reCAPTCHA、RSS feed 和 Sitemap class 的組件取代原先的 L3 bundle,並用 Composer 加到 project 內。這個過程都算輕鬆,因為這些組件是一般常用的組件,很容易找到。

Laravel 4 改用 Composer 管理組件的安裝、更新及相依性

Laravel 3 和 Laravel 4 的用法上的改動可以參考 Jeffery Way 的 Laravel 4 Mastery 和 Jason Lewis 的 Laravel 4: Illuminating Your Laravel 3 Applications。不過因為這些影片和文章都是在 Beta 版時寫的,和正式版會有小量出入。以下是我升級 CityU GE 指南時主要遇到的變化:

HTML、Form、Blade、Asset Management、i18n

  • L3 用來產生 HTML <a> tag 的 HTML::link()HTML::link_to_route()HTML::link_to_secure() 在 L4 變成了 global function link_to()link_to_action()
  • Form class 仍然存在,在 L4 beta 時曾傳出 L4 會取消
  • Form::open() 的傳入參數改為一個 associative array
  • Asset class 已經消失,要自己找替代品,或者乾脆不用
  • Blade 的 @include() 易名為 @extends()
  • Blade 的 @endsection 易名為 @stop(但不轉也可以用到,但上面的 @include 就一定要改)
  • Blade 新增了{{{ }}} 語法,括在裏面的 variable 會做一次 HTML escape;而原有的 {{ }} 語法就和以前一樣不會 escape
  • e() 這個 escape HTML entity 的 function 仍然存在
  • Lang class 已經可以支援單數 / 眾數 / 個別數量時會套用不同款的翻譯字串
  • L3 內 __() 這個模仿 gettext 的 functoin 在 L4 改為 trans()trans_choice() 或者 Lang::get()Lang::choice()

Pagination

  • Paginate 過的 variable 如果要取得本頁的行列的話 L3 是 foreach ($courses->results as $course) {...};L4 則不用再加 results,即是 foreach ($courses as $course) {...}
  • 因為上述的改動,如果要檢查 paginate 過的結果是否為空的話,要使用 if (!$courses->getTotal()) {...}

Route

  • 新增了 resource controller:Route::resource()(可以方便做 RESTful API,它會自動產生 RESTful URL,並且會有 route name)
  • 新增了 sub-domain routing
  • 新增了 route prefix(即是網址中段的 directory 名),例如要做一個 admin section,不用再每個 admin section 的 route 加 /admin/,可以用 Route::group(array('prefix' => 'admin'), function() {...}) 包起所有 admin section 的 route

URL、Request、Response

  • URL::base() 這個 function 改為使用 URL::to('')
  • L3 要取得目前這個 request 的 route name 是用 Request::route()->action['as'] 而 L4 是用 Route::currentRouteName()
  • 要送出 HTTP 404、500 等 error,L3 是用 return Response::error('404') 而 L4 是用 return App::abort(404)

Raw Query、Eloquent、Migration

  • L3 raw query 的 DB::only() 在 L4 已經取消
  • L4 可以用到 transaction
  • L3 要執行 raw query 是 DB::query() 而 L4 則分拆成 DB::select()DB::insert()DB::update()DB::delete()DB::statement
  • Eloquent model 的 getter 和 setter function 的命名規則分別改為 getFooAttribute()setFirstNameAttribute()FooFirstName 是 database column 名(留意 column 名仍然是用 snake_case,所以 setFirstNameAttribute() 是對應 database table 的 first_name column)
  • 新加了 database seed 功能,可以不用再將填測試或預設資料寫成 DB schema 的 migration,並且在有需要時才導入到資料庫中
  • 經 Eloquent 取得的 created_atupdated_atdeleted_at column 不再是普通的 string,而是 extends 自 DateTimeCarbon object,它提供一些方便易用的 function 來切換顯示格式、運算和處理這些日期和時間

Artisan

  • 新增了 php artisan serve,只要讓 console 開着的話就可以用 PHP 內置的網頁伺服器運行這個 Laravel project,可以不用設定 VirtualHost
  • 新增了 php artisan controller:make,用來產生 resource controller
  • 新增了 php artisan optimize,用來產生最佳化過的 class loader,加快載入速度
  • 新增了 php artisan migrate:refresh,可以還原所有 migration 並重新執行所有 migration

其他

  • dd() 仍然可以使用
  • L4 目前未有內置 profiler bar (Anbu),但可以用 loic-sharma/profiler 代替
    其實還有很多的改變,只是我在這次升級未有遇到。要查 L4 的說明文件可以到 Laravel 官方網站,官方網站亦都有 L4 API。說明文件並沒有將所有 function 列出,如果要找一些比較少用的 function 就要到 API documentation 查。如果已經有 L3 的 project 的話,其實可以繼續用 L3。因為升級不只是換 Laravel 的核心檔案,還要逐個檔案去改。但如果是要開始一個新 project 的話,就最好用 L4。因為 L3 將會淡出,日後未必再有新的 L3 bundle 可以用。相反,L4 是用 Packagist,愈來愈多 PHP framework 都開始支援 Packagist / Composer,這意味着日後會有更多現成組件可以用,節省自己開發的時間。