diff --git a/UPGRADE-3.3.md b/UPGRADE-3.3.md
new file mode 100644
index 0000000000000..758941e2eb598
--- /dev/null
+++ b/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
diff --git a/UPGRADE-4.0.md b/UPGRADE-4.0.md
index 483b7e6ed1447..7463425be81a0 100644
--- a/UPGRADE-4.0.md
+++ b/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
-------
diff --git a/src/Symfony/Bundle/FrameworkBundle/Resources/config/services.xml b/src/Symfony/Bundle/FrameworkBundle/Resources/config/services.xml
index f07f5261bb40a..dbc830e60aa37 100644
--- a/src/Symfony/Bundle/FrameworkBundle/Resources/config/services.xml
+++ b/src/Symfony/Bundle/FrameworkBundle/Resources/config/services.xml
@@ -32,7 +32,6 @@
Symfony\Component\HttpFoundation\Request
Symfony\Component\HttpKernel\Kernel
Symfony\Component\ClassLoader\ClassCollectionLoader
- Symfony\Component\ClassLoader\ApcClassLoader
diff --git a/src/Symfony/Component/ClassLoader/ApcClassLoader.php b/src/Symfony/Component/ClassLoader/ApcClassLoader.php
index 5500e3628902d..0d899842b3c96 100644
--- a/src/Symfony/Component/ClassLoader/ApcClassLoader.php
+++ b/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 @@
*
* @author Fabien Potencier
* @author Kris Wallsmith
+ *
+ * @deprecated since version 3.3, to be removed in 4.0. Use `composer install --apcu-autoloader` instead.
*/
class ApcClassLoader
{
diff --git a/src/Symfony/Component/ClassLoader/CHANGELOG.md b/src/Symfony/Component/ClassLoader/CHANGELOG.md
index 64ef8d9c9bcfa..1753ce6c3de46 100644
--- a/src/Symfony/Component/ClassLoader/CHANGELOG.md
+++ b/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
-----
diff --git a/src/Symfony/Component/ClassLoader/Tests/ApcClassLoaderTest.php b/src/Symfony/Component/ClassLoader/Tests/ApcClassLoaderTest.php
index e96ba954087c0..e1b84f6115754 100644
--- a/src/Symfony/Component/ClassLoader/Tests/ApcClassLoaderTest.php
+++ b/src/Symfony/Component/ClassLoader/Tests/ApcClassLoaderTest.php
@@ -14,6 +14,9 @@
use Symfony\Component\ClassLoader\ApcClassLoader;
use Symfony\Component\ClassLoader\ClassLoader;
+/**
+ * @group legacy
+ */
class ApcClassLoaderTest extends \PHPUnit_Framework_TestCase
{
protected function setUp()
diff --git a/src/Symfony/Component/ClassLoader/WinCacheClassLoader.php b/src/Symfony/Component/ClassLoader/WinCacheClassLoader.php
index b95a1d79873ac..76b13d39a4d84 100644
--- a/src/Symfony/Component/ClassLoader/WinCacheClassLoader.php
+++ b/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 @@
* @author Fabien Potencier
* @author Kris Wallsmith
* @author Artem Ryzhkov
+ *
+ * @deprecated since version 3.3, to be removed in 4.0. Use `composer install --apcu-autoloader` instead.
*/
class WinCacheClassLoader
{
diff --git a/src/Symfony/Component/ClassLoader/XcacheClassLoader.php b/src/Symfony/Component/ClassLoader/XcacheClassLoader.php
index bf309a6924d79..d3ea09b2c0bdf 100644
--- a/src/Symfony/Component/ClassLoader/XcacheClassLoader.php
+++ b/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 @@
* @author Fabien Potencier
* @author Kris Wallsmith
* @author Kim Hemsø Rasmussen
+ *
+ * @deprecated since version 3.3, to be removed in 4.0. Use `composer install --apcu-autoloader` instead.
*/
class XcacheClassLoader
{