TrackManiaControl/application/core/Files/FileUtil.php

200 lines
5.0 KiB
PHP
Raw Normal View History

<?php
2014-02-07 00:26:32 +01:00
namespace ManiaControl\Files;
use ManiaControl\Logger;
2014-05-15 13:04:05 +02:00
use ManiaControl\Utils\Formatter;
use ManiaControl\Utils\WebReader;
/**
* Files Utility Class
2014-05-02 17:40:47 +02:00
*
* @author ManiaControl Team <mail@maniacontrol.com>
* @copyright 2014 ManiaControl Team
* @license http://www.gnu.org/licenses/ GNU General Public License, Version 3
*/
2013-11-27 02:42:39 +01:00
abstract class FileUtil {
/**
2014-06-27 00:42:19 +02:00
* @deprecated
* @see \ManiaControl\Utils\WebReader::loadUrl()
*/
2014-06-27 00:42:19 +02:00
public static function loadFile($url) {
$response = WebReader::loadUrl($url);
return $response->getContent();
}
2014-01-06 14:22:48 +01:00
/**
* Load Config XML File
2014-05-02 17:40:47 +02:00
*
2014-01-06 14:22:48 +01:00
* @param string $fileName
* @return \SimpleXMLElement
*/
public static function loadConfig($fileName) {
2014-05-03 21:47:53 +02:00
$fileLocation = ManiaControlDir . 'configs' . DIRECTORY_SEPARATOR . $fileName;
if (!file_exists($fileLocation)) {
Logger::log("Config file doesn't exist! ({$fileName})");
return null;
}
if (!is_readable($fileLocation)) {
Logger::log("Config file isn't readable! Please check the file permissions. ({$fileName})");
return null;
}
2014-06-13 22:09:25 +02:00
$configXml = @simplexml_load_file($fileLocation);
if (!$configXml) {
Logger::log("Config file isn't maintained properly! ({$fileName})");
2014-06-13 22:09:25 +02:00
return null;
}
return $configXml;
}
2013-11-27 02:42:39 +01:00
/**
* Return file name cleared from special characters
2014-05-02 17:40:47 +02:00
*
2014-01-06 14:22:48 +01:00
* @param string $fileName
2013-11-27 02:42:39 +01:00
* @return string
*/
public static function getClearedFileName($fileName) {
2014-03-31 21:04:15 +02:00
$fileName = Formatter::stripCodes($fileName);
2014-05-24 21:53:07 +02:00
$fileName = str_replace(array(DIRECTORY_SEPARATOR, '\\', '/', ':', '*', '?', '"', '<', '>', '|'), '_', $fileName);
$fileName = preg_replace('/[^[:print:]]/', '', $fileName);
2014-06-23 15:51:39 +02:00
$fileName = Formatter::utf8($fileName);
2014-03-31 21:04:15 +02:00
return $fileName;
2013-11-27 02:42:39 +01:00
}
2014-05-02 17:40:47 +02:00
/**
2014-06-20 18:51:25 +02:00
* Delete the temporary folder if it's empty
2014-05-02 17:40:47 +02:00
*
* @return bool
*/
2014-06-20 18:51:25 +02:00
public static function deleteTempFolder() {
return self::deleteFolder(self::getTempFolder());
2014-05-02 17:40:47 +02:00
}
/**
2014-06-20 18:51:25 +02:00
* Delete the given folder if it's empty
*
* @param string $folderPath
* @param bool $onlyIfEmpty
* @return bool
*/
public static function deleteFolder($folderPath, $onlyIfEmpty = true) {
if ($onlyIfEmpty && !self::isFolderEmpty($folderPath)) {
return false;
}
return rmdir($folderPath);
}
/**
* Check if the given folder is empty
*
* @param string $folderPath
* @return bool
*/
public static function isFolderEmpty($folderPath) {
if (!is_readable($folderPath) || !is_dir($folderPath)) {
return false;
}
$files = scandir($folderPath);
return (count($files) <= 2);
}
/**
* Get the temporary folder and create it if necessary
2014-05-02 17:40:47 +02:00
*
* @return string|bool
*/
public static function getTempFolder() {
2014-05-24 21:49:38 +02:00
$tempFolder = ManiaControlDir . 'temp' . DIRECTORY_SEPARATOR;
if (!is_dir($tempFolder) && !mkdir($tempFolder)) {
trigger_error("Couldn't create the temp folder!");
return false;
}
if (!is_writeable($tempFolder)) {
trigger_error("ManiaControl doesn't have the necessary write rights for the temp folder!");
return false;
}
return $tempFolder;
}
/**
* Check if ManiaControl has sufficient Access to write to Files in the given Directories
2014-05-02 17:40:47 +02:00
*
* @param mixed $directories
* @return bool
*/
public static function checkWritePermissions($directories) {
if (!is_array($directories)) {
$directories = array($directories);
}
foreach ($directories as $directory) {
$dir = new \RecursiveDirectoryIterator(ManiaControlDir . $directory);
foreach (new \RecursiveIteratorIterator($dir) as $fileName => $file) {
if (substr($fileName, 0, 1) === '.') {
continue;
}
if (!is_writable($fileName)) {
Logger::log("Write access missing for file '{$fileName}'!");
return false;
}
}
}
return true;
}
2014-05-03 21:47:53 +02:00
/**
2014-06-20 16:51:08 +02:00
* Clean the given directory by deleting old files
*
2014-06-20 16:51:08 +02:00
* @param string $directory
* @param float $maxFileAgeInDays
* @param bool $recursive
* @return bool
*/
2014-06-20 16:51:08 +02:00
public static function cleanDirectory($directory, $maxFileAgeInDays = 10., $recursive = false) {
if (!is_dir($directory) || !is_readable($directory)) {
return false;
}
2014-06-20 16:51:08 +02:00
$dirHandle = opendir($directory);
if (!is_resource($dirHandle)) {
return false;
}
2014-06-20 18:51:25 +02:00
$directory = self::appendDirectorySeparator($directory);
$time = time();
while ($fileName = readdir($dirHandle)) {
2014-06-20 16:51:08 +02:00
$filePath = $directory . $fileName;
if (!is_readable($filePath)) {
continue;
}
2014-06-20 16:51:08 +02:00
if (is_dir($filePath) && $recursive) {
// Directory
self::cleanDirectory($filePath . DIRECTORY_SEPARATOR, $maxFileAgeInDays, $recursive);
} else if (is_file($filePath)) {
// File
if (!is_writable($filePath)) {
continue;
}
$fileModTime = filemtime($filePath);
$timeDeltaDays = ($time - $fileModTime) / (24. * 3600.);
if ($timeDeltaDays > $maxFileAgeInDays) {
unlink($filePath);
}
}
}
closedir($dirHandle);
return true;
}
2014-06-20 18:51:25 +02:00
/**
* Append the directory separator to the given path if necessary
*
* @param string $path
* @return string
*/
public static function appendDirectorySeparator($path) {
if (substr($path, -1, 1) !== DIRECTORY_SEPARATOR) {
$path .= DIRECTORY_SEPARATOR;
}
return $path;
}
}