laravel では、コントローラー (Controller) は特定の機能を実装するために使用されるクラスであり、コントローラーは関連するリクエスト処理ロジックを別のクラスに結合できます。一部のメソッドは、特定の機能を実装するためにコントローラーに保存されます。コントローラーはルーティングを通じて呼び出され、コールバック関数は使用されなくなり、コントローラーは「app/Http/Controllers」ディレクトリに保存されます。
このチュートリアルの動作環境: 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']);
UserController
コントローラーのshowメソッドが実行されます。ルート パラメーターもこのメソッドに渡されます。
ヒント: コントローラーは基本クラスを継承するために
middleware、validate、
dispatch
メソッドなどの一部の便利な機能を使用できません。 。単一動作コントローラー
単一動作のみを処理するコントローラーを定義したい場合は、__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
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 つに割り当てることができます。ただし、それはコントローラーが複雑になっていることを示している可能性があります。コントローラーを複数の小さなコントローラーに分割することをお勧めします。
リソースコントローラー
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 模板的路由(如create
和edit
)。为了方便起见,你可以使用apiResource
方法自动排除这两个路由:
Route::apiResource('photos', PhotoController::class);
你也可以传递一个数组给apiResources
方法来同时注册多个 API 资源控制器:
Route::apiResources([ 'photos' => PhotoController::class, 'posts' => PostController::class, ]);
要快速生成不包含create
或edit
方法的用于开发接口的资源控制器,请在执行 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
模型。
默认情况下,Route::resource
将会用英文动词创建资源 URI。如果需要自定义create
和edit
行为的动作名,可以在AppServiceProvider
的boot
中使用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:cache
Artisan 命令:
php artisan route:cache
在运行该命令后,每次请求将会加载您缓存的路由文件。请记住,您每次添加新路由后均需要生成新的路由缓存。因此,您应该在项目部署时才运行route:cache
命令。
您亦可使用route:clear
来清除路由缓存:
php artisan route:clear
【相关推荐:laravel视频教程】
以上がLaravelコントローラーとは何ですかの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。