## 全新安裝，然后遷移 推薦的升級方式是建立一個全新的 Laravel 5.0 項目，然后復制您在 4.2 的文件到此新的應用程序，這將包含控制器、路由、Eloquent 模型、Artisan 命令（Asset）、資源和關于此應用程序的其他特定文件。 最開始，安裝新的 Laravel 5 應用程序到新的本地目錄下，我們將詳細探討遷移各部分的過程。 ## Composer 依賴與組件 別忘了將任何附加于 Composer 的依賴組件加入 5.0 應用程序內，包含第三方代碼(例如 SDKs)。 部分組件也許不兼容剛發布的 Laravel 5 版本，請向組件管理者確認該組件支持 Laravel 5 的版本，當您在 Composer 內加入任何組件，請執行 `composer update`。 ## 命名空間 默認情況下，Laravel 4 沒有在應用程序的源碼中使用命名空間，所以，舉例來說，所有的 Eloquent 模型和控制器僅存在「全局」的命名空間下，為了更快速的遷移，Laravel 5 也允許您可以將這些類別一樣保留在「全局」的命名空間。 ## 設置文件 #### 遷移環境變量 復制新的 `.env.example` 文件到 `.env`，在 5.0 這相當于原本的 `.env.php`。像是您的 `APP_ENV` 和 `APP_KEY` (您的加密鑰匙)、數據庫認證和您的緩存驅動與 `session` 驅動。 此外，復制原先自定義的 `.env.php` 文件，并修改為 `.env` (本機環境的真實設置值) 和 `.env.example` (給其他團隊成員的示例)。 更多關于環境設置值，請見完整文檔。 > 注意: 在部署 Laravel 5 應用程序之前，您需要在正式主機上放置 .env 文件并設置適當的值。 #### 設置文件 Laravel 5.0 不再使用 `app/config/{environmentName}/` 目錄結構來提供對應該環境的設置文件，取而代之的是，將環境對應的設置值復制到 `.env`，然后在設置文件使用 `env('key', 'default value')` 來訪問，您可以在 `config/database.php` 文件內看到相關范例。 將設置文件放在 `config/` 目錄下，來表示所有環境共用的設置文件，或是在文件內使用 `env()` 來取得對應該環境的設置值。 請記住，若您在 `.env` 文件內增加 `key` 值，同時也要對應增加到 `.env.example` 文件中，這將可以幫助團隊成員修改他們的 `.env` 文件。 ## 路由 復制原本的 `routes.php` 文件到 `app/Http/routes.php`。 ## 控制器 下一步，請將所有的控制器復制到 `app/Http/Controllers` 目錄，既然在本指南中我們不打算遷移到完整的命名空間，請將 `app/Http/Controllers` 添加到 `composer.json` 的 `classmap`，接下來，您可以從 `app/Http/Controllers/Controller.php` 基礎抽象類中移除命名空間，并確認遷移過來的控制器要繼承這個基礎類。 在 `app/Providers/RouteServiceProvider.php` 文件中，將 `namespace` 屬性設置為 `null`。 ## 路由過濾器 將過濾器綁定從原來的 `app/filters.php` 復制到 `app/Providers/RouteServiceProvider.php` 的 `boot()` 方法中，并在 `app/Providers/RouteServiceProvider.php` 加入 `use Illuminate\Support\Facades\Route;` 來繼續使用 `Route Facade`。 您不需要移動任何 Laravel 4.0 默認的過濾器，像是 `auth` 和 `csrf` 。他們已經內置，只是換作以中間件形式出現。那些在路由或控制器內有參照到舊有的過濾器 (例如 ['before' => 'auth']) 請修改參照到新的中間件 (例如 ['middleware' => 'auth'].) Laravel 5 并沒有將過濾器移除，您一樣可以使用 `before` 和 `after` 綁定和使用您自定義的過濾器。 ## 全局 CSRF 默認情況下，所有路由都會使用CSRF 保護。若想關閉他們，或是在指定在特定路由開啟，請移除 `App\Http\Kernel` 中 `middleware` 數組內的這一行： ~~~ 'App\Http\Middleware\VerifyCsrfToken', ~~~ 如果您想在其他地方使用它，加入這一行到 $routeMiddleware: ~~~ 'csrf' => 'App\Http\Middleware\VerifyCsrfToken', ~~~ 現在，您可于路由內使用 ['middleware' => 'csrf'] 即可個別添加中間件到路由/控制器。了解更多關于中間件，請見完整文檔。 ## Eloquent 模型 你可以建立新的 `app/Models` 目錄來放置所有 Eloquent 模型。并且同樣的，在 `composer.json` 將此目錄添加到 `classmap` 內。 在模型內加入 `SoftDeletingTrait` 來使用 `Illuminate\Database\Eloquent\SoftDeletes`. #### Eloquent 緩存 Eloquent 不再提供 `remember` 方法來緩存查詢。現在你需要手動使用 `Cache::remember` 方法快速緩存。了解更多關于緩存，請見完整文檔。 ## 會員認證模型 要使用 Laravel 5 的會員認證系統，請遵循以下指引來升級您的 User 模型： 從 use 區塊刪除以下內容： ~~~ use Illuminate\Auth\UserInterface; use Illuminate\Auth\Reminders\RemindableInterface; ~~~ 添加以下內容到 use 區塊： ~~~ use Illuminate\Auth\Authenticatable; use Illuminate\Auth\Passwords\CanResetPassword; use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract; use Illuminate\Contracts\Auth\CanResetPassword as CanResetPasswordContract; ~~~ 移除 UserInterface 和 RemindableInterface 接口。 實現以下接口： ~~~ implements AuthenticatableContract, CanResetPasswordContract ~~~ 在類中聲明引入以下 traits： ~~~ use Authenticatable, CanResetPassword; ~~~ 如果你引入了上面的 `traits`，從 `use` 區塊和類聲明中移除 `Illuminate\Auth\Reminders\RemindableTrait` 和 `Illuminate\Auth\UserTrait` ## Cashier 的用戶需要的修改 Laravel Cashier 的 trait 和接口名稱已作修改。trait 請改用 `Laravel\Cashier\Billable` 取代 `BillableTrait`。接口請改用 `Laravel\Cashier\Contracts\Billable` 取代 `Larave\Cashier\BillableInterface` 。不需要修改任何方法。 ## Artisan 命令 將所有的命令從舊的 `app/commands` 目錄移到新的 `app/Console/Commands` 目錄。接下來，把 `app/Console/Commands` 目錄添加到 `composer.json` 的 `classmap` 中。 然后，復制 Artisan 命令列表從 `start/artisan.php` 到 `app/Console/Kernel.php` 文件的 command 數組內。 ## 數據庫遷移和數據填充 如果在您的數據庫內已經有 `users` 表，請移除 Laravel 5 內置的兩個遷移文件。 將所有的遷移文件從舊的 `app/database/migrations` 目錄復制到新的 `database/migrations` 。所有的數據填充文件也要從 `app/database/seeds` 復制到 `database/seeds`。 ## 全局 IoC 綁定 若您在 `start/global.php` 有綁定任何 IoC，請將它們復制到 `app/Providers/AppServiceProvider.php` 內的 `register` 方法，您可能需要引入 App facade。 你可以選擇將這些綁定，依照類型拆分到不同的服務提供者中。 ## 視圖 將所有的視圖從舊的 `app/views` 復制到新的 `resources/views` 目錄內。 ## Blade 標簽修改 從安全的角度考慮，Laravel 5.0 會過濾所有輸出，不論您使用 `{{ }}` 或 `{{{ }}}` 標簽。您可以使用 `{!! !!}` 新的標簽來取消輸出過濾。請務必 確定 輸出內容是安全地才使用 `{!! !!}` 標簽。 不過，如果您 仍然必須 使用舊的 Blade 語法，請在 `AppServiceProvider@register` 開頭加入以下內容： ~~~ \Blade::setRawTags('{{', '}}'); \Blade::setContentTags('{{{', '}}}'); \Blade::setEscapedContentTags('{{{', '}}}'); ~~~ 但是輕易不要這樣做，這可能使您的應用進程更加容易受到 XSS 攻擊，并且用 `{{--` 來注釋代碼將不再起作用。 ## 多語言配置文件 將所有的多語言配置文件從舊的 `app/lang` 目錄復制到新的`resources/lang` 目錄。 ## 公開目錄 將 4.2 版公共目錄內的資源復制到新應用程序內的public 目錄。并確認保留 5.0 版的 index.php 文件。 ## 測試 將所有的測試文件從舊的 `app/tests` 復制到 `tests` 目錄。 ## 各式各樣的文件 復制項目內其他各式各樣的文件，例如：`.scrutinizer.yml`, `bower.json` 以及其他類似工具的設置文件。 您可以將 Sass，Less 或 CoffeeScript 移動到任何您想放置的地方。 `resources/assets` 目錄是一個不錯的默認位置。 ## 表單和 HTML 輔助函數 如果您使用表單或 HTML 輔助函數，您將會看到以下錯誤 `class 'Form' not found` 或 `class 'Html' not found` 。`Form` 類以及 `HTML` 輔助函數在 Laravel 5.0 中已經廢棄了；不過，這里有一些替代方法，比如基于社區驅動的，由 `Laravel Collective` 維護。 比如，你可以在 composer.json 文件中的 require 區塊增加 "laravelcollective/html": "~5.0"。 您也需要添加表單和 HTML 的 facades 以及服務提供者。 編輯 `config/app.php` 文件，添加此行到 'providers' 數組內： ~~~ 'Collective\Html\HtmlServiceProvider', ~~~ 接著，添加以下到 'aliases' 數組內： ~~~ 'Form' => 'Collective\Html\FormFacade', 'Html' => 'Collective\Html\HtmlFacade', ~~~ ## 緩存管理員 如果您的程序注入 `Illuminate\Cache\CacheManager` 來取得非 Facade 版本的 Laravel 緩存，請改用 `Illuminate\Contracts\Cache\Repository` 注入。 ## 分頁 請將所有的 `$paginator->links()` 用 `$paginator->render()` 取代。 Replace any calls to $paginator->getFrom() and $paginator->getTo() with $paginator->firstItem() and $paginator->lastItem() respectively. Remove the "get" prefix from calls to $paginator->getPerPage(), $paginator->getCurrentPage(), $paginator->getLastPage() and $paginator->getTotal() (e.g. $paginator->perPage()). ## Beanstalk 隊列 Laravel 5.0 使用 `"pda/pheanstalk": "~3.0"` 取代原本的 `"pda/pheanstalk": "~2.1"`。 ## Remote Remote 組件已不再使用。 ## 工作區 工作區組件已不再使用。