在laravel中，控制器（Controller）是一個(gè)類(lèi)，用來(lái)實(shí)現(xiàn)一定的功能；控制器能將相關(guān)的請(qǐng)求處理邏輯組成一個(gè)單獨(dú)的類(lèi)別?？刂破髦写娣胖幸恍┓椒?，實(shí)現(xiàn)一定的功能，透過(guò)路由呼叫控制器，不再使用回呼函數(shù)；控制器被存放在「app/Http/Controllers」目錄中。

本教學(xué)操作環(huán)境：windows7系統(tǒng)、Laravel6版，DELL G3電腦。

控制器介紹

1、控制器是什麼？

為了取代在路由檔案中以閉包形式定義的所有的請(qǐng)求處理邏輯，你可能想要使用控制類(lèi)別來(lái)組織這些行為?？刂破髂軐⑾嚓P(guān)的請(qǐng)求處理邏輯組成一個(gè)單獨(dú)的類(lèi)別。

Controller，是類(lèi)，用於實(shí)現(xiàn)一定的功能，控制器中存放中一些方法，實(shí)現(xiàn)一定的功能，透過(guò)路由調(diào)用控制器，不再使用回調(diào)函數(shù)。

2、控制器寫(xiě)在哪裡？

App/Http/Controllers放置控制器

Controller.php是父類(lèi)別文件，別的控制器可以繼承

3、控制器檔案如何命名？

大駝峰的控制器名稱Controller.php

例如AddDataController.php LoginController.php

4、控制器結(jié)構(gòu)怎麼寫(xiě)？

透過(guò)artisan指令自動(dòng)生成，例如：確保在目前專案的根目錄，命令列輸入：

php artisan make:controller TestController

結(jié)構(gòu)程式碼自動(dòng)完成，

   namespace App\Http\Controller;
   use Illuminate\Http\Request;    
   class TestController extends  Controller{
     //
   }

基礎(chǔ)控制器

定義控制器

#下面是一個(gè)基礎(chǔ)控制器類(lèi)別的範(fàn)例。需要注意的是，該控制器繼承了 Laravel 的基礎(chǔ)控制器。這個(gè)類(lèi)別控制器提供了一些便利的方法，例如?middleware 方法，該方法可以為控制器行為添加中間件：

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\User;

class UserController extends Controller
{
    /**
     * 顯示指定用戶的簡(jiǎn)介
     *
     * @param  int  $id
     * @return \Illuminate\View\View
     */
    public function show($id)
    {
        return view(&#39;user.profile&#39;, [&#39;user&#39; => User::findOrFail($id)]);
    }
}

你可以像這樣定義一個(gè)指向控制器行為的路由：

use App\Http\Controllers\UserController;

Route::get('user/{id}', [UserController::class, 'show']);

當(dāng)一個(gè)要求與指定路由的URI 匹配時(shí)，UserController 控制器中的show 方法將會(huì)執(zhí)行。路由參數(shù)也會(huì)傳遞給該方法。

技巧：控制器並不是 必要 繼承基礎(chǔ)類(lèi)別。如果控制器沒(méi)有繼承基礎(chǔ)類(lèi)，你將無(wú)法使用一些方便的功能，例如 middleware，validate，和 dispatch 方法。

單一行為控制器

如果你想要定義一個(gè)只處理單一行為的控制器，你可以在控制器中放置一個(gè)__invoke 方法：

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\User;

class ShowProfile extends Controller
{
    /**
     * 顯示指定用戶的簡(jiǎn)介
     *
     * @param  int  $id
     * @return \Illuminate\View\View
     */
    public function __invoke($id)
    {
        return view(&#39;user.profile&#39;, [&#39;user&#39; => User::findOrFail($id)]);
    }
}

當(dāng)註冊(cè)單一行為控制器的路由時(shí)不需要指名方法：

use App\Http\Controllers\ShowProfile;

Route::get('user/{id}', ShowProfile::class);

你可以透過(guò)Artisan 指令工具裡的make: controller 指令中的--invokable 選項(xiàng)來(lái)產(chǎn)生一個(gè)可呼叫的控制器

php artisan make:controller ShowProfile --invokable

技巧：可以使用stub 自訂 自訂控制器模板

控制器中間件

中間件 可以在路由檔案中指派給控制器的路由：

Route::get('profile', [UserController::class, 'show'])->middleware('auth');

然而，在控制器的建構(gòu)子中指定中間件更為方便。使用控制器建構(gòu)函數(shù)中的 middleware 方法，可以輕鬆地將中間件指派給控制器。你甚至可以將中間件限制為只在控制器中的某些方法生效：

class UserController extends Controller
{
    /**
     * 實(shí)例化一個(gè)新的控制器實(shí)例
     *
     * @return void
     */
    public function __construct()
    {
        $this->middleware('auth');

        $this->middleware('log')->only('index');

        $this->middleware('subscribed')->except('store');
    }
}

同時(shí)，控制器也允許你使用一個(gè)閉包來(lái)註冊(cè)中間件。這為不定義整個(gè)中間件類(lèi)別的情況下為單一控制器定義中間件提供了一種便捷的方法：

$this->middleware(function ($request, $next) {
    // ...

    return $next($request);
});

技巧：你可以將中間件指派給控制器操作的一個(gè)子集。然而，它可能表明你的控制器正在變得複雜。建議你將控制器拆分為多個(gè)較小的控制器。

資源型控制器

Laravel 的資源路由透過(guò)單行程式碼即可將典型的「CURD (增刪改查)」路由分配給控制器。例如，你希望建立一個(gè)控制器來(lái)處理儲(chǔ)存 「照片」 應(yīng)用程式的所有 HTTP 請(qǐng)求。使用Artisan 指令make:controller 可以快速建立這樣一個(gè)控制器：

php artisan make:controller PhotoController --resource

這個(gè)指令將會(huì)產(chǎn)生一個(gè)控制器app/Http/Controllers/PhotoController.php 。其中包括每個(gè)可用資源操作的方法。

接下來(lái)，你可以為控制器註冊(cè)一個(gè)資源路由：

Route::resource('photos', PhotoController::class);

這個(gè)單一的路由宣告會(huì)建立了多個(gè)路由來(lái)處理資源上的各種行為。生成的控制器為每個(gè)行為保留了方法，包括了關(guān)於處理 HTTP 動(dòng)詞和 URLs 的聲明註釋。

你可以透過(guò)將陣列傳參到resources 方法中的方式來(lái)一次的建立多個(gè)資源控制器：

Route::resources([
    'photos' => PhotoController::class,
    'posts' => PostController::class,
]);

資源控制器操作處理

指定資源模型

如果你使用了路由模型綁定，并且想在資源控制器的方法中使用類(lèi)型提示，你可以在生成控制器的時(shí)候使用 --model 選項(xiàng)：

php artisan make:controller PhotoController --resource --model=Photo

部分資源路由

當(dāng)聲明資源路由時(shí)，你可以指定控制器處理的部分行為，而不是所有默認(rèn)的行為：

Route::resource('photos', PhotoController::class)->only([
    'index', 'show'
]);

Route::resource('photos', PhotoController::class)->except([
    'create', 'store', 'update', 'destroy'
]);

API 資源路由

當(dāng)聲明用于 APIs 的資源路由時(shí)，通常需要排除顯示 HTML 模板的路由（如 create 和 edit ）。為了方便起見(jiàn)，你可以使用 apiResource 方法自動(dòng)排除這兩個(gè)路由：

Route::apiResource('photos', PhotoController::class);

你也可以傳遞一個(gè)數(shù)組給 apiResources 方法來(lái)同時(shí)注冊(cè)多個(gè) API 資源控制器：

Route::apiResources([
    'photos' => PhotoController::class,
    'posts' => PostController::class,
]);

要快速生成不包含 create 或 edit 方法的用于開(kāi)發(fā)接口的資源控制器，請(qǐng)?jiān)趫?zhí)行 make:controller 命令時(shí)使用 --api 參數(shù):

php artisan make:controller API/PhotoController --api

嵌套資源

有時(shí)可能需要定義一個(gè)嵌套的資源型路由。例如，照片資源可能被添加了多個(gè)評(píng)論。那么可以在路由中使用 “點(diǎn)” 符號(hào)來(lái)聲明資源型控制器：

Route::resource('photos.comments', PhotoCommentController::class);

該路由會(huì)注冊(cè)一個(gè)嵌套資源，可以使用如下 URI 訪問(wèn):

/photos/{photo}/comments/{comment}

限定嵌套資源的范圍

Laravel 的 隱式模型綁定 特性可以自動(dòng)限定嵌套綁定的范圍，因此已解析的子模型會(huì)自動(dòng)屬于父模型。定義嵌套路由時(shí)，使用 scoped 方法，可以開(kāi)啟自動(dòng)范圍限定，也可以指定 Laravel 應(yīng)該按照哪個(gè)字段檢索子模型資源

Route::resource('photos.comments', PhotoCommentController::class)->scoped([
    'comment' => 'slug',
]);

這個(gè)路由會(huì)注冊(cè)一個(gè)限定范圍的嵌套資源路由，可以像下面這樣來(lái)訪問(wèn)：

/photos/{photo}/comments/{comment:slug}

淺層嵌套

通常，并不完全需要在 URI 中同時(shí)擁有父 ID 和子 ID ，因?yàn)樽?ID 已經(jīng)是唯一的標(biāo)識(shí)符。當(dāng)使用唯一標(biāo)識(shí)符（如自動(dòng)遞增的主鍵）來(lái)標(biāo)識(shí) URI 中的模型時(shí)，可以選擇使用「淺嵌套」的方式定義路由：

Route::resource('photos.comments', CommentController::class)->shallow();

上面的路由定義方式會(huì)定義以下路由：

命名資源路由

默認(rèn)情況下，所有的資源控制器行為都有一個(gè)路由名稱。你可以傳入 names 數(shù)組來(lái)覆蓋這些名稱：

Route::resource('photos', PhotoController::class)->names([
    'create' => 'photos.build'
]);

命名資源路由參數(shù)

默認(rèn)情況下，Route::resource 會(huì)根據(jù)資源名稱的「單數(shù)」形式創(chuàng)建資源路由的路由參數(shù)。你可以在選項(xiàng)數(shù)組中傳入 parameters 參數(shù)來(lái)輕松地覆蓋每個(gè)資源。parameters 數(shù)組應(yīng)該是資源名稱和參數(shù)名稱的關(guān)聯(lián)數(shù)組：

Route::resource('users', AdminUserController::class)->parameters([
    'users' => 'admin_user'
]);

上例將會(huì)為資源的 show 路由生成如下的 URI ：

/users/{admin_user}

限定范圍的資源路由

有時(shí)，在定義資源路由時(shí)隱式綁定了多個(gè) Eloquent 模型，你希望限定第二個(gè) Eloquent 模型必須為第一個(gè) Eloquent 模型的子模型。例如，考慮這樣一個(gè)場(chǎng)景，通過(guò) slug 檢索某個(gè)特殊用戶的一篇文章：

use App\Http\Controllers\PostsController;Route::resource('users.posts', PostsController::class)->scoped();

你可以通過(guò)給 scoped 方法傳遞一個(gè)數(shù)組來(lái)覆蓋默認(rèn)的模型路由鍵：

use App\Http\Controllers\PostsController;Route::resource('users.posts', PostsController::class)->scoped([
    'post' => 'slug',
]);

當(dāng)使用一個(gè)自定義鍵的隱式綁定作為嵌套路由參數(shù)時(shí)，Laravel 會(huì)自動(dòng)限定查詢范圍，按照約定的命名方式去父類(lèi)中查找關(guān)聯(lián)方法，然后檢索到對(duì)應(yīng)的嵌套模型。在這種情況下，將假定 User 模型有一個(gè)叫 posts（路由參數(shù)名的復(fù)數(shù)）的關(guān)聯(lián)方法，通過(guò)這個(gè)方法可以檢索到 Post 模型。

本地化資源 URI

默認(rèn)情況下，Route::resource 將會(huì)用英文動(dòng)詞創(chuàng)建資源 URI。如果需要自定義 create 和 edit 行為的動(dòng)作名，可以在 AppServiceProvider 的 boot 中使用 Route::resourceVerbs 方法實(shí)現(xiàn):

use Illuminate\Support\Facades\Route;

/**
 * 引導(dǎo)任何應(yīng)用服務(wù)。
 *
 * @return void
 */
public function boot()
{
    Route::resourceVerbs([
        'create' => 'crear',
        'edit' => 'editar',
    ]);
}

動(dòng)作被自定義后，像 Route::resource('fotos', 'PhotoController') 這樣注冊(cè)的資源路由將會(huì)產(chǎn)生如下的 URI：

/fotos/crear

/fotos/{foto}/editar

補(bǔ)充資源控制器

如果您需要增加額外的路由到默認(rèn)的資源路由之中，您需要在 Route::resource 前定義它們；否則， resource 方法定義的路由可能會(huì)無(wú)意間優(yōu)先于您定義的路由：

Route::get('photos/popular', [PhotoController::class, 'popular']);

Route::resource('photos', PhotoController::class);

技巧：記得保持您的控制器的專一性。如果您需要典型的資源操作以外的方法，請(qǐng)考慮將您的控制器分割為兩個(gè)更小的控制器。

依賴注入 & 控制器

構(gòu)造注入

Laravel 服務(wù)容器 被用于解析所有的 Laravel 控制器。因此，您可以在控制器的構(gòu)造函數(shù)中使用類(lèi)型提示需要的依賴項(xiàng)。聲明的解析會(huì)自動(dòng)解析并注入到控制器實(shí)例中去：

<?php

namespace App\Http\Controllers;

use App\Repositories\UserRepository;

class UserController extends Controller
{
    /**
     * 用戶 repository 實(shí)例。
     */
    protected $users;

    /**
     * 創(chuàng)建一個(gè)新的控制器實(shí)例。
     *
     * @param  UserRepository  $users
     * @return void
     */
    public function __construct(UserRepository $users)
    {
        $this->users = $users;
    }
}

您亦可類(lèi)型提示 Laravel 契約 ，只要它能夠被解析。取決于您的應(yīng)用，注入依賴到控制器可能會(huì)提供更好的可測(cè)試性。

方法注入

除了構(gòu)造器注入以外，您亦可在控制器方法中類(lèi)型提示依賴。最常見(jiàn)的用法便是注入 Illuminate\Http\Request 到您的控制器方法中：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * 保存一個(gè)新用戶。
     *
     * @param  Request  $request
     * @return Response
     */
    public function store(Request $request)
    {
        $name = $request->name;

        //
    }
}

如果您的控制器方法要從路由參數(shù)中獲取輸入內(nèi)容，請(qǐng)?jiān)谀囊蕾図?xiàng)之后列出您的路由參數(shù)。例如，您可以像下方這樣定義路由：

Route::put('user/{id}', [UserController::class, 'update']);

如下所示，您依然可以類(lèi)型提示 Illuminate\Http\Request 并通過(guò)定義您的控制器方法訪問(wèn) id 參數(shù)：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * 修改指定的用戶。
     *
     * @param  Request  $request
     * @param  string  $id
     * @return Response
     */
    public function update(Request $request, $id)
    {
        //
    }
}

路由緩存

如果您的應(yīng)用僅使用了基于路由的控制器，您應(yīng)該充分利用 Laravel 路由緩存。使用路由緩存將會(huì)大幅降低您的應(yīng)用路由的注冊(cè)時(shí)間。有時(shí)，您的路由注冊(cè)的速度可能會(huì)提高 100 倍。要生成路由緩存，僅需執(zhí)行 route:cache Artisan 命令：

php artisan route:cache

在運(yùn)行該命令后，每次請(qǐng)求將會(huì)加載您緩存的路由文件。請(qǐng)記住，您每次添加新路由后均需要生成新的路由緩存。因此，您應(yīng)該在項(xiàng)目部署時(shí)才運(yùn)行 route:cache 命令。

您亦可使用 route:clear 來(lái)清除路由緩存：

php artisan route:clear

【相關(guān)推薦：laravel視頻教程】

以上是什麼叫l(wèi)aravel控制器的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！