[ClassLoader] Deprecate Apc/WinCache/Xcache class loaders

UPGRADE-3.3.md

@@ -0,0 +1,8 @@
+UPGRADE FROM 3.2 to 3.3
+=======================
+
+ClassLoader
+-----------
+
+ * The ApcClassLoader, WinCacheClassLoader and XcacheClassLoader classes have been deprecated
+   in favor of the `--apcu-autoloader` option introduced in composer 1.3

UPGRADE-4.0.md

@@ -1,6 +1,12 @@
 UPGRADE FROM 3.x to 4.0
 =======================
 
+ClassLoader
+-----------
+
+ * The ApcClassLoader, WinCacheClassLoader and XcacheClassLoader classes have been removed
+   in favor of the `--apcu-autoloader` option introduced in composer 1.3
+
 Console
 -------
 

src/Symfony/Bundle/FrameworkBundle/Resources/config/services.xml

@@ -32,7 +32,6 @@
                 <argument>Symfony\Component\HttpFoundation\Request</argument>
                 <argument>Symfony\Component\HttpKernel\Kernel</argument>
                 <argument>Symfony\Component\ClassLoader\ClassCollectionLoader</argument>
-                <argument>Symfony\Component\ClassLoader\ApcClassLoader</argument>
             </argument>
         </service>
 

src/Symfony/Component/ClassLoader/ApcClassLoader.php

@@ -11,6 +11,8 @@
 
 namespace Symfony\Component\ClassLoader;
 
+@trigger_error('The '.__NAMESPACE__.'\ApcClassLoader class is deprecated since version 3.3 and will be removed in 4.0. Use `composer install --apcu-autoloader` instead.', E_USER_DEPRECATED);
+
 /**
  * ApcClassLoader implements a wrapping autoloader cached in APC for PHP 5.3.
  *
@@ -44,6 +46,8 @@ namespace Symfony\Component\ClassLoader;
  *
  * @author Fabien Potencier <fabien@symfony.com>
  * @author Kris Wallsmith <kris@symfony.com>
+ *
+ * @deprecated since version 3.3, to be removed in 4.0. Use `composer install --apcu-autoloader` instead.
  */
 class ApcClassLoader
 {

src/Symfony/Component/ClassLoader/CHANGELOG.md

@@ -1,6 +1,12 @@
 CHANGELOG
 =========
 
+3.3.0
+-----
+
+ * The ApcClassLoader, WinCacheClassLoader and XcacheClassLoader classes have been deprecated
+   in favor of the `--apcu-autoloader` option introduced in composer 1.3
+
 3.0.0
 -----
 

src/Symfony/Component/ClassLoader/Tests/ApcClassLoaderTest.php

@@ -14,6 +14,9 @@ namespace Symfony\Component\ClassLoader\Tests;
 use Symfony\Component\ClassLoader\ApcClassLoader;
 use Symfony\Component\ClassLoader\ClassLoader;
 
+/**
+ * @group legacy
+ */
 class ApcClassLoaderTest extends \PHPUnit_Framework_TestCase
 {
     protected function setUp()

src/Symfony/Component/ClassLoader/WinCacheClassLoader.php

@@ -11,6 +11,8 @@
 
 namespace Symfony\Component\ClassLoader;
 
+@trigger_error('The '.__NAMESPACE__.'\WinCacheClassLoader class is deprecated since version 3.3 and will be removed in 4.0. Use `composer install --apcu-autoloader` instead.', E_USER_DEPRECATED);
+
 /**
  * WinCacheClassLoader implements a wrapping autoloader cached in WinCache.
  *
@@ -43,6 +45,8 @@ namespace Symfony\Component\ClassLoader;
  * @author Fabien Potencier <fabien@symfony.com>
  * @author Kris Wallsmith <kris@symfony.com>
  * @author Artem Ryzhkov <artem@smart-core.org>
+ *
+ * @deprecated since version 3.3, to be removed in 4.0. Use `composer install --apcu-autoloader` instead.
  */
 class WinCacheClassLoader
 {

src/Symfony/Component/ClassLoader/XcacheClassLoader.php

@@ -11,6 +11,8 @@
 
 namespace Symfony\Component\ClassLoader;
 
+@trigger_error('The '.__NAMESPACE__.'\XcacheClassLoader class is deprecated since version 3.3 and will be removed in 4.0. Use `composer install --apcu-autoloader` instead.', E_USER_DEPRECATED);
+
 /**
  * XcacheClassLoader implements a wrapping autoloader cached in XCache for PHP 5.3.
  *
@@ -43,6 +45,8 @@ namespace Symfony\Component\ClassLoader;
  * @author Fabien Potencier <fabien@symfony.com>
  * @author Kris Wallsmith <kris@symfony.com>
  * @author Kim Hemsø Rasmussen <kimhemsoe@gmail.com>
+ *
+ * @deprecated since version 3.3, to be removed in 4.0. Use `composer install --apcu-autoloader` instead.
  */
 class XcacheClassLoader
 {