tourze/doctrine-cache-bundle

Doctrine Cache Bundle

1.0.0 2025-11-01 16:08 UTC

Requires

• ext-pcre: *
• ext-reflection: *
• ext-spl: *
• doctrine/common: ^3.5
• doctrine/dbal: ^4.0
• doctrine/doctrine-bundle: ^2.13
• doctrine/orm: ^3.0
• monolog/monolog: ^3.1
• psr/log: ^3|^2|^1
• symfony/cache-contracts: ^3
• symfony/config: ^7.3
• symfony/dependency-injection: ^7.3
• symfony/doctrine-bridge: ^7.3
• symfony/framework-bundle: ^7.3
• symfony/http-kernel: ^7.3
• symfony/property-access: ^7.3
• symfony/yaml: ^7.3
• tourze/backtrace-helper: 1.*
• tourze/bundle-dependency: 1.*
• tourze/cache-strategy: 1.0.*
• tourze/doctrine-helper: 1.0.*
• tourze/symfony-dependency-service-loader: 1.*

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5
• tourze/phpunit-symfony-kernel-test: 1.0.*
• tourze/phpunit-symfony-unit-test: 1.*

MIT

README

[] (https://packagist.org/packages/tourze/doctrine-cache-bundle) [] (https://packagist.org/packages/tourze/doctrine-cache-bundle) [] (https://github.com/tourze/php-monorepo/blob/main/packages/doctrine-cache-bundle/LICENSE) [] (https://github.com/tourze/php-monorepo/actions) [] (https://codecov.io/gh/tourze/php-monorepo)

English | 中文

A Symfony bundle that provides caching capabilities for Doctrine ORM, with automatic cache invalidation based on entity changes.

Features

• Automatic cache invalidation based on entity lifecycle events (insert, update, delete)
• Tag-based cache invalidation strategy for better cache control
• Cache strategy pattern allows for flexible cache behavior customization
• Seamless integration with Symfony and Doctrine
• Compatible with PSR-6 cache implementations

Requirements

• PHP 8.1+
• Symfony 6.4+
• Doctrine ORM 2.20+ or 3.0+

Installation

composer require tourze/doctrine-cache-bundle

Quick Start

1. Register the bundle in your config/bundles.php:

<?php

return [
    // ... other bundles
    Tourze\DoctrineCacheBundle\DoctrineCacheBundle::class => ['all' => true],
];

2. Basic usage example:

The bundle automatically listens to Doctrine entity lifecycle events and invalidates related cache tags when entities are changed:

<?php

namespace App\Controller;

use App\Entity\Post;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\Cache\Adapter\TagAwareAdapterInterface;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class PostController extends AbstractController
{
    #[Route('/posts', name: 'app_posts')]
    public function index(
        EntityManagerInterface $entityManager,
        TagAwareAdapterInterface $cache
    ): Response {
        // Get posts from cache or database
        $cacheKey = 'all_posts';
        $cacheItem = $cache->getItem($cacheKey);
        
        if (!$cacheItem->isHit()) {
            $posts = $entityManager->getRepository(Post::class)->findAll();
            $cacheItem->set($posts);
            
            // Tag the cache with the entity class name
            $cacheItem->tag(['App_Entity_Post']);
            $cache->save($cacheItem);
        } else {
            $posts = $cacheItem->get();
        }
        
        return $this->render('post/index.html.twig', [
            'posts' => $posts,
        ]);
    }
}

When a Post entity is updated, the bundle will automatically invalidate the cache with the tagged name.

Configuration

No specific configuration is needed for basic functionality. The bundle automatically registers the required services.

Advanced Usage

Custom Cache Strategies

If you want to implement custom cache strategies, you can create your own strategy class:

<?php

namespace App\Cache\Strategy;

use Tourze\CacheStrategy\CacheStrategy;

class CustomCacheStrategy implements CacheStrategy
{
    public function shouldCache(string $query, array $params): bool
    {
        // Your logic to determine if a query should be cached
        return true; // or false
    }
}

Register your strategy as a service with the appropriate tag:

# config/services.yaml
services:
    App\Cache\Strategy\CustomCacheStrategy:
        tags: ['doctrine.cache.entity_cache_strategy']

Environment Variables

You can control cache behavior using environment variables:

• DOCTRINE_CACHE_TABLE_SWITCH: Enable/disable caching (default: true)
• DOCTRINE_GLOBAL_CACHE_TABLE_DURATION: Default cache duration in seconds (default: 86400)
• DOCTRINE_CACHE_TABLE_DURATION_{table_name}: Cache duration for specific tables

Cache Tag Naming

The bundle automatically generates cache tags based on table names extracted from SQL queries. Common SQL operations (SELECT, INSERT, UPDATE, DELETE) are automatically detected and appropriate cache tags are generated.

Best Practices

• Use specific cache tags to minimize invalidation scope
• Be mindful of complex entity relationships when using cache invalidation
• For high-performance applications, consider implementing custom cache strategies

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This bundle is released under the MIT License. See the LICENSE file for details.