cakephp - why do some changes NOT happen until I switch debugging to 3?

Question

Sometime I will implement changes locally and they work fine, I copy them to my remote webserver and the changed are ignored. (The code is identical.)

I go into core.php, change debugging to 3, check again... it works!

I have a feeling it's something to do with cache but I don't know what exactly to change.

Answer 1

I think it is a client-side problem. Do you have the Web Developer addon for Firefox Mozilla installed? if yes, you can easily deactivate the cache on client side just to check.

It works again if you change the debugging level because then the urls and cookie data is probably slightly different leading to a fresh reload from server. If it still does not work then it must be the server side cache...

NOTE: Beside this you can do all kind of useful things for web development with that addon like modifying css on the fly or visualizing styles as overlay on the page.

Answer 2

It's definitely caching. On the server side if you have caching enabled, do not wonder if caching happens. You can turn this off in core.php, or more likely clear the cache Cache::clear() when you upgrade your app. On the client side you might want to tweak your browser to disable caching fully.

Answer 3

CakePHP has a cache located in /app/tmp/cache. The directory structure looks like this:

# /app/tmp/cache
# /app/tmp/cache/models
# /app/tmp/cache/persistent
# /app/tmp/cache/views

The main issue usually experienced is with the model cache. When debug is off (ie. in production) and you cause CakePHP to dispatch, it introspects the schema of all your database tables and stores these in flat files in the models folder above. If you do not delete the files in this folder, CakePHP will start to say models/tables/fields don't exist when they clearly do in your database.

If you enable view caching in your application, when views are rendered for the first time CakePHP will compile flat files to the views folder to prevent having to render these views again on the next request.

During CakePHP's bootstrap process it has to determine the directory structure you are using in your installation before it can access important files (like database.php). As such, CakePHP will generate cache files to the persistent directory with the absolute paths to each and every important directory and file, any plugins you are using and even any localisations you have created so it can quickly translate your application between languages without reparsing .pot files.

So, simply put, you have to remember to delete all of the files in these directories whenever you make code changes to an application that is in production, or add this as part of your deployment mechanism. You must not delete any of the directories however.

The reason changing debug to 3 works for you is because when debug mode is turned on (at any value greater zero) the cache is cleared and regenerated on every request, but - while this works - it is not easy to automate.

There are a number of ways to do this programmatically - including shell commands, CakePHP plugins, Capistrano configs, Ant files - but one can also just do so manually.