8000 Merge branch '2.3' into 2.4 · symfony/symfony-docs@15b813f · GitHub
[go: up one dir, main page]
Skip to content

Commit 15b813f

Browse files
weaverryanweaverryan
committed
Merge branch '2.3' into 2.4
2 parents 3570711 + 41b2eb8 commit 15b813f

File tree

8 files changed

+117
-60
lines changed

8 files changed

+117
-60
lines changed

‎book/installation.rst

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -269,6 +269,15 @@ If there are any issues, correct them now before moving on.
269269

270270
Note that using the ACL is recommended when you have access to them
271271
on your server because changing the umask is not thread-safe.
272+
273+
**4. Use the same user for the CLI and the web server**
274+
275+
In development environments, it is a common practice to use the same unix
276+
user for the CLI and the web server because it avoids any of these permissions
277+
issues when setting up new projects. This can be done by editing your web server
278+
configuration (e.g. commonly httpd.conf or apache2.conf for Apache) and setting
279+
its user to be the same as your CLI user (e.g. for Apache, update the User
280+
and Group values).
272281

273282
When everything is fine, click on "Go to the Welcome page" to request your
274283
first "real" Symfony2 webpage:

‎book/routing.rst

Lines changed: 23 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1282,29 +1282,6 @@ In an upcoming section, you'll learn how to generate URLs from inside templates.
12821282
12831283
For more information, see the documentation for that bundle.
12841284

1285-
.. index::
1286-
single: Routing; Absolute URLs
1287-
1288-
Generating Absolute URLs
1289-
~~~~~~~~~~~~~~~~~~~~~~~~
1290-
1291-
By default, the router will generate relative URLs (e.g. ``/blog``). To generate
1292-
an absolute URL, simply pass ``true`` to the third argument of the ``generate()``
1293-
method::
1294-
1295-
$this->get('router')->generate('blog_show', array('slug' => 'my-blog-post'), true);
1296-
// http://www.example.com/blog/my-blog-post
1297-
1298-
.. note::
1299-
1300-
The host that's used when generating an absolute URL is the host of
1301-
the current ``Request`` object. This is detected automatically based
1302-
on server information supplied by PHP. When generating absolute URLs for
1303-
scripts run from the command line, you'll need to manually set the desired
1304-
host on the ``RequestContext`` object::
1305-
1306-
$this->get('router')->getContext()->setHost('www.example.com');
1307-
13081285
.. index::
13091286
single: Routing; Generating URLs in a template
13101287

@@ -1317,7 +1294,7 @@ But if you pass extra ones, they will be added to the URI as a query string::
13171294
$this->get('router')->generate('blog', array('page' => 2, 'category' => 'Symfony'));
13181295
// /blog/2?category=Symfony
13191296

1320-
Generating URLs from a template
1297+
Generating URLs from a Template
13211298
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
13221299

13231300
The most common place to generate a URL is from within a template when linking
@@ -1340,7 +1317,20 @@ a template helper function:
13401317
Read this blog post.
13411318
</a>
13421319

1343-
Absolute URLs can also be generated.
1320+
.. index::
1321+
single: Routing; Absolute URLs
1322+
1323+
Generating Absolute URLs
1324+
~~~~~~~~~~~~~~~~~~~~~~~~
1325+
1326+
By default, the router will generate relative URLs (e.g. ``/blog``). From
1327+
a controller, simply pass ``true`` to the third argument of the ``generateUrl()``
1328+
method::
1329+
1330+
$this->generateUrl('blog_show', array('slug' => 'my-blog-post'), true);
1331+
// http://www.example.com/blog/my-blog-post
1332+
1333+
From a template, it looks like this:
13441334

13451335
.. configuration-block::
13461336

@@ -1358,6 +1348,14 @@ Absolute URLs can also be generated.
13581348
Read this blog post.
13591349
</a>
13601350

1351+
.. note::
1352+
1353+
The host that's used when generating an absolute URL is the host of
1354+
the current ``Request`` object. This is detected automatically. But if
1355+
you generate absolute URLs for scripts run from the command line, this
1356+
won't work. But don't worry! Just see :doc:`/cookbook/console/sending_emails`
1357+
for details.
1358+
13611359
Summary
13621360
-------
13631361

‎cookbook/bundles/extension.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ The second method has several specific advantages:
9292
.. seealso::
9393

9494
For parameter handling within a Dependency Injection class see
95-
:doc:`</cookbook/configuration/using_parameters_in_dic>`.
95+
:doc:`/cookbook/configuration/using_parameters_in_dic`.
9696

9797
.. index::
9898
single: Bundle; Extension

‎cookbook/routing/service_container_parameters.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -128,4 +128,4 @@ path):
128128
.. seealso::
129129

130130
For parameter handling within a Dependency Injection class see
131-
:doc:`</cookbook/configuration/using_parameters_in_dic>`.
131+
:doc:`/cookbook/configuration/using_parameters_in_dic`.

‎reference/forms/types/button.rst

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -12,20 +12,24 @@ A simple, non-responsive button.
1212
+----------------------+----------------------------------------------------------------------+
1313
| Rendered as | ``button`` tag |
1414
+----------------------+----------------------------------------------------------------------+
15-
| Options | - `attr`_ |
16-
| | - `disabled`_ |
15+
| Inherited | - `attr`_ |
16+
| options | - `disabled`_ |
1717
| | - `label`_ |
1818
| | - `translation_domain`_ |
1919
+----------------------+----------------------------------------------------------------------+
20-
| Overridden options | - `auto_initialize`_ |
21-
+----------------------+----------------------------------------------------------------------+
2220
| Parent type | none |
2321
+----------------------+----------------------------------------------------------------------+
2422
| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ButtonType` |
2523
+----------------------+----------------------------------------------------------------------+
2624

27-
Options
28-
-------
25+
Inherited options
26+
-----------------
27+
28+
The following options are defined in the
29+
:class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\BaseType` class.
30+
The ``BaseType`` class is the parent class for both the ``button`` type and
31+
the :doc:`form type </reference/forms/types/form>`, but it is not part of
32+
the form type tree (i.e. it can not be used as a form type on its own).
2933

3034
.. include:: /reference/forms/types/options/button_attr.rst.inc
3135

@@ -34,8 +38,3 @@ Options
3438
.. include:: /reference/forms/types/options/button_label.rst.inc
3539

3640
.. include:: /reference/forms/types/options/button_translation_domain.rst.inc
37-
38-
Overridden Options
39-
------------------
40-
41-
.. include:: /reference/forms/types/options/button_auto_initialize.rst.inc

‎reference/forms/types/form.rst

Lines changed: 65 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,47 @@
44
form Field Type
55
===============
66

7-
See :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`.
8-
97
The ``form`` type predefines a couple of options that are then available
10-
on all fields.
8+
on all types for which ``form`` is the parent type.
9+
10+
+-----------+--------------------------------------------------------------------+
11+
| Options | - `compound`_ |
12+
| | - `data`_ |
13+
| | - `data_class`_ |
14+
| | - ` 7802 empty_data`_ |
15+
| | - `required`_ |
16+
| | - `label_attr`_ |
17+
| | - `constraints`_ |
18+
| | - `cascade_validation`_ |
19+
| | - `read_only`_ |
20+
| | - `trim`_ |
21+
| | - `mapped`_ |
22+
| | - `property_path`_ |
23+
| | - `max_length`_ |
24+
| | - `by_reference`_ |
25+
| | - `error_bubbling`_ |
26+
| | - `inherit_data`_ |
27+
| | - `error_mapping`_ |
28+
| | - `invalid_message`_ |
29+
| | - `invalid_message_parameters`_ |
30+
| | - `extra_fields_message`_ |
31+
| | - `post_max_size_message`_ |
32+
| | - `pattern`_ |
33+
+-----------+--------------------------------------------------------------------+
34+
| Inherited | - `block_name`_ |
35+
| options | - `disabled`_ |
36+
| | - `label`_ |
37+
| | - `attr`_ |
38+
| | - `translation_domain`_ |
39+
| | - `auto_initialize`_ |
40+
+-----------+--------------------------------------------------------------------+
41+
| Parent | none |
42+
+-----------+--------------------------------------------------------------------+
43+
| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType` |
44+
+-----------+--------------------------------------------------------------------+
45+
46+
Options
47+
-------
1148

1249
.. include:: /reference/forms/types/options/data.rst.inc
1350

@@ -25,8 +62,6 @@ on all fields.
2562

2663
.. include:: /reference/forms/types/options/required.rst.inc
2764

28-
.. include:: /reference/forms/types/options/label.rst.inc
29-
3065
.. include:: /reference/forms/types/options/label_attr.rst.inc
3166

3267
.. include:: /reference/forms/types/options/constraints.rst.inc
@@ -35,20 +70,12 @@ on all fields.
3570

3671
.. include:: /reference/forms/types/options/read_only.rst.inc
3772

38-
.. include:: /reference/forms/types/options/disabled.rst.inc
39-
4073
.. include:: /reference/forms/types/options/trim.rst.inc
4174

4275
.. include:: /reference/forms/types/options/mapped.rst.inc
4376

4477
.. include:: /reference/forms/types/options/property_path.rst.inc
4578

46-
.. include:: /reference/forms/types/options/attr.rst.inc
47-
48-
.. include:: /reference/forms/types/options/translation_domain.rst.inc
49-
50-
.. include:: /reference/forms/types/options/block_name.rst.inc
51-
5279
.. _reference-form-option-max_length:
5380

5481
.. include:: /reference/forms/types/options/max_length.rst.inc
@@ -72,3 +99,28 @@ on all fields.
7299
.. _reference-form-option-pattern:
73100

74101
.. include:: /reference/forms/types/options/pattern.rst.inc
102+
103+
.. include:: /reference/forms/types/options/action.rst.inc
104+
105+
.. include:: /reference/forms/types/options/method.rst.inc
106+
107+
Inherited options
108+
-----------------
109+
110+
The following options are defined in the
111+
:class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\BaseType` class.
112+
The ``BaseType`` class is the parent class for both the ``form`` type and
113+
the :doc:`button type </reference/forms/types/button>`, but it is not part
114+
of the form type tree (i.e. it can not be used as a form type on its own).
115+
116+
.. include:: /reference/forms/types/options/block_name.rst.inc
117+
118+
.. include:: /reference/forms/types/options/disabled.rst.inc
119+
120+
.. include:: /reference/forms/types/options/label.rst.inc
121+
122+
.. include:: /reference/forms/types/options/attr.rst.inc
123+
124+
.. include:: /reference/forms/types/options/translation_domain.rst.inc
125+
126+
.. include:: /reference/forms/types/options/auto_initialize.rst.inc

‎reference/forms/types/options/auto_initialize.rst.inc

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
auto_initialize
2+
~~~~~~~~~~~~~~~
3+
4+
**type**: ``boolean`` **default**: ``true``
5+
6+
An internal option: sets whether the form should be initialized automatically.
7+
For all fields, this option should only be ``true`` for root forms. You won't
8+
need to change this option and probably won't need to worry about it.

‎reference/forms/types/options/button_auto_initialize.rst.inc

Lines changed: 0 additions & 9 deletions
This file was deleted.

0 commit comments

Comments
 (0)
0