minor #10364 [PHPUnitBridge] Describes how to disable DebugClassLoader (MarioBlazek)

javiereguiluz · javiereguiluz · commit 938cdaa1415d · 2018-10-29T16:45:01.000+01:00
This PR was merged into the master branch. Discussion ---------- [PHPUnitBridge] Describes how to disable DebugClassLoader Documents #10360 Commits ------- 719526e #10360 disable DebugClassLoader doc
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
@@ -226,6 +226,25 @@ related to deprecations.
 
 .. _write-assertions-about-deprecations:
 
+Deprecation notices at autoloading time
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, the PHPUnit Bridge uses ``DebugClassLoader`` from Debug component to
+throw deprecation notices at autoloading time. It attempts to throw more helpful
+exceptions when a class isn't found by the registered autoloaders.
+All autoloaders that implement a findFile() method are replaced with a ``DebugClassLoader`` wrapper.
+This can be disabled by setting ``debug-class-loader`` option to ``0`` in  ``phpunit.xml.dist``.
+
+.. code-block:: xml
+
+        <listeners>
+            <listener class="Symfony\Bridge\PhpUnit\SymfonyTestsListener">
+                <arguments>
+                    <array>
+                        <element key="debug-class-loader"><integer>0</integer></element>
+        ...
+
+
 Write Assertions about Deprecations
 -----------------------------------
 
