Add disclaimer in documentation about opcache

[maktouch]

Me again! :)

Not a bug this time, just maybe add a disclaimer in the docs. There's a nasty situation (It's not a bug!) with symlink and opcache.

This is the issue -> zendtech/ZendOptimizerPlus#126 (comment)

This is the resolution, straight from The Rasmus
zendtech/ZendOptimizerPlus#126 (comment)

Since rocketeer is a deployment aimed for PHP, using symlinks, might be nice to add that to the docs.

Cheers!

[Anahkiasen]

I'm not sure I fully grasp what the issue is, what would you write in the docs for someone looking for an issue ?

[maktouch]

PHP5.5 has opcache built-in.

The Opcache is supposed to invalidate when the script has changed, but it has issue when the script is in a symlinked folder and called from the webserver.

Basically, opcache "thinks" that the script is /var/www/hello/current/public/index

while in reality, it's /var/www/hello/releases/20140101011/public/index

There's an easy fix for nginx (by just changing a config), but no easy fix for apache.

I'd write something like..

Possibles issues

• When I deploy; my old scripts are running instead of the new, but the deployment was successful.

If you have opcache enabled, it might not work properly. See this github issue (link).

[Anahkiasen]

Added a troubleshooting page.