AbstractAdapter.php 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210
  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\Adapter;
  11. use Psr\Log\LoggerAwareInterface;
  12. use Psr\Log\LoggerInterface;
  13. use Symfony\Component\Cache\CacheItem;
  14. use Symfony\Component\Cache\Exception\InvalidArgumentException;
  15. use Symfony\Component\Cache\ResettableInterface;
  16. use Symfony\Component\Cache\Traits\AbstractAdapterTrait;
  17. use Symfony\Component\Cache\Traits\ContractsTrait;
  18. use Symfony\Contracts\Cache\CacheInterface;
  19. /**
  20. * @author Nicolas Grekas <p@tchwork.com>
  21. */
  22. abstract class AbstractAdapter implements AdapterInterface, CacheInterface, LoggerAwareInterface, ResettableInterface
  23. {
  24. use AbstractAdapterTrait;
  25. use ContractsTrait;
  26. /**
  27. * @internal
  28. */
  29. protected const NS_SEPARATOR = ':';
  30. private static $apcuSupported;
  31. private static $phpFilesSupported;
  32. protected function __construct(string $namespace = '', int $defaultLifetime = 0)
  33. {
  34. $this->namespace = '' === $namespace ? '' : CacheItem::validateKey($namespace).static::NS_SEPARATOR;
  35. if (null !== $this->maxIdLength && \strlen($namespace) > $this->maxIdLength - 24) {
  36. throw new InvalidArgumentException(sprintf('Namespace must be %d chars max, %d given ("%s").', $this->maxIdLength - 24, \strlen($namespace), $namespace));
  37. }
  38. $this->createCacheItem = \Closure::bind(
  39. static function ($key, $value, $isHit) {
  40. $item = new CacheItem();
  41. $item->key = $key;
  42. $item->value = $v = $value;
  43. $item->isHit = $isHit;
  44. // Detect wrapped values that encode for their expiry and creation duration
  45. // For compactness, these values are packed in the key of an array using
  46. // magic numbers in the form 9D-..-..-..-..-00-..-..-..-5F
  47. if (\is_array($v) && 1 === \count($v) && 10 === \strlen($k = (string) array_key_first($v)) && "\x9D" === $k[0] && "\0" === $k[5] && "\x5F" === $k[9]) {
  48. $item->value = $v[$k];
  49. $v = unpack('Ve/Nc', substr($k, 1, -1));
  50. $item->metadata[CacheItem::METADATA_EXPIRY] = $v['e'] + CacheItem::METADATA_EXPIRY_OFFSET;
  51. $item->metadata[CacheItem::METADATA_CTIME] = $v['c'];
  52. }
  53. return $item;
  54. },
  55. null,
  56. CacheItem::class
  57. );
  58. $getId = \Closure::fromCallable([$this, 'getId']);
  59. $this->mergeByLifetime = \Closure::bind(
  60. static function ($deferred, $namespace, &$expiredIds) use ($getId, $defaultLifetime) {
  61. $byLifetime = [];
  62. $now = microtime(true);
  63. $expiredIds = [];
  64. foreach ($deferred as $key => $item) {
  65. $key = (string) $key;
  66. if (null === $item->expiry) {
  67. $ttl = 0 < $defaultLifetime ? $defaultLifetime : 0;
  68. } elseif (!$item->expiry) {
  69. $ttl = 0;
  70. } elseif (0 >= $ttl = (int) (0.1 + $item->expiry - $now)) {
  71. $expiredIds[] = $getId($key);
  72. continue;
  73. }
  74. if (isset(($metadata = $item->newMetadata)[CacheItem::METADATA_TAGS])) {
  75. unset($metadata[CacheItem::METADATA_TAGS]);
  76. }
  77. // For compactness, expiry and creation duration are packed in the key of an array, using magic numbers as separators
  78. $byLifetime[$ttl][$getId($key)] = $metadata ? ["\x9D".pack('VN', (int) (0.1 + $metadata[self::METADATA_EXPIRY] - self::METADATA_EXPIRY_OFFSET), $metadata[self::METADATA_CTIME])."\x5F" => $item->value] : $item->value;
  79. }
  80. return $byLifetime;
  81. },
  82. null,
  83. CacheItem::class
  84. );
  85. }
  86. /**
  87. * Returns the best possible adapter that your runtime supports.
  88. *
  89. * Using ApcuAdapter makes system caches compatible with read-only filesystems.
  90. *
  91. * @param string $namespace
  92. * @param int $defaultLifetime
  93. * @param string $version
  94. * @param string $directory
  95. *
  96. * @return AdapterInterface
  97. */
  98. public static function createSystemCache($namespace, $defaultLifetime, $version, $directory, LoggerInterface $logger = null)
  99. {
  100. $opcache = new PhpFilesAdapter($namespace, $defaultLifetime, $directory, true);
  101. if (null !== $logger) {
  102. $opcache->setLogger($logger);
  103. }
  104. if (!self::$apcuSupported = self::$apcuSupported ?? ApcuAdapter::isSupported()) {
  105. return $opcache;
  106. }
  107. if (\in_array(\PHP_SAPI, ['cli', 'phpdbg'], true) && !filter_var(\ini_get('apc.enable_cli'), \FILTER_VALIDATE_BOOLEAN)) {
  108. return $opcache;
  109. }
  110. $apcu = new ApcuAdapter($namespace, intdiv($defaultLifetime, 5), $version);
  111. if (null !== $logger) {
  112. $apcu->setLogger($logger);
  113. }
  114. return new ChainAdapter([$apcu, $opcache]);
  115. }
  116. public static function createConnection($dsn, array $options = [])
  117. {
  118. if (!\is_string($dsn)) {
  119. throw new InvalidArgumentException(sprintf('The "%s()" method expect argument #1 to be string, "%s" given.', __METHOD__, \gettype($dsn)));
  120. }
  121. if (str_starts_with($dsn, 'redis:') || str_starts_with($dsn, 'rediss:')) {
  122. return RedisAdapter::createConnection($dsn, $options);
  123. }
  124. if (str_starts_with($dsn, 'memcached:')) {
  125. return MemcachedAdapter::createConnection($dsn, $options);
  126. }
  127. throw new InvalidArgumentException(sprintf('Unsupported DSN: "%s".', $dsn));
  128. }
  129. /**
  130. * {@inheritdoc}
  131. *
  132. * @return bool
  133. */
  134. public function commit()
  135. {
  136. $ok = true;
  137. $byLifetime = $this->mergeByLifetime;
  138. $byLifetime = $byLifetime($this->deferred, $this->namespace, $expiredIds);
  139. $retry = $this->deferred = [];
  140. if ($expiredIds) {
  141. try {
  142. $this->doDelete($expiredIds);
  143. } catch (\Exception $e) {
  144. $ok = false;
  145. CacheItem::log($this->logger, 'Failed to delete expired items: '.$e->getMessage(), ['exception' => $e, 'cache-adapter' => get_debug_type($this)]);
  146. }
  147. }
  148. foreach ($byLifetime as $lifetime => $values) {
  149. try {
  150. $e = $this->doSave($values, $lifetime);
  151. } catch (\Exception $e) {
  152. }
  153. if (true === $e || [] === $e) {
  154. continue;
  155. }
  156. if (\is_array($e) || 1 === \count($values)) {
  157. foreach (\is_array($e) ? $e : array_keys($values) as $id) {
  158. $ok = false;
  159. $v = $values[$id];
  160. $type = \is_object($v) ? \get_class($v) : \gettype($v);
  161. $message = sprintf('Failed to save key "{key}" of type %s%s', $type, $e instanceof \Exception ? ': '.$e->getMessage() : '.');
  162. CacheItem::log($this->logger, $message, ['key' => substr($id, \strlen($this->namespace)), 'exception' => $e instanceof \Exception ? $e : null]);
  163. }
  164. } else {
  165. foreach ($values as $id => $v) {
  166. $retry[$lifetime][] = $id;
  167. }
  168. }
  169. }
  170. // When bulk-save failed, retry each item individually
  171. foreach ($retry as $lifetime => $ids) {
  172. foreach ($ids as $id) {
  173. try {
  174. $v = $byLifetime[$lifetime][$id];
  175. $e = $this->doSave([$id => $v], $lifetime);
  176. } catch (\Exception $e) {
  177. }
  178. if (true === $e || [] === $e) {
  179. continue;
  180. }
  181. $ok = false;
  182. $type = \is_object($v) ? \get_class($v) : \gettype($v);
  183. $message = sprintf('Failed to save key "{key}" of type %s%s', $type, $e instanceof \Exception ? ': '.$e->getMessage() : '.');
  184. CacheItem::log($this->logger, $message, ['key' => substr($id, \strlen($this->namespace)), 'exception' => $e instanceof \Exception ? $e : null]);
  185. }
  186. }
  187. return $ok;
  188. }
  189. }