@@ -5,13 +5,13 @@ Controller
5
5
==========
6
6
7
7
A controller is a PHP function you create that takes information from the
8
- HTTP request and constructs and returns an HTTP response (as a Symfony2
8
+ HTTP request and constructs and returns an HTTP response (as a Symfony
9
9
``Response `` object). The response could be an HTML page, an XML document,
10
10
a serialized JSON array, an image, a redirect, a 404 error or anything else
11
11
you can dream up. The controller contains whatever arbitrary logic *your
12
12
application * needs to render the content of a page.
13
13
14
- See how simple this is by looking at a Symfony2 controller in action.
14
+ See how simple this is by looking at a Symfony controller in action.
15
15
The following controller would render a page that simply prints ``Hello world! ``::
16
16
17
17
use Symfony\Component\HttpFoundation\Response;
@@ -50,7 +50,7 @@ common examples:
50
50
Requests, Controller, Response Lifecycle
51
51
----------------------------------------
52
52
53
- Every request handled by a Symfony2 project goes through the same simple lifecycle.
53
+ Every request handled by a Symfony project goes through the same simple lifecycle.
54
54
The framework takes care of the repetitive tasks and ultimately executes a
55
55
controller, which houses your custom application code:
56
56
@@ -87,7 +87,7 @@ A Simple Controller
87
87
-------------------
88
88
89
89
While a controller can be any PHP callable (a function, method on an object,
90
- or a ``Closure ``), in Symfony2 , a controller is usually a single method inside
90
+ or a ``Closure ``), in Symfony , a controller is usually a single method inside
91
91
a controller object. Controllers are also called *actions *.
92
92
93
93
.. code-block :: php
@@ -117,7 +117,7 @@ a controller object. Controllers are also called *actions*.
117
117
118
118
This controller is pretty straightforward:
119
119
120
- * *line 4 *: Symfony2 takes advantage of PHP 5.3 namespace functionality to
120
+ * *line 4 *: Symfony takes advantage of PHP 5.3 namespace functionality to
121
121
namespace the entire controller class. The ``use `` keyword imports the
122
122
``Response `` class, which the controller must return.
123
123
@@ -185,8 +185,8 @@ controller and passes in ``ryan`` for the ``$name`` variable. Creating a
185
185
"page" means simply creating a controller method and associated route.
186
186
187
187
Notice the syntax used to refer to the controller: ``AcmeHelloBundle:Hello:index ``.
188
- Symfony2 uses a flexible string notation to refer to different controllers.
189
- This is the most common syntax and tells Symfony2 to look for a controller
188
+ Symfony uses a flexible string notation to refer to different controllers.
189
+ This is the most common syntax and tells Symfony to look for a controller
190
190
class called ``HelloController `` inside a bundle named ``AcmeHelloBundle ``. The
191
191
method ``indexAction() `` is then executed.
192
192
@@ -232,7 +232,7 @@ passed to that method::
232
232
233
233
The controller has a single argument, ``$name ``, which corresponds to the
234
234
``{name} `` parameter from the matched route (``ryan `` in the example). In
235
- fact, when executing your controller, Symfony2 matches each argument of
235
+ fact, when executing your controller, Symfony matches each argument of
236
236
the controller with a parameter from the matched route. Take the following
237
237
example:
238
238
@@ -369,7 +369,7 @@ Use it! See :doc:`/cookbook/templating/render_without_controller`.
369
369
The Base Controller Class
370
370
-------------------------
371
371
372
- For convenience, Symfony2 comes with a base ``Controller `` class that assists
372
+ For convenience, Symfony comes with a base ``Controller `` class that assists
373
373
with some of the most common controller tasks and gives your controller class
374
374
access to any resource it might need. By extending this ``Controller `` class,
375
375
you can take advantage of several helper methods.
@@ -393,7 +393,7 @@ Add the ``use`` statement atop the ``Controller`` class and then modify the
393
393
394
394
This doesn't actually change anything about how your controller works. In
395
395
the next section, you'll learn about the helper methods that the base controller
396
- class makes available. These methods are just shortcuts to using core Symfony2
396
+ class makes available. These methods are just shortcuts to using core Symfony
397
397
functionality that's available to you with or without the use of the base
398
398
``Controller `` class. A great way to see the core functionality in action
399
399
is to look in the
@@ -427,7 +427,7 @@ Common Controller Tasks
427
427
Though a controller can do virtually anything, most controllers will perform
428
428
the same basic tasks over and over again. These tasks, such as redirecting,
429
429
forwarding, rendering templates and accessing core services, are very easy
430
- to manage in Symfony2 .
430
+ to manage in Symfony .
431
431
432
432
.. index ::
433
433
single: Controller; Redirecting
@@ -501,15 +501,15 @@ look something like the following::
501
501
}
502
502
503
503
And just like when creating a controller for a route, the order of the arguments
504
- to ``fancyAction `` doesn't matter. Symfony2 matches the index key names
504
+ to ``fancyAction `` doesn't matter. Symfony matches the index key names
505
505
(e.g. ``name ``) with the method argument names (e.g. ``$name ``). If you
506
- change the order of the arguments, Symfony2 will still pass the correct
506
+ change the order of the arguments, Symfony will still pass the correct
507
507
value to each variable.
508
508
509
509
.. tip ::
510
510
511
511
Like other base ``Controller `` methods, the ``forward `` method is just
512
- a shortcut for core Symfony2 functionality. A forward can be accomplished
512
+ a shortcut for core Symfony functionality. A forward can be accomplished
513
513
directly by duplicating the current request. When this
514
514
:ref: `sub request <http-kernel-sub-requests >` is executed via the ``http_kernel ``
515
515
service the ``HttpKernel `` returns a ``Response `` object::
@@ -603,7 +603,7 @@ The Symfony templating engine is explained in great detail in the
603
603
Accessing other Services
604
604
~~~~~~~~~~~~~~~~~~~~~~~~
605
605
606
- When extending the base controller class, you can access any Symfony2 service
606
+ When extending the base controller class, you can access any Symfony service
607
607
via the ``get() `` method. Here are several common services you might need::
608
608
609
609
$templating = $this->get('templating');
@@ -648,7 +648,7 @@ The ``createNotFoundException()`` method creates a special ``NotFoundHttpExcepti
648
648
object, which ultimately triggers a 404 HTTP response inside Symfony.
649
649
650
650
Of course, you're free to throw any ``Exception `` class in your controller -
651
- Symfony2 will automatically return a 500 HTTP response code.
651
+ Symfony will automatically return a 500 HTTP response code.
652
652
653
653
.. code-block :: php
654
654
@@ -666,9 +666,9 @@ Both of these error pages can be customized. For details, read the
666
666
Managing the Session
667
667
--------------------
668
668
669
- Symfony2 provides a nice session object that you can use to store information
669
+ Symfony provides a nice session object that you can use to store information
670
670
about the user (be it a real person using a browser, a bot, or a web service)
671
- between requests. By default, Symfony2 stores the attributes in a cookie
671
+ between requests. By default, Symfony stores the attributes in a cookie
672
672
by using the native PHP sessions.
673
673
674
674
Storing and retrieving information from the session can be easily achieved
0 commit comments