In this section, we will cover how to setup the cache and the system for production environment.

Boot file

If the context is prefixed with prod-, the $app application object will be cached.

Cache drivers like ApcCache or FilesystemCache will be used in response to the environment automatically.

$context = 'prod-app';
require dirname(dirname(__DIR__)) . '/bootstrap/bootstrap.php';

Cache settings


In the default ProdModule of BEAR.Package, ApcCache is designed for one single web server.

For multiple servers, you need to set the shared cache storage. You can implement application specific src/Module/ProdModule.php.

namespace BEAR\HelloWorld\Module;

use BEAR\RepositoryModule\Annotation\Storage;
use BEAR\Package\Context\ProdModule as PackageProdModule;
use Doctrine\Common\Cache\Cache;
use Ray\Di\AbstractModule;
use Ray\Di\Scope;

use Doctrine\Common\Cache\ApcCache;

class ProdModule extends AbstractModule
     * {@inheritdoc}
    protected function configure()
        $cache = ApcCache::class;
        // shared cache
        // cache per server
        // install package ProdModule
        $this->install(new PackageProdModule);

Cache interface annotated with @Storage is defined for query repository and it is a shared storage for web servers.

We cannot use ApcCache on multiple servers, however, we have the options to use Redis or other storage by creating an adapter. (memcached is also available, but be careful about the capacity and volatility because it is stored in memory.)

HTTP Cache

The resource annotated with the @Cacheable, outputs an ETag entity tag.

By using this ETag, we can return a 304 (Not Modified) appropriate response when the resource is not modified.

(Therefore, we can save not only the cpu cost but also the network transfer cost.)


To use HttpCache in script, we are going to inject HttpCache using HttpCacheInject trait in App class.

namespace MyVendor\MyApi\Module;

use BEAR\QueryRepository\HttpCacheInject; // Add this line
use BEAR\Sunday\Extension\Application\AbstractApp;
use Ray\Di\Di\Inject;

class App extends AbstractApp
    use HttpCacheInject; // Add this line


Next, modify the route section in bootstrap/bootstrap.php to return a 304 when the contents are not modified by adding an if conditional statement.

route: {
    $app = (new Bootstrap)->getApp(__NAMESPACE__, $context);
    if ($app->httpCache->isNotModified($_SERVER)) {

ETag is also updated automatically, but you need to specify the relation of the resource caches using @Refresh and @Purge annotations.


Optimize performances by installing pecl extensions.

pecl install uri_template


composer show --platform
ext-uri_template    1.0      The uri_template PHP extension


Please refer to BEAR.Sunday Deployer.php support for deploying with Deployer.