0 follower

CFileHelper

Package system.utils
Inheritance class CFileHelper
Since 1.0
Version $Id$
Source Code framework/utils/CFileHelper.php
CFileHelper provides a set of helper methods for common file system operations.

Public Methods

Hide inherited methods

MethodDescriptionDefined By
copyDirectory() Copies a directory recursively as another. CFileHelper
findFiles() Returns the files found under the specified directory and subdirectories. CFileHelper
getMimeType() Determines the MIME type of the specified file. CFileHelper
getMimeTypeByExtension() Determines the MIME type based on the extension name of the specified file. CFileHelper

Protected Methods

Hide inherited methods

MethodDescriptionDefined By
copyDirectoryRecursive() Copies a directory. CFileHelper
findFilesRecursive() Returns the files found under the specified directory and subdirectories. CFileHelper
validatePath() Validates a file or directory. CFileHelper

Method Details

copyDirectory() method
public static void copyDirectory(string $src, string $dst, array $options=array ( ))
$src string the source directory
$dst string the destination directory
$options array options for directory copy. Valid options are:
  • fileTypes: array, list of file name suffix (without dot). Only files with these suffixes will be copied.
  • exclude: array, list of directory and file exclusions. Each exclusion can be either a name or a path. If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude file or directory '$src/a/b'.
  • level: integer, recursion depth, default=-1. Level -1 means copying all directories and files under the directory; Level 0 means copying only the files DIRECTLY under the directory; level N means copying those directories that are within N levels.
Source Code: framework/utils/CFileHelper.php#40 (show)
public static function copyDirectory($src,$dst,$options=array())
{
    
$fileTypes=array();
    
$exclude=array();
    
$level=-1;
    
extract($options);
    
self::copyDirectoryRecursive($src,$dst,'',$fileTypes,$exclude,$level);
}

Copies a directory recursively as another. If the destination directory does not exist, it will be created.

copyDirectoryRecursive() method
protected static void copyDirectoryRecursive(string $src, string $dst, string $base, array $fileTypes, array $exclude, integer $level)
$src string the source directory
$dst string the destination directory
$base string the path relative to the original source directory
$fileTypes array list of file name suffix (without dot). Only files with these suffixes will be copied.
$exclude array list of directory and file exclusions. Each exclusion can be either a name or a path. If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude file or directory '$src/a/b'.
$level integer recursion depth. It defaults to -1. Level -1 means copying all directories and files under the directory; Level 0 means copying only the files DIRECTLY under the directory; level N means copying those directories that are within N levels.
Source Code: framework/utils/CFileHelper.php#94 (show)
protected static function copyDirectoryRecursive($src,$dst,$base,$fileTypes,$exclude,$level)
{
    @
mkdir($dst);
    @
chmod($dst,0777);
    
$folder=opendir($src);
    while((
$file=readdir($folder))!==false)
    {
        if(
$file==='.' || $file==='..')
            continue;
        
$path=$src.DIRECTORY_SEPARATOR.$file;
        
$isFile=is_file($path);
        if(
self::validatePath($base,$file,$isFile,$fileTypes,$exclude))
        {
            if(
$isFile)
                
copy($path,$dst.DIRECTORY_SEPARATOR.$file);
            else if(
$level)
                
self::copyDirectoryRecursive($path,$dst.DIRECTORY_SEPARATOR.$file,$base.'/'.$file,$fileTypes,$exclude,$level-1);
        }
    }
    
closedir($folder);
}

Copies a directory. This method is mainly used by copyDirectory.

findFiles() method
public static array findFiles(string $dir, array $options=array ( ))
$dir string the directory under which the files will be looked for
$options array options for file searching. Valid options are:
  • fileTypes: array, list of file name suffix (without dot). Only files with these suffixes will be returned.
  • exclude: array, list of directory and file exclusions. Each exclusion can be either a name or a path. If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude file or directory '$src/a/b'.
  • level: integer, recursion depth, default=-1. Level -1 means searching for all directories and files under the directory; Level 0 means searching for only the files DIRECTLY under the directory; level N means searching for those directories that are within N levels.
{return} array files found under the directory. The file list is sorted.
Source Code: framework/utils/CFileHelper.php#67 (show)
public static function findFiles($dir,$options=array())
{
    
$fileTypes=array();
    
$exclude=array();
    
$level=-1;
    
extract($options);
    
$list=self::findFilesRecursive($dir,'',$fileTypes,$exclude,$level);
    
sort($list);
    return 
$list;
}

Returns the files found under the specified directory and subdirectories.

findFilesRecursive() method
protected static array findFilesRecursive(string $dir, string $base, array $fileTypes, array $exclude, integer $level)
$dir string the source directory
$base string the path relative to the original source directory
$fileTypes array list of file name suffix (without dot). Only files with these suffixes will be returned.
$exclude array list of directory and file exclusions. Each exclusion can be either a name or a path. If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude file or directory '$src/a/b'.
$level integer recursion depth. It defaults to -1. Level -1 means searching for all directories and files under the directory; Level 0 means searching for only the files DIRECTLY under the directory; level N means searching for those directories that are within N levels.
{return} array files found under the directory.
Source Code: framework/utils/CFileHelper.php#132 (show)
protected static function findFilesRecursive($dir,$base,$fileTypes,$exclude,$level)
{
    
$list=array();
    
$handle=opendir($dir);
    while((
$file=readdir($handle))!==false)
    {
        if(
$file==='.' || $file==='..')
            continue;
        
$path=$dir.DIRECTORY_SEPARATOR.$file;
        
$isFile=is_file($path);
        if(
self::validatePath($base,$file,$isFile,$fileTypes,$exclude))
        {
            if(
$isFile)
                
$list[]=$path;
            else if(
$level)
                
$list=array_merge($list,self::findFilesRecursive($path,$base.'/'.$file,$fileTypes,$exclude,$level-1));
        }
    }
    
closedir($handle);
    return 
$list;
}

Returns the files found under the specified directory and subdirectories. This method is mainly used by findFiles.

getMimeType() method
public static string getMimeType(string $file)
$file string the file name.
{return} string the MIME type. Null is returned if the MIME type cannot be determined.
Source Code: framework/utils/CFileHelper.php#195 (show)
public static function getMimeType($file)
{
    if(
function_exists('finfo_open'))
    {
        if((
$info=finfo_open(FILEINFO_MIME)) && ($result=finfo_file($info,$file))!==false)
            return 
$result;
    }

    if(
function_exists('mime_content_type') && ($result=mime_content_type($file))!==false)
        return 
$result;

    return 
self::getMimeTypeByExtension($file);
}

Determines the MIME type of the specified file. This method will attempt the following approaches in order:

  1. finfo
  2. mime_content_type
  3. getMimeTypeByExtension

getMimeTypeByExtension() method
public static string getMimeTypeByExtension(string $file)
$file string the file name.
{return} string the MIME type. Null is returned if the MIME type cannot be determined.
Source Code: framework/utils/CFileHelper.php#215 (show)
public static function getMimeTypeByExtension($file)
{
    static 
$extensions;
    if(
$extensions===null)
        
$extensions=require(Yii::getPathOfAlias('system.utils.mimeTypes').'.php');
    if((
$pos=strrpos($file,'.'))!==false)
    {
        
$ext=strtolower(substr($file,$pos+1));
        if(isset(
$extensions[$ext]))
            return 
$extensions[$ext];
    }
    return 
null;
}

Determines the MIME type based on the extension name of the specified file. This method will use a local map between extension name and MIME type.

validatePath() method
protected static boolean validatePath(string $base, string $file, boolean $isFile, array $fileTypes, array $exclude)
$base string the path relative to the original source directory
$file string the file or directory name
$isFile boolean whether this is a file
$fileTypes array list of file name suffix (without dot). Only files with these suffixes will be copied.
$exclude array list of directory and file exclusions. Each exclusion can be either a name or a path. If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude file or directory '$src/a/b'.
{return} boolean whether the file or directory is valid
Source Code: framework/utils/CFileHelper.php#166 (show)
protected static function validatePath($base,$file,$isFile,$fileTypes,$exclude)
{
    foreach(
$exclude as $e)
    {
        if(
$file===$e || strpos($base.'/'.$file,$e)===0)
            return 
false;
    }
    if(!
$isFile || empty($fileTypes))
        return 
true;
    if((
$pos=strrpos($file,'.'))!==false)
    {
        
$type=substr($file,$pos+1);
        return 
in_array($type,$fileTypes);
    }
    else
        return 
false;
}

Validates a file or directory.