diff --git a/debug/debugging.rst b/debug/debugging.rst index 2bb3a585830..a633ef7872c 100644 --- a/debug/debugging.rst +++ b/debug/debugging.rst @@ -14,53 +14,6 @@ configuration is optimized for two main purposes: * Be as similar as possible as the production environment to avoid problems when deploying the project. -Disabling the Bootstrap File and Class Caching ----------------------------------------------- - -And to make the production environment as fast as possible, Symfony creates -big PHP files in your cache containing the aggregation of PHP classes your -project needs for every request. However, this behavior can confuse your debugger, -because the same class can be located in two different places: the original class -file and the big file which aggregates lots of classes. - -This recipe shows you how you can tweak this caching mechanism to make it friendlier -when you need to debug code that involves Symfony classes. - -The ``app_dev.php`` front controller reads as follows by default:: - - // ... - - $loader = require __DIR__.'/../app/autoload.php'; - Debug::enable(); - - $kernel = new AppKernel('dev', true); - $kernel->loadClassCache(); - $request = Request::createFromGlobals(); - // ... - -To make your debugger happier, disable the loading of all PHP class caches -by removing the call to ``loadClassCache()``:: - - // ... - - $loader = require_once __DIR__.'/../app/autoload.php'; - Debug::enable(); - - $kernel = new AppKernel('dev', true); - // $kernel->loadClassCache(); - $request = Request::createFromGlobals(); - -.. tip:: - - If you disable the PHP caches, don't forget to revert after your debugging - session. - -Some IDEs do not like the fact that some classes are stored in different -locations. To avoid problems, you can either tell your IDE to ignore the PHP -cache files, or you can change the extension used by Symfony for these files:: - - $kernel->loadClassCache('classes', '.php.cache'); - Useful Debugging Commands -------------------------