Symfony2コントローラーの使い方を詳しく解説
この記事では、主に 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 サイトの他の関連記事を参照してください。
ホットAIツール
Undresser.AI Undress
リアルなヌード写真を作成する AI 搭載アプリ
AI Clothes Remover
写真から衣服を削除するオンライン AI ツール。
Undress AI Tool
脱衣画像を無料で
Clothoff.io
AI衣類リムーバー
Video Face Swap
完全無料の AI 顔交換ツールを使用して、あらゆるビデオの顔を簡単に交換できます。
人気の記事
ホットツール
メモ帳++7.3.1
使いやすく無料のコードエディター
SublimeText3 中国語版
中国語版、とても使いやすい
ゼンドスタジオ 13.0.1
強力な PHP 統合開発環境
ドリームウィーバー CS6
ビジュアル Web 開発ツール
SublimeText3 Mac版
神レベルのコード編集ソフト（SublimeText3）
ホットトピック
7681
15
1639
14
1393
52
1286
25
1229
29
Windows 11 で Xbox One コントローラーを適切に調整する方法
Sep 21, 2023 pm 09:09 PM
Windows がゲーム プラットフォームとして選ばれるようになったため、そのゲーム指向の機能を特定することがさらに重要になっています。その 1 つは、Windows 11 で Xbox One コントローラーを調整する機能です。組み込みの手動キャリブレーションを使用すると、ドリフト、ランダムな動き、またはパフォーマンスの問題を取り除き、X、Y、Z 軸を効果的に調整できます。利用可能なオプションが機能しない場合は、いつでもサードパーティの Xbox One コントローラー調整ツールを使用できます。確認してみましょう！ Windows 11 で Xbox コントローラーを調整するにはどうすればよいですか?続行する前に、コントローラーをコンピューターに接続し、Xbox One コントローラーのドライバーを更新していることを確認してください。この作業中に、利用可能なファームウェアのアップデートもインストールします。 1. 風を利用する
JSPコメントの使用法と分類を分析する
Feb 01, 2024 am 08:01 AM
JSP コメントの分類と使用状況の分析 JSP コメントは 2 つのタイプに分類されます。 単一行コメント: で終わる、単一行のコードのみコメントできます。複数行のコメント: /* で始まり */ で終わると、複数行のコードにコメントを付けることができます。単一行のコメントの例 複数行のコメントの例/**これは複数行のコメントです*コードの複数行にコメントできます*/JSP コメントの使用法 JSP コードを読みやすくするために JSP コメントを使用できます。
PHPでCodeIgniter4フレームワークを使用するにはどうすればよいですか?
May 31, 2023 pm 02:51 PM
PHP は非常に人気のあるプログラミング言語であり、CodeIgniter4 は一般的に使用される PHP フレームワークです。 Web アプリケーションを開発する場合、フレームワークを使用すると、開発プロセスのスピードアップ、コードの品質の向上、メンテナンス コストの削減が可能になり、非常に役立ちます。この記事ではCodeIgniter4フレームワークの使い方を紹介します。 CodeIgniter4 フレームワークのインストール CodeIgniter4 フレームワークは、公式 Web サイト (https://codeigniter.com/) からダウンロードできます。下
Laravelをゼロから学ぶ：コントローラーメソッド呼び出しの詳細説明
Mar 10, 2024 pm 05:03 PM
Laravelをゼロから学ぶ：コントローラーメソッド呼び出しの詳細解説 Laravelの開発において、コントローラーは非常に重要な概念です。コントローラーはモデルとビューの間のブリッジとして機能し、ルートからのリクエストを処理し、対応するデータを表示のためにビューに返す責任を負います。コントローラー内のメソッドはルートから呼び出すことができます。この記事では、コントローラー内のメソッドの記述方法と呼び出し方法を詳しく紹介し、具体的なコード例を示します。まず、コントローラーを作成する必要があります。 Artisan コマンド ライン ツールを使用して、
C言語でexit関数を正しく使用する方法
Feb 18, 2024 pm 03:40 PM
C 言語で exit 関数を使用する方法には、具体的なコード例が必要です。C 言語では、プログラムの実行をプログラムの初期段階で終了したり、特定の条件下でプログラムを終了したりする必要があることがよくあります。 C 言語には、この関数を実装するための exit() 関数が用意されています。この記事では、exit() 関数の使用法を紹介し、対応するコード例を示します。 exit() 関数は C 言語の標準ライブラリ関数であり、ヘッダー ファイルに含まれています。その機能はプログラムの実行を終了することであり、整数を取ることができます。
WPSdatedif関数の使い方
Feb 20, 2024 pm 10:27 PM
WPS は一般的に使用されるオフィス ソフトウェア スイートであり、WPS テーブル関数はデータ処理と計算に広く使用されています。 WPS テーブルには、2 つの日付間の時差を計算するために使用される、DATEDIF 関数という非常に便利な関数があります。 DATEDIF 関数は英語の DateDifference の略語で、構文は次のとおりです: DATEDIF(start_date,end_date,unit) ここで、start_date は開始日を表します。
Python関数入門：abs関数の使い方と例
Nov 03, 2023 pm 12:05 PM
Python 関数入門: abs 関数の使い方と例 1. abs 関数の使い方の概要 Python では、abs 関数は、指定された値の絶対値を計算するために使用される組み込み関数です。数値引数を受け入れ、その数値の絶対値を返すことができます。 abs 関数の基本構文は次のとおりです。 abs(x) ここで、x は絶対値を計算する数値パラメータであり、整数または浮動小数点数を指定できます。 2. abs 関数の例 以下に、いくつかの具体的な例を通して abs 関数の使用法を示します。 例 1: 計算
Python関数入門：isinstance関数の使い方と例
Nov 04, 2023 pm 03:15 PM
Python 関数の紹介: isinstance 関数の使用法と例 Python は、プログラミングをより便利かつ効率的にするための多くの組み込み関数を提供する強力なプログラミング言語です。非常に便利な組み込み関数の 1 つは isinstance() 関数です。この記事では、isinstance関数の使い方と例を紹介し、具体的なコード例を紹介します。 isinstance() 関数は、オブジェクトが指定されたクラスまたは型のインスタンスであるかどうかを判断するために使用されます。この関数の構文は次のとおりです
