lib/Phpfastcache/Drivers/Zendshm/Driver.php
<?php
/**
*
* This file is part of Phpfastcache.
*
* @license MIT License (MIT)
*
* For full copyright and license information, please see the docs/CREDITS.txt file.
*
* @author Lucas Brucksch <support@hammermaps.de>
*
*/
declare(strict_types=1);
namespace Phpfastcache\Drivers\Zendshm;
use Phpfastcache\Cluster\AggregatablePoolInterface;
use Phpfastcache\Core\Pool\ExtendedCacheItemPoolInterface;
use Phpfastcache\Core\Pool\TaggableCacheItemPoolTrait;
use Phpfastcache\Core\Item\ExtendedCacheItemInterface;
use Phpfastcache\Entities\DriverStatistic;
use Phpfastcache\Exceptions\PhpfastcacheInvalidArgumentException;
/**
* Requires Zend Data Cache Functions from ZendServer
* @method Config getConfig()
*/
class Driver implements AggregatablePoolInterface
{
use TaggableCacheItemPoolTrait;
/**
* @return bool
*/
public function driverCheck(): bool
{
return extension_loaded('Zend Data Cache') && function_exists('zend_shm_cache_store');
}
/**
* @return string
*/
public function getHelp(): string
{
return <<<HELP
<p>
This driver rely on Zend Server 8.5+, see: https://www.zend.com/products/zend-server
</p>
HELP;
}
/**
* @return DriverStatistic
*/
public function getStats(): DriverStatistic
{
$stats = (array)zend_shm_cache_info();
return (new DriverStatistic())
->setData(implode(', ', array_keys($this->itemInstances)))
->setInfo(sprintf("The Zend memory have %d item(s) in cache.\n For more information see RawData.", $stats['items_total']))
->setRawData($stats)
->setSize($stats['memory_total']);
}
/**
* @return bool
*/
protected function driverConnect(): bool
{
return true;
}
/**
* @param ExtendedCacheItemInterface $item
* @return ?array<string, mixed>
*/
protected function driverRead(ExtendedCacheItemInterface $item): ?array
{
$data = zend_shm_cache_fetch($item->getKey());
if (empty($data) || !\is_array($data)) {
return null;
}
return $data;
}
/**
* @param ExtendedCacheItemInterface $item
* @return mixed
* @throws PhpfastcacheInvalidArgumentException
*/
protected function driverWrite(ExtendedCacheItemInterface $item): bool
{
$ttl = $item->getExpirationDate()->getTimestamp() - time();
return zend_shm_cache_store($item->getKey(), $this->driverPreWrap($item), ($ttl > 0 ? $ttl : 0));
}
/**
* @param string $key
* @param string $encodedKey
* @return bool
*/
protected function driverDelete(string $key, string $encodedKey): bool
{
return (bool)zend_shm_cache_delete($key);
}
protected function driverClear(): bool
{
return @zend_shm_cache_clear();
}
}