1 | <?php |
||||
2 | /** |
||||
3 | * This file is part of the O2System Framework package. |
||||
4 | * |
||||
5 | * For the full copyright and license information, please view the LICENSE |
||||
6 | * file that was distributed with this source code. |
||||
7 | * |
||||
8 | * @author Steeve Andrian Salim |
||||
9 | * @copyright Copyright (c) Steeve Andrian Salim |
||||
10 | */ |
||||
11 | |||||
12 | // ------------------------------------------------------------------------ |
||||
13 | |||||
14 | namespace O2System\Filesystem; |
||||
15 | |||||
16 | // ------------------------------------------------------------------------ |
||||
17 | |||||
18 | use O2System\Spl\Info\SplFileInfo; |
||||
19 | |||||
20 | /** |
||||
21 | * Class File |
||||
22 | * |
||||
23 | * @package O2System\Filesystem |
||||
24 | */ |
||||
25 | class File extends SplFileInfo |
||||
26 | { |
||||
27 | /** |
||||
28 | * File::$filePath |
||||
29 | * |
||||
30 | * Path of File |
||||
31 | * @var String |
||||
32 | */ |
||||
33 | private $filePath; |
||||
34 | |||||
35 | // ------------------------------------------------------------------------ |
||||
36 | |||||
37 | /** |
||||
38 | * File::__construct |
||||
39 | * |
||||
40 | * @param string|null $filePath |
||||
41 | */ |
||||
42 | public function __construct($filePath = null) |
||||
43 | { |
||||
44 | if (isset($filePath)) { |
||||
45 | $this->filePath = $filePath; |
||||
46 | parent::__construct($filePath); |
||||
47 | } |
||||
48 | } |
||||
49 | |||||
50 | // ------------------------------------------------------------------------ |
||||
51 | |||||
52 | /** |
||||
53 | * File::setGroup |
||||
54 | * |
||||
55 | * Attempts to change the group of the file filename to group. |
||||
56 | * |
||||
57 | * Only the superuser may change the group of a file arbitrarily; other users may change the group of a file to any |
||||
58 | * group of which that user is a member. |
||||
59 | * |
||||
60 | * @param mixed $group A group name or number. |
||||
61 | * |
||||
62 | * @return bool Returns TRUE on success or FALSE on failure. |
||||
63 | */ |
||||
64 | public function setGroup($group) |
||||
65 | { |
||||
66 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
![]() |
|||||
67 | $params[] = $group; |
||||
68 | |||||
69 | return call_user_func_array('chgrp', $params); |
||||
70 | } |
||||
71 | |||||
72 | // ------------------------------------------------------------------------ |
||||
73 | |||||
74 | /** |
||||
75 | * File::setMode |
||||
76 | * |
||||
77 | * Attempts to change the mode of the specified file to that given in mode. |
||||
78 | * |
||||
79 | * @param int $mode The mode parameter consists of three octal number components specifying access restrictions for |
||||
80 | * the owner, the user group in which the owner is in, and to everybody else in this order. One |
||||
81 | * component can be computed by adding up the needed permissions for that target user base. Number |
||||
82 | * 1 means that you grant execute rights, number 2 means that you make the file writable, number |
||||
83 | * 4 means that you make the file readable. Add up these numbers to specify needed rights. You can |
||||
84 | * also read more about modes on Unix systems with 'man 1 chmod' and 'man 2 chmod'. |
||||
85 | * |
||||
86 | * @return bool Returns TRUE on success or FALSE on failure. |
||||
87 | */ |
||||
88 | public function setMode($mode) |
||||
89 | { |
||||
90 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
|
|||||
91 | $params[] = $mode; |
||||
92 | |||||
93 | return call_user_func_array('chmod', $params); |
||||
94 | } |
||||
95 | |||||
96 | // ------------------------------------------------------------------------ |
||||
97 | |||||
98 | /** |
||||
99 | * File::setOwner |
||||
100 | * |
||||
101 | * Attempts to change the owner of the file filename to user user. |
||||
102 | * Only the superuser may change the owner of a file. |
||||
103 | * |
||||
104 | * @param mixed $user A user name or number. |
||||
105 | * |
||||
106 | * @return bool Returns TRUE on success or FALSE on failure. |
||||
107 | */ |
||||
108 | public function setOwner($user) |
||||
109 | { |
||||
110 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
|
|||||
111 | $params[] = $user; |
||||
112 | |||||
113 | return call_user_func_array('chown', $params); |
||||
114 | } |
||||
115 | |||||
116 | // ------------------------------------------------------------------------ |
||||
117 | |||||
118 | /** |
||||
119 | * File::setLink |
||||
120 | * |
||||
121 | * Creates a symbolic link to the file with the specified name link. |
||||
122 | * |
||||
123 | * @param string $link The link name. |
||||
124 | * |
||||
125 | * @return bool Returns TRUE on success or FALSE on failure. |
||||
126 | */ |
||||
127 | public function setLink($link) |
||||
128 | { |
||||
129 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
|
|||||
130 | $params[] = $link; |
||||
131 | |||||
132 | return call_user_func_array('symlink', $params); |
||||
133 | } |
||||
134 | |||||
135 | // ------------------------------------------------------------------------ |
||||
136 | |||||
137 | /** |
||||
138 | * File::getContents |
||||
139 | * |
||||
140 | * Reads entire file into a string. |
||||
141 | * |
||||
142 | * @param bool $useIncludePath As of PHP 5 the FILE_USE_INCLUDE_PATH constant can be used to trigger include |
||||
143 | * path search. |
||||
144 | * |
||||
145 | * @param resource $context A valid context resource created with stream_context_create(). If you don't need |
||||
146 | * to use a custom context, you can skip this parameter by NULL. |
||||
147 | * |
||||
148 | * @param int $offset The offset where the reading starts on the original stream. Negative offsets |
||||
149 | * count from the end of the stream. Seeking (offset) is not supported with remote |
||||
150 | * files. Attempting to seek on non-local files may work with small offsets, but |
||||
151 | * this is unpredictable because it works on the buffered stream. |
||||
152 | * @param int $maxlen Maximum length of data read. The default is to read until end of file is |
||||
153 | * reached. Note that this parameter is applied to the stream processed by the |
||||
154 | * filters. |
||||
155 | * |
||||
156 | * @return string The function returns the read data or FALSE on failure. |
||||
157 | */ |
||||
158 | public function getContents($useIncludePath = false, $context = null, $offset = 0, $maxlen = 0) |
||||
159 | { |
||||
160 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
|
|||||
161 | $params[] = $useIncludePath; |
||||
162 | $params[] = $context; |
||||
163 | $params[] = $offset; |
||||
164 | |||||
165 | if ($maxlen > 0) { |
||||
166 | $params[] = $maxlen; |
||||
167 | } |
||||
168 | |||||
169 | return call_user_func_array('file_get_contents', $params); |
||||
170 | } |
||||
171 | |||||
172 | // ------------------------------------------------------------------------ |
||||
173 | |||||
174 | /** |
||||
175 | * File::touch |
||||
176 | * |
||||
177 | * @param int $time The touch time. If time is not supplied, the current system time is used. |
||||
178 | * @param int $atime If present, the access time of the given filename is set to the value of atime. Otherwise, it |
||||
179 | * is set to the value passed to the time parameter. If neither are present, the current system |
||||
180 | * time is used. |
||||
181 | * |
||||
182 | * @return bool Returns TRUE on success or FALSE on failure. |
||||
183 | */ |
||||
184 | public function touch($time = null, $atime = null) |
||||
185 | { |
||||
186 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
|
|||||
187 | $params[] = (isset($time) ? $time : time()); |
||||
188 | $params[] = (isset($atime) ? $atime : time()); |
||||
189 | |||||
190 | return call_user_func_array('touch', $params); |
||||
191 | } |
||||
192 | |||||
193 | // ------------------------------------------------------------------------ |
||||
194 | |||||
195 | /** |
||||
196 | * File::show |
||||
197 | * |
||||
198 | * Show file with header. |
||||
199 | * |
||||
200 | * @return void |
||||
201 | */ |
||||
202 | public function show() |
||||
203 | { |
||||
204 | if ($mime = $this->getMime()) { |
||||
205 | $mime = is_array($mime) ? $mime[ 0 ] : $mime; |
||||
206 | } elseif (is_file($this->getRealPath())) { |
||||
207 | $mime = 'application/octet-stream'; |
||||
208 | } |
||||
209 | |||||
210 | $fileSize = filesize($this->getRealPath()); |
||||
211 | $filename = pathinfo($this->getRealPath(), PATHINFO_BASENAME); |
||||
212 | |||||
213 | // Common headers |
||||
214 | $expires = 604800; // (60*60*24*7) |
||||
215 | header('Expires:' . gmdate('D, d M Y H:i:s', time() + $expires) . ' GMT'); |
||||
216 | |||||
217 | header('Accept-Ranges: bytes', true); |
||||
218 | header("Cache-control: private", true); |
||||
219 | header('Pragma: private', true); |
||||
220 | |||||
221 | header('Content-Type: ' . $mime); |
||||
222 | header('Content-Disposition: inline; filename="' . $filename . '"'); |
||||
223 | header('Content-Transfer-Encoding: binary'); |
||||
224 | header('Accept-Ranges: bytes'); |
||||
225 | |||||
226 | $ETag = '"' . md5($filename) . '"'; |
||||
227 | |||||
228 | if ( ! empty($_SERVER[ 'HTTP_IF_NONE_MATCH' ]) |
||||
229 | && $_SERVER[ 'HTTP_IF_NONE_MATCH' ] == $ETag |
||||
230 | ) { |
||||
231 | header('HTTP/1.1 304 Not Modified'); |
||||
232 | header('Content-Length: ' . $fileSize); |
||||
233 | exit; |
||||
234 | } |
||||
235 | |||||
236 | $expires = 604800; // (60*60*24*7) |
||||
237 | header('ETag: ' . $ETag); |
||||
238 | header('Last-Modified: ' . gmdate('D, d M Y H:i:s', time()) . ' GMT'); |
||||
239 | header('Expires:' . gmdate('D, d M Y H:i:s', time() + $expires) . ' GMT'); |
||||
240 | |||||
241 | // Open file |
||||
242 | // @readfile($file_path); |
||||
243 | $file = @fopen($filename, "rb"); |
||||
244 | if ($file) { |
||||
245 | while ( ! feof($file)) { |
||||
246 | print(fread($file, 1024 * 8)); |
||||
247 | flush(); |
||||
248 | if (connection_status() != 0) { |
||||
249 | @fclose($file); |
||||
0 ignored issues
–
show
It seems like you do not handle an error condition for
fclose() . This can introduce security issues, and is generally not recommended.
(
Ignorable by Annotation
)
If this is a false-positive, you can also ignore this issue in your code via the
If you suppress an error, we recommend checking for the error condition explicitly: // For example instead of
@mkdir($dir);
// Better use
if (@mkdir($dir) === false) {
throw new \RuntimeException('The directory '.$dir.' could not be created.');
}
![]() |
|||||
250 | die(); |
||||
0 ignored issues
–
show
|
|||||
251 | } |
||||
252 | } |
||||
253 | @fclose($file); |
||||
254 | } |
||||
255 | } |
||||
256 | |||||
257 | // ------------------------------------------------------------------------ |
||||
258 | |||||
259 | /** |
||||
260 | * File::getMime |
||||
261 | * |
||||
262 | * Get mime info based on MIME config. |
||||
263 | * |
||||
264 | * @return bool|string|array |
||||
265 | */ |
||||
266 | public function getMime() |
||||
267 | { |
||||
268 | $mimes = $this->getMimes(); |
||||
269 | $ext = strtolower($this->getExtension()); |
||||
270 | |||||
271 | if (isset($mimes[ $ext ])) { |
||||
272 | return $mimes[ $ext ]; |
||||
273 | } |
||||
274 | |||||
275 | return false; |
||||
276 | } |
||||
277 | |||||
278 | // ------------------------------------------------------------------------ |
||||
279 | |||||
280 | /** |
||||
281 | * File::getMimes |
||||
282 | * |
||||
283 | * Get config mimes. |
||||
284 | * |
||||
285 | * @static |
||||
286 | * @return array Returns the MIME types array from config/mimes.php |
||||
287 | */ |
||||
288 | public static function getMimes() |
||||
289 | { |
||||
290 | static $mimes; |
||||
291 | |||||
292 | if (empty($mimes)) { |
||||
293 | if (file_exists(__DIR__ . '/Config/Mimes.php')) { |
||||
294 | $mimes = require(__DIR__ . '/Config/Mimes.php'); |
||||
295 | } |
||||
296 | } |
||||
297 | |||||
298 | return $mimes; |
||||
299 | } |
||||
300 | |||||
301 | // ------------------------------------------------------------------------ |
||||
302 | |||||
303 | /** |
||||
304 | * File::read |
||||
305 | * |
||||
306 | * Outputs a file. |
||||
307 | * |
||||
308 | * @param bool $useIncludePath You can use the optional second parameter and set it to TRUE, if you want to |
||||
309 | * search for the file in the include_path, too. |
||||
310 | * @param resource $context A context stream resource. |
||||
311 | * |
||||
312 | * @return int Returns the number of bytes read from the file. If an error occurs, FALSE is returned and unless |
||||
313 | * the function was called as @readfile(), an error message is printed. |
||||
314 | */ |
||||
315 | public function read($useIncludePath = false, $context = null) |
||||
316 | { |
||||
317 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
|
|||||
318 | $params[] = $useIncludePath; |
||||
319 | $params[] = $context; |
||||
320 | |||||
321 | return call_user_func_array('readfile', $params); |
||||
322 | } |
||||
323 | |||||
324 | // ------------------------------------------------------------------------ |
||||
325 | |||||
326 | /** |
||||
327 | * File::write |
||||
328 | * |
||||
329 | * Writes a file. |
||||
330 | * |
||||
331 | * @param string $contents File contents to write. |
||||
332 | * @param string $mode File handle mode. |
||||
333 | * |
||||
334 | * @return bool |
||||
335 | */ |
||||
336 | public function write($filePath, $contents, $mode = 'wb') |
||||
337 | { |
||||
338 | if (false !== ($fp = $this->create($filePath, $mode))) { |
||||
339 | flock($fp, LOCK_EX); |
||||
340 | |||||
341 | for ($result = $written = 0, $length = strlen($contents); $written < $length; $written += $result) { |
||||
342 | if (($result = fwrite($fp, substr($contents, $written))) === false) { |
||||
343 | break; |
||||
344 | } |
||||
345 | } |
||||
346 | |||||
347 | flock($fp, LOCK_UN); |
||||
348 | fclose($fp); |
||||
349 | |||||
350 | return is_int($result); |
||||
351 | } |
||||
352 | |||||
353 | return false; |
||||
354 | } |
||||
355 | |||||
356 | // ------------------------------------------------------------------------ |
||||
357 | |||||
358 | /** |
||||
359 | * File::create |
||||
360 | * |
||||
361 | * Create a File |
||||
362 | * |
||||
363 | * @param string|null $filePath |
||||
364 | * @param string $mode |
||||
365 | * |
||||
366 | * @return resource |
||||
367 | */ |
||||
368 | public function create($filePath = null, $mode = 'wb') |
||||
369 | { |
||||
370 | $filePath = isset($filePath) ? $filePath : $this->filePath; |
||||
371 | $dir = dirname($filePath); |
||||
372 | |||||
373 | if ( ! is_writable($dir)) { |
||||
374 | if ( ! file_exists($dir)) { |
||||
375 | mkdir($dir, 0777, true); |
||||
376 | } |
||||
377 | } |
||||
378 | |||||
379 | if ( ! $fp = @fopen($filePath, $mode)) { |
||||
380 | return false; |
||||
0 ignored issues
–
show
|
|||||
381 | } |
||||
382 | |||||
383 | parent::__construct($filePath); |
||||
384 | |||||
385 | return $fp; |
||||
386 | } |
||||
387 | |||||
388 | // ------------------------------------------------------------------------ |
||||
389 | |||||
390 | /** |
||||
391 | * File::rename |
||||
392 | * |
||||
393 | * Renames a file. |
||||
394 | * |
||||
395 | * @param string $newFilename The new filename. |
||||
396 | * @param null $context Context support was added with PHP 5.0.0. For a description of contexts, refer to |
||||
397 | * Streams. |
||||
398 | * |
||||
399 | * @return bool Returns TRUE on success or FALSE on failure. |
||||
400 | */ |
||||
401 | public function rename($newFilename, $context = null) |
||||
402 | { |
||||
403 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
|
|||||
404 | $params[] = dirname($this->getRealPath()) . DIRECTORY_SEPARATOR . $newFilename; |
||||
405 | $params[] = $context; |
||||
406 | |||||
407 | return call_user_func_array('rename', $params); |
||||
408 | } |
||||
409 | |||||
410 | // ------------------------------------------------------------------------ |
||||
411 | |||||
412 | /** |
||||
413 | * File::copy |
||||
414 | * |
||||
415 | * Makes a copy of the file source to destination. |
||||
416 | * |
||||
417 | * @param string $destination The destination path. If destination is a URL, the copy operation may fail if the |
||||
418 | * wrapper does not support overwriting of existing files. |
||||
419 | * @param resource $context A valid context resource created with stream_context_create(). |
||||
420 | * |
||||
421 | * @return bool Returns TRUE on success or FALSE on failure. |
||||
422 | */ |
||||
423 | public function copy($destination, $context = null) |
||||
424 | { |
||||
425 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
|
|||||
426 | $params[] = $destination; |
||||
427 | $params[] = $context; |
||||
428 | |||||
429 | return call_user_func_array('copy', $params); |
||||
430 | } |
||||
431 | |||||
432 | // ------------------------------------------------------------------------ |
||||
433 | |||||
434 | /** |
||||
435 | * File::delete |
||||
436 | * |
||||
437 | * Deletes a file. |
||||
438 | * |
||||
439 | * @param resource $context Context support was added with PHP 5.0.0. For a description of contexts, refer to |
||||
440 | * Streams. |
||||
441 | * |
||||
442 | * @return bool Returns TRUE on success or FALSE on failure. |
||||
443 | */ |
||||
444 | public function delete($context = null) |
||||
445 | { |
||||
446 | $params[] = $this->getRealPath(); |
||||
0 ignored issues
–
show
Comprehensibility
Best Practice
introduced
by
|
|||||
447 | $params[] = $context; |
||||
448 | |||||
449 | return call_user_func_array('unlink', $params); |
||||
450 | } |
||||
451 | } |