pengawal
Pengawal ialah fungsi php yang anda buat, yang boleh mendapatkan maklumat permintaan http dan membina serta mengembalikan respons http (sebagai objek Respons Symfony mungkin halaman html, dokumen xml, tatasusunan json bersiri, Imej, ubah hala). , 404 ralat atau apa-apa lagi yang anda boleh bayangkan. Pengawal mengandungi sebarang logik yang diperlukan oleh aplikasi anda untuk memaparkan halaman.
Sila lihat pengawal ringkas symfony. Pengawal berikut akan mengeluarkan hello word: hello word：
use Symfony\Component\HttpFoundation\Response; public function helloAction(){
return new Response('Hello world!');}控制器的目标都是相同的：创建并返回一个Response对象。在这个过程中，它可能会从请求中读取信息，加载数据库资源，发送邮件，在用户session中设置信息。但是所有情况下，控制器将最终返回 Response 对象给客户端。
没有什么神奇的不用担心还有别的要求！下面是一些常见的例子：
控制器A准备了一个首页上的
Response对象。-控制器B从请求中读取
{slug}参数，从数据库中载入一条博文，并创建一个显示该博文的Response对象。如果{slug}不能被数据库中检索到，那么控制器将创建并返回一个带404状态码的Response对象。控制器C处理关于联系人的表单提交。它从请求中读取表单信息，将联系人信息存入数据库并发送包含联系人信息的电子邮件给网站管理员。最后，它创建一个
Response对象将用户的浏览器重定向到联系人表单的“感谢”页面。
请求、控制器、响应的生命周期 ¶
symfony处理的每一个请求都会有相同的生命周期。框架会负责把很多重复的任务用一个控制器最终执行，控制器执行你自定义的应用代码：
每个请求都被单个前端控制器（如
app.php生产环境 或app_dev.php开发环境）文件处理，前端控制器负责引导框架；前端控制器的唯一工作是去初始化Symfony引擎（调用
Kernel）并传入一个Request// src/AppBundle/Controller/HelloController.phpnamespace AppBundle\Controller; use Symfony\Component\HttpFoundation\Response; class HelloController{ public function indexAction($name) { return new Response('<html><body>Hello '.$name.'!</body></html>'); }}Matlamat pengawal adalah sama: untuk mencipta dan mengembalikan objekRespons. Semasa proses ini, ia mungkin membaca maklumat daripada permintaan, memuatkan sumber pangkalan data, menghantar e-mel dan menetapkan maklumat dalam sesi pengguna. Tetapi dalam semua kes, pengawal akhirnya akan mengembalikan objekResponskepada klien.- Tiada apa-apa yang ajaib, jangan risau tentang sebarang keperluan lain! Berikut ialah beberapa contoh biasa:
- Pengawal B membaca parameter
- Pengawal C mengendalikan penyerahan borang berkenaan kenalan. Ia membaca maklumat borang daripada permintaan, menyimpan maklumat hubungan dalam pangkalan data dan menghantar e-mel yang mengandungi maklumat hubungan kepada pentadbir laman web. Akhir sekali, ia mencipta objek
Kitaran hayat permintaan, pengawal dan respons ¶
Pengendalian Symfony Setiap permintaan akan mempunyai kitaran hayat yang sama. Rangka kerja akan bertanggungjawab untuk menggabungkan banyak tugas berulang ke dalam pengawal yang melaksanakan kod aplikasi tersuai anda:第2行：Symfony利用php命名空间函数去命名整个控制器类
第4行：Symfony充分利用了PHP5.3的名称空间的功能：
use关键字导入Response类，是我们控制器必须返回的；第6行：类名是一个串联的控制器类名称（例如
hello）加上Controller关键字。这是一个约定,为控制器提供一致性,并允许它们引用控制器名称(例如hello)作为路由配置。第8行：在控制器类中的每个action都有着后缀
Action，并且这个action名（index）被引用到路由配置文件中。在下一节中，我们将使用路由映射一个URI到该action，并展示如何将路由占位符（{name}）变成action的参数（$name）；第10行：控制器创建并返回一个
Response- 🎜Baris 2: Symfony menggunakan fungsi ruang nama php untuk menamakan keseluruhan kelas pengawal🎜🎜
- 🎜Baris 4: Symfony menggunakan sepenuhnya The fungsi ruang nama PHP5.3 ditambah: kata kunci
usemengimport kelasResponse, yang mesti dikembalikan oleh pengawal kami 🎜🎜 - 🎜Baris 6: Nama Kelas ialah gabungan nama kelas pengawal (seperti
hello) serta kata kunciController. Ini ialah konvensyen yang memberikan ketekalan kepada pengawal dan membenarkan mereka merujuk nama pengawal (cth.hello) sebagai konfigurasi laluan. 🎜🎜 - 🎜Baris 8: Setiap tindakan dalam kelas pengawal mempunyai akhiran
Actiondan nama tindakan (index) dirujuk kepada konfigurasi penghalaan dalam fail . Dalam bahagian seterusnya, kami akan menggunakan penghalaan untuk memetakan URI kepada tindakan dan menunjukkan cara menukar ruang letak laluan ({name}) kepada parameter tindakan ($name>);🎜🎜 - 🎜Baris 10: Pengawal mencipta dan mengembalikan objek
Respons. 🎜🎜🎜🎜Memetakan URI kepada Pengawal 🎜¶🎜🎜🎜 Pengawal baharu kami mengembalikan halaman HTML yang ringkas. Untuk dapat memberikan pengawal ini pada URI tertentu, kita perlu mencipta laluan untuknya. Kami akan membincangkan butiran komponen penghalaan dalam bab penghalaan, tetapi buat masa ini mari buat laluan mudah untuk pengawal kami: 🎜🎜XML:<!-- app/config/routing.xml --><?xml version="1.0" encoding="UTF-8" ?><routes xmlns="http://symfony.com/schema/routing" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd"> <route id="hello" path="/hello/{name}"> <!-- uses a special syntax to point to the controller - see note below --> <default key="_controller">AppBundle:Hello:index</default> </route></routes>🎜PHP:// app/config/routing.phpuse Symfony\Component\Routing\Route;use Symfony\Component\Routing\RouteCollection; $collection = new RouteCollection();$collection->add('hello', new Route('/hello/{name}', array( // uses a special syntax to point to the controller - see note below '_controller' => 'AppBundle:Hello:index',))); return $collection;// src/AppBundle/Controller/HelloController.php// ...use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; /** * @Route("/hello/{name}", name="hello") */public function indexAction($name){ // ...}Annotations:// src/AppBundle/Controller/HelloController.php// ... use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; class HelloController{ /** * @Route("/hello/{firstName}/{lastName}", name="hello") */ public function indexAction($firstName, $lastName) { // ... }}Sekarang, anda datang ke
/hello/ryan(contohnya, jika anda menggunakan perkhidmatan web terbina dalamhttp://localhost:8000/hello/ryan) , kemudian PengawalHelloController::indexAction()akan dilaksanakan danryanakan diberikan kepada pembolehubah$name. Mencipta halaman sedemikian membolehkan perkaitan mudah antara penghalaan dan pengawal./hello/ryan（例如，如果你使用内置的web服务http://localhost:8000/hello/ryan），那么它就会执行HelloController::indexAction()控制器，并且将ryan赋给$name变量。创建这样一个页面就能够让路由跟控制器做简单的关联。简单吧？
把路由参数传入控制器 ¶
我们现在已经知道路由指向AppBundle中的
HelloController::indexAction()方法。还有更有趣的就是控制器方法的参数传递:YAML:# app/config/routing.ymlhello: path: /hello/{firstName}/{lastName} defaults: { _controller: AppBundle:Hello:index }控制器有个参数
$name，对应所匹配路由的{name}参数（如果你访问/hello/ryan， 在本例中是ryan）。实际上当执行你的控制器时，Symfony在所匹配路由中匹配带参数控制器中的每个参数。所以这个{name}值被传入到$name。只需要确保占位符的名称和参数名称一样就行。以下是更有趣的例子，这里的控制器有两个参数：
XML:<!-- app/config/routing.xml --><?xml version="1.0" encoding="UTF-8" ?><routes xmlns="http://symfony.com/schema/routing" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd"> <route id="hello" path="/hello/{firstName}/{lastName}"> <default key="_controller">AppBundle:Hello:index</default> </route></routes>PHP:// app/config/routing.phpuse Symfony\Component\Routing\Route;use Symfony\Component\Routing\RouteCollection; $collection = new RouteCollection();$collection->add('hello', new Route('/hello/{firstName}/{lastName}', array( '_controller' => 'AppBundle:Hello:index',))); return $collection;public function indexAction($lastName, $firstName){ // ...}public function indexAction($firstName, $lastName, $foo){ // ...}将路由参数映射到控制器参数是十分容易和灵活的。在你开发时请遵循以下思路：
1. 控制器参数的顺序无关紧要Symfony可以根据路由参数名匹配控制器方法参数。换句话说，它可以实现
last_name参数与$last_name参数的匹配。控制器可以在随意排列参数的情况下正常工作。public function indexAction($firstName, $lastName, $foo = 'bar'){ // ...}2.控制器所需参数必须匹配路由参数
下面会抛出一个运行时异常（
RuntimeException），因为在路由定义中没有foo参数：public function indexAction($firstName){ // ...}如果参数是可选的，那该多好。下面的例子不会抛出异常：
// src/AppBundle/Controller/HelloController.phpnamespace AppBundle\Controller; use Symfony\Bundle\FrameworkBundle\Controller\Controller; class HelloController extends Controller{ // ...}3.不是所有的路由参数都需要在控制器上有响应参数的
如果，举个例子，
Mudah kan?last_nameAppBundle:Hello:index controller syntax
Jika Sama ada anda menggunakan format YAML atau XML, anda menggunakan sintaks pintasan khusus untuk pengawal anda yang dipanggil nama pengawal logik, sepertiAppBundle:Hello:index. Untuk mendapatkan maklumat lanjut tentang format pengawal, baca Corak Penamaan Pengawal dalam bab Penghala.Lepaskan parameter laluan ke dalam pengawal ¶
Kami kini tahu bahawa laluan itu menghala ke kaedahHelloController::indexAction()dalam AppBundle. Apa yang lebih menarik ialah lulus parameter kaedah pengawal:public function indexAction(){ return $this->redirectToRoute('homepage'); // redirectToRoute is equivalent to using redirect() and generateUrl() together: // return $this->redirect($this->generateUrl('homepage'));}🎜Pengawal mempunyai parameter$name, yang sepadan dengan parameter{name}bagi laluan yang dipadankan ( jika anda Lawati/hello/ryan, dalam kes iniryan). Malah, apabila pengawal anda dilaksanakan, Symfony memadankan setiap parameter dalam pengawal berparameter dalam laluan yang dipadankan. Jadi nilai{name}ini dihantar ke$name. Cuma pastikan nama pemegang tempat adalah sama dengan nama parameter. 🎜🎜🎜 Berikut adalah contoh yang lebih menarik, di sini pengawal mempunyai dua parameter: 🎜public function indexAction(){ return $this->redirectToRoute('homepage', array(), 301);}public function indexAction(){ return $this->redirect('http://symfony.com/doc');}use Symfony\Component\HttpFoundation\RedirectResponse; public function indexAction() { return new RedirectResponse($this->generateUrl('homepage')); }// renders app/Resources/views/hello/index.html.twig return $this->render('hello/index.html.twig', array('name' => $name));🎜Memetakan parameter penghalaan ke parameter pengawal adalah sangat mudah dan fleksibel. Sila ikut idea berikut apabila anda membangunkan: 🎜🎜1 Susunan parameter pengawal tidak penting🎜Symfony boleh memadankan parameter kaedah pengawal berdasarkan nama parameter laluan. Dalam erti kata lain, ia boleh memadankan parameterlast_namedengan parameter$last_name. Pengawal boleh berfungsi secara normal dengan sebarang susunan parameter. 🎜// renders app/Resources/views/hello/greetings/index.html.twigreturn $this->render('hello/greetings/index.html.twig', array( 'name' => $name));🎜2. Parameter yang diperlukan oleh pengawal mesti sepadan dengan parameter laluan🎜🎜🎜Pengecualian masa jalan (RuntimeException) akan dilemparkan di bawah kerana tiada < kod> foo Parameter: 🎜 $templating = $this->get('templating'); $router = $this->get('router'); $mailer = $this->get('mailer');🎜 Alangkah baiknya jika parameter tersebut adalah pilihan. Contoh berikut tidak akan mengeluarkan pengecualian: 🎜🎜$ php bin/console debug:container
🎜3 Tidak semua parameter laluan perlu mempunyai parameter respons pada pengawal🎜🎜🎜Jika, sebagai contoh,nama_akhir . Jika ia tidak begitu penting kepada pengawal anda, anda boleh mengabaikannya sepenuhnya: 🎜 public function indexAction(){ // retrieve the object from database $product = ...; if (!$product) { throw $this->createNotFoundException('The product does not exist'); } return $this->render(...);}🎜🎜🎜🎜🎜Anda juga boleh menghantar parameter lain daripada penghala anda kepada parameter pengawal anda. Lihat cara menghantar maklumat tambahan dari laluan ke pengawal 🎜🎜Kelas asas pengawal ¶
Untuk kemudahan, Symfony menyediakan kelas asas
Controlerpilihan. Jika anda mewarisi daripadanya, ia tidak mengubah apa-apa tentang cara pengawal anda berfungsi dan anda boleh mewarisi beberapa kaedah pembantu dan bekas perkhidmatan dengan mudah (lihat Mengakses Bekas Lain, di bawah): membenarkan anda mengakses segala-galanya dalam sistem Objek berguna, serupa kepada objek tatasusunan. Objek berguna ini dipanggil perkhidmatan, dan symfony disertakan dengan objek perkhidmatan ini, yang boleh membuat templat, merekod maklumat log, dsb.Controller基类。如果你继承它，它不会改变你控制器的任何工作原理，而且你还能够很容易的继承一些帮助方法和服务容器（可看，下面的访问其他容器）：允许你在系统中访问每一个有用的对象，类似一个数组对象一样。这些有用的对象被称为服务，并且symfony附带这些服务对象，可以渲染模板，还可以记录日志信息等。在顶部使用use语句添加
Controller类，然后修改HelloController去继承它。如下所示：throw new \Exception('Something went wrong!');而无论你是否使用
Controller基类，这些帮助方法只是让你可以方便地使用Symfony的核心功能。其实查看核心功能的最好方式就是看Controller类本身。生成URL ¶
generateUrl()能够生成一个URL给路由器的辅助方法。重定向 ¶
如果你想将用户重定向到另一个页面,请使用
redirectToRoute()方法：use Symfony\Component\HttpFoundation\Request; public function indexAction($firstName, $lastName, Request $request){ $page = $request->query->get('page', 1); // ...}默认情况下，
redirectToRoute()方法执行302（临时）重定向。如果要执行301（永久）重定向，请修改第2个参数：use Symfony\Component\HttpFoundation\Request; public function indexAction(Request $request){ $session = $request->getSession(); // store an attribute for reuse during a later user request $session->set('foo', 'bar'); // get the attribute set by another controller in another request $foobar = $session->get('foobar'); // use a default value if the attribute doesn't exist $filters = $session->get('filters', array());}从定向到外部网站，使用
redirect()并传入外部URL：use Symfony\Component\HttpFoundation\Request; public function updateAction(Request $request){ $form = $this->createForm(...); $form->handleRequest($request); if ($form->isValid()) { // do some sort of processing $this->addFlash( 'notice', 'Your changes were saved!' ); // $this->addFlash is equivalent to $this->get('session')->getFlashBag()->add return $this->redirectToRoute(...); } return $this->render(...);}更多细节，请参考框架起步之路由。
Tidak kira sama ada anda menggunakan kelas asas比创建一个专门从事重定向用户的
Gunakan pernyataan penggunaan di bahagian atas untuk menambah kelasResponse对象来说redirectToRoute()Controllerdan kemudian mengubah suaiHelloControlleruntuk mewarisinya. Seperti yang ditunjukkan di bawah:XML:{% for flash_message in app.session.flashBag.get('notice') %} <div class="flash-notice"> {{ flash_message }} </div>{% endfor %}Controller, kaedah pembantu ini hanya membenarkan anda menggunakan fungsi teras Symfony dengan mudah. Malah, cara terbaik untuk melihat fungsi teras adalah dengan melihat kelasPengawalitu sendiri. 🎜🎜🎜Jika anda ingin mengetahui cara pengawal berfungsi tanpa mewarisi kelas asas pengawal, anda boleh menyemak cara untuk balut pengawal Ditakrifkan sebagai perkhidmatan. Ini adalah pilihan, tetapi ia memberi anda kawalan yang tepat ke atas lebih banyak "objek/bergantungan" yang boleh disuntik ke dalam pengawal anda. 🎜🎜🎜Jana URL ¶
🎜generateUrl()Kaedah tambahan yang boleh menjana URL ke penghala. 🎜Ubah hala ¶
🎜Jika anda ingin mengubah hala pengguna ke halaman lain, sila gunakan < code> kaedah redirectToRoute(): 🎜PHP:<?php foreach ($view['session']->getFlash('notice') as $message): ?> <div class="flash-notice"> <?php echo "<div class='flash-error'>$message</div>" ?> </div><?php endforeach ?>🎜Secara lalai, kaedahredirectToRoute()melakukan ubah hala 302 (sementara). Jika anda ingin melakukan ubah hala 301 (kekal), ubah suai parameter ke-2: 🎜🎜use Symfony\Component\HttpFoundation\Request; public function indexAction(Request $request){ $request->isXmlHttpRequest(); // is it an Ajax request? $request->getPreferredLanguage(array('en', 'fr')); // retrieve GET and POST variables respectively $request->query->get('page'); $request->request->get('page'); // retrieve SERVER variables $request->server->get('HTTP_HOST'); // retrieves an instance of UploadedFile identified by foo $request->files->get('foo'); // retrieve a COOKIE value $request->cookies->get('PHPSESSID'); // retrieve an HTTP request header, with normalized, lowercase keys $request->headers->get('host'); $request->headers->get('content_type');}🎜Dari menghala ke tapak web luaran, gunakanredirect()dan masukkan URL luaran: 🎜use Symfony\Component\HttpFoundation\Response; // create a simple Response with a 200 status code (the default)$response = new Response('Hello '.$name, Response::HTTP_OK); // create a CSS-response with a 200 status code $response = new Response('<style> ... </style>'); $response->headers->set('Content-Type', 'text/css');🎜Lagi butiran , sila rujuk penghalaan untuk memulakan rangka kerja. 🎜🎜🎜 Daripada mencipta objekResponsyang pakar dalam mengubah hala penggunaredirectToRoute ()kaedah ialah pintasan mudah, yang bersamaan dengan: 🎜// ...public function indexAction(){ // returns '{"username":"jane.doe"}' and sets the proper Content-Type header return $this->json(array('username' => 'jane.doe')); // the shortcut defines three optional arguments // return $this->json($data, $status = 200, $headers = array(), $context = array());}🎜🎜Templat Rendering ¶
Jika anda menggunakan HTML, anda sepatutnya mahu membuat templat. Kaedah
rrreeerender()boleh digunakan untuk memaparkan templat dan meletakkan kandungan output ke dalam objekResponsanda:render()方法可以用来渲染模板并可以把输出的内容放到你的Response对象：模板也可以防止在更深层次的子目录。但应该避免创建不必要的深层结构：
rrreee模板可以在任何格式的文件中以一种通用的方式去渲染内容。虽然在大多数情况下，你使用模板来渲染HTML内容，模板也可以很容易地生成JavaScript，CSS，XML或者你能想到的任何其他格式。要了解如何使不同的模板格式，参考创建并使用模板中的“模板格式”。
rrreeeTemplat boleh menghasilkan kandungan secara universal dalam sebarang format fail. Walaupun dalam kebanyakan kes anda menggunakan templat untuk memaparkan kandungan HTML, templat juga boleh menjana JavaScript, CSS, XML atau sebarang format lain yang boleh anda fikirkan dengan mudah. Untuk mengetahui cara memformat templat yang berbeza, lihat "Pemformatan Templat" dalam Mencipta dan Menggunakan Templat.
🎜Laman web PHP Cina
Respons pada halaman utama. -{slug} daripada permintaan, memuatkan catatan blog daripada pangkalan data dan mencipta objek Respons yang memaparkan catatan blog. Jika {slug} tidak boleh diambil daripada pangkalan data, pengawal akan mencipta dan mengembalikan objek Respons dengan kod status 404. Respons yang mengubah hala penyemak imbas pengguna ke halaman "Terima kasih" borang kenalan. Setiap permintaan dikendalikan oleh pengawal bahagian hadapan tunggal (seperti app.php persekitaran pengeluaran atau persekitaran pembangunan app_dev.php) pemprosesan fail, pengawal bahagian hadapan bertanggungjawab untuk but rangka kerja
Kernel) dan masukkan objek Request untuk membenarkannya diproses. 🎜🎜🎜🎜Symfony Core meminta penghala untuk memeriksa permintaan ini; Kod dalam pengendali akan mencipta dan mengembalikan objek Respons; pengepala 🎜🎜🎜🎜HTTP dan kandungan objek Respons akan dihantar semula kepada klien. 🎜🎜🎜🎜Mencipta pengawal semudah membuat halaman, sambil memetakan URI ke pengawal. 🎜🎜🎜🎜Walaupun namanya serupa, pengawal bahagian hadapan adalah berbeza daripada pengawal yang kita bincangkan dalam bab ini Pengawal bahagian hadapan ialah fail PHP kecil dalam direktori web/ anda. dan semua permintaan semua melaluinya terus. Aplikasi biasa akan mempunyai pengawal bahagian hadapan untuk pengeluaran (seperti app.php) dan pengawal bahagian hadapan untuk pembangunan (seperti app_dev.php) . Anda tidak perlu mengedit, melihat atau bimbang tentang pengawal hadapan. "Kelas pengawal" dalam bab ini menggunakan kaedah yang mudah untuk menyusun "pengawal" individu, juga dipanggil tindakan, ke dalam satu kelas (cth., updateAction(), deleteAction () , dsb.). Oleh itu, pengawal adalah kaedah dalam kelas pengawal. Mereka akan memegang kod yang anda buat dan mengembalikan objek respons Response. web/目录中的一个PHP小文件，所有的请求都直接经过它。一个典型的应用程序将有一个用于生产的前端控制器（如app.php）和一个用于开发的前端控制器（如app_dev.php）。你可以永远不需要去对前端控制器编辑、查看或者有所担心。本章的“控制器类”用一种方便的方法组织各自的“controllers”，也被称为actions，它们都在一个类里（如，updateAction(), deleteAction(), 等）。所以，在控制器类里一个控制器就是一个方法。它们会持有你创建的代码，并返回Response响应对象。
一个简单的控制器 ¶
虽然一个控制器可以是任何的可被调用的PHP（函数、对象的方法或Closure），在Symfony，控制器通常是在控制器类中的一个方法，控制器也常被称为action：
Annotations:// src/AppBundle/Controller/HelloController.phpnamespace AppBundle\Controller; use Symfony\Component\HttpFoundation\Response;use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; class HelloController{
/**
* @Route("/hello/{name}", name="hello")
*/
public function indexAction($name)
{
return new Response('<html><body>Hello '.$name.'!</body></html>');
}}这里面的控制器是indexAction方法，它隶属于一个控制器类HelloController。
这个控制器非常的简单：
Walaupun pengawal boleh berupa PHP yang boleh dipanggil (fungsi, Kaedah objek atau Penutupan), dalam Symfony, pengawal biasanya merupakan kaedah dalam kelas pengawal, pengawal juga sering dipanggil tindakan:
YAML:# app/config/routing.ymlhello:
path: /hello/{name}
# uses a special syntax to point to the controller - see note below
defaults: { _controller: AppBundle:Hello:index }.Pengawal di sini ialah indexAction Kaedah, yang dimiliki oleh kelas pengawal < kod>HelloController.
