Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit ef97812

Browse filesBrowse files
xabbuhxabbuh
committed
Merge branch '3.4'
* 3.4: (32 commits) [#8185] minor reword [#8211] minor reword Reword Update language.rst Mention lazy loading for Doctrine event listeners Documented the WebProfilerBundle configuration Added a note about the new behavior of BrowserKit and redirects Fixed usage of default configuration in PHP Some typos Add pipe to dump command Update event_dispatcher.rst Typo fixed in a doctrine docs [#8245] link text directly Link to '"creating a reproducer" in "reporting a bug" Removed an extra line Updated xml config applying comment from @wouterj [Form] [RepeatedType] Update "type" default value Adds a missing semicolon Added missing "," in encore/legacy-apps doc ...
2 parents 3231d9a + 6b7e99e commit ef97812
Copy full SHA for ef97812
Expand file treeCollapse file tree

24 files changed

+395
-88
lines changed

‎components/cache/cache_pools.rst

Copy file name to clipboardExpand all lines: components/cache/cache_pools.rst
+17Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,3 +121,20 @@ when all items are successfully deleted)::
121121

122122
// ...
123123
$cacheIsEmpty = $cache->clear();
124+
125+
.. tip::
126+
127+
If the Cache component is used inside a Symfony application, you can remove
128+
all the items of a given cache pool with the following command:
129+
130+
.. code-block:: terminal
131+
132+
$ php bin/console cache:pool:clear <cache-pool-name>
133+
134+
# clears the "cache.app" pool
135+
$ php bin/console cache:pool:clear cache.app
136+
137+
# clears the "cache.validation" and "cache.app" pool
138+
$ php bin/console cache:pool:clear cache.validation cache.app
139+
140+
.. _`Doctrine Cache`: https://github.com/doctrine/cache

‎components/event_dispatcher.rst

Copy file name to clipboardExpand all lines: components/event_dispatcher.rst
+1-2Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -497,8 +497,7 @@ with some other dispatchers:
497497

498498
* :doc:`/components/event_dispatcher/container_aware_dispatcher`
499499
* :doc:`/components/event_dispatcher/immutable_dispatcher`
500-
* :doc:`/components/event_dispatcher/traceable_dispatcher` (provided by the
501-
:doc:`HttpKernel component </components/http_kernel>`)
500+
* :doc:`/components/event_dispatcher/traceable_dispatcher`
502501

503502
Learn More
504503
----------

‎components/form.rst

Copy file name to clipboardExpand all lines: components/form.rst
+6-6Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -476,8 +476,8 @@ builder:
476476
);
477477
478478
$form = $this->createFormBuilder($defaults)
479-
->add('task', TextType::class)
480-
->add('dueDate', DateType::class)
479+
->add('task', TextType::class)
480+
->add('dueDate', DateType::class)
481481
->getForm();
482482
483483
// ...
@@ -616,8 +616,8 @@ method:
616616
public function newAction(Request $request)
617617
{
618618
$form = $this->createFormBuilder()
619-
->add('task', TextType::class)
620-
->add('dueDate', DateType::class)
619+
->add('task', TextType::class)
620+
->add('dueDate', DateType::class)
621621
->getForm();
622622
623623
$form->handleRequest($request);
@@ -694,10 +694,10 @@ option when building each field:
694694
public function newAction(Request $request)
695695
{
696696
$form = $this->createFormBuilder()
697-
->add('task', TextType::class, array(
697+
->add('task', TextType::class, array(
698698
'constraints' => new NotBlank(),
699699
))
700-
->add('dueDate', DateType::class, array(
700+
->add('dueDate', DateType::class, array(
701701
'constraints' => array(
702702
new NotBlank(),
703703
new Type(\DateTime::class),

‎contributing/code/bugs.rst

Copy file name to clipboardExpand all lines: contributing/code/bugs.rst
+3-3Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@ If your problem definitely looks like a bug, report it using the official bug
2626
* Describe the steps needed to reproduce the bug with short code examples
2727
(providing a unit test that illustrates the bug is best);
2828

29-
* If the bug you experienced affects more than one layer, providing a simple
30-
failing unit test may not be sufficient. In this case, please fork the
31-
`Symfony Standard Edition`_ and reproduce your issue on a new branch;
29+
* If the bug you experienced is not obvious or affects more than one layer,
30+
providing a simple failing unit test may not be sufficient. In this case,
31+
please :doc:`provide a reproducer </contributing/code/reproducer>`;
3232

3333
* Give as much detail as possible about your environment (OS, PHP version,
3434
Symfony version, enabled extensions, ...);

‎doctrine.rst

Copy file name to clipboardExpand all lines: doctrine.rst
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -527,7 +527,7 @@ a controller, this is pretty easy. Add the following method to the
527527
{
528528
$doctrine = $this->getDoctrine();
529529
$em = $doctrine->getManager();
530-
$em2 = $doctrine->getManager('other_connection')
530+
$em2 = $doctrine->getManager('other_connection');
531531
}
532532

533533
.. note::
@@ -680,7 +680,7 @@ Updating an Object
680680
Once you've fetched an object from Doctrine, updating it is easy. Suppose
681681
you have a route that maps a product id to an update action in a controller::
682682

683-
use AppBundle\Entity\Post;
683+
use AppBundle\Entity\Product;
684684
// ...
685685

686686
public function updateAction($productId)

‎doctrine/event_listeners_subscribers.rst

Copy file name to clipboardExpand all lines: doctrine/event_listeners_subscribers.rst
+53Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -185,5 +185,58 @@ interface and have an event method for each event it subscribes to::
185185

186186
For a full reference, see chapter `The Event System`_ in the Doctrine documentation.
187187

188+
Lazy loading for Event Listeners
189+
--------------------------------
190+
191+
One subtle difference between listeners and subscribers is that Symfony can load
192+
entity listeners lazily. This means that your listener class will only be fetched
193+
from the service container (and thus be instantiated) once the event it is linked
194+
to actually fires.
195+
196+
Lazy loading might give you a slight performance improvement when your listener
197+
runs for events that rarely fire. Also, it can help you when you run into
198+
*circular dependency issues* that may occur when your listener service in turn
199+
depends on the DBAL connection.
200+
201+
To mark a listener service as lazily loaded, just add the ``lazy`` attribute
202+
to the tag like so:
203+
204+
.. configuration-block::
205+
206+
.. code-block:: yaml
207+
208+
services:
209+
my.listener:
210+
class: AppBundle\EventListener\SearchIndexer
211+
tags:
212+
- { name: doctrine.event_listener, event: postPersist, lazy: true }
213+
214+
.. code-block:: xml
215+
216+
<?xml version="1.0" ?>
217+
<container xmlns="http://symfony.com/schema/dic/services"
218+
xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
219+
220+
<services>
221+
<service id="my.listener" class="AppBundle\EventListener\SearchIndexer">
222+
<tag name="doctrine.event_listener" event="postPersist" lazy="true" />
223+
</service>
224+
</services>
225+
</container>
226+
227+
.. code-block:: php
228+
229+
use AppBundle\EventListener\SearchIndexer;
230+
231+
$container
232+
->register('my.listener', SearchIndexer::class)
233+
->addTag('doctrine.event_listener', array('event' => 'postPersist', 'lazy' => 'true'))
234+
;
235+
236+
.. note::
237+
238+
  Marking an event listener as ``lazy`` has nothing to do with lazy service
239+
definitions which are described :doc:`in their own section </service_container/lazy_services>`
240+
188241
.. _`The Event System`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html
189242
.. _`the Doctrine Documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#entity-listeners

‎form/create_custom_field_type.rst

Copy file name to clipboardExpand all lines: form/create_custom_field_type.rst
+2-3Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,9 @@ How to Create a Custom Form Field Type
66

77
Symfony comes with a bunch of core field types available for building forms.
88
However there are situations where you may want to create a custom form field
9-
type for a specific purpose. This recipe assumes you need a field definition
9+
type for a specific purpose. This article assumes you need a field definition
1010
that holds a shipping option, based on the existing choice field. This section
11-
explains how the field is defined, how you can customize its layout and finally,
12-
how you can register it for use in your application.
11+
explains how the field is defined and how you can customize its layout.
1312

1413
Defining the Field Type
1514
-----------------------

‎frontend/encore/legacy-apps.rst

Copy file name to clipboardExpand all lines: frontend/encore/legacy-apps.rst
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ method from Encore. In practice, it's equivalent to doing:
5252
// such as '_' for the 'underscore' library
5353
.autoProvideVariables({
5454
$: 'jquery',
55-
jQuery: 'jquery'
55+
jQuery: 'jquery',
5656
'window.jQuery': 'jquery',
5757
})
5858
// ...

‎reference/configuration/debug.rst

Copy file name to clipboardExpand all lines: reference/configuration/debug.rst
+14Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ Configuration
1919
-------------
2020

2121
* `max_items`_
22+
* `min_depth`_
2223
* `max_string_length`_
2324
* `dump_destination`_
2425

@@ -30,6 +31,19 @@ max_items
3031
This is the maximum number of items to dump. Setting this option to ``-1``
3132
disables the limit.
3233

34+
min_depth
35+
~~~~~~~~~
36+
37+
**type**: ``integer`` **default**: ``1``
38+
39+
Configures the minimum tree depth until which all items are guaranteed to
40+
be cloned. After this depth is reached, only ``max_items`` items will be
41+
cloned. The default value is ``1``, which is consistentcwith older Symfony
42+
versions.
43+
44+
.. versionadded:: 3.4
45+
The ``min_depth`` option was introduced in Symfony 3.4.
46+
3347
max_string_length
3448
~~~~~~~~~~~~~~~~~
3549

‎reference/configuration/twig.rst

Copy file name to clipboardExpand all lines: reference/configuration/twig.rst
+86Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,16 @@ TwigBundle Configuration ("twig")
5555
paths:
5656
'%kernel.project_dir%/vendor/acme/foo-bar/templates': foo_bar
5757
58+
# The following were added in Symfony 2.7.
59+
date:
60+
format: d.m.Y, H:i:s
61+
interval_format: '%%d days'
62+
timezone: Asia/Tokyo
63+
number_format:
64+
decimals: 2
65+
decimal_point: ','
66+
thousands_separator: '.'
67+
5868
.. code-block:: xml
5969
6070
<!-- app/config/config.xml -->
@@ -81,6 +91,9 @@ TwigBundle Configuration ("twig")
8191
8292
<twig:global key="foo" id="bar" type="service" />
8393
<twig:global key="pi">3.14</twig:global>
94+
95+
<twig:date format="d.m.Y, H:i:s" interval-format="%d days" timezone="Asia/Tokyo" />
96+
<twig:number-format decimals="2" decimal-point="," thousands-separator="." />
8497
8598
<twig:exception-controller>AcmeFooBundle:Exception:showException</twig:exception-controller>
8699
<twig:path namespace="foo_bar">%kernel.project_dir%/vendor/acme/foo-bar/templates</twig:path>
@@ -111,6 +124,16 @@ TwigBundle Configuration ("twig")
111124
'paths' => array(
112125
'%kernel.project_dir%/vendor/acme/foo-bar/templates' => 'foo_bar',
113126
),
127+
'date' => array(
128+
'format' => 'd.m.Y, H:i:s',
129+
'interval_format' => '%%d days',
130+
'timezone' => 'Asia/Tokyo',
131+
),
132+
'number_format' => array(
133+
'decimals' => 2,
134+
'decimal_point' => ',',
135+
'thousands_separator' => '.',
136+
),
114137
));
115138
116139
.. caution::
@@ -210,6 +233,37 @@ charset
210233
The charset used by the template files. In the Symfony Standard edition this
211234
defaults to the ``UTF-8`` charset.
212235

236+
date
237+
~~~~
238+
239+
These options define the default values used by the ``date`` filter to format
240+
date and time values. They are useful to avoid passing the same arguments on
241+
every ``date`` filter call.
242+
243+
format
244+
......
245+
246+
**type**: ``string`` **default**: ``F j, Y H:i``
247+
248+
The format used by the ``date`` filter to display values when no specific format
249+
is passed as argument.
250+
251+
internal_format
252+
...............
253+
254+
**type**: ``string`` **default**: ``%d days``
255+
256+
The format used by the ``date`` filter to display ``DateInterval`` instances
257+
when no specific format is passed as argument.
258+
259+
timezone
260+
........
261+
262+
**type**: ``string`` **default**: (the value returned by ``date_default_timezone_get()``)
263+
264+
The timezone used when formatting date values with the ``date`` filter and no
265+
specific timezone is passed as argument.
266+
213267
debug
214268
~~~~~
215269

@@ -234,6 +288,38 @@ option is advanced. If you need to customize an error page you should use
234288
the previous link. If you need to perform some behavior on an exception,
235289
you should add a listener to the ``kernel.exception`` event (see :ref:`dic-tags-kernel-event-listener`).
236290

291+
number_format
292+
~~~~~~~~~~~~~
293+
294+
These options define the default values used by the ``number_format`` filter to
295+
format numeric values. They are useful to avoid passing the same arguments on
296+
every ``number_format`` filter call.
297+
298+
decimals
299+
........
300+
301+
**type**: ``integer`` **default**: ``0``
302+
303+
The number of decimals used to format numeric values when no specific number is
304+
passed as argument to the ``number_format`` filter.
305+
306+
decimal_point
307+
.............
308+
309+
**type**: ``string`` **default**: ``.``
310+
311+
The character used to separate the decimals from the integer part of numeric
312+
values when no specific character is passed as argument to the ``number_format``
313+
filter.
314+
315+
thousands_separator
316+
...................
317+
318+
**type**: ``string`` **default**: ``,``
319+
320+
The character used to separate every group of thousands in numeric values when
321+
no specific character is passed as argument to the ``number_format`` filter.
322+
237323
optimizations
238324
~~~~~~~~~~~~~
239325

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.