オペレーション
コントローラーは、エンドユーザーのリクエストを実行するための最も基本的な単位であるオペレーションで構成されます。コントローラーには 1 つ以上のオペレーションを含めることができます。次の例は、view と create の 2 つの操作を含むコントローラー ポストを示しています。 リーリー
操作ビュー (actionView() メソッドとして定義) では、コードは最初にリクエスト モデル ID に従ってモデルを読み込みます。読み込みが成功すると、view という名前のビューがレンダリングされて表示されます。そうでない場合は、例外がスローされます。 。
create 操作 (actionCreate() メソッドとして定義) のコードは同様です。最初にリクエスト データをモデルに入力し、両方が成功すると、ID を使用して view 操作にジャンプします。それ以外の場合は、ユーザー入力を提供する作成ビューを表示します。
ルーティングエンドユーザーは、以下の部分を含む文字列である、いわゆるルートを通じてアクションを見つけます:
モデル ID: コントローラーが非アプリケーションに属するモジュールにのみ存在します。
コントローラーID/アクションID
モジュールの下のコントローラーに属している場合は、次の形式を使用します:
モジュールID/コントローラーID/アクションID
yiiwebApplication Web アプリケーションでは、コントローラーは yiiwebController またはそのサブクラスを継承する必要があります。 同様に、yiiconsoleApplication コンソール アプリケーションでは、コントローラーは yiiconsoleController またはそのサブクラスを継承します。 次のコードはサイト コントローラーを定義します:
リーリー コントローラーID通常、コントローラーはリクエストに関連するリソースタイプを処理するために使用されるため、コントローラー ID は通常、リソースに関連する名詞です。 たとえば、アーティクルを処理するためのコントローラー ID としてアーティクルを使用します。
コントローラー ID には、英語の小文字、数字、アンダースコア、ダッシュ、スラッシュのみを含める必要があります。たとえば、article と postcomment は実際のコントローラー ID ですが、article?、PostComment、および adminpost はコントローラー ID ではありません。
コントローラー ID にはサブディレクトリのプレフィックスを含めることができます。たとえば、admin/article は、yiibaseApplication::controllerNamespace コントローラー名前空間の下の admin サブディレクトリ内のアーティクル コントローラーを表します。 サブディレクトリの接頭辞には、英語の大文字と小文字、数字、アンダースコア、およびスラッシュを使用できます。スラッシュは、複数レベルのサブディレクトリ (panels/admin など) を区別するために使用されます。
コントローラークラスの名前付けコントローラー ID は、次のルールに従ってコントローラー クラス名を導出します:
スラッシュで区切られた各単語の最初の文字を大文字に変換します。コントローラー ID にスラッシュが含まれている場合、最後のスラッシュの後の最初の文字のみが大文字に変換されることに注意してください。 ダッシュを削除し、スラッシュをバックスラッシュに置き換えます。
コントローラーのサフィックスを追加します;
yiibaseApplication::controllerNamespace コントローラーの名前空間を前に追加します。
以下に、yiibaseApplication::controllerNamespace コントローラーの名前空間が appcontrollers:
であると仮定した場合の、いくつかの例を示します。
記事は appcontrollersArticleController に対応します;
コントローラーの導入
yiibaseApplication::controllerMap を設定して、上記のコントローラー ID とクラス名を強制的に対応させることができます。通常、サードパーティを使用する場合にクラス名を制御できないコントローラーに使用されます。
各アプリケーションには、yiibaseApplication::defaultRoute 属性で指定されたデフォルトのコントローラーがあります。リクエストでルートが指定されていない場合は、属性値がルートとして使用されます。 yiiwebApplication Web アプリケーションの場合、その値は「site」であり、yiiconsoleApplication コンソール アプリケーションの場合、その値は help であるため、URL は http://hostname/index.php となり、サイト コントローラーによって処理されることを意味します。
可以在 应用配置 中修改默认控制器,如下所示: 创建操作 创建操作可简单地在控制器类中定义所谓的 操作方法 来完成,操作方法必须是以action开头的公有方法。 操作方法的返回值会作为响应数据发送给终端用户,如下代码定义了两个操作 index 和 hello-world: 操作ID 操作通常是用来执行资源的特定操作,因此,操作ID通常为动词,如view, update等。 操作ID应仅包含英文小写字母、数字、下划线和中横杠,操作ID中的中横杠用来分隔单词。 例如view, update2, comment-post是真实的操作ID,view?, Update不是操作ID. 可通过两种方式创建操作ID,内联操作和独立操作. An inline action is 内联操作在控制器类中定义为方法;独立操作是继承yii\base\Action或它的子类的类。 内联操作容易创建,在无需重用的情况下优先使用; 独立操作相反,主要用于多个控制器重用,或重构为扩展。 内联操作 内联操作指的是根据我们刚描述的操作方法。 操作方法的名字是根据操作ID遵循如下规则衍生: 注意: 操作方法的名字大小写敏感,如果方法名称为ActionIndex不会认为是操作方法, 所以请求index操作会返回一个异常,也要注意操作方法必须是公有的,私有或者受保护的方法不能定义成内联操作。 独立操作 独立操作通过继承yii\base\Action或它的子类来定义。 例如Yii发布的yii\web\ViewAction和yii\web\ErrorAction都是独立操作。 要使用独立操作,需要通过控制器中覆盖yii\base\Controller::actions()方法在action map中申明,如下例所示: 如上所示, actions() 方法返回键为操作ID、值为对应操作类名或数组configurations 的数组。 和内联操作不同,独立操作ID可包含任意字符,只要在actions() 方法中申明. 为创建一个独立操作类,需要继承yii\base\Action 或它的子类,并实现公有的名称为run()的方法, run() 方法的角色和操作方法类似,例如: 操作结果 操作方法或独立操作的run()方法的返回值非常重要,它表示对应操作结果。 返回值可为 响应 对象,作为响应发送给终端用户。 对于yii\web\Application网页应用,返回值可为任意数据, 它赋值给yii\web\Response::data, 最终转换为字符串来展示响应内容。 public function actionForward() 操作参数 内联操作的操作方法和独立操作的 run() 方法可以带参数,称为操作参数。 参数值从请求中获取,对于yii\web\Application网页应用, 每个操作参数的值从$_GET中获得,参数名作为键; 对于yii\console\Application控制台应用, 操作参数对应命令行参数。 如下例,操作view (内联操作) 申明了两个参数 $id 和 $version。 操作参数会被不同的参数填入,如下所示: http://hostname/index.php?r=post/view&id=123: $id 会填入'123',$version 仍为 null 空因为没有version请求参数; 现在如果请求为 http://hostname/index.php?r=post/view&id[]=123, 参数 $id 会使用数组值['123'], 如果请求为http://hostname/index.php?r=post/view&id=123, 参数 $id 会获取相同数组值,因为无类型的'123'会自动转成数组。 上述例子主要描述网页应用的操作参数,对于控制台应用,更多详情请参阅控制台命令。 默认操作 每个控制器都有一个由 yii\base\Controller::defaultAction 属性指定的默认操作, 当路由 只包含控制器ID,会使用所请求的控制器的默认操作。 默认操作默认为 index,如果想修改默认操作,只需简单地在控制器类中覆盖这个属性,如下所示: 控制器动作参数绑定 为了详细说明此功能,假设我们需要为 PostController 写一个 create 动作。此动作需要两个参数: 从 $_GET 中提取参数时,我们可以不再下面这种无聊的代码了: 现在使用动作参数功能,我们可以更轻松的完成任务: 注意我们在动作方法 actionCreate 中添加了两个参数。这些参数的名字必须和我们想要从 $_GET 中提取的名字一致。当用户没有在请求中指定 $language 参数时,这个参数会使用默认值 en 。由于 $category 没有默认值,如果用户没有在 $_GET 中提供 category 参数,将会自动抛出一个 CHttpException (错误代码 400) 异常。 从版本1.1.5开始,Yii已经支持数组的动作参数。使用方法如下: 控制器生命周期 处理一个请求时,应用主体 会根据请求路由创建一个控制器,控制器经过以下生命周期来完成请求: 在设计良好的应用中,控制器很精练,包含的操作代码简短; 如果你的控制器很复杂,通常意味着需要重构,转移一些代码到其他类中。 归纳起来,控制器:
[
'defaultRoute' => 'main',
]
namespace app\controllers;
use yii\web\Controller;
class SiteController extends Controller
{
public function actionIndex()
{
return $this->render('index');
}
public function actionHelloWorld()
{
return 'Hello World';
}
}
因为容易创建,内联操作是最常用的操作,但是如果你计划在不同地方重用相同的操作, 或者你想重新分配一个操作,需要考虑定义它为独立操作。
public function actions()
{
return [
// 用类来申明"error" 操作
'error' => 'yii\web\ErrorAction',
// 用配置数组申明 "view" 操作
'view' => [
'class' => 'yii\web\ViewAction',
'viewPrefix' => '',
],
];
}
<?php
namespace app\components;
use yii\base\Action;
class HelloWorldAction extends Action
{
public function run()
{
return "Hello World";
}
}
对于yii\console\Application控制台应用,返回值可为整数, 表示命令行下执行的 yii\console\Response::exitStatus 退出状态。
在上面的例子中,操作结果都为字符串,作为响应数据发送给终端用户,下例显示一个操作通过 返回响应对象(因为yii\web\Controller::redirect()方法返回一个响应对象)可将用户浏览器跳转到新的URL。
{
// 用户浏览器跳转到 http://example.com
return $this->redirect('http://example.com');
}
namespace app\controllers;
use yii\web\Controller;
class PostController extends Controller
{
public function actionView($id, $version = null)
{
// ...
}
}
http://hostname/index.php?r=post/view&id=123&version=2: $id 和 $version 分别填入 '123' 和 '2'`;
http://hostname/index.php?r=post/view: 会抛出yii\web\BadRequestHttpException 异常 因为请求没有提供参数给必须赋值参数$id;
http://hostname/index.php?r=post/view&id[]=123: 会抛出yii\web\BadRequestHttpException 异常 因为$id 参数收到数字值 ['123']而不是字符串.
如果想让操作参数接收数组值,需要指定$id为array,如下所示:
public function actionView(array $id, $version = null)
{
// ...
}
namespace app\controllers;
use yii\web\Controller;
class SiteController extends Controller
{
public $defaultAction = 'home';
public function actionHome()
{
return $this->render('home');
}
}
从版本 1.1.4 开始,Yii 提供了对自动动作参数绑定的支持。就是说,控制器动作可以定义命名的参数,参数的值将由 Yii 自动从 $_GET 填充。
class PostController extends CController
{
public function actionCreate()
{
if(isset($_GET['category']))
$category=(int)$_GET['category'];
else
throw new CHttpException(404,'invalid request');
if(isset($_GET['language']))
$language=$_GET['language'];
else
$language='en';
// ... fun code starts here ...
}
}
class PostController extends CController
{
public function actionCreate($category, $language='en')
{
$category = (int)$category;
echo 'Category:'.$category.'/Language:'.$language;
// ... fun code starts here ...
}
}
class PostController extends CController
{
public function actionCreate(array $categories)
{
// Yii will make sure $categories be an array
}
}
最佳实践
興味があるかもしれない記事: