Updated reference articles to Symfony 4

Author: javiereguiluz

reference/configuration/assetic.rst

@@ -4,119 +4,8 @@
 AsseticBundle Configuration ("assetic")
 =======================================
 
-.. include:: /assetic/_standard_edition_warning.rst.inc
+.. caution::
 
-Full Default Configuration
---------------------------
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # app/config/config.yml
-        assetic:
-            debug:                '%kernel.debug%'
-            use_controller:
-                enabled:              '%kernel.debug%'
-                profiler:             false
-            read_from:            '%assetic.read_from%'
-            write_to:             '%kernel.project_dir%/web'
-            java:                 /usr/bin/java
-            node:                 /usr/bin/node
-            ruby:                 /usr/bin/ruby
-            sass:                 /usr/bin/sass
-            # An key-value pair of any number of named elements
-            variables:
-                some_name:                 []
-            bundles:
-
-                # Defaults (all currently registered bundles):
-                - FrameworkBundle
-                - SecurityBundle
-                - TwigBundle
-                - MonologBundle
-                - SwiftmailerBundle
-                - DoctrineBundle
-                - AsseticBundle
-                - ...
-            assets:
-                # An array of named assets (e.g. some_asset, some_other_asset)
-                some_asset:
-                    inputs:               []
-                    filters:              []
-                    options:
-                        # A key-value array of options and values
-                        some_option_name: []
-            filters:
-
-                # An array of named filters (e.g. some_filter, some_other_filter)
-                some_filter:                 []
-            workers:
-                # see https://github.com/symfony/AsseticBundle/pull/119
-                # Cache can also be busted via the framework.assets.version
-                # setting - see the "framework" configuration section
-                cache_busting:
-                    enabled:              false
-            twig:
-                functions:
-                    # An array of named functions (e.g. some_function, some_other_function)
-                    some_function:                 []
-
-    .. code-block:: xml
-
-        <!-- app/config/config.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <container xmlns="http://symfony.com/schema/dic/services"
-            xmlns:assetic="http://symfony.com/schema/dic/assetic"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                http://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/assetic
-                http://symfony.com/schema/dic/assetic/assetic-1.0.xsd">
-
-            <assetic:config
-                debug="%kernel.debug%"
-                use-controller="%kernel.debug%"
-                read-from="%assetic.read_from%"
-                write-to="%kernel.project_dir%/web"
-                java="/usr/bin/java"
-                node="/usr/bin/node"
-                sass="/usr/bin/sass">
-
-                <!-- Defaults (all currently registered bundles) -->
-                <assetic:bundle>FrameworkBundle</assetic:bundle>
-                <assetic:bundle>SecurityBundle</assetic:bundle>
-                <assetic:bundle>TwigBundle</assetic:bundle>
-                <assetic:bundle>MonologBundle</assetic:bundle>
-                <assetic:bundle>SwiftmailerBundle</assetic:bundle>
-                <assetic:bundle>DoctrineBundle</assetic:bundle>
-                <assetic:bundle>AsseticBundle</assetic:bundle>
-                <assetic:bundle>...</assetic:bundle>
-
-                <assetic:asset>
-                    <!-- prototype -->
-                    <assetic:name>
-                        <assetic:input />
-
-                        <assetic:filter />
-
-                        <assetic:option>
-                            <!-- prototype -->
-                            <assetic:name />
-                        </assetic:option>
-                    </assetic:name>
-                </assetic:asset>
-
-                <assetic:filter>
-                    <!-- prototype -->
-                    <assetic:name />
-                </assetic:filter>
-
-                <assetic:twig>
-                    <assetic:functions>
-                        <!-- prototype -->
-                        <assetic:name />
-                    </assetic:functions>
-                </assetic:twig>
-            </assetic:config>
-        </container>
+    Assetic is no longer recommended to manage web assets in Symfony
+    applications. Instead, use :doc:`Webpack Encore </frontend>`, which bridges
+    Symfony applications with modern JavaScript tools used to manage web assets.

reference/configuration/debug.rst

@@ -64,13 +64,13 @@ destination for dumps. Typically, you would set this to ``php://stderr``:
 
     .. code-block:: yaml
 
-        # app/config/config.yml
+        # config/packages/debug.yaml
         debug:
            dump_destination: php://stderr
 
     .. code-block:: xml
 
-        <!-- app/config/config.xml -->
+        <!-- config/packages/debug.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/debug"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -84,7 +84,7 @@ destination for dumps. Typically, you would set this to ``php://stderr``:
 
     .. code-block:: php
 
-        // app/config/config.php
+        // config/packages/debug.php
         $container->loadFromExtension('debug', array(
            'dump_destination' => 'php://stderr',
         ));

reference/configuration/doctrine.rst

@@ -12,17 +12,17 @@ Full Default Configuration
 
     .. code-block:: yaml
 
-        # app/config/config.yml
+        # config/packages/doctrine.yaml
         doctrine:
             dbal:
                 default_connection:   default
                 types:
                     # A collection of custom types
                     # Example
                     some_custom_type:
-                        class:                Acme\HelloBundle\MyCustomType
+                        class:                App\Bridge\Doctrine\DBAL\MyCustomType
                         commented:            true
-                
+
 
                 connections:
                     # A collection of different named connections (e.g. default, conn2, etc)
@@ -75,11 +75,11 @@ Full Default Configuration
                         mapping_types:
                             # an array of mapping types
                             name:                 []
-                            
+
                         # If defined, only the tables whose names match this regular expression are managed
                         # by the schema tool (in this example, any table name not starting with `wp_`)
                         #schema_filter:               '/^(?!wp_)/'
-                        
+
                         slaves:
 
                             # a collection of named slave connections (e.g. slave1, slave2)
@@ -163,17 +163,17 @@ Full Default Configuration
                             # a collection of string functions
                             string_functions:
                                 # example
-                                # test_string: Acme\HelloBundle\DQL\StringFunction
+                                # test_string: App\Bridge\Doctrine\DQL\StringFunction
 
                             # a collection of numeric functions
                             numeric_functions:
                                 # example
-                                # test_numeric: Acme\HelloBundle\DQL\NumericFunction
+                                # test_numeric: App\Bridge\Doctrine\DQL\NumericFunction
 
                             # a collection of datetime functions
                             datetime_functions:
                                 # example
-                                # test_datetime: Acme\HelloBundle\DQL\DatetimeFunction
+                                # test_datetime: App\Bridge\Doctrine\DQL\DatetimeFunction
 
                         # Register SQL Filters in the entity manager
                         filters:
@@ -184,7 +184,7 @@ Full Default Configuration
 
     .. code-block:: xml
 
-        <!-- app/config/config.xml -->
+        <!-- config/packages/doctrine.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -204,22 +204,22 @@ Full Default Configuration
                         user="user"
                         password="secret"
                         driver="pdo_mysql"
-                        driver-class="MyNamespace\MyDriverImpl"
+                        driver-class="App\Bridge\Doctrine\DBAL\MyDatabaseDriver"
                         path="%kernel.project_dir%/var/data/data.sqlite"
                         memory="true"
                         unix-socket="/tmp/mysql.sock"
-                        wrapper-class="MyDoctrineDbalConnectionWrapper"
+                        wrapper-class="App\Bridge\Doctrine\DBAL\MyConnectionWrapper"
                         charset="UTF8"
                         logging="%kernel.debug%"
-                        platform-service="MyOwnDatabasePlatformService"
+                        platform-service="App\Bridge\Doctrine\DBAL\MyDatabasePlatformService"
                         server-version="5.6"
                         keep-slave="false"
                     >
                         <doctrine:option key="foo">bar</doctrine:option>
                         <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
                     </doctrine:connection>
                     <doctrine:connection name="conn1" />
-                    <doctrine:type name="custom">Acme\HelloBundle\MyCustomType</doctrine:type>
+                    <doctrine:type name="custom">App\Bridge\Doctrine\DBAL\MyCustomType</doctrine:type>
                 </doctrine:dbal>
 
                 <doctrine:orm
@@ -247,15 +247,15 @@ Full Default Configuration
 
                         <doctrine:dql>
                             <doctrine:string-function name="test_string">
-                                Acme\HelloBundle\DQL\StringFunction
+                                App\Bridge\Doctrine\DQL\StringFunction
                             </doctrine:string-function>
 
                             <doctrine:numeric-function name="test_numeric">
-                                Acme\HelloBundle\DQL\NumericFunction
+                                App\Bridge\Doctrine\DQL\NumericFunction
                             </doctrine:numeric-function>
 
                             <doctrine:datetime-function name="test_datetime">
-                                Acme\HelloBundle\DQL\DatetimeFunction
+                                App\Bridge\Doctrine\DQL\DatetimeFunction
                             </doctrine:datetime-function>
                         </doctrine:dql>
                     </doctrine:entity-manager>
@@ -301,23 +301,23 @@ The following block shows all possible configuration keys:
                 password:             secret
                 driver:               pdo_mysql
                 # the DBAL driverClass option
-                driver_class:         MyNamespace\MyDriverImpl
+                driver_class:         App\Bridge\Doctrine\DBAL\MyDatabaseDriver
                 # the DBAL driverOptions option
                 options:
                     foo: bar
                 path:                 '%kernel.project_dir%/app/data/data.sqlite'
                 memory:               true
                 unix_socket:          /tmp/mysql.sock
                 # the DBAL wrapperClass option
-                wrapper_class:        MyDoctrineDbalConnectionWrapper
+                wrapper_class:        App\Bridge\Doctrine\DBAL\MyConnectionWrapper
                 charset:              UTF8
                 logging:              '%kernel.debug%'
-                platform_service:     MyOwnDatabasePlatformService
+                platform_service:     App\Bridge\Doctrine\DBAL\MyDatabasePlatformService
                 server_version:       5.6
                 mapping_types:
                     enum: string
                 types:
-                    custom: Acme\HelloBundle\MyCustomType
+                    custom: App\Bridge\Doctrine\DBAL\MyCustomType
 
     .. code-block:: xml
 
@@ -339,19 +339,19 @@ The following block shows all possible configuration keys:
                     user="user"
                     password="secret"
                     driver="pdo_mysql"
-                    driver-class="MyNamespace\MyDriverImpl"
+                    driver-class="App\Bridge\Doctrine\DBAL\MyDatabaseDriver"
                     path="%kernel.project_dir%/var/data/data.sqlite"
                     memory="true"
                     unix-socket="/tmp/mysql.sock"
-                    wrapper-class="MyDoctrineDbalConnectionWrapper"
+                    wrapper-class="App\Bridge\Doctrine\DBAL\MyConnectionWrapper"
                     charset="UTF8"
                     logging="%kernel.debug%"
-                    platform-service="MyOwnDatabasePlatformService"
+                    platform-service="App\Bridge\Doctrine\DBAL\MyDatabasePlatformService"
                     server-version="5.6">
 
                     <doctrine:option key="foo">bar</doctrine:option>
                     <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
-                    <doctrine:type name="custom">Acme\HelloBundle\MyCustomType</doctrine:type>
+                    <doctrine:type name="custom">App\Bridge\Doctrine\DBAL\MyCustomType</doctrine:type>
                 </doctrine:dbal>
             </doctrine:config>
         </container>
@@ -480,7 +480,7 @@ The following example shows an overview of the caching configurations:
             # the 'service' type requires to define the 'id' option too
             query_cache_driver:
                 type: service
-                id: my_doctrine_common_cache_service
+                id: App\Bridge\Doctrine\ORM\MyCacheService
 
 Mapping Configuration
 ~~~~~~~~~~~~~~~~~~~~~
@@ -662,7 +662,7 @@ If the ``type`` on the bundle configuration isn't set, the DoctrineBundle
 will try to detect the correct mapping configuration format for the bundle.
 
 DoctrineBundle will look for files matching ``*.orm.[FORMAT]`` (e.g.
-``Post.orm.yml``) in the configured ``dir`` of your mapping (if you're mapping
+``Post.orm.yaml``) in the configured ``dir`` of your mapping (if you're mapping
 a bundle, then ``dir`` is relative to the bundle's directory).
 
 The bundle looks for (in this order) XML, YAML and PHP files.