從Laravel 4遷移到Laravel 5：循序漸進(jìn)指南

Laravel 5 已經(jīng)發(fā)布，但人們對(duì)變化的恐懼依然存在。我們不斷聽到人們抱怨一些重大的改變，例如新的文件夾結(jié)構(gòu)。我的應(yīng)用如果執(zhí)行composer update會(huì)崩潰嗎？

本文將指導(dǎo)您如何將現(xiàn)有的Laravel 4應(yīng)用遷移到Laravel 5，并了解新的文件夾結(jié)構(gòu)。

關(guān)鍵要點(diǎn)

• 從Laravel 4升級(jí)到Laravel 5包含多個(gè)步驟，包括更新composer.json文件、更新路由、控制器和視圖，以及修改任何自定義代碼以使用Laravel 5中的新功能和更改。
• Laravel 5引入了許多新功能和改進(jìn)，例如新的目錄結(jié)構(gòu)、改進(jìn)的路由、更好的環(huán)境配置處理以及新的組件，如Socialite、Elixir和Scheduler。
• 升級(jí)到Laravel 5的過程可能很復(fù)雜且耗時(shí)，具體取決于應(yīng)用程序的大小。但是，沒有必要升級(jí)到新的文件夾結(jié)構(gòu)；您可以保留舊的結(jié)構(gòu)，只更新composer依賴項(xiàng)，但這并不是推薦的做法。

安裝

我現(xiàn)有的Laravel 4應(yīng)用程序是一個(gè)之前的關(guān)于使用Google Analytics API的文章中的演示程序。該應(yīng)用程序代碼不多，但足以用于我們的教程。

讓我們首先在計(jì)算機(jī)上安裝Laravel 5，并創(chuàng)建一個(gè)臨時(shí)文件夾來保存我們的Laravel 4版本的應(yīng)用程序。

composer create-project laravel/laravel --prefer-dist

我更喜歡通過composer安裝Laravel，但您可以訪問文檔以了解更多關(guān)于Laravel安裝程序的信息。

您可以使用存儲(chǔ)庫中的Vagrant虛擬機(jī)，或使用Homestead Improved。如果一切順利，您應(yīng)該會(huì)看到Laravel 5的歡迎頁面。

配置文件

舊的app/config文件夾現(xiàn)在位于應(yīng)用程序的根目錄下，因此我們必須將app/config/analytics.php移動(dòng)到config/analytics.php。憑據(jù)直接粘貼到文件中，所以為什么不使用環(huán)境變量呢？

// config/analytics.php

return [
  'app_name'          => env('app_name'),
  'client_id'         => env('client_id'),
  'client_secret'     => env('client_secret'),
  'api_key'           => env('api_key')
];

<code>// .env

app_name='YOUR APP NAME'
client_id='YOUR CLIENT ID'
client_secret='CLIENT SECRET'
api_key='API KEY'</code>

.env文件會(huì)自動(dòng)加載，可用于將本地環(huán)境配置與生產(chǎn)環(huán)境、測(cè)試環(huán)境等分開。

路由

Laravel 4路由注冊(cè)在app/routes.php中。在Laravel 5中，所有與HTTP相關(guān)的部分都分組在app/Http文件夾下，包括路由，因此讓我們將app/routes.php移動(dòng)到app/Http/routes.php。

過濾器

Laravel 5已從過濾器遷移到中間件，因此如果您的路由中包含任何過濾器，請(qǐng)確保將其更改為中間件。

Route::get('/report', ['middleware' => 'auth', function() {
    //
}]);

如果您有自定義過濾器，您可以將其遷移為中間件。我的路由中使用了一個(gè)GoogleLogin中間件，實(shí)現(xiàn)如下所示。

composer create-project laravel/laravel --prefer-dist

// config/analytics.php

return [
  'app_name'          => env('app_name'),
  'client_id'         => env('client_id'),
  'client_secret'     => env('client_secret'),
  'api_key'           => env('api_key')
];

<code>// .env

app_name='YOUR APP NAME'
client_id='YOUR CLIENT ID'
client_secret='CLIENT SECRET'
api_key='API KEY'</code>

默認(rèn)情況下會(huì)添加CRSF保護(hù)中間件。如果要?jiǎng)h除它，您可以轉(zhuǎn)到app/Http/Kernel.php文件并注釋掉相應(yīng)的行。

控制器

因?yàn)槲覀兊目刂破鞅徽J(rèn)為是HTTP邏輯的一部分，我們需要將app/controllers/*移動(dòng)到app/Http/Controllers并使用App\Http\Controllers命名空間。您需要修復(fù)的最后一個(gè)問題是將BaseController更改為Controller類。

如果您不喜歡App根命名空間，您可以使用以下artisan命令全局更改它。

Route::get('/report', ['middleware' => 'auth', function() {
    //
}]);

遷移

我們的Google Analytics應(yīng)用程序沒有任何本地?cái)?shù)據(jù)庫交互，但升級(jí)過程值得一提。

app/database目錄現(xiàn)在位于/database文件夾內(nèi)，您只需要將文件移動(dòng)到那里即可。該目錄已經(jīng)包含一個(gè)users表和一個(gè)password_resets表，您可以根據(jù)需要?jiǎng)h除或更新它們。

模型

Laravel 4中的models文件夾消失了，Laravel 5直接在app文件夾中放置User模型作為示例。您也可以將您的模型復(fù)制到那里，并使用App命名空間。

但是，如果您不喜歡將模型放在那里的想法，您可以在app目錄下創(chuàng)建一個(gè)名為Models的新文件夾，但不要忘記使用App\Models命名空間為您的類命名空間。

// app/Http/Middleware/GoogleLogin.php

class GoogleLogin
{
  public function handle($request, Closure $next)
  {
    $ga = \App::make('\App\Services\GoogleLogin');
    if (!$ga->isLoggedIn()) {
      return redirect('login');
    }

    return $next($request);
  }
}

應(yīng)用程序服務(wù)

我們的src文件夾包含一個(gè)GA_Service和一個(gè)GA_Utils類。如果我們認(rèn)為它們是服務(wù)，我們可以將它們放在app/Services中。否則，我們可以創(chuàng)建一個(gè)名為app/GA的新文件夾，我們將在此處存儲(chǔ)我們的服務(wù)類。這將導(dǎo)致問題，因?yàn)槲覀円婚_始沒有使用PSR-4自動(dòng)加載，因此我們需要使用正確的新的命名空間更新控制器中的類引用。

視圖

應(yīng)用程序視圖從app/views文件夾移動(dòng)到resources/views文件夾。

resources文件夾還包含用于應(yīng)用程序本地化的lang文件夾，以及用于前端資源的assets文件夾。Laravel 5引入了Elixir，它將Gulp任務(wù)運(yùn)行器適配到Laravel開發(fā)環(huán)境。

Composer

確保您復(fù)制應(yīng)用程序的composer依賴項(xiàng)并進(jìn)行任何必要的升級(jí)。對(duì)于我們的演示，我將把"google/apiclient": "1.1.*"移動(dòng)到新的composer.json中，并執(zhí)行composer update以反映這些更改。

表單和HTML

illuminate/html包已從Laravel 5的默認(rèn)安裝中移除，您需要單獨(dú)安裝它。

要將HTML輔助函數(shù)帶回到您的項(xiàng)目中，您需要將"illuminate/html": "5.0.*"包添加到您的composer.json中并運(yùn)行composer update，然后您需要將'Illuminate\Html\HtmlServiceProvider'添加到您的config/app.php提供程序數(shù)組中。如果您想在blade模板中使用Html和Form外觀，您可以將以下外觀添加到您的config/app.php外觀數(shù)組中。

composer create-project laravel/laravel --prefer-dist

結(jié)論

升級(jí)到Laravel 5的過程的復(fù)雜性和持續(xù)時(shí)間始終取決于您的應(yīng)用程序的大小，對(duì)于您的特定情況，該過程可能比此示例長(zhǎng)得多。在本文中，我們?cè)噲D解釋常見的過程，該過程應(yīng)該可以處理大多數(shù)（如果不是全部）需要更改的內(nèi)容。

您不必升級(jí)到新的文件夾結(jié)構(gòu)，您可以保留舊的結(jié)構(gòu)，只更新您的composer依賴項(xiàng)，但這并不是推薦的做法。如果您有任何問題或意見，請(qǐng)務(wù)必在下面發(fā)布。有關(guān)更多信息，請(qǐng)參閱完整的版本升級(jí)指南。

Laravel 4到Laravel 5升級(jí)指南常見問題解答(FAQs)

Laravel 4和Laravel 5的主要區(qū)別是什么？

Laravel 5在Laravel 4的基礎(chǔ)上引入了許多新功能和改進(jìn)。這些包括新的目錄結(jié)構(gòu)、改進(jìn)的路由、更好的環(huán)境配置處理以及新的組件，如Socialite、Elixir和Scheduler。Laravel 5還引入了一個(gè)新的命令行界面，稱為Artisan，它為常見任務(wù)提供許多有用的命令。

如何在Laravel 5中處理環(huán)境配置？

Laravel 5引入了一種新的環(huán)境配置處理方式。Laravel 5不再使用單個(gè).env.php文件，而是為每個(gè)環(huán)境使用一個(gè).env文件。這使得管理不同環(huán)境的不同配置更容易。您可以在.env文件中設(shè)置環(huán)境變量，Laravel將自動(dòng)加載它們。

Laravel 5中的新目錄結(jié)構(gòu)是什么？

Laravel 5引入了一個(gè)新的目錄結(jié)構(gòu)，該結(jié)構(gòu)旨在更直觀和靈活。app目錄現(xiàn)在是應(yīng)用程序的根目錄，它包含應(yīng)用程序不同部分的幾個(gè)子目錄，例如Http、Providers和Console。public目錄現(xiàn)在是Web服務(wù)器的根目錄，它包含您的資源，例如圖像、JavaScript和CSS文件。

如何從Laravel 4升級(jí)到Laravel 5？

從Laravel 4升級(jí)到Laravel 5包含幾個(gè)步驟。首先，您需要更新您的composer.json文件以要求最新版本的Laravel。然后，您需要更新應(yīng)用程序的代碼以使用Laravel 5中的新功能和更改。這可能涉及更新您的路由、控制器和視圖，以及您編寫的任何自定義代碼。

什么是Laravel Elixir以及如何使用它？

Laravel Elixir是Laravel 5中的一個(gè)新組件，它為定義基本的Gulp任務(wù)提供了一個(gè)簡(jiǎn)潔流暢的API。它支持常見的CSS和JavaScript預(yù)處理器，如Sass和CoffeeScript，它還提供了一種方便的方法來版本化和連接您的資源。

如何使用Laravel 5中的新路由系統(tǒng)？

Laravel 5引入了一個(gè)新的路由系統(tǒng)，它比Laravel 4中的路由系統(tǒng)更靈活和強(qiáng)大。路由現(xiàn)在在app/Http/routes.php文件中定義，您可以對(duì)路由進(jìn)行分組，為它們應(yīng)用中間件，甚至為它們命名空間。

什么是Laravel Socialite以及如何使用它？

Laravel Socialite是Laravel 5中的一個(gè)新組件，它提供了一種簡(jiǎn)單方便的方法來使用OAuth提供程序進(jìn)行身份驗(yàn)證。它開箱即用地支持多個(gè)流行的提供程序，您還可以添加自己的自定義提供程序。

如何使用Laravel 5中的新Artisan命令？

Laravel 5引入了一個(gè)新的命令行界面，稱為Artisan，它為常見任務(wù)提供許多有用的命令。您可以使用Artisan生成樣板代碼、運(yùn)行數(shù)據(jù)庫遷移，甚至啟動(dòng)本地開發(fā)服務(wù)器。

Laravel 5.0中的新功能是什么？

Laravel 5.0引入了一些新功能，包括新的目錄結(jié)構(gòu)、改進(jìn)的路由、更好的環(huán)境配置處理以及新的組件，如Socialite、Elixir和Scheduler。它還引入了一個(gè)新的命令行界面，稱為Artisan。

如何在Laravel 5中處理數(shù)據(jù)庫遷移？

Laravel 5提供了一個(gè)強(qiáng)大的數(shù)據(jù)庫遷移系統(tǒng)，允許您對(duì)數(shù)據(jù)庫模式進(jìn)行版本控制。您可以使用Artisan命令行工具創(chuàng)建遷移，然后使用migrate命令運(yùn)行它們。這使得在不同環(huán)境中應(yīng)用數(shù)據(jù)庫模式更改變得容易。

以上是Laravel 4至Laravel 5-簡(jiǎn)單升級(jí)指南的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！