[ClassLoader] deprecate caching class loaders

Author: xabbuh

components/class_loader.rst

@@ -52,7 +52,15 @@ Learn More
     :maxdepth: 1
 
     class_loader/class_loader
-    class_loader/*
+    class_loader/class_map_generator.rst
+    class_loader/debug_class_loader.rst
+    class_loader/map_class_loader.rst
+    class_loader/psr4_class_loader.rst
+
+.. toctree::
+    :hidden:
+
+    class_loader/cache_class_loader
 
 .. _PSR-0: http://www.php-fig.org/psr/psr-0/
 .. _PSR-4: http://www.php-fig.org/psr/psr-4/

components/class_loader/cache_class_loader.rst

@@ -8,58 +8,6 @@
 Cache a Class Loader
 ====================
 
-Finding the file for a particular class can be an expensive task. Luckily,
-the ClassLoader component comes with two classes to cache the mapping
-from a class to its containing file. Both the :class:`Symfony\\Component\\ClassLoader\\ApcClassLoader`
-and the :class:`Symfony\\Component\\ClassLoader\\XcacheClassLoader` wrap
-around an object which implements a ``findFile()`` method to find the file
-for a class.
-
-.. note::
-
-    Both the ``ApcClassLoader`` and the ``XcacheClassLoader`` can be used
-    to cache Composer's `autoloader`_.
-
-ApcClassLoader
---------------
-
-``ApcClassLoader`` wraps an existing class loader and caches calls to its
-``findFile()`` method using `APC`_::
-
-    require_once '/path/to/src/Symfony/Component/ClassLoader/ApcClassLoader.php';
-
-    // instance of a class that implements a findFile() method, like the ClassLoader
-    $loader = ...;
-
-    // sha1(__FILE__) generates an APC namespace prefix
-    $cachedLoader = new ApcClassLoader(sha1(__FILE__), $loader);
-
-    // register the cached class loader
-    $cachedLoader->register();
-
-    // deactivate the original, non-cached loader if it was registered previously
-    $loader->unregister();
-
-XcacheClassLoader
------------------
-
-``XcacheClassLoader`` uses `XCache`_ to cache a class loader. Registering
-it is straightforward::
-
-    require_once '/path/to/src/Symfony/Component/ClassLoader/XcacheClassLoader.php';
-
-    // instance of a class that implements a findFile() method, like the ClassLoader
-    $loader = ...;
-
-    // sha1(__FILE__) generates an XCache namespace prefix
-    $cachedLoader = new XcacheClassLoader(sha1(__FILE__), $loader);
-
-    // register the cached class loader
-    $cachedLoader->register();
-
-    // deactivate the original, non-cached loader if it was registered previously
-    $loader->unregister();
-
-.. _APC:        http://php.net/manual/en/book.apc.php
-.. _autoloader: https://getcomposer.org/doc/01-basic-usage.md#autoloading
-.. _XCache:     http://xcache.lighttpd.net
+The ``ApcClassLoader``, the ``WinCacheClassLoader`` and the ``XcacheClassLoader``
+are deprecated since Symfony 3.3. Use the ``--apcu-autoloader`` option instead
+when dumping the autoloader using the ``composer dump-autoload`` command.