vendor/symfony/cache/LockRegistry.php line 85

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.     /**
  28.      * The number of items in this list controls the max number of concurrent processes.
  29.      */
  30.     private static $files = [
  31.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'AbstractAdapter.php',
  32.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'AbstractTagAwareAdapter.php',
  33.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'AdapterInterface.php',
  34.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ApcuAdapter.php',
  35.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ArrayAdapter.php',
  36.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ChainAdapter.php',
  37.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'CouchbaseBucketAdapter.php',
  38.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'CouchbaseCollectionAdapter.php',
  39.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'DoctrineAdapter.php',
  40.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'DoctrineDbalAdapter.php',
  41.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'FilesystemAdapter.php',
  42.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'FilesystemTagAwareAdapter.php',
  43.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'MemcachedAdapter.php',
  44.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'NullAdapter.php',
  45.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ParameterNormalizer.php',
  46.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'PdoAdapter.php',
  47.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'PhpArrayAdapter.php',
  48.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'PhpFilesAdapter.php',
  49.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'ProxyAdapter.php',
  50.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'Psr16Adapter.php',
  51.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'RedisAdapter.php',
  52.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'RedisTagAwareAdapter.php',
  53.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'TagAwareAdapter.php',
  54.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'TagAwareAdapterInterface.php',
  55.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'TraceableAdapter.php',
  56.         __DIR__.\DIRECTORY_SEPARATOR.'Adapter'.\DIRECTORY_SEPARATOR.'TraceableTagAwareAdapter.php',
  57.     ];
  58.     /**
  59.      * Defines a set of existing files that will be used as keys to acquire locks.
  60.      *
  61.      * @return array The previously defined set of files
  62.      */
  63.     public static function setFiles(array $files): array
  64.     {
  65.         $previousFiles self::$files;
  66.         self::$files $files;
  67.         foreach (self::$openedFiles as $file) {
  68.             if ($file) {
  69.                 flock($file\LOCK_UN);
  70.                 fclose($file);
  71.             }
  72.         }
  73.         self::$openedFiles self::$lockedFiles = [];
  74.         return $previousFiles;
  75.     }
  76.     public static function compute(callable $callbackItemInterface $itembool &$saveCacheInterface $pool\Closure $setMetadata nullLoggerInterface $logger null)
  77.     {
  78.         if ('\\' === \DIRECTORY_SEPARATOR && null === self::$lockedFiles) {
  79.             // disable locking on Windows by default
  80.             self::$files self::$lockedFiles = [];
  81.         }
  82.         $key self::$files abs(crc32($item->getKey())) % \count(self::$files) : -1;
  83.         if ($key || self::$lockedFiles || !$lock self::open($key)) {
  84.             return $callback($item$save);
  85.         }
  86.         while (true) {
  87.             try {
  88.                 $locked false;
  89.                 // race to get the lock in non-blocking mode
  90.                 $locked flock($lock\LOCK_EX \LOCK_NB$wouldBlock);
  91.                 if ($locked || !$wouldBlock) {
  92.                     $logger && $logger->info(sprintf('Lock %s, now computing item "{key}"'$locked 'acquired' 'not supported'), ['key' => $item->getKey()]);
  93.                     self::$lockedFiles[$key] = true;
  94.                     $value $callback($item$save);
  95.                     if ($save) {
  96.                         if ($setMetadata) {
  97.                             $setMetadata($item);
  98.                         }
  99.                         $pool->save($item->set($value));
  100.                         $save false;
  101.                     }
  102.                     return $value;
  103.                 }
  104.                 // if we failed the race, retry locking in blocking mode to wait for the winner
  105.                 $logger && $logger->info('Item "{key}" is locked, waiting for it to be released', ['key' => $item->getKey()]);
  106.                 flock($lock\LOCK_SH);
  107.             } finally {
  108.                 flock($lock\LOCK_UN);
  109.                 unset(self::$lockedFiles[$key]);
  110.             }
  111.             static $signalingException$signalingCallback;
  112.             $signalingException $signalingException ?? unserialize("O:9:\"Exception\":1:{s:16:\"\0Exception\0trace\";a:0:{}}");
  113.             $signalingCallback $signalingCallback ?? function () use ($signalingException) { throw $signalingException; };
  114.             try {
  115.                 $value $pool->get($item->getKey(), $signalingCallback0);
  116.                 $logger && $logger->info('Item "{key}" retrieved after lock was released', ['key' => $item->getKey()]);
  117.                 $save false;
  118.                 return $value;
  119.             } catch (\Exception $e) {
  120.                 if ($signalingException !== $e) {
  121.                     throw $e;
  122.                 }
  123.                 $logger && $logger->info('Item "{key}" not found while lock was released, now retrying', ['key' => $item->getKey()]);
  124.             }
  125.         }
  126.         return null;
  127.     }
  128.     private static function open(int $key)
  129.     {
  130.         if (null !== $h self::$openedFiles[$key] ?? null) {
  131.             return $h;
  132.         }
  133.         set_error_handler(function () {});
  134.         try {
  135.             $h fopen(self::$files[$key], 'r+');
  136.         } finally {
  137.             restore_error_handler();
  138.         }
  139.         return self::$openedFiles[$key] = $h ?: @fopen(self::$files[$key], 'r');
  140.     }
  141. }