Dalam laravel, pengawal (Pengawal) ialah kelas yang digunakan untuk melaksanakan fungsi tertentu, pengawal boleh menggabungkan logik pemprosesan permintaan yang berkaitan ke dalam kelas yang berasingan. Sesetengah kaedah disimpan dalam pengawal untuk melaksanakan fungsi tertentu Pengawal dipanggil melalui penghalaan, dan fungsi panggil balik tidak lagi digunakan dalam direktori "app/Http/Controllers".

Persekitaran pengendalian tutorial ini: sistem Windows 7, versi Laravel 6, komputer DELL G3.

Pengenalan Pengawal

1.

Untuk menggantikan semua logik pemprosesan permintaan yang ditakrifkan dalam bentuk penutupan dalam fail laluan, anda mungkin mahu menggunakan kelas kawalan untuk mengatur tingkah laku ini. Pengawal boleh mengumpulkan logik pemprosesan permintaan berkaitan ke dalam kelas yang berasingan.

Pengawal ialah kelas yang digunakan untuk melaksanakan fungsi tertentu Beberapa kaedah disimpan dalam pengawal untuk melaksanakan fungsi tertentu Pengawal dipanggil melalui penghalaan dan fungsi panggil balik tidak lagi digunakan.

2. Di manakah pengawal itu ditulis?

App/Http/Controllers letakkan pengawal

Controller.php ialah fail kelas induk, pengawal lain boleh mewarisi

3. Bagaimana untuk menamakan fail pengawal?

Nama pengawal bonggol tinggi +Controller.php

Contohnya, AddDataController.php LoginController.php

4 Bagaimana untuk menulis struktur peranti?

Dijana secara automatik melalui arahan artisan, sebagai contoh: Pastikan anda memasukkan dalam direktori akar projek semasa pada baris arahan:

php artisan make:controller TestController

Kod struktur ialah dilengkapkan secara automatik,

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

Pengawal Asas

Define Controller

Berikut ialah contoh kelas pengawal asas. Perlu diingatkan bahawa pengawal ini mewarisi pengawal asas Laravel. Kelas pengawal ini menyediakan beberapa kaedah kemudahan, seperti kaedah middleware, yang menambahkan perisian tengah pada tingkah laku pengawal:

<?php

namespace App\Http\Controllers;

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

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

Anda boleh menentukan laluan yang menghala ke tingkah laku pengawal seperti ini:

use App\Http\Controllers\UserController;

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

Apabila permintaan sepadan dengan URI laluan yang ditentukan, kaedah UserController dalam pengawal show akan dilaksanakan. Parameter laluan juga akan dihantar kepada kaedah ini.

Petua: Pengawal tidak diperlukan untuk mewarisi daripada kelas asas. Jika pengawal tidak mewarisi daripada kelas asas, anda tidak akan dapat menggunakan beberapa ciri kemudahan, seperti kaedah middleware, validate dan dispatch.

Pengawal Tingkah Laku Tunggal

Jika anda ingin menentukan pengawal yang hanya mengendalikan satu gelagat, anda boleh meletakkan Kaedah __invoke:

<?php

namespace App\Http\Controllers;

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

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

Tidak perlu menentukan kaedah semasa mendaftarkan laluan pengawal tingkah laku tunggal:

use App\Http\Controllers\ShowProfile;

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

Anda boleh lulus perintah make:controller dalam alat arahan Artisan. Pilihan --invokable untuk menjana pengawal boleh panggil

php artisan make:controller ShowProfile --invokable

Petua: Anda boleh menggunakan stub untuk menyesuaikan templat pengawal tersuai

Perisian Tengah Pengawal

Perisian Tengah Laluan yang boleh diberikan kepada pengawal dalam fail laluan:

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

Walau bagaimanapun, dalam kawalan Ia lebih mudah untuk menentukan perisian tengah dalam pembina pembina. Middleware boleh diperuntukkan dengan mudah kepada pengawal menggunakan kaedah middleware dalam pembina pengawal. Anda juga boleh mengehadkan perisian tengah untuk hanya berkuat kuasa pada kaedah tertentu dalam pengawal:

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');
    }
}

Pada masa yang sama, pengawal juga membenarkan anda mendaftar perisian tengah menggunakan penutupan. Ini menyediakan cara yang mudah untuk mentakrifkan middleware untuk satu pengawal tanpa mentakrifkan keseluruhan kelas middleware:

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

    return $next($request);
});

Petua: Anda boleh menetapkan middleware kepada tindakan pengawal subset . Walau bagaimanapun, ini mungkin tanda bahawa pengawal anda menjadi rumit. Anda disyorkan agar memisahkan pengawal kepada beberapa pengawal yang lebih kecil.

Pengawal Sumber

Penghalaan sumber Laravel boleh memperuntukkan laluan "CURD (Buat, Padam, Ubah Suai, Semak)" biasa melalui satu baris kod kepada pengawal. Contohnya, anda ingin mencipta pengawal yang mengendalikan semua permintaan HTTP untuk apl Simpan Foto. Anda boleh mencipta pengawal sedemikian dengan cepat menggunakan perintah Artisan make:controller:

php artisan make:controller PhotoController --resource

Arahan ini akan menjana pengawal app/Http/Controllers/PhotoController.php. Ini termasuk kaedah untuk setiap operasi sumber yang tersedia.

Seterusnya, anda boleh mendaftarkan laluan sumber dengan pengawal:

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

Pengisytiharan laluan tunggal ini mencipta berbilang laluan untuk mengendalikan pelbagai gelagat pada sumber. Pengawal yang dijana mengekalkan kaedah untuk setiap tindakan, termasuk anotasi deklaratif untuk mengendalikan kata kerja HTTP dan URL.

Anda boleh mencipta berbilang pengawal sumber serentak dengan menghantar parameter tatasusunan ke dalam kaedah resources:

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

Pemprosesan Operasi Pengawal Sumber

指定資源模型

如果你使用了路由模型綁定，并且想在資源控制器的方法中使用類型提示，你可以在生成控制器的時(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 ）。為了方便起見，你可以使用 apiResource 方法自動(dòng)排除這兩個(gè)路由：

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

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

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

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

php artisan make:controller API/PhotoController --api

嵌套資源

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

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

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

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

限定嵌套資源的范圍

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

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

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

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

淺層嵌套

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

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

上面的路由定義方式會定義以下路由：

命名資源路由

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

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

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

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

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

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

/users/{admin_user}

限定范圍的資源路由

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

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

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

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

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

本地化資源 URI

默認(rèn)情況下，Route::resource 將會用英文動(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') 這樣注冊的資源路由將會產(chǎn)生如下的 URI：

/fotos/crear

/fotos/{foto}/editar

補(bǔ)充資源控制器

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

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

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

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

依賴注入 & 控制器

構(gòu)造注入

Laravel 服務(wù)容器 被用于解析所有的 Laravel 控制器。因此，您可以在控制器的構(gòu)造函數(shù)中使用類型提示需要的依賴項(xiàng)。聲明的解析會自動(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;
    }
}

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

方法注入

除了構(gòu)造器注入以外，您亦可在控制器方法中類型提示依賴。最常見的用法便是注入 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)容，請?jiān)谀囊蕾図?xiàng)之后列出您的路由參數(shù)。例如，您可以像下方這樣定義路由：

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

如下所示，您依然可以類型提示 Illuminate\Http\Request 并通過定義您的控制器方法訪問 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 路由緩存。使用路由緩存將會大幅降低您的應(yīng)用路由的注冊時(shí)間。有時(shí)，您的路由注冊的速度可能會提高 100 倍。要生成路由緩存，僅需執(zhí)行 route:cache Artisan 命令：

php artisan route:cache

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

您亦可使用 route:clear 來清除路由緩存：

php artisan route:clear

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

Atas ialah kandungan terperinci Apakah pengawal laravel. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!