Detaillierte Erläuterung der Verwendung des Symfony2-Controllers

In diesem Artikel wird hauptsächlich die Verwendung des Symfony2-Controllers vorgestellt und die Funktionen, Implementierungstechniken und zugehörigen technischen Details des Symfony-Controllers im Detail analysiert. Freunde in Not können darauf verweisen. Ich hoffe, dass es für alle hilfreich ist.

Ein Controller ist eine von Ihnen erstellte PHP-Funktion, die eine HTTP-Anfrage empfängt und eine HTTP-Antwort erstellt und zurückgibt. Das Antwortobjekt (Response) kann eine HTML-Seite, ein XML-Dokument, ein serialisiertes JSON-Array, ein Bild, eine Weiterleitung, ein 404-Fehler oder alles andere sein, was Sie möchten. Der Controller kann jede Logik enthalten, die zum Rendern des Inhalts Ihrer Seite erforderlich ist.

Das Folgende ist das einfachste Beispiel eines Controllers, der lediglich eine „Hallo Welt“ druckt!

use Symfony\Component\HttpFoundation\Response;
public function helloAction()
{
 return new Response('Hello world!');
}

Das ultimative Ziel des Controllers ist dasselbe, nämlich das Erstellen und Zurückgeben einer Antwort Objekt. Dieser Idee folgend können Sie Informationen aus dem Anforderungsobjekt lesen, Datenbankressourcen laden, E-Mails senden oder Informationen in die Sitzung des Benutzers schreiben. Aber in allen Fällen wird der Controller schließlich ein Antwortobjekt zurückgeben und an den Client verteilen.

Zum Beispiel die folgende Situation:

Controller A bereitet ein Antwortobjekt vor, um den Inhalt der Website-Homepage darzustellen.
Controller B liest den Slug-Parameter aus der Anfrage, lädt einen Blog-Inhalt aus der Datenbank und erstellt ein Antwortobjekt, um den Blog anzuzeigen. Wenn der Slug nicht in der Datenbank vorhanden ist, erstellt er ein Antwortobjekt mit einem 404-Statuscode und gibt es zurück.

Controller C verarbeitet ein Slave-Kontaktformular, das die Formularinformationen aus dem Request-Objekt liest und speichert Kontaktinformationen Gehen Sie zur Datenbank und senden Sie eine E-Mail an den Administrator. Schließlich wird ein Response-Objekt erstellt, das den Client-Browser zur Dankesseite des Kontaktformulars weiterleitet.

Lebenszyklus von Anfragen, Controller, Antwort

Jede im Symfony2-Projekt verarbeitete Anfrage durchläuft denselben einfachen Lebenszyklus. Das Framework ist für sich wiederholende Aufgaben verantwortlich und führt letztendlich einen Controller aus, der Ihren Anwendungscode enthält:

1 Jede Anfrage wird von einer einheitlichen Front-End-Controller-Datei verarbeitet (z. B. app.php oder app_dev .php) und die Anwendung wird gestartet.
2.Router liest die URI-Informationen aus der Anfrage, findet die Route, die dazu passt, und liest den _controller-Parameter aus der Route.
3. Der Controller der erfolgreich abgeglichenen Route wird ausgeführt und der Code im Controller erstellt ein Antwortobjekt und gibt es zurück.
4. Der HTTP-Header und der generierte Antwortobjektinhalt werden an den Client zurückgesendet.

Das Erstellen einer Seite ist so einfach wie das Erstellen eines Controllers und das Erstellen einer Route, um dem Controller eine URL zuzuordnen.

Hinweis: Obwohl Front-End-Controller und Controller namentlich ähnlich sind, unterscheiden sie sich tatsächlich.
Ein Front-End-Controller ist eine im Webverzeichnis gespeicherte PHP-Datei, über die alle Anfragen umgeleitet werden. Jede Anwendung verfügt über einen Produktions-Front-End-Controller app.php und einen Entwicklungs-Front-End-Controller app_dev.php. Sie müssen sie nicht bearbeiten, anzeigen oder sich darum kümmern.

Sehen Sie sich einen einfachen Controller an: Jeder von PHP aufrufbare Inhalt (z. B. eine Funktion, Objektmethode oder ein Abschluss) kann zu einem Controller werden. In Symfongy2 ist ein Controller normalerweise eine einzelne Methode im Controller-Objekt. Controller werden oft auch als Aktionen bezeichnet.

// src/Acme/HelloBundle/Controller/HelloController.php
namespace Acme\HelloBundle\Controller;
use Symfony\Component\HttpFoundation\Response;
class HelloController
{
 public function indexAction($name)
 {
  return new Response(&#39;<html><body>Hello &#39;.$name.&#39;!</body></html>&#39;);
 }
}

Beachten Sie, dass in diesem Beispiel der Controller die indexAction-Methode ist, die in der Controller-Klasse (HelloController) vorhanden ist. Lassen Sie sich nicht verwirren, der Grund, warum eine Controller-Klasse (HelloController) definiert wird, besteht lediglich darin, die gemeinsame Organisation mehrerer Controller/Aktionen zu erleichtern. Im Allgemeinen verfügt eine Controller-Klasse über mehrere Controller/Aktionen.

Der Controller im obigen Beispiel ist recht einfach:

In der Namespace-Zeile verwendet Symfony2 die Namespace-Funktion von PHP5.3, um einen Namespace für die gesamte Controller-Klasse anzugeben. Das Schlüsselwort
use importiert die Response-Klasse, die unser Controller zurückgeben muss.

Controller-Klassennamen werden durch das Hinzufügen von Controller am Ende ihres Namens definiert, aber nur der vordere Teil ist ihr echter Name. Aus Gründen der Vereinheitlichung wird Controller am Ende hinzugefügt. Bei der Routing-Konfiguration wird nur der erste Teil berücksichtigt.

Jeder Methode in der Controller-Klasse, die für den realen Controller verwendet wird, wird ein einheitliches Suffix „Action“ hinzugefügt. Ebenso nehmen wir bei der Konfiguration des Routings nur den ersten Teil und ignorieren die Action. Ordnen Sie es einer URL zu.

Am Ende jeder Controller-Methode muss ein Response-Objekt erstellt und zurückgegeben werden.

Ordnet eine URL einer Controller-Methode zu:

Die Controller-Methode im obigen Beispiel gibt eine einfache HTML-Seite zurück. Wenn Sie in einem Browser auf diese Seite zugreifen möchten, müssen Sie eine Route dafür erstellen und sie einer URL mit einem bestimmten Muster zuordnen.

# app/config/routing.yml
hello:
 pattern:  /hello/{name}
 defaults:  { _controller: AcmeHelloBundle:Hello:index }

XML-Format:

<!-- app/config/routing.xml -->
<route id="hello" pattern="/hello/{name}">
 <default key="_controller">AcmeHelloBundle:Hello:index</default>
</route>

PHP-Codeformat:

// app/config/routing.php
$collection->add('hello', new Route('/hello/{name}', array(
 '_controller' => 'AcmeHelloBundle:Hello:index',
)));

Stellen Sie sich nun vor, dass die URL /hello/ryan HelloController zugeordnet wird:: indexAction( )-Controller und übergeben Sie ryan an die Variable $name.

Das Erstellen einer sogenannten Seite ist eigentlich das Erstellen einer Controller-Methode und einer zugehörigen Route.

Beachten Sie die Syntax, die wir verwenden, um auf die Controller-Methode zu verweisen: 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(&#39;<html><body>Hello &#39;.$name.&#39;!</body></html>&#39;);
 }
}

在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(&#39;notice&#39;) }}
 </p>
{% endif %}

PHP代码：

<?php if ($view[&#39;session&#39;]->hasFlash(&#39;notice&#39;)): ?>
 <p class="flash-notice">
  <?php echo $view[&#39;session&#39;]->getFlash(&#39;notice&#39;) ?>
 </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模板快捷变量的用法

详解Symfony在模板和行为中取得request参数的方法

详解symfony如何使用命令创建项目

Das obige ist der detaillierte Inhalt vonDetaillierte Erläuterung der Verwendung des Symfony2-Controllers. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!