|
1 | 1 | .. index:: |
2 | 2 | single: Configuration reference; Framework |
3 | 3 |
|
4 | | -FrameworkBundle Configuration ("framework") |
5 | | -=========================================== |
| 4 | +FrameworkBundle Configuration |
| 5 | +============================= |
6 | 6 |
|
7 | | -The FrameworkBundle contains most of the "base" framework functionality |
8 | | -and can be configured under the ``framework`` key in your application |
9 | | -configuration. When using XML, you must use the |
10 | | -``http://symfony.com/schema/dic/symfony`` namespace. |
| 7 | +The FrameworkBundle includes the main framework configuration, from sessions and |
| 8 | +translations to forms, validation, routing and more. All these options are |
| 9 | +configured under the ``framework`` key in your application configuration. |
11 | 10 |
|
12 | | -This includes settings related to sessions, translation, forms, validation, |
13 | | -routing and more. |
| 11 | +.. code-block:: terminal |
14 | 12 |
|
15 | | -.. tip:: |
| 13 | + # displays the default config values defined by Symfony |
| 14 | + $ ./bin/console config:dump-reference framework |
| 15 | +
|
| 16 | + # displays the actual config values used by your application |
| 17 | + $ ./bin/console debug:config framework |
16 | 18 |
|
17 | | - The XSD schema is available at |
18 | | - ``http://symfony.com/schema/dic/symfony/symfony-1.0.xsd``. |
| 19 | +.. note:: |
| 20 | + |
| 21 | + When using XML, you must use the ``http://symfony.com/schema/dic/symfony`` |
| 22 | + namespace and the related XSD schema is available at: |
| 23 | + ``http://symfony.com/schema/dic/symfony/symfony-1.0.xsd`` |
19 | 24 |
|
20 | 25 | Configuration |
21 | 26 | ------------- |
@@ -1477,143 +1482,6 @@ If this option is enabled, serialization groups can be defined using annotations |
1477 | 1482 |
|
1478 | 1483 | For more information, see :ref:`serializer-using-serialization-groups-annotations`. |
1479 | 1484 |
|
1480 | | -Full Default Configuration |
1481 | | --------------------------- |
1482 | | - |
1483 | | -.. configuration-block:: |
1484 | | - |
1485 | | - .. code-block:: yaml |
1486 | | -
|
1487 | | - framework: |
1488 | | - secret: ~ |
1489 | | - http_method_override: true |
1490 | | - trusted_proxies: [] |
1491 | | - ide: ~ |
1492 | | - test: ~ |
1493 | | - default_locale: en |
1494 | | -
|
1495 | | - csrf_protection: |
1496 | | - enabled: false |
1497 | | - field_name: _token # Deprecated since 2.4, to be removed in 3.0. Use form.csrf_protection.field_name instead |
1498 | | -
|
1499 | | - # form configuration |
1500 | | - form: |
1501 | | - enabled: false |
1502 | | - csrf_protection: |
1503 | | - enabled: true |
1504 | | - field_name: ~ |
1505 | | -
|
1506 | | - # esi configuration |
1507 | | - esi: |
1508 | | - enabled: false |
1509 | | -
|
1510 | | - # fragments configuration |
1511 | | - fragments: |
1512 | | - enabled: false |
1513 | | - path: /_fragment |
1514 | | -
|
1515 | | - # profiler configuration |
1516 | | - profiler: |
1517 | | - enabled: false |
1518 | | - collect: true |
1519 | | - only_exceptions: false |
1520 | | - only_master_requests: false |
1521 | | - dsn: file:%kernel.cache_dir%/profiler |
1522 | | - username: |
1523 | | - password: |
1524 | | - lifetime: 86400 |
1525 | | - matcher: |
1526 | | - ip: ~ |
1527 | | -
|
1528 | | - # use the urldecoded format |
1529 | | - path: ~ # Example: ^/path to resource/ |
1530 | | - service: ~ |
1531 | | -
|
1532 | | - # router configuration |
1533 | | - router: |
1534 | | - resource: ~ # Required |
1535 | | - type: ~ |
1536 | | - http_port: 80 |
1537 | | - https_port: 443 |
1538 | | -
|
1539 | | - # * set to true to throw an exception when a parameter does not |
1540 | | - # match the requirements |
1541 | | - # * set to false to disable exceptions when a parameter does not |
1542 | | - # match the requirements (and return null instead) |
1543 | | - # * set to null to disable parameter checks against requirements |
1544 | | - # |
1545 | | - # 'true' is the preferred configuration in development mode, while |
1546 | | - # 'false' or 'null' might be preferred in production |
1547 | | - strict_requirements: true |
1548 | | -
|
1549 | | - # session configuration |
1550 | | - session: |
1551 | | - storage_id: session.storage.native |
1552 | | - handler_id: session.handler.native_file |
1553 | | - name: ~ |
1554 | | - cookie_lifetime: ~ |
1555 | | - cookie_path: ~ |
1556 | | - cookie_domain: ~ |
1557 | | - cookie_secure: ~ |
1558 | | - cookie_httponly: ~ |
1559 | | - gc_divisor: ~ |
1560 | | - gc_probability: ~ |
1561 | | - gc_maxlifetime: ~ |
1562 | | - save_path: '%kernel.cache_dir%/sessions' |
1563 | | -
|
1564 | | - # serializer configuration |
1565 | | - serializer: |
1566 | | - enabled: false |
1567 | | -
|
1568 | | - # assets configuration |
1569 | | - assets: |
1570 | | - base_path: ~ |
1571 | | - base_urls: [] |
1572 | | - version: ~ |
1573 | | - version_format: '%%s?%%s' |
1574 | | - packages: |
1575 | | -
|
1576 | | - # Prototype |
1577 | | - name: |
1578 | | - base_path: ~ |
1579 | | - base_urls: [] |
1580 | | - version: ~ |
1581 | | - version_format: '%%s?%%s' |
1582 | | -
|
1583 | | - # templating configuration |
1584 | | - templating: |
1585 | | - hinclude_default_template: ~ |
1586 | | - form: |
1587 | | - resources: |
1588 | | -
|
1589 | | - # Default: |
1590 | | - - FrameworkBundle:Form |
1591 | | - cache: ~ |
1592 | | - engines: # Required |
1593 | | -
|
1594 | | - # Example: |
1595 | | - - twig |
1596 | | - loaders: [] |
1597 | | -
|
1598 | | - # translator configuration |
1599 | | - translator: |
1600 | | - enabled: false |
1601 | | - fallbacks: [en] |
1602 | | - logging: "%kernel.debug%" |
1603 | | -
|
1604 | | - # validation configuration |
1605 | | - validation: |
1606 | | - enabled: false |
1607 | | - cache: ~ |
1608 | | - enable_annotations: false |
1609 | | - translation_domain: validators |
1610 | | -
|
1611 | | - # annotation configuration |
1612 | | - annotations: |
1613 | | - cache: file |
1614 | | - file_cache_dir: '%kernel.cache_dir%/annotations' |
1615 | | - debug: '%kernel.debug%' |
1616 | | -
|
1617 | 1485 | .. _`HTTP Host header attacks`: http://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html |
1618 | 1486 | .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning |
1619 | 1487 | .. _`Doctrine Cache`: http://docs.doctrine-project.org/projects/doctrine-common/en/latest/reference/caching.html |
|
0 commit comments