ILIAS  release_5-3 Revision v5.3.23-19-g915713cf615
Serializer.php
Go to the documentation of this file.
1<?php
2
4{
5
11 public function add($def, $config)
12 {
13 if (!$this->checkDefType($def)) {
14 return;
15 }
17 if (file_exists($file)) {
18 return false;
19 }
20 if (!$this->_prepareDir($config)) {
21 return false;
22 }
23 return $this->_write($file, serialize($def), $config);
24 }
25
31 public function set($def, $config)
32 {
33 if (!$this->checkDefType($def)) {
34 return;
35 }
37 if (!$this->_prepareDir($config)) {
38 return false;
39 }
40 return $this->_write($file, serialize($def), $config);
41 }
42
48 public function replace($def, $config)
49 {
50 if (!$this->checkDefType($def)) {
51 return;
52 }
54 if (!file_exists($file)) {
55 return false;
56 }
57 if (!$this->_prepareDir($config)) {
58 return false;
59 }
60 return $this->_write($file, serialize($def), $config);
61 }
62
67 public function get($config)
68 {
70 if (!file_exists($file)) {
71 return false;
72 }
73 return unserialize(file_get_contents($file));
74 }
75
80 public function remove($config)
81 {
83 if (!file_exists($file)) {
84 return false;
85 }
86 return unlink($file);
87 }
88
93 public function flush($config)
94 {
95 if (!$this->_prepareDir($config)) {
96 return false;
97 }
98 $dir = $this->generateDirectoryPath($config);
99 $dh = opendir($dir);
100 // Apparently, on some versions of PHP, readdir will return
101 // an empty string if you pass an invalid argument to readdir.
102 // So you need this test. See #49.
103 if (false === $dh) {
104 return false;
105 }
106 while (false !== ($filename = readdir($dh))) {
107 if (empty($filename)) {
108 continue;
109 }
110 if ($filename[0] === '.') {
111 continue;
112 }
113 unlink($dir . '/' . $filename);
114 }
115 closedir($dh);
116 return true;
117 }
118
123 public function cleanup($config)
124 {
125 if (!$this->_prepareDir($config)) {
126 return false;
127 }
128 $dir = $this->generateDirectoryPath($config);
129 $dh = opendir($dir);
130 // See #49 (and above).
131 if (false === $dh) {
132 return false;
133 }
134 while (false !== ($filename = readdir($dh))) {
135 if (empty($filename)) {
136 continue;
137 }
138 if ($filename[0] === '.') {
139 continue;
140 }
141 $key = substr($filename, 0, strlen($filename) - 4);
142 if ($this->isOld($key, $config)) {
143 unlink($dir . '/' . $filename);
144 }
145 }
146 closedir($dh);
147 return true;
148 }
149
157 public function generateFilePath($config)
158 {
159 $key = $this->generateKey($config);
160 return $this->generateDirectoryPath($config) . '/' . $key . '.ser';
161 }
162
171 {
173 return $base . '/' . $this->type;
174 }
175
184 {
185 $base = $config->get('Cache.SerializerPath');
186 $base = is_null($base) ? HTMLPURIFIER_PREFIX . '/HTMLPurifier/DefinitionCache/Serializer' : $base;
187 return $base;
188 }
189
197 private function _write($file, $data, $config)
198 {
199 $result = file_put_contents($file, $data);
200 if ($result !== false) {
201 // set permissions of the new file (no execute)
202 $chmod = $config->get('Cache.SerializerPermissions');
203 if ($chmod !== null) {
204 chmod($file, $chmod & 0666);
205 }
206 }
207 return $result;
208 }
209
215 private function _prepareDir($config)
216 {
217 $directory = $this->generateDirectoryPath($config);
218 $chmod = $config->get('Cache.SerializerPermissions');
219 if ($chmod === null) {
220 // TODO: This races
221 if (is_dir($directory)) return true;
222 return mkdir($directory);
223 }
224 if (!is_dir($directory)) {
226 if (!is_dir($base)) {
227 trigger_error(
228 'Base directory ' . $base . ' does not exist,
229 please create or change using %Cache.SerializerPath',
230 E_USER_WARNING
231 );
232 return false;
233 } elseif (!$this->_testPermissions($base, $chmod)) {
234 return false;
235 }
236 if (!mkdir($directory, $chmod)) {
237 trigger_error(
238 'Could not create directory ' . $directory . '',
239 E_USER_WARNING
240 );
241 return false;
242 }
243 if (!$this->_testPermissions($directory, $chmod)) {
244 return false;
245 }
246 } elseif (!$this->_testPermissions($directory, $chmod)) {
247 return false;
248 }
249 return true;
250 }
251
259 private function _testPermissions($dir, $chmod)
260 {
261 // early abort, if it is writable, everything is hunky-dory
262 if (is_writable($dir)) {
263 return true;
264 }
265 if (!is_dir($dir)) {
266 // generally, you'll want to handle this beforehand
267 // so a more specific error message can be given
268 trigger_error(
269 'Directory ' . $dir . ' does not exist',
270 E_USER_WARNING
271 );
272 return false;
273 }
274 if (function_exists('posix_getuid') && $chmod !== null) {
275 // POSIX system, we can give more specific advice
276 if (fileowner($dir) === posix_getuid()) {
277 // we can chmod it ourselves
278 $chmod = $chmod | 0700;
279 if (chmod($dir, $chmod)) {
280 return true;
281 }
282 } elseif (filegroup($dir) === posix_getgid()) {
283 $chmod = $chmod | 0070;
284 } else {
285 // PHP's probably running as nobody, so we'll
286 // need to give global permissions
287 $chmod = $chmod | 0777;
288 }
289 trigger_error(
290 'Directory ' . $dir . ' not writable, ' .
291 'please chmod to ' . decoct($chmod),
292 E_USER_WARNING
293 );
294 } else {
295 // generic error message
296 trigger_error(
297 'Directory ' . $dir . ' not writable, ' .
298 'please alter file permissions',
299 E_USER_WARNING
300 );
301 }
302 return false;
303 }
304}
305
306// vim: et sw=4 sts=4
$result
An exception for terminatinating execution or to throw for unit testing.
generateDirectoryPath($config)
Generates the path to the directory contain this cache's serial files.
Definition: Serializer.php:170
_testPermissions($dir, $chmod)
Tests permissions on a directory and throws out friendly error messages and attempts to chmod it itse...
Definition: Serializer.php:259
_prepareDir($config)
Prepares the directory that this type stores the serials in.
Definition: Serializer.php:215
generateFilePath($config)
Generates the file path to the serial file corresponding to the configuration and definition name.
Definition: Serializer.php:157
generateBaseDirectoryPath($config)
Generates path to base directory that contains all definition type serials.
Definition: Serializer.php:183
_write($file, $data, $config)
Convenience wrapper function for file_put_contents.
Definition: Serializer.php:197
Abstract class representing Definition cache managers that implements useful common methods and is a ...
checkDefType($def)
Checks if a definition's type jives with the cache's type.
isOld($key, $config)
Tests whether or not a key is old with respect to the configuration's version and revision number.
generateKey($config)
Generates a unique identifier for a particular configuration.
$def
Definition: croninfo.php:21
$key
Definition: croninfo.php:18
$base
Definition: index.php:4
if(!file_exists("$old.txt")) if( $old===$new) if(file_exists("$new.txt")) $file