Laravelコントローラーとは何ですか

青灯夜游
リリース: 2023-01-14 11:16:31
オリジナル
1410 人が閲覧しました

laravel では、コントローラー (Controller) は特定の機能を実装するために使用されるクラスであり、コントローラーは関連するリクエスト処理ロジックを別のクラスに結合できます。一部のメソッドは、特定の機能を実装するためにコントローラーに保存されます。コントローラーはルーティングを通じて呼び出され、コールバック関数は使用されなくなり、コントローラーは「app/Http/Controllers」ディレクトリに保存されます。

Laravelコントローラーとは何ですか

このチュートリアルの動作環境: Windows 7 システム、Laravel 6 バージョン、DELL G3 コンピューター。

#コントローラーの紹介

#1. コントローラーとは何ですか?

ルート ファイル内のクロージャの形式で定義されているすべてのリクエスト処理ロジックを置き換えるには、コントロール クラスを使用してこの動作を整理する必要がある場合があります。コントローラーは、関連するリクエスト処理ロジックを別のクラスにグループ化できます。

Controller は、特定の機能を実装するために使用されるクラスです。一部のメソッドは、特定の機能を実装するためにコントローラに格納されます。コントローラはルーティングを通じて呼び出され、コールバック関数は使用されなくなりました。

2. コントローラーはどこに書かれていますか?

#App/Http/Controllers コントローラーを配置します

Controller.php は親クラス ファイルであり、他のコントローラーは継承できます

#3. コントローラーファイルに名前を付けるにはどうすればよいですか?#せむしコントローラ名Controller.php

例: AddDataController.php LoginController.php

#4. コントローラの書き方構造?

artisan コマンドによって自動的に生成されます。例: 現在のプロジェクトのルート ディレクトリにいることを確認し、コマンド ラインに次のように入力します:

php artisan make:controller TestController
ログイン後にコピー

構造コードは自動的に完了します。

namespace App\Http\Controller; use Illuminate\Http\Request; class TestController extends Controller{ // }
ログイン後にコピー

基本コントローラ

コントローラの定義

次は基本的なコントローラの例です。コントローラークラス。このコントローラーは
Laravel

のベースコントローラーを継承していることに注意してください。このクラスのコントローラーには、コントローラーの動作にミドルウェアを追加できる

middlewareメソッドなどの便利なメソッドがいくつか用意されています。

 User::findOrFail($id)]); } }
ログイン後にコピー
次のルーティングのように、コントローラーの動作へのポインターを定義できます。
use App\Http\Controllers\UserController; Route::get('user/{id}', [UserController::class, 'show']);
ログイン後にコピー

リクエストが指定されたルートの URI と一致すると、

UserController

コントローラーの

showメソッドが実行されます。ルート パラメーターもこのメソッドに渡されます。ヒント: コントローラーは基本クラスを継承するために

必須ではありません。コントローラーが基本クラスから継承していない場合、
middleware

validatedispatchメソッドなどの一部の便利な機能を使用できません。 。単一動作コントローラー

単一動作のみを処理するコントローラーを定義したい場合は、__invoke# を配置できます。 ## メソッド:

 User::findOrFail($id)]); } }
ログイン後にコピー

単一の動作コントローラーのルートを登録する場合、メソッドを指定する必要はありません:

use App\Http\Controllers\ShowProfile; Route::get('user/{id}', ShowProfile::class);
ログイン後にコピー
これは、Artisan コマンド ツールのmake を通じて実行できます。 :controller

コマンドの

--invokable

オプションは、呼び出し可能なコントローラー

php artisan make:controller ShowProfile --invokable
ログイン後にコピー
を生成します。 ヒント: スタブを使用して、カスタム コントロール コントローラーをカスタマイズできます。 template

Controller middleware

Middlewareルート ファイルでコントローラに割り当てることができるルート:
Route::get('profile', [UserController::class, 'show'])->middleware('auth');
ログイン後にコピー

ただし、コントローラーのコンストラクターでミドルウェアを指定する方が便利です。コントローラーのコンストラクターで

middlewareメソッドを使用すると、ミドルウェアをコントローラーに簡単に割り当てることができます。コントローラー内の特定のメソッドにのみ有効になるようにミドルウェアを制限することもできます。

class UserController extends Controller { /** * 实例化一个新的控制器实例 * * @return void */ public function __construct() { $this->middleware('auth'); $this->middleware('log')->only('index'); $this->middleware('subscribed')->except('store'); } }
ログイン後にコピー

同時に、コントローラーではクロージャーを使用してミドルウェアを登録することもできます。これにより、ミドルウェア クラス全体を定義せずに、単一のコントローラーのミドルウェアを定義する便利な方法が提供されます。

$this->middleware(function ($request, $next) { // ... return $next($request); });
ログイン後にコピー
ヒント: ミドルウェアをコントローラー アクション サブセットの 1 つに割り当てることができます。ただし、それはコントローラーが複雑になっていることを示している可能性があります。コントローラーを複数の小さなコントローラーに分割することをお勧めします。

リソースコントローラー

Laravel のリソースルーティングは、典型的な「CURD (作成、削除、変更、確認)」ルートを 1 行で割り当てることができます。コントローラーへのコード。たとえば、Save Photos アプリのすべての HTTP リクエストを処理するコントローラーを作成するとします。このようなコントローラーをすばやく作成するには、アーティザン コマンドmake:controllerを使用します。
php artisan make:controller PhotoController --resource
ログイン後にコピー

このコマンドは、コントローラー

app/Http/Controllers/PhotoController.phpを生成します。これには、利用可能な各リソース操作のメソッドが含まれます。

次に、リソース ルートをコントローラーに登録できます。

Route::resource('photos', PhotoController::class);
ログイン後にコピー
この 1 つのルート宣言により、リソース上のさまざまな動作を処理するための複数のルートが作成されます。生成されたコントローラーは、HTTP 動詞と URL を処理するための宣言的アノテーションを含む、各アクションのメソッドを保持します。

配列パラメーターを

resources

メソッドに渡すことで、複数のリソース コントローラーを一度に作成できます:

Route::resources([ 'photos' => PhotoController::class, 'posts' => PostController::class, ]);
ログイン後にコピー

リソース コントローラー操作の処理

Verb URI Action Route Name
GET /photos index photos.index
GET /photos/create create photos.create
POST /photos store photos.store
GET /photos/{photo} show photos.show
GET /photos/{photo}/edit edit photos.edit
PUT/PATCH /photos/{photo} update photos.update
DELETE /photos/{photo} destroy photos.destroy

指定资源模型

如果你使用了路由模型绑定,并且想在资源控制器的方法中使用类型提示,你可以在生成控制器的时候使用--model选项:

php artisan make:controller PhotoController --resource --model=Photo
ログイン後にコピー

部分资源路由

当声明资源路由时,你可以指定控制器处理的部分行为,而不是所有默认的行为:

Route::resource('photos', PhotoController::class)->only([ 'index', 'show' ]); Route::resource('photos', PhotoController::class)->except([ 'create', 'store', 'update', 'destroy' ]);
ログイン後にコピー

API 资源路由

当声明用于 APIs 的资源路由时,通常需要排除显示 HTML 模板的路由(如createedit)。为了方便起见,你可以使用apiResource方法自动排除这两个路由:

Route::apiResource('photos', PhotoController::class);
ログイン後にコピー

你也可以传递一个数组给apiResources方法来同时注册多个 API 资源控制器:

Route::apiResources([ 'photos' => PhotoController::class, 'posts' => PostController::class, ]);
ログイン後にコピー

要快速生成不包含createedit方法的用于开发接口的资源控制器,请在执行 make:controller 命令时使用--api参数:

php artisan make:controller API/PhotoController --api
ログイン後にコピー

嵌套资源

有时可能需要定义一个嵌套的资源型路由。例如,照片资源可能被添加了多个评论。那么可以在路由中使用 “点” 符号来声明资源型控制器:

Route::resource('photos.comments', PhotoCommentController::class);
ログイン後にコピー

该路由会注册一个嵌套资源,可以使用如下URI访问:

/photos/{photo}/comments/{comment}
ログイン後にコピー

限定嵌套资源的范围

Laravel 的隐式模型绑定特性可以自动限定嵌套绑定的范围,因此已解析的子模型会自动属于父模型。定义嵌套路由时,使用scoped方法,可以开启自动范围限定,也可以指定 Laravel 应该按照哪个字段检索子模型资源

Route::resource('photos.comments', PhotoCommentController::class)->scoped([ 'comment' => 'slug', ]);
ログイン後にコピー

这个路由会注册一个限定范围的嵌套资源路由,可以像下面这样来访问:

/photos/{photo}/comments/{comment:slug}
ログイン後にコピー

浅层嵌套

通常,并不完全需要在URI中同时拥有父 ID 和子 ID ,因为子 ID 已经是唯一的标识符。当使用唯一标识符(如自动递增的主键)来标识URI中的模型时,可以选择使用「浅嵌套」的方式定义路由:

Route::resource('photos.comments', CommentController::class)->shallow();
ログイン後にコピー

上面的路由定义方式会定义以下路由:

HTTP 方式 URI 行为 路由名称
GET /photos/{photo}/comments index photos.comments.index
GET /photos/{photo}/comments/create create photos.comments.create
POST /photos/{photo}/comments store photos.comments.store
GET /comments/{comment} show comments.show
GET /comments/{comment}/edit edit comments.edit
PUT/PATCH /comments/{comment} update comments.update
DELETE /comments/{comment} destroy comments.destroy

命名资源路由

默认情况下,所有的资源控制器行为都有一个路由名称。你可以传入names数组来覆盖这些名称:

Route::resource('photos', PhotoController::class)->names([ 'create' => 'photos.build' ]);
ログイン後にコピー

命名资源路由参数

默认情况下,Route::resource会根据资源名称的「单数」形式创建资源路由的路由参数。你可以在选项数组中传入parameters参数来轻松地覆盖每个资源。parameters数组应该是资源名称和参数名称的关联数组:

Route::resource('users', AdminUserController::class)->parameters([ 'users' => 'admin_user' ]);
ログイン後にコピー

上例将会为资源的show路由生成如下的 URI :

/users/{admin_user}
ログイン後にコピー

限定范围的资源路由

有时,在定义资源路由时隐式绑定了多个 Eloquent 模型,你希望限定第二个 Eloquent 模型必须为第一个 Eloquent 模型的子模型。例如,考虑这样一个场景,通过 slug 检索某个特殊用户的一篇文章:

use App\Http\Controllers\PostsController;Route::resource('users.posts', PostsController::class)->scoped();
ログイン後にコピー

你可以通过给scoped方法传递一个数组来覆盖默认的模型路由键:

use App\Http\Controllers\PostsController;Route::resource('users.posts', PostsController::class)->scoped([ 'post' => 'slug', ]);
ログイン後にコピー

当使用一个自定义键的隐式绑定作为嵌套路由参数时,Laravel 会自动限定查询范围,按照约定的命名方式去父类中查找关联方法,然后检索到对应的嵌套模型。在这种情况下,将假定User模型有一个叫posts(路由参数名的复数)的关联方法,通过这个方法可以检索到Post模型。

本地化资源 URI

默认情况下,Route::resource将会用英文动词创建资源 URI。如果需要自定义createedit行为的动作名,可以在AppServiceProviderboot中使用Route::resourceVerbs方法实现:

use Illuminate\Support\Facades\Route; /** * 引导任何应用服务。 * * @return void */ public function boot() { Route::resourceVerbs([ 'create' => 'crear', 'edit' => 'editar', ]); }
ログイン後にコピー

动作被自定义后,像Route::resource('fotos', 'PhotoController')这样注册的资源路由将会产生如下的 URI:

/fotos/crear /fotos/{foto}/editar
ログイン後にコピー

补充资源控制器

如果您需要增加额外的路由到默认的资源路由之中,您需要在Route::resource前定义它们;否则,resource方法定义的路由可能会无意间优先于您定义的路由:

Route::get('photos/popular', [PhotoController::class, 'popular']); Route::resource('photos', PhotoController::class);
ログイン後にコピー

技巧:记得保持您的控制器的专一性。如果您需要典型的资源操作以外的方法,请考虑将您的控制器分割为两个更小的控制器。

依赖注入 & 控制器

构造注入

Laravel服务容器被用于解析所有的 Laravel 控制器。因此,您可以在控制器的构造函数中使用类型提示需要的依赖项。声明的解析会自动解析并注入到控制器实例中去:

users = $users; } }
ログイン後にコピー

您亦可类型提示Laravel 契约,只要它能够被解析。取决于您的应用,注入依赖到控制器可能会提供更好的可测试性。

方法注入

除了构造器注入以外,您亦可在控制器方法中类型提示依赖。最常见的用法便是注入Illuminate\Http\Request到您的控制器方法中:

name; // } }
ログイン後にコピー

如果您的控制器方法要从路由参数中获取输入内容,请在您的依赖项之后列出您的路由参数。例如,您可以像下方这样定义路由:

Route::put('user/{id}', [UserController::class, 'update']);
ログイン後にコピー

如下所示,您依然可以类型提示Illuminate\Http\Request并通过定义您的控制器方法访问id参数:


        
ログイン後にコピー

路由缓存

如果您的应用仅使用了基于路由的控制器,您应该充分利用 Laravel 路由缓存。使用路由缓存将会大幅降低您的应用路由的注册时间。有时,您的路由注册的速度可能会提高 100 倍。要生成路由缓存,仅需执行route:cacheArtisan 命令:

php artisan route:cache
ログイン後にコピー

在运行该命令后,每次请求将会加载您缓存的路由文件。请记住,您每次添加新路由后均需要生成新的路由缓存。因此,您应该在项目部署时才运行route:cache命令。

您亦可使用route:clear来清除路由缓存:

php artisan route:clear
ログイン後にコピー

【相关推荐:laravel视频教程

以上がLaravelコントローラーとは何ですかの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

関連ラベル:
ソース:php.cn
このウェブサイトの声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
最新のダウンロード
詳細>
ウェブエフェクト
公式サイト
サイト素材
フロントエンドテンプレート
私たちについて 免責事項 Sitemap
PHP中国語ウェブサイト:福祉オンライン PHP トレーニング,PHP 学習者の迅速な成長を支援します!