vendor/symfony/cache/LockRegistry.php line 113

Open in your IDE?
  1. <?php
  2. /*
  3.  * This file is part of the Symfony package.
  4.  *
  5.  * (c) Fabien Potencier <fabien@symfony.com>
  6.  *
  7.  * For the full copyright and license information, please view the LICENSE
  8.  * file that was distributed with this source code.
  9.  */
  10. namespace Symfony\Component\Cache;
  11. use Psr\Log\LoggerInterface;
  12. use Symfony\Contracts\Cache\CacheInterface;
  13. use Symfony\Contracts\Cache\ItemInterface;
  14. /**
  15.  * LockRegistry is used internally by existing adapters to protect against cache stampede.
  16.  *
  17.  * It does so by wrapping the computation of items in a pool of locks.
  18.  * Foreach each apps, there can be at most 20 concurrent processes that
  19.  * compute items at the same time and only one per cache-key.
  20.  *
  21.  * @author Nicolas Grekas <p@tchwork.com>
  22.  */
  23. final class LockRegistry
  24. {
  25.     private static $openedFiles = [];
  26.     private static $lockedFiles;
  27.     private static $signalingException;
  28.     private static $signalingCallback;
  29.     /**
  30.      * The number of items in this list controls the max number of concurrent processes.
  31.      */
  32.     private static $files = [
  33.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'AbstractAdapter.php',
  34.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'AbstractTagAwareAdapter.php',
  35.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'AdapterInterface.php',
  36.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ApcuAdapter.php',
  37.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ArrayAdapter.php',
  38.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ChainAdapter.php',
  39.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'CouchbaseBucketAdapter.php',
  40.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'CouchbaseCollectionAdapter.php',
  41.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'DoctrineAdapter.php',
  42.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'DoctrineDbalAdapter.php',
  43.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'FilesystemAdapter.php',
  44.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'FilesystemTagAwareAdapter.php',
  45.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'MemcachedAdapter.php',
  46.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'NullAdapter.php',
  47.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ParameterNormalizer.php',
  48.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'PdoAdapter.php',
  49.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'PhpArrayAdapter.php',
  50.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'PhpFilesAdapter.php',
  51.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ProxyAdapter.php',
  52.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'Psr16Adapter.php',
  53.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'RedisAdapter.php',
  54.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'RedisTagAwareAdapter.php',
  55.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'TagAwareAdapter.php',
  56.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'TagAwareAdapterInterface.php',
  57.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'TraceableAdapter.php',
  58.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'TraceableTagAwareAdapter.php',
  59.     ];
  60.     /**
  61.      * Defines a set of existing files that will be used as keys to acquire locks.
  62.      *
  63.      * @return array The previously defined set of files
  64.      */
  65.     public static function setFiles(array $files): array
  66.     {
  67.         $previousFiles self::$files;
  68.         self::$files $files;
  69.         foreach (self::$openedFiles as $file) {
  70.             if ($file) {
  71.                 flock($file\LOCK_UN);
  72.                 fclose($file);
  73.             }
  74.         }
  75.         self::$openedFiles self::$lockedFiles = [];
  76.         return $previousFiles;
  77.     }
  78.     public static function compute(callable $callbackItemInterface $itembool &$saveCacheInterface $pool\Closure $setMetadata nullLoggerInterface $logger null)
  79.     {
  80.         if ('\\' === \DIRECTORY_SEPARATOR && null === self::$lockedFiles) {
  81.             // disable locking on Windows by default
  82.             self::$files self::$lockedFiles = [];
  83.         }
  84.         $key self::$files abs(crc32($item->getKey())) % \count(self::$files) : -1;
  85.         if ($key || self::$lockedFiles || !$lock self::open($key)) {
  86.             return $callback($item$save);
  87.         }
  88.         self::$signalingException ?? self::$signalingException unserialize("O:9:\"Exception\":1:{s:16:\"\0Exception\0trace\";a:0:{}}");
  89.         self::$signalingCallback ?? self::$signalingCallback = function () { throw self::$signalingException; };
  90.         while (true) {
  91.             try {
  92.                 $locked false;
  93.                 // race to get the lock in non-blocking mode
  94.                 $locked flock($lock\LOCK_EX \LOCK_NB$wouldBlock);
  95.                 if ($locked || !$wouldBlock) {
  96.                     $logger && $logger->info(sprintf('Lock %s, now computing item "{key}"'$locked 'acquired' 'not supported'), ['key' => $item->getKey()]);
  97.                     self::$lockedFiles[$key] = true;
  98.                     $value $callback($item$save);
  99.                     if ($save) {
  100.                         if ($setMetadata) {
  101.                             $setMetadata($item);
  102.                         }
  103.                         $pool->save($item->set($value));
  104.                         $save false;
  105.                     }
  106.                     return $value;
  107.                 }
  108.                 // if we failed the race, retry locking in blocking mode to wait for the winner
  109.                 $logger && $logger->info('Item "{key}" is locked, waiting for it to be released', ['key' => $item->getKey()]);
  110.                 flock($lock\LOCK_SH);
  111.             } finally {
  112.                 flock($lock\LOCK_UN);
  113.                 unset(self::$lockedFiles[$key]);
  114.             }
  115.             try {
  116.                 $value $pool->get($item->getKey(), self::$signalingCallback0);
  117.                 $logger && $logger->info('Item "{key}" retrieved after lock was released', ['key' => $item->getKey()]);
  118.                 $save false;
  119.                 return $value;
  120.             } catch (\Exception $e) {
  121.                 if (self::$signalingException !== $e) {
  122.                     throw $e;
  123.                 }
  124.                 $logger && $logger->info('Item "{key}" not found while lock was released, now retrying', ['key' => $item->getKey()]);
  125.             }
  126.         }
  127.         return null;
  128.     }
  129.     private static function open(int $key)
  130.     {
  131.         if (null !== $h self::$openedFiles[$key] ?? null) {
  132.             return $h;
  133.         }
  134.         set_error_handler(function () {});
  135.         try {
  136.             $h fopen(self::$files[$key], 'r+');
  137.         } finally {
  138.             restore_error_handler();
  139.         }
  140.         return self::$openedFiles[$key] = $h ?: @fopen(self::$files[$key], 'r');
  141.     }
  142. }