*/ /** * Contains methods for accessing file system * * @author NAVER (developers@xpressengine.com) */ class FileHandler { /** * Changes path of target file, directory into absolute path * * @param string $source path to change into absolute path * @return string Absolute path */ public static function getRealPath($source) { return (strncmp($source, './', 2) === 0) ? (\RX_BASEDIR . substr($source, 2)) : $source; } /** * Copy a directory to target * * If target directory does not exist, this function creates it * * @param string $source_dir Path of source directory * @param string $target_dir Path of target dir * @param string $filter Regex to filter files. If file matches this regex, the file is not copied. * @return void */ public static function copyDir($source_dir, $target_dir, $filter = null) { return Rhymix\Framework\Storage::copyDirectory(self::getRealPath($source_dir), self::getRealPath($target_dir), $filter); } /** * Copy a file to target * * @param string $source Path of source file * @param string $target Path of target file * @param string $force Y: overwrite * @return void */ public static function copyFile($source, $target, $force = 'Y') { setlocale(LC_CTYPE, 'en_US.UTF8', 'ko_KR.UTF8'); return Rhymix\Framework\Storage::copy(self::getRealPath($source), self::getRealPath($target)); } /** * Returns the content of the file * * @param string $filename Path of target file * @return string The content of the file. If target file does not exist, this function returns nothing. */ public static function readFile($filename) { return Rhymix\Framework\Storage::read(self::getRealPath($filename)); } /** * Write $buff into the specified file * * @param string $filename Path of target file * @param string $buff Content to be written * @param string $mode a(append) / w(write) * @return void */ public static function writeFile($filename, $buff, $mode = "w") { return Rhymix\Framework\Storage::write(self::getRealPath($filename), $buff, $mode); } /** * Remove a file * * @param string $filename path of target file * @return bool Returns TRUE on success or FALSE on failure. */ public static function removeFile($filename) { return Rhymix\Framework\Storage::delete(self::getRealPath($filename)); } /** * Rename a file * * In order to move a file, use this function. * * @param string $source Path of source file * @param string $target Path of target file * @return bool Returns TRUE on success or FALSE on failure. */ public static function rename($source, $target) { return Rhymix\Framework\Storage::move(self::getRealPath($source), self::getRealPath($target)); } /** * Move a file * * @param string $source Path of source file * @param string $target Path of target file * @return bool Returns TRUE on success or FALSE on failure. */ public static function moveFile($source, $target) { return Rhymix\Framework\Storage::move(self::getRealPath($source), self::getRealPath($target)); } /** * Move a directory * * This function just wraps rename function. * * @param string $source_dir Path of source directory * @param string $target_dir Path of target directory * @return void */ public static function moveDir($source_dir, $target_dir) { return Rhymix\Framework\Storage::move(self::getRealPath($source_dir), self::getRealPath($target_dir)); } /** * Return list of the files in the path * * The array does not contain files, such as '.', '..', and files starting with '.' * * @param string $path Path of target directory * @param string $filter If specified, return only files matching with the filter * @param bool $to_lower If TRUE, file names will be changed into lower case. * @param bool $concat_prefix If TRUE, return file name as absolute path * @return string[] Array of the filenames in the path */ public static function readDir($path, $filter = '', $to_lower = FALSE, $concat_prefix = FALSE) { $list = Rhymix\Framework\Storage::readDirectory(self::getRealPath($path), $concat_prefix, true, false); if (!$list) { return array(); } $output = array(); foreach ($list as $filename) { $filename = str_replace(array('/\\', '//'), '/', $filename); $basename = $concat_prefix ? basename($filename) : $filename; if ($basename[0] === '.' || ($filter && !preg_match($filter, $basename))) { continue; } if ($to_lower) { $filename = strtolower($filename); } if($filter) { $filename = preg_replace($filter, '$1', $filename); } $output[] = $filename; } return $output; } /** * Creates a directory * * This function creates directories recursively, which means that if ancestors of the target directory does not exist, they will be created too. * * @param string $path_string Path of target directory * @return bool TRUE if success. It might return nothing when ftp is used and connection to the ftp address failed. */ public static function makeDir($path_string) { if (!ini_get('safe_mode')) { $path = self::getRealPath($path_string); return Rhymix\Framework\Storage::isDirectory($path) || Rhymix\Framework\Storage::createDirectory($path); } // if safe_mode is on, use FTP else { static $oFtp = NULL; $ftp_info = Context::getFTPInfo(); if($oFtp == NULL) { if(!Context::isFTPRegisted()) { return; } $oFtp = new ftp(); if(!$ftp_info->ftp_host) { $ftp_info->ftp_host = "127.0.0.1"; } if(!$ftp_info->ftp_port) { $ftp_info->ftp_port = 21; } if(!$oFtp->ftp_connect($ftp_info->ftp_host, $ftp_info->ftp_port)) { return; } if(!$oFtp->ftp_login($ftp_info->ftp_user, $ftp_info->ftp_password)) { $oFtp->ftp_quit(); return; } } if(!($ftp_path = $ftp_info->ftp_root_path)) { $ftp_path = DIRECTORY_SEPARATOR; } $path_string = str_replace(_XE_PATH_, '', $path_string); $path_list = explode(DIRECTORY_SEPARATOR, $path_string); $path = _XE_PATH_; for($i = 0, $c = count($path_list); $i < $c; $i++) { if(!$path_list[$i]) { continue; } $path .= $path_list[$i] . DIRECTORY_SEPARATOR; $ftp_path .= $path_list[$i] . DIRECTORY_SEPARATOR; if(!is_dir($path)) { $oFtp->ftp_mkdir($ftp_path); $oFtp->ftp_site("CHMOD 777 " . $ftp_path); } } } return is_dir($path_string); } /** * Remove all files under the path * * @param string $path Path of the target directory * @return void */ public static function removeDir($path) { return Rhymix\Framework\Storage::deleteDirectory(self::getRealPath($path)); } /** * Remove a directory only if it is empty * * @param string $path Path of the target directory * @return void */ public static function removeBlankDir($path) { $path = self::getRealPath($path); if (Rhymix\Framework\Storage::isEmptyDirectory($path)) { return Rhymix\Framework\Storage::deleteDirectory($path); } else { return false; } } /** * Remove files in the target directory * * This function keeps the directory structure. * * @param string $path Path of the target directory * @return void */ public static function removeFilesInDir($path) { return Rhymix\Framework\Storage::deleteDirectory(self::getRealPath($path), false); } /** * Makes file size byte into KB, MB according to the size * * @see self::returnBytes() * @param int $size Number of the size * @return string File size string */ public static function filesize($size) { if(!$size) { return '0Byte'; } if($size === 1) { return '1Byte'; } if($size < 1024) { return $size . 'Bytes'; } if($size >= 1024 && $size < 1024 * 1024) { return sprintf("%0.1fKB", $size / 1024); } return sprintf("%0.2fMB", $size / (1024 * 1024)); } /** * Return remote file's content via HTTP * * @param string $url The address of the target file * @param string $body HTTP request body * @param int $timeout Connection timeout * @param string $method GET/POST * @param string $content_type Content type header of HTTP request * @param string[] $headers Headers key value array. * @param string[] $cookies Cookies key value array. * @param string $post_data Request arguments array for POST method * @return string If success, the content of the target file. Otherwise: none */ public static function getRemoteResource($url, $body = null, $timeout = 3, $method = 'GET', $content_type = null, $headers = array(), $cookies = array(), $post_data = array(), $request_config = array()) { try { $request_headers = array(); $request_cookies = array(); $request_options = array('timeout' => $timeout); foreach($headers as $key => $val) { $request_headers[$key] = $val; } if(isset($cookies[$host]) && is_array($cookies[$host])) { foreach($cookies[$host] as $key => $val) { $request_cookies[] = rawurlencode($key) . '=' . rawurlencode($val); } } if(count($request_cookies)) { $request_headers['Cookie'] = implode('; ', $request_cookies); } foreach($request_config as $key => $val) { $request_options[$key] = $val; } if($content_type) { $request_headers['Content-Type'] = $content_type; } $proxy = parse_url(__PROXY_SERVER__); if($proxy["host"]) { $request_options['proxy'] = array($proxy['host'] . ($proxy['port'] ? (':' . $proxy['port']) : '')); if($proxy['user'] && $proxy['pass']) { $request_options['proxy'][] = $proxy['user']; $request_options['proxy'][] = $proxy['pass']; } } $url = str_replace('&', '&', $url); $response = Requests::request($url, $request_headers, $body ?: $post_data, $method, $request_options); if(count($response->cookies)) { foreach($response->cookies as $cookie) { $cookies[$host][$cookie->name] = $cookie->value; } } if($response->success) { if (isset($request_config['filename'])) { return true; } else { return $response->body; } } else { return NULL; } } catch(Exception $e) { return NULL; } } /** * Retrieves remote file, then stores it into target path. * * @param string $url The address of the target file * @param string $target_filename The location to store * @param string $body HTTP request body * @param string $timeout Connection timeout * @param string $method GET/POST * @param string $content_type Content type header of HTTP request * @param string[] $headers Headers key value array. * @return bool TRUE: success, FALSE: failed */ public static function getRemoteFile($url, $target_filename, $body = null, $timeout = 3, $method = 'GET', $content_type = null, $headers = array(), $cookies = array(), $post_data = array(), $request_config = array()) { $request_config['filename'] = $target_filename; $success = self::getRemoteResource($url, $body, $timeout, $method, $content_type, $headers, $cookies, $post_data, $request_config); return $success ? true : false; } /** * Convert size in string into numeric value * * @see self::filesize() * @param $val Size in string (ex., 10, 10K, 10M, 10G ) * @return int converted size */ public static function returnBytes($val) { $unit = strtoupper(substr($val, -1)); $val = (float)$val; switch ($unit) { case 'G': $val *= 1024; case 'M': $val *= 1024; case 'K': $val *= 1024; } return round($val); } /** * Check available memory to load image file * * @param array $imageInfo Image info retrieved by getimagesize function * @return bool TRUE: it's ok, FALSE: otherwise */ public static function checkMemoryLoadImage(&$imageInfo) { $K64 = 65536; $TWEAKFACTOR = 2.0; $channels = $imageInfo['channels']; if(!$channels) { $channels = 6; //for png } $memoryNeeded = round(($imageInfo[0] * $imageInfo[1] * $imageInfo['bits'] * $channels / 8 + $K64 ) * $TWEAKFACTOR); $memoryLimit = self::returnBytes(ini_get('memory_limit')); if($memoryLimit < 0) { return true; } $availableMemory = $memoryLimit - memory_get_usage(); if($availableMemory < $memoryNeeded) { return false; } return false; } /** * Moves an image file (resizing is possible) * * @param string $source_file Path of the source file * @param string $target_file Path of the target file * @param int $resize_width Width to resize * @param int $resize_height Height to resize * @param string $target_type If $target_type is set (gif, jpg, png, bmp), result image will be saved as target type * @param string $thumbnail_type Thumbnail type(crop, ratio) * @return bool TRUE: success, FALSE: failed */ public static function createImageFile($source_file, $target_file, $resize_width = 0, $resize_height = 0, $target_type = '', $thumbnail_type = 'crop') { // check params if (($source_file = self::exists($source_file)) === FALSE) { return; } $target_file = self::getRealPath($target_file); if(!$resize_width) { $resize_width = 100; } if(!$resize_height) { $resize_height = $resize_width; } // retrieve source image's information $imageInfo = getimagesize($source_file); if(!self::checkMemoryLoadImage($imageInfo)) { return FALSE; } list($width, $height, $type, $attrs) = $imageInfo; if($width < 1 || $height < 1) { return; } switch($type) { case '1' : $type = 'gif'; break; case '2' : $type = 'jpg'; break; case '3' : $type = 'png'; break; case '6' : $type = 'bmp'; break; default : return; } if(!$target_type) { $target_type = $type; } $target_type = strtolower($target_type); // if original image is larger than specified size to resize, calculate the ratio $width_per = ($resize_width > 0 && $width >= $resize_width) ? $resize_width / $width : 1; $height_per = ($resize_height > 0 && $height >= $resize_height) ? $resize_height / $height : 1; $per = NULL; if($thumbnail_type == 'ratio') { $per = ($width_per > $height_per) ? $height_per : $width_per; $resize_width = $width * $per; $resize_height = $height * $per; } else { $per = ($width_per < $height_per) ? $height_per : $width_per; } // create temporary image with target size $thumb = NULL; if(function_exists('imagecreateTRUEcolor')) { $thumb = imagecreateTRUEcolor($resize_width, $resize_height); } else if(function_exists('imagecreate')) { $thumb = imagecreate($resize_width, $resize_height); } if(!$thumb) { return FALSE; } imagefilledrectangle($thumb, 0, 0, $resize_width - 1, $resize_height - 1, imagecolorallocate($thumb, 255, 255, 255)); // create temporary image having original type $source = NULL; switch($type) { case 'gif' : if(function_exists('imagecreatefromgif')) { $source = @imagecreatefromgif($source_file); } break; case 'jpeg' : case 'jpg' : if(function_exists('imagecreatefromjpeg')) { $source = @imagecreatefromjpeg($source_file); } break; case 'png' : if(function_exists('imagecreatefrompng')) { $source = @imagecreatefrompng($source_file); } break; case 'wbmp' : case 'bmp' : if(function_exists('imagecreatefromwbmp')) { $source = @imagecreatefromwbmp($source_file); } break; } if(!$source) { imagedestroy($thumb); return FALSE; } // resize original image and put it into temporary image $new_width = (int) ($width * $per); $new_height = (int) ($height * $per); $x = 0; $y = 0; if($thumbnail_type == 'crop') { $x = (int) ($resize_width / 2 - $new_width / 2); $y = (int) ($resize_height / 2 - $new_height / 2); } if(function_exists('imagecopyresampled')) { imagecopyresampled($thumb, $source, $x, $y, 0, 0, $new_width, $new_height, $width, $height); } else { imagecopyresized($thumb, $source, $x, $y, 0, 0, $new_width, $new_height, $width, $height); } // create directory self::makeDir(dirname($target_file)); // write into the file $output = NULL; switch($target_type) { case 'gif' : if(function_exists('imagegif')) { $output = imagegif($thumb, $target_file); } break; case 'jpeg' : case 'jpg' : if(function_exists('imagejpeg')) { $output = imagejpeg($thumb, $target_file, 100); } break; case 'png' : if(function_exists('imagepng')) { $output = imagepng($thumb, $target_file, 9); } break; case 'wbmp' : case 'bmp' : if(function_exists('imagewbmp')) { $output = imagewbmp($thumb, $target_file, 100); } break; } imagedestroy($thumb); imagedestroy($source); if(!$output) { return FALSE; } @chmod($target_file, 0644); return TRUE; } /** * Reads ini file, and puts result into array * * @see self::writeIniFile() * @param string $filename Path of the ini file * @return array ini array (if the target file does not exist, it returns FALSE) */ public static function readIniFile($filename) { if(!Rhymix\Framework\Storage::isReadable($filename)) { return false; } $arr = parse_ini_file($filename, true); return is_array($arr) ? $arr : array(); } /** * Write array into ini file * * $ini['key1'] = 'value1';
* $ini['key2'] = 'value2';
* $ini['section']['key1_in_section'] = 'value1_in_section';
* $ini['section']['key2_in_section'] = 'value2_in_section';
* self::writeIniFile('exmple.ini', $ini); * * @see self::readIniFile() * @param string $filename Target ini file name * @param array $arr Array * @return bool if array contains nothing it returns FALSE, otherwise TRUE */ public static function writeIniFile($filename, $arr) { if(!is_array($arr) || count($arr) == 0) { return FALSE; } self::writeFile($filename, self::_makeIniBuff($arr)); return TRUE; } /** * Make array to ini string * * @param array $arr Array * @return string */ public static function _makeIniBuff($arr) { $return = array(); foreach($arr as $key => $val) { // section if(is_array($val)) { $return[] = sprintf("[%s]", $key); foreach($val as $k => $v) { $return[] = sprintf("%s=\"%s\"", $k, $v); } // value } else if(is_object($val)) { continue; } else { $return[] = sprintf("%s=\"%s\"", $key, $val); } } return join("\n", $return); } /** * Returns a file object * * If the directory of the file does not exist, create it. * * @param string $filename Target file name * @param string $mode File mode for fopen * @return FileObject File object */ public static function openFile($filename, $mode) { $filename = self::getRealPath($filename); Rhymix\Framework\Storage::createDirectory(dirname($filename)); return new FileObject($filename, $mode); } /** * Check whether the given file has the content. * * @param string $filename Target file name * @return bool Returns TRUE if the file exists and contains something. */ public static function hasContent($filename) { return Rhymix\Framework\Storage::getSize(self::getRealPath($filename)) > 0; } /** * Check file exists. * * @param string $filename Target file name * @return bool Returns FALSE if the file does not exists, or Returns full path file(string). */ public static function exists($filename) { $filename = self::getRealPath($filename); return Rhymix\Framework\Storage::exists($filename) ? $filename : false; } /** * Check it is dir * * @param string $dir Target dir path * @return bool Returns FALSE if the dir is not dir, or Returns full path of dir(string). */ public static function isDir($path) { $path = self::getRealPath($path); return Rhymix\Framework\Storage::isDirectory($path) ? $path : false; } /** * Check is writable dir * * @param string $path Target dir path * @return bool */ public static function isWritableDir($path) { $path = self::getRealPath($path); return Rhymix\Framework\Storage::isDirectory($path) && Rhymix\Framework\Storage::isWritable($path); } } /* End of file FileHandler.class.php */ /* Location: ./classes/file/FileHandler.class.php */