この記事では、主に Symfony2 コントローラーの使用法を紹介し、Symfony コントローラーの機能、実装テクニック、関連技術の詳細を詳細に分析します。困っている友達が参考になれば幸いです。
コントローラーは、HTTP リクエスト (リクエスト) を受信し、HTTP 応答 (レスポンス) を作成して返す、ユーザーが作成する PHP 関数です。応答オブジェクト (Response) には、HTML ページ、XML ドキュメント、シリアル化された JSON 配列、画像、リダイレクト、404 エラーなど、任意のものを指定できます。コントローラーには、ページのコンテンツをレンダリングするために必要なロジックを含めることができます。
以下は、Hello world! を出力するだけのコントローラーの最も単純な例です。
use Symfony\Component\HttpFoundation\Response; public function helloAction() { return new Response('Hello world!'); }
コントローラーの最終的な目標は同じで、Response オブジェクトを作成して返すことです。この考え方に従って、リクエスト オブジェクトから情報を読み取ったり、データベース リソースをロードしたり、電子メールを送信したり、ユーザーのセッションに情報を書き込んだりすることができます。ただし、どのような場合でも、コントローラーは最終的に Response オブジェクトを返し、クライアントに配布されます。
たとえば、次の状況:
コントローラー A は、Web サイトのホームページのコンテンツを表す Response オブジェクトを準備します。
コントローラー B はリクエストからスラッグパラメータを読み取り、データベースからブログコンテンツをロードし、ブログを表示するためのレスポンスオブジェクトを作成します。スラグがデータベースに存在しない場合は、404 ステータス コードを持つ Response オブジェクトを作成して返します。
コントローラー C は問い合わせフォームを処理し、Request オブジェクトからフォーム情報を読み取り、連絡先情報をデータベースに保存します。そして管理者にメールを送信します。最後に、クライアント ブラウザを問い合わせフォームのサンキュー ページにリダイレクトする Response オブジェクトを作成します。
リクエスト、コントローラー、レスポンスのライフサイクル
Symfony2 プロジェクトで処理されるすべてのリクエストは、同じ単純なライフサイクルを通過します。フレームワークは反復的なタスクを担当し、最終的にアプリケーション コードを含むコントローラーを実行します:
1. 各リクエストは統合されたフロントエンド コントローラー ファイル (app.php や app_dev.php など) によって処理されます。 、アプリケーションが起動します。
2.Router は、Request から URI 情報を読み取り、それに一致する Route を見つけ、Route から _controller パラメーターを読み取ります。
3. 正常に一致したルートのコントローラーが実行され、コントローラー内のコードが Response オブジェクトを作成して返します。
4.HTTP ヘッダーと生成された Response オブジェクトの内容がクライアントに返送されます。
ページの作成は、コントローラーを作成し、URL をコントローラーにマップするルートを作成するのと同じくらい簡単です。
注: フロントエンド コントローラーとコントローラーは名前が似ていますが、実際には異なります。
フロントエンド コントローラーは Web ディレクトリに保存されている PHP ファイルであり、すべてのリクエストはそれを通じてリダイレクトされます。すべてのアプリケーションには、運用フロントエンド コントローラー app.php と開発フロントエンド コントローラー app_dev.php があります。編集したり、表示したり、心配したりする必要はありません。
単純なコントローラーを見てください: PHP 呼び出し可能なコンテンツ (関数、オブジェクト メソッド、クロージャーなど) はすべてコントローラーになることができます。 Symfongy2 では、コントローラーは通常、コントローラー オブジェクト内の単一のメソッドです。コントローラーはアクションとも呼ばれます。
// src/Acme/HelloBundle/Controller/HelloController.php namespace Acme\HelloBundle\Controller; use Symfony\Component\HttpFoundation\Response; class HelloController { public function indexAction($name) { return new Response('<html><body>Hello '.$name.'!</body></html>'); } }
この例では、コントローラーはコントローラー クラス (HelloController) に存在する IndexAction メソッドであることに注意してください。混乱しないでください。コントローラー クラス (HelloController) が定義されている理由は、複数のコントローラー/アクションをまとめて整理しやすくするためだけです。一般に、コントローラー クラスには複数のコントローラー/アクションがあります。
上記の例のコントローラーは非常に単純です:
Namespace 行では、symfony2 が PHP5.3 のネームスペース機能を使用してコントローラー クラス全体のネームスペースを指定します。
use キーワードは、コントローラーが返さなければならない Response クラスをインポートします。
Controllerのクラス名は名前の後ろにControllerを付けて定義しますが、統一のため最後にControllerを付けるのは前部分のみです。 ルーティング設定時に最初の部分のみが取得されます。
実際のコントローラーに使用されるコントローラー クラスのすべてのメソッドには、統一されたサフィックス アクションが追加されます。同様に、ルーティングを設定するときは、最初の部分のみを取得し、アクションを無視します。それを URL にマッピングします。
各コントローラー メソッドの最後に、Response オブジェクトを作成して返す必要があります。
URL をコントローラー メソッドにマッピング:
上記の例のコントローラー メソッドは、単純な HTML ページを返します。ブラウザでこのページにアクセスする場合は、そのページへのルートを作成し、特定のパターンで URL にマップする必要があります。
# app/config/routing.yml hello: pattern: /hello/{name} defaults: { _controller: AcmeHelloBundle:Hello:index }
XML 形式:
<!-- app/config/routing.xml --> <route id="hello" pattern="/hello/{name}"> <default key="_controller">AcmeHelloBundle:Hello:index</default> </route>
PHP コード形式:
// app/config/routing.php $collection->add('hello', new Route('/hello/{name}', array( '_controller' => 'AcmeHelloBundle:Hello:index', )));
次に、URL /hello/ryan が HelloController::indexAction() コントローラーにマップされ、ryan を $name 変数に渡すと想像してください。
いわゆるページの作成は、実際にはコントローラーメソッドと関連ルートを作成することです。
コントローラー メソッドを指すために使用する構文に注意してください: AcmeHelloBundle:Hello:index
Symfony2使用了一个非常灵活的字符串声明来指向不同的controller。它告诉Symfony2在一个名叫AcmeHelloBundle的bundle中去查找一个叫HelloController的类,并执行它的indexAction()方法。在这个例子中,我们的路由配置直接写在了app/config/ 目录下,一个更好的组织方式是把你的路由放到各自的bundle中。
路由参数作为Controller方法参变量
你已经了_controller参数 AcmeHelloBundle:Hello:index指向一个位于AcmeHelloBundle中名叫HelloController::indexAction()的方法。有趣的是路由中参数都会被传递给该方法。
<?php // src/Acme/HelloBundle/Controller/HelloController.php namespace Acme\HelloBundle\Controller; use Symfony\Bundle\FrameworkBundle\Controller\Controller; class HelloController extends Controller { public function indexAction($name) { // ... } }
上例中controller方法有一个唯一参数,$name, 它对应着route中定义的{name}占位符名称。事实上,等你执行你的controller时,Symfony2会匹配controller和route中每一个参数。
如果我修改一下Hello的路由定义:
YAML格式:
# app/config/routing.yml hello: pattern: /hello/{first_name}/{last_name} defaults: { _controller: AcmeHelloBundle:Hello:index, color: green }
XML格式:
<!-- app/config/routing.xml --> <route id="hello" pattern="/hello/{first_name}/{last_name}"> <default key="_controller">AcmeHelloBundle:Hello:index</default> <default key="color">green</default> </route>
PHP代码格式:
// app/config/routing.php $collection->add('hello', new Route('/hello/{first_name}/{last_name}', array( '_controller' => 'AcmeHelloBundle:Hello:index', 'color' => 'green', )));
这时候controller中可以获取这些参变量了:
public function indexAction($first_name, $last_name, $color) { // ... }
注意route定义中无论是占位符变量还是默认值变量都会被转化为controller方法的输入变量。当一个route匹配成功时,它会合并占位符和defaults到一个数组传递给controller。映射route参数到controller参数非常简单和灵活。它们从route到controller不匹配顺序。Symfony能够把route中参变量的名字映射到controller方法签名中的变量名字。比如{last_name} => $last_name,跟排列顺序无关。
Controller方法中的参数必须匹配route中定义的参数下面为hello route定义的controller方法将会抛出异常:
public function indexAction($last_name, $color, $first_name) { // .. }
如果我们把$foo变量变为可选变量,那么就不会抛异常了。
public function indexAction($first_name, $last_name, $color, $foo) { // .. }
并不是每一个在route中定义的参数都需要在controller中有与之对应的签名参变量的,比如hello route中定义的{$last_name} 如果对你没什么意义的话可以在controller中省略掉它。
public function indexAction($first_name, $color) { // .. }
反之,如果你在Controller签名中定义了变量,并且不是可选变量,那么必须在route中有与之对应的参数被定义。
在route定义中有一个特殊参数 _route, 它匹配route的名称(如上例中的hello)。虽然不常用,但是它也可以作为controller方法的一个参变量使用。
Request作为一个Controller方法签名变量
为了方便,你可能会让symfony传递你的Request对象作为参数到你的controller方法。这在你处理表单时尤为方便。
use Symfony\Component\HttpFoundation\Request; public function updateAction(Request $request) { $form = $this->createForm(...); $form->bindRequest($request); // ... }
Controller基类
为了方便,Symfony2定义了一个Controller基类,包含了一些常用的controller任务并给了你的controller类访问任何你需要的资源的途径。通过继承该类,你可以获得许多帮助方法。
// src/Acme/HelloBundle/Controller/HelloController.php namespace Acme\HelloBundle\Controller; use Symfony\Bundle\FrameworkBundle\Controller\Controller; use Symfony\Component\HttpFoundation\Response; class HelloController extends Controller { public function indexAction($name) { return new Response('<html><body>Hello '.$name.'!</body></html>'); } }
在Symfony中controller并不一定非得继承Controller基类,因为它内部的帮助方法等都不是必须的。你也可以继承 Symfony\Component\DependencyInjection\ContainerAware 服务容器对象可以通过container属性来访问。同时你也可以把controller定义成service。
通用的Controller任务:
尽管Controller可以干任何事情,但是大部分的controller还是要重复的干一些基础的任务。比如 重定向,跳转,渲染模板和访问核心服务等。
重定向(redirecting)
如果你想重定向你的用户到另一个页面,可以使用redirect()方法。
public function indexAction() { return $this->redirect($this->generateUrl('homepage')); }
这里generateUrl()方法是一个帮助函数,用于根据给定的route生成相应的URL。默认情况下,redirect()方法执行一个302重定向。如果要执行301重定向,那么需要修改第二个参数如下:
public function indexAction() { return $this->redirect($this->generateUrl('homepage'), 301); }
redirect()方法其实是一个简化写法,真正的代码如下:
use Symfony\Component\HttpFoundation\RedirectResponse; return new RedirectResponse($this->generateUrl('homepage'));
跳转(Forwarding)
你可以使用forward()方法很容易从一个controller到另一个controller内部。它执行的是一个内部子请求,来调用指定的controller,所以不会产生用户客户端浏览器的重定向。forward()方法返回的Response对象还将从原controller返回。
public function indexAction($name) { $response = $this->forward('AcmeHelloBundle:Hello:fancy', array( 'name' => $name, 'color' => 'green' )); // further modify the response or return it directly return $response; }
这里forward()方法使用了跟route配置中相同的字符串参数。这里传入数组参数会作为目标调用controller的参数。当将controller嵌入到模板时,也会使用同样的接口。目标调用的controller方法应该是如下定义:
public function fancyAction($name, $color) { // ... create and return a Response object }
就像为一个route创建一个controller一样,跟参数的顺序没关系。symfony2 会匹配索引键名称name到方法参数名称$name,即使顺序打乱也没关系。跟其它Controller基类方法一样,forward方法也仅仅是一个symfony2核心函数的快捷写法。一个跳转可以直接通过http_kernel服务来完成,返回一个Response对象。
$httpKernel = $this->container->get('http_kernel'); $response = $httpKernel->forward('AcmeHelloBundle:Hello:fancy', array( 'name' => $name, 'color' => 'green', ));
渲染模板:
虽然不是必须的,但是大部分controller将最终渲染一个负责生成为controller负责生成HTML的模板。renderView()方法会渲染一个模板并返回它的内容。这个返回内容可以用作创建Response对象,以供controller返回使用。
$content = $this->renderView('AcmeHelloBundle:Hello:index.html.twig', array('name' => $name)); return new Response($content);
上面的代码完全可以更进一步的使用下面的代码形式来写:
return $this->render('AcmeHelloBundle:Hello:index.html.twig', array('name' => $name));
这两种情况下,AcmeHelloBundle中的模板Resources/views/Hello/index.html.twig都会被渲染。
renderview()方法是如下代码的快捷写法:
$templating = $this->get('templating'); $content = $templating->render('AcmeHelloBundle:Hello:index.html.twig', array('name' => $name));
当然也可以在子目录中渲染模板
$templating->render('AcmeHelloBundle:Hello/Greetings:index.html.twig', array('name' => $name)); // index.html.twig 存放于 Resources/views/Hello/Greetings 目录.
访问其它服务
只要是继承了Controller基类,你就可以通过get()方法访问symfony2的服务了。比如:
$request = $this->getRequest(); $templating = $this->get('templating'); $router = $this->get('router'); $mailer = $this->get('mailer');
Symfony2中还有无数的可用服务,同时也鼓励你定义自己的服务。要查看所有的服务,可以使用container:debug 命令行工具
$ php app/console container:debug
管理错误和404页面
当一些东西没有找到,你应该重置HTTP协议返回一个404 回复。要做到这个,你将抛出一个特殊类型的异常。如果你是继承了Controller基类,则:
public function indexAction() { $product = // retrieve the object from database if (!$product) { throw $this->createNotFoundException('The product does not exist'); } return $this->render(...); }
createNotFoundException()方法创建一个特定的NotFoundHttpException对象,它最终触发404 HTTP回复。当然你从你的controller方法中可以抛出任何类型的Exception 类,Symfony2会自动返回一个500 HTTP回复代码。
throw new \Exception('Something went wrong!');
管理Session
Symfony2 提供了一个非常好的Session对象,你可以用它来在请求之间存贮有关用户的信息。默认情况下,Symfony2 通过PHP本身的Session保存属性到cookie。在任何controller中存储和获取Session信息将非常容易:
$session = $this->getRequest()->getSession(); // 为用户的后一个请求使用存储一个属性 $session->set('foo', 'bar'); // 在另一个controller中为另一个请求获取该属性 $foo = $session->get('foo'); // 设置用户的本地化语言 $session->setLocale('fr');
Flash 消息
你可以为特定的请求存储少量的消息到用户的Session。这在处理一个表单时非常有用,你想重定向和一个特定的信息显示在下一个请求中。这种类型的消息被称为Flash消息。比如,假设你处理一个表单提交:
public function updateAction() { $form = $this->createForm(...); $form->bindRequest($this->getRequest()); if ($form->isValid()) { // 做些排序处理 $this->get('session')->setFlash('notice', 'Your changes were saved!'); return $this->redirect($this->generateUrl(...)); } return $this->render(...); }
此例中,在处理完请求后,controller设置了一个notice flash消息并作了重定向。名字notice没什么意义,只是用于标识该消息。在下一个活动的模板中,下面的代码能够渲染这个notic消息:
Twig
{% if app.session.hasFlash('notice') %} <p class="flash-notice"> {{ app.session.flash('notice') }} </p> {% endif %}
PHP代码:
<?php if ($view['session']->hasFlash('notice')): ?> <p class="flash-notice"> <?php echo $view['session']->getFlash('notice') ?> </p> <?php endif; ?>
这样设计,flash消息就能够为准确的某个请求存在了。他们一般被设计出来就是用于重定向的。
Response对象
作为一个Controller来说,唯一必须做到的是返回一个Response对象。
Response对象是一个PHP代码对HTTP Response的抽象。
HTTP Response是一个基于文本的消息有HTTP headers和 返回给客户端的内容组成。
//创建一个简单的Response对象,默认状态码为200 $response = new Response('Hello ' .$name, 200); //创建一个基于JSON的Response对象,状态码也为200 $response = new Response(json_encode(array('name'=>$name))); $response->headers->set('content-type','application/json');
其中headers属性是一个HeaderBag对象,内部包含许多有用的方法来读取和改变Response的头信息。头名字被标准化使用Content-Type 与content-type或者content_type效果等同。
请求对象Request
除了路由占位符的值以外,如果继承了Controller基类那么该controller还可以访问Request对象。
$request = $this->getRequest(); $request->isXmlHttpRequest(); // 判断是不是Ajax请求 $request->getPreferredLanguage(array('en','fr')); $request->query->get('page'); // 获取$_GET 参数 $request->request->get('page'); //获取$_POST参数
跟Response对象一样,Request对象的头也保存在HeaderBag对象中,可以很方便的被访问。
总结思考:
无论何时,你创建一个页面,你最终需要为它写一些包含逻辑的代码。在Symfony中,这叫一个controller, 它是一个PHP的函数,它可以为了最后返回一个Response对象给用户可以做需要的任何事情。简单的说,你可以选择继承一个Controller基类,它包含了许多执行controller通用任务的快捷方法。比如,你不想把HTML代码写入你的controller, 你可以使用render()方法来渲染并返回一个模板内容。
相关推荐:
详解Symfony在模板和行为中取得request参数的方法
以上がSymfony2コントローラーの使い方を詳しく解説の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。