|
1
|
|
|
<?php |
|
2
|
|
|
/* |
|
3
|
|
|
* This file is part of the Koded package. |
|
4
|
|
|
* |
|
5
|
|
|
* (c) Mihail Binev <[email protected]> |
|
6
|
|
|
* |
|
7
|
|
|
* Please view the LICENSE distributed with this source code |
|
8
|
|
|
* for the full copyright and license information. |
|
9
|
|
|
*/ |
|
10
|
|
|
|
|
11
|
|
|
namespace Koded\Caching\Client; |
|
12
|
|
|
|
|
13
|
|
|
use Exception; |
|
14
|
|
|
use Koded\Caching\{Cache, CacheException}; |
|
15
|
|
|
use Memcached; |
|
16
|
|
|
use Koded\Caching\Configuration\{MemcachedConfiguration, PredisConfiguration, RedisConfiguration}; |
|
17
|
|
|
use Koded\Stdlib\{Configuration, Serializer}; |
|
18
|
|
|
use Koded\Stdlib\Serializer\SerializerFactory; |
|
19
|
|
|
use Psr\Log\{LoggerInterface, NullLogger}; |
|
20
|
|
|
use Redis; |
|
21
|
|
|
use Throwable; |
|
22
|
|
|
use function error_log; |
|
23
|
|
|
use function getenv; |
|
24
|
|
|
use function sprintf; |
|
25
|
|
|
use function strtolower; |
|
26
|
|
|
|
|
27
|
|
|
final class ClientFactory |
|
28
|
|
|
{ |
|
29
|
|
|
public const CACHE_CLIENT = 'CACHE_CLIENT'; |
|
30
|
|
|
|
|
31
|
|
|
public function __construct(private Configuration $factory) {} |
|
32
|
|
|
|
|
33
|
|
|
/** |
|
34
|
|
|
* Create an instance of specific cache client. |
|
35
|
|
|
* |
|
36
|
|
|
* @param string $client The required cache client |
|
37
|
|
|
* (memcached, redis, predis, shmop, file, memory) |
|
38
|
|
|
* |
|
39
|
|
|
* @return Cache An instance of the cache client |
|
40
|
|
|
* @throws CacheException |
|
41
|
|
|
* @throws Exception |
|
42
|
|
|
*/ |
|
43
|
560 |
|
public function new(string $client = ''): Cache |
|
44
|
|
|
{ |
|
45
|
560 |
|
$client = strtolower($client ?: getenv(self::CACHE_CLIENT) ?: 'memory'); |
|
46
|
560 |
|
$config = $this->factory->build($client); |
|
47
|
|
|
|
|
48
|
560 |
|
return match ($client) { |
|
49
|
560 |
|
'memory' => new MemoryClient($config->get('ttl')), |
|
50
|
560 |
|
'memcached' => $this->createMemcachedClient($config), |
|
51
|
560 |
|
'redis' => $this->createRedisClient($config), |
|
52
|
560 |
|
'predis' => $this->createPredisClient($config), |
|
53
|
560 |
|
'shmop' => new ShmopClient((string)$config->get('dir'), $config->get('ttl')), |
|
54
|
560 |
|
'file' => new FileClient($this->getLogger($config), (string)$config->get('dir'), $config->get('ttl')), |
|
55
|
560 |
|
default => throw CacheException::forUnsupportedClient($client) |
|
56
|
560 |
|
}; |
|
57
|
|
|
} |
|
58
|
|
|
|
|
59
|
70 |
|
private function createMemcachedClient(MemcachedConfiguration|Configuration $conf): Cache |
|
60
|
|
|
{ |
|
61
|
70 |
|
$client = new Memcached($conf->get('id')); |
|
62
|
70 |
|
$client->setOptions($conf->getOptions()); |
|
63
|
70 |
|
if (empty($client->getServerList())) { |
|
64
|
70 |
|
$client->addServers($conf->getServers()); |
|
65
|
|
|
} |
|
66
|
70 |
|
return new MemcachedClient($client, $conf->getTtl()); |
|
67
|
|
|
} |
|
68
|
|
|
|
|
69
|
155 |
|
private function createRedisClient(RedisConfiguration|Configuration $conf): Cache |
|
70
|
|
|
{ |
|
71
|
155 |
|
$serializer = $conf->get('serializer'); |
|
72
|
155 |
|
$binary = $conf->get('binary'); |
|
73
|
155 |
|
if (Serializer::JSON === $serializer && $binary) { |
|
74
|
71 |
|
return new RedisJsonClient( |
|
75
|
71 |
|
$this->newRedisClient($conf), |
|
76
|
71 |
|
SerializerFactory::new((string)$binary, ...$conf->get('options', [0])), |
|
77
|
71 |
|
(int)$conf->get('options'), |
|
78
|
71 |
|
$conf->get('ttl') |
|
79
|
71 |
|
); |
|
80
|
|
|
} |
|
81
|
84 |
|
return new RedisClient( |
|
82
|
84 |
|
$this->newRedisClient($conf), |
|
83
|
84 |
|
SerializerFactory::new($serializer, ...$conf->get('options', [0])), |
|
84
|
84 |
|
$conf->get('ttl') |
|
85
|
84 |
|
); |
|
86
|
|
|
} |
|
87
|
|
|
|
|
88
|
135 |
|
private function createPredisClient(PredisConfiguration|Configuration $conf): Cache |
|
89
|
|
|
{ |
|
90
|
135 |
|
$binary = $conf->get('binary'); |
|
91
|
135 |
|
if (Serializer::JSON === $conf->get('serializer') && $binary) { |
|
92
|
71 |
|
return new PredisJsonClient( |
|
93
|
71 |
|
$this->newPredisClient($conf), |
|
94
|
71 |
|
SerializerFactory::new((string)$binary, ...$conf->get('options', [0])), |
|
95
|
71 |
|
(int)$conf->get('options'), |
|
96
|
71 |
|
$conf->get('ttl') |
|
97
|
71 |
|
); |
|
98
|
|
|
} |
|
99
|
64 |
|
return new PredisClient( |
|
100
|
64 |
|
$this->newPredisClient($conf), |
|
101
|
64 |
|
SerializerFactory::new($conf->get('serializer'), ...$conf->get('options', [0])), |
|
102
|
64 |
|
$conf->get('ttl') |
|
103
|
64 |
|
); |
|
104
|
|
|
} |
|
105
|
|
|
|
|
106
|
155 |
|
private function newRedisClient(RedisConfiguration $conf): Redis |
|
107
|
|
|
{ |
|
108
|
155 |
|
$client = new Redis; |
|
109
|
|
|
try { |
|
110
|
155 |
|
@$client->connect(...$conf->getConnectionParams()); |
|
|
|
|
|
|
111
|
154 |
|
$client->setOption(Redis::OPT_SERIALIZER, $conf->get('type')); |
|
112
|
154 |
|
$client->setOption(Redis::OPT_PREFIX, $conf->get('prefix')); |
|
113
|
153 |
|
$client->select((int)$conf->get('db')); |
|
114
|
153 |
|
if ($auth = $conf->get('auth')) { |
|
115
|
1 |
|
$client->auth($auth); |
|
116
|
|
|
} |
|
117
|
152 |
|
if ($message = $client->getLastError()) { |
|
118
|
|
|
// [NOTE] Redis module complains if auth is set, |
|
119
|
|
|
// but <Redis v5 or less> does not have auth |
|
120
|
|
|
throw new Exception($message); |
|
121
|
|
|
} |
|
122
|
152 |
|
return $client; |
|
123
|
|
|
|
|
124
|
|
|
} /** @noinspection PhpRedundantCatchClauseInspection */ |
|
125
|
3 |
|
catch (Throwable $e) { |
|
126
|
3 |
|
error_log(sprintf(PHP_EOL . '[Redis] %s: %s', $e::class, $e->getMessage())); |
|
127
|
3 |
|
error_log('[Redis] with conf: ' . $conf->delete('auth')->toJSON()); |
|
128
|
3 |
|
throw CacheException::withConnectionErrorFor('Redis'); |
|
129
|
|
|
} |
|
130
|
|
|
} |
|
131
|
|
|
|
|
132
|
135 |
|
private function newPredisClient(PredisConfiguration $conf): \Predis\Client |
|
133
|
|
|
{ |
|
134
|
135 |
|
$client = new \Predis\Client($conf->getConnectionParams(), $conf->getOptions()); |
|
135
|
|
|
|
|
136
|
|
|
try { |
|
137
|
135 |
|
$client->connect(); |
|
138
|
134 |
|
$client->select((int)$conf->get('db')); |
|
139
|
134 |
|
if ($auth = $conf->get('auth')) { |
|
140
|
1 |
|
$client->auth($auth); |
|
141
|
|
|
} |
|
142
|
133 |
|
return $client; |
|
143
|
|
|
|
|
144
|
|
|
} /** @noinspection PhpRedundantCatchClauseInspection */ |
|
145
|
2 |
|
catch (Throwable $e) { |
|
146
|
2 |
|
error_log(sprintf(PHP_EOL . '[Predis] %s: %s', $e::class, $e->getMessage())); |
|
147
|
2 |
|
error_log('[Predis] with conf: ' . $conf->delete('auth')->toJSON()); |
|
148
|
2 |
|
throw CacheException::withConnectionErrorFor('Predis'); |
|
149
|
|
|
} |
|
150
|
|
|
} |
|
151
|
|
|
|
|
152
|
63 |
|
private function getLogger(Configuration $conf): LoggerInterface |
|
153
|
|
|
{ |
|
154
|
63 |
|
$logger = $conf->logger ?? new NullLogger; |
|
|
|
|
|
|
155
|
63 |
|
if ($logger instanceof LoggerInterface) { |
|
156
|
62 |
|
return $logger; |
|
157
|
|
|
} |
|
158
|
1 |
|
throw CacheException::forUnsupportedLogger(LoggerInterface::class, $logger::class); |
|
159
|
|
|
} |
|
160
|
|
|
} |
|
161
|
|
|
|