首页 > 代码库 > PHP常用的文件操作函数集锦

PHP常用的文件操作函数集锦

以下是个人总结的PHP文件操作函数。当然,这只是部分,还有很多,我没有列出来。

一 、解析路径:

1 获得文件名:
basename();
给出一个包含有指向一个文件的全路径的字符串,本函数返回基本的文件名。如果文件名是以 suffix 结束的,那这一部分也会被去掉。
eg:

$path = "/home/httpd/html/index.php";
$file = basename($path,".php"); // $file is set to "index"

 

2 得到目录部分:
dirname();
给出一个包含有指向一个文件的全路径的字符串,本函数返回去掉文件名后的目录名。
eg:

$path = "/etc/passwd";
$file = dirname($path); // $file is set to "/etc"

 

3 得到路径关联数组
pathinfo();
得到一个指定路径中的三个部分:目录名,基本名,扩展名。
eg:

$pathinfo = pathinfo("www/test/index.html");
var_dump($pathinfo);
// $path[‘dirname‘]
$path[‘basename‘]
$path[‘extenssion‘]

 
二、文件类型
1. filetype();
返回文件的类型。可能的值有 fifo,char,dir,block,link,file 和 unknown。
eg:

echo filetype(‘/etc/passwd‘); // file
echo filetype(‘/etc/‘);        // dir

 
三、得到给定文件有用信息数组(很有用)

1. fstat();
通过已打开的文件指针取得文件信息
获取由文件指针 handle 所打开文件的统计信息。本函数和 stat() 函数相似,除了它是作用于已打开的文件指针而不是文件名。
eg:

 

// 打开文件
$fp = fopen("/etc/passwd", "r");
// 取得统计信息
$fstat = fstat($fp);
// 关闭文件
fclose($fp);
// 只显示关联数组部分
print_r(array_slice($fstat, 13));

2. stat()
获取由 filename 指定的文件的统计信息(类比fstat())

四、计算大小
1. filesize()
返回文件大小的字节数,如果出错返回 FALSE 并生成一条 E_WARNING 级的错误。
eg:

// 输出类似:somefile.txt: 1024 bytes
$filename = ‘somefile.txt‘;
echo $filename . ‘: ‘ . filesize($filename) . ‘ bytes‘;

 
2. disk_free_space()
获得目录所在磁盘分区的可用空间(字节单位)
eg

// $df 包含根目录下可用的字节数
$df = disk_free_space("/");
//在 Windows 下:
disk_free_space("C:");
disk_free_space("D:");

 
3. disk_total_space()
返回一个目录的磁盘总大小
eg:(同上,换掉函数)

另:如需要计算一个目录大小,可以编写一个递归函数来实现

代码
function dir_size($dir){
$dir_size = 0;
if($dh = @opendir($dir)){
while(($filename = readdir($dh)) != false){
if($filename !=‘.‘ and $filename !=‘..‘){

     if(is_file($dir.‘/‘.$filename)){
$dir_size +=filesize($dir.‘/‘.$filename);

}else if(is_dir($dir.‘/‘.$filename)){

      $dir_size +=dir_size($dir.‘/‘.$filename);
}
}

                   }#end while

            }# end opendir

@closedir($dh);
return $dir_size;
} #end function

 

五、 访问与修改时间
1. fileatime(): 最后访问时间
2. filectime(): 最后改变时间(任何数据的修改)
3. filemtime(): 最后修改时间(指仅是内容修改)

 

六、 文件的I/O操作

1. fopen -- 打开文件或者 URL

mode 说明
‘r‘ 只读方式打开,将文件指针指向文件头。
‘r+‘ 读写方式打开,将文件指针指向文件头。
‘w‘ 写入方式打开,将文件指针指向文件头并将文件大小截为零。如果文件不存在则尝试创建之。
‘w+‘ 读写方式打开,将文件指针指向文件头并将文件大小截为零。如果文件不存在则尝试创建之。
‘a‘ 写入方式打开,将文件指针指向文件末尾。如果文件不存在则尝试创建之。
‘a+‘ 读写方式打开,将文件指针指向文件末尾。如果文件不存在则尝试创建之。
‘x‘ 创建并以写入方式打开,将文件指针指向文件头。如果文件已存在,则 fopen() 调用失败并返回 FALSE,
‘x+‘ 创建并以读写方式打开,将文件指针指向文件头。如果文件已存在,则 fopen() 调用失败并返回 FALSE
eg:

$handle = fopen("/home/rasmus/file.txt", "r");

 

2. file -- 把整个文件读入一个数组中(此函数是很有用的)
和 file_get_contents() 一样,只除了 file() 将文件作为一个数组返回。数组中的每个单元都是文件中相应的一行,包括换行符在内。如果失败 file() 返回 FALSE。
eg:

代码
$lines = file(‘http://www.example.com/‘);
// 在数组中循环,显示 HTML 的源文件并加上行号。
foreach ($lines as $line_num => $line) {
echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}
// 另一个例子将 web 页面读入字符串。参见 file_get_contents()。
$html = implode(‘‘, file (‘http://www.example.com/‘));

 

3. fgets -- 从文件指针中读取一行
从 handle 指向的文件中读取一行并返回长度最多为 length - 1 字节的字符串。碰到换行符(包括在返回值中)、EOF 或者已经读取了 length - 1 字节后停止(看先碰到那一种情况)。如果没有指定 length,则默认为 1K,或者说 1024 字节。
eg:

$handle = @fopen("/tmp/inputfile.txt", "r");
if ($handle) {
while (!feof($handle)) {
$buffer = fgets($handle, 4096);
echo $buffer;
}
fclose($handle);
}

 

4. fgetss -- 从文件指针中读取一行并过滤掉 HTML 标记
和 fgets() 相同,只除了 fgetss 尝试从读取的文本中去掉任何 HTML 和 PHP 标记。

   可以用可选的第三个参数指定哪些标记不被去掉


   另:对的目录的操作:
1. opendir -- 打开目录句柄,打开一个目录句柄,可用于之后的 closedir(),readdir() 和 rewinddir() 调用中。
2. readdir -- 从目录句柄中读取条目,返回目录中下一个文件的文件名。文件名以在文件系统中的排序返回。
eg:

 

代码
// 注意在 4.0.0-RC2 之前不存在 !== 运算符

if ($handle = opendir(‘/path/to/files‘)) {
echo "Directory handle: $handle\n";
echo "Files:\n";
  
while (false !== ($file = readdir($handle))) {
echo "$file\n";
}
   
while ($file = readdir($handle)) {
echo "$file\n";
}
     closedir($handle);
}

 


3. scandir -- 列出指定路径中的文件和目录(很有用),返回一个 array,包含有 directory 中的文件和目录。
默认的排序顺序是按字母升序排列。如果使用了可选参数 sorting_order(设为 1),则排序顺序是按字母降序排列。
eg:

$dir    = ‘/tmp‘;
$files1 = scandir($dir);
$files2 = scandir($dir, 1);

print_r($files1);
print_r($files2);   

 

另外注:

七、 对文件属性的操作(操作系统环境不同,可能有所不一样,这点要注意)

    1文件是否可读:

       boolis_readable ( string filename )

         如果由 filename 指定的文件或目录存在并且可读则返回 TRUE

        记住 PHP 也许只能以运行 webserver 的用户名(通常为 ‘nobody‘)来访问文件。不计入安全模式的限制。

    2 文件是否可写

         bool is_writable ( string filename )

        如果文件存在并且可写则返回 TRUEfilename 参数可以是一个允许进行是否可写检查的目录名。

         记住 PHP 也许只能以运行 webserver 的用户名(通常为 ‘nobody‘)来访问文件。不计入安全模式的限制

 

 

 

   3  检查文件是否存在

    boolfile_exists ( string filename )

      如果由 filename 指定的文件或目录存在则返回 TRUE,否则返回 FALSE

 

  1 <?php  2 /***************************************************************************************  3 文件名:File.cls.php  4 文件简介:类clsFile的定义,对文件操作的封装  5 版本:2.0  最后修改日期:2011-8-23  6 ****************************************************************************************/  7 !defined(‘INIT_PHPV‘) && die(‘No direct script access allowed‘);  8 class clsFile  9 { 10    private $fileName_str;         //文件的路径 11    private $fileOpenMethod_str;   //文件打开模式 12     13    function __construct($fileName_str=‘‘,$fileOpenMethod_str=‘readOnly‘)//路径,默认为空;模式,默认均为只读 14    { 15        //构造函数,完成数据成员的初始化 16        $this->fileName_str=$fileName_str; 17        $this->fileOpenMethod_str=$fileOpenMethod_str; 18    } 19     20    function __destruct() 21    { 22        //析构函数 23    } 24     25    public function __get($valName_val)//欲取得的数据成员名称 26    { 27        //特殊函数,取得指定名称数据成员的值 28           return $this->$valName_val; 29    } 30     31    private function on_error($errMsg_str=‘Unkown Error!‘,$errNo_int=0)//错误信息,错误代码 32    { 33         echo ‘程序错误:‘.$errMsg_str.‘错误代码:‘.$errNo_int;//出错处理函数 34    } 35     36    public function open() 37    { 38        //打开相应文件,返回文件资源标识 39           //根据fileOpenMethod_str选择打开方式 40           switch($this->fileOpenMethod_str) 41           { 42                  case ‘readOnly‘: 43                     $openMethod_str=‘r‘;      //只读,指针指向文件头 44                     break; 45                  case ‘readWrite‘: 46                     $openMethod_str=‘r+‘;     //读写,指针指向文件头 47                     break; 48                  case ‘writeAndInit‘: 49                     $openMethod_str=‘w‘;      //只写,指针指向文件头将大小截为零,不存在则创建 50                     break; 51                  case ‘readWriteAndInit‘: 52                     $openMethod_str=‘r+‘;     //读写,指针指向文件头将大小截为零,不存在则创建 53                     break; 54                  case ‘writeAndAdd‘: 55                     $openMethod_str=‘a‘;      //只写,指针指向文件末尾,不存在则创建 56                     break; 57                  case ‘readWriteAndAdd‘: 58                     $openMethod_str=‘a+‘;     //读写,指针指向文件末尾,不存在则创建 59                     break; 60                  default: 61                     $this->on_error(‘Open method error!‘,310);//出错处理 62                     exit; 63           } 64            65           //打开文件        66           if(!$fp_res=fopen($this->fileName_str,$openMethod_str)) 67           { 68                  $this->on_error(‘Can\‘t open the file!‘,301);//出错处理 69                  exit; 70           } 71            72           return $fp_res; 73    } 74     75    public function close($fp_res)//由open返回的资源标识 76    { 77        //关闭所打开的文件 78           if(!fclose($fp_res)) 79           { 80                  $this->on_error(‘Can\‘t close the file!‘,302);//出错处理 81                  exit; 82           } 83    } 84     85    public function write()//$fp_res,$data_str,$length_int:文件资源标识,写入的字符串,长度控制 86    { 87        //将字符串string_str写入文件fp_res,可控制写入的长度length_int 88           //判断参数数量,调用相关函数 89           $argNum_int=func_num_args();//参数个数 90            91           $fp_res=func_get_arg(0);          //文件资源标识 92           $data_str=func_get_arg(1);        //写入的字符串 93            94           if($argNum_int==3) 95           { 96                  $length_int=func_get_arg(2);  //长度控制 97               if(!fwrite($fp_res,$data_str,$length_int)) 98               { 99                     $this->on_error(‘Can\‘t write the file!‘,303);//出错处理100                     exit;101               }102           }103           else104           {105                  if(!fwrite($fp_res,$data_str))106               {107                     $this->on_error(‘Can\‘t write the file!‘,303);//出错处理108                     exit;109               }110           }111    }112    113    public function read_line()//$fp_res,$length_int:文件资源标识,读入长度114    {115        //从文件fp_res中读入一行字符串,可控制长度116           //判断参数数量117           $argNum_int=func_num_args();118           $fp_res=func_get_arg(0);119           120           if($argNum_int==2)121           {122               $length_int=func_get_arg(1);123               if($string_str=!fgets($fp_res,$length_int))124               {125                     $this->on_error(‘Can\‘t read the file!‘,304);//出错处理126                     exit;127               }128               return $string_str;129        }130        else131        {132               if(!$string_str=fgets($fp_res))133               {134                     $this->on_error(‘Can\‘t read the file!‘,304);//出错处理135                     exit;136               }137               return $string_str;138           }139    }140    141    public function read($fp_res,$length_int)//文件资源标识,长度控制142    {143        //读入文件fp_res,最长为length_int144           if(!$string_str=fread($fp_res,$length_int))145           {146                  $this->on_error(‘Can\‘t read the file!‘,305);//出错处理147                  exit;148           }149           return $string_str;150    }151    152    public function is_exists($fileName_str)//文件名153    {154        //检查文件$fileName_str是否存在,存在则返回true,不存在返回false155           return file_exists($fileName_str);156    }157 158 /******************取得文件大小*********************/159 /*160 取得文件fileName_str的大小161 $fileName_str 是文件的路径和名称162 返回文件大小的值163 */164    public function get_file_size($fileName_str)//文件名165    {166        return filesize($fileName_str);167    }168 169 /******************转换文件大小的表示方法*********************/170 /*171 $fileSize_int文件的大小,单位是字节172 返回转换后带计量单位的文件大小173 */174    public function change_size_express($fileSize_int)//文件名175    {176        if($fileSize_int>1024)177        {178           $fileSizeNew_int=$fileSize_int/1024;//转换为K179           $unit_str=‘KB‘;180             if($fileSizeNew_int>1024)181              {182               $fileSizeNew_int=$fileSizeNew_int/1024;//转换为M183               $unit_str=‘MB‘;184              }185           $fileSizeNew_arr=explode(‘.‘,$fileSizeNew_int);186           $fileSizeNew_str=$fileSizeNew_arr[0].‘.‘.substr($fileSizeNew_arr[1],0,2).$unit_str;187        }188        return $fileSizeNew_str;189    }190 /******************重命名文件*********************/191 /*192 将oldname_str指定的文件重命名为newname_str193 $oldName_str是文件的原名称194 $newName_str是文件的新名称195 返回错误信息196 */ 197    public function rename_file($oldName_str,$newName_str)198    {199           if(!rename($oldName_str,$newName_str))200           {201                  $this->on_error(‘Can\‘t rename file!‘,308);202                  exit;203           }204    }205 206 /******************删除文件*********************/207 /*208 将filename_str指定的文件删除209 $fileName_str要删除文件的路径和名称210 返回错误信息211 */212    public function delete_file($fileName_str)//213    {214           if(!unlink($fileName_str))215           {216                  $this->on_error(‘Can\‘t delete file!‘,309);//出错处理217                  exit;218           }219    }220 221 /******************取文件的扩展名*********************/222 /*223 取filename_str指定的文件的扩展名224 $fileName_str要取类型的文件路径和名称225 返回文件的扩展名226 */227    public function get_file_type($fileName_str)228    {229           $fileNamePart_arr=explode(‘.‘,$fileName_str);230           while(list(,$fileType_str)=each($fileNamePart_arr))231           {232            $type_str=$fileType_str;233           }234            return $type_str;235    }236 237 /******************判断文件是否是规定的文件类型*********************/238 /*239 $fileType_str规定的文件类型240 $fileName_str要取类型的文件路径和名称241 返回false或true242 */243    public function is_the_type($fileName_str,$fileType_arr)244    {245        $cheakFileType_str=$this->get_file_type($fileName_str);246        if(!in_array($cheakFileType_str,$fileType_arr))247        {248         return false;249           }250        else251        {252           return true;253        }254    }255 256 /******************上传文件,并返回上传后的文件信息*********************/257 /*258 $fileName_str本地文件名259 $filePath上传文件的路径,如果$filePath是str则上传到同一目录用一个文件命名,新文件名在其加-1,2,3..,如果是arr则顺序命名260 $allowType_arr允许上传的文件类型,留空不限制261 $maxSize_int允许文件的最大值,留空不限制262 返回的是新文件信息的二维数组:$reFileInfo_arr263 */264    public function upload_file($fileName_str,$filePath,$allowType_arr=‘‘,$maxSize_int=‘‘)265 {      266        $fileName_arr=$_FILES[$fileName_str][‘name‘];  //文件的名称267        $fileTempName_arr=$_FILES[$fileName_str][‘tmp_name‘];  //文件的缓存文件268        $fileSize_arr=$_FILES[$fileName_str][‘size‘];//取得文件大小269        $reFileInfo_arr=array();270        $num=count($fileName_arr)-1;271        for($i=0;$i<=$num;$i++)272       {273            if($fileName_arr[$i]!=‘‘) 274         {275           if($allowType_arr!=‘‘ and !$this->is_the_type($fileName_arr[$i],$allowType_arr))//判断是否是允许的文件类型276           {277            $this->on_error(‘The file is not allowed type!‘,310);//出错处理278            break;279           }280 281           if($maxSize_int!=‘‘ and $fileSize_arr[$i]>$maxSize_int)282           {283            $this->on_error(‘The file is too big!‘,311);//出错处理284            break;285           }286   287           $j=$i+1;288           $fileType_str=$this->get_file_type($fileName_arr[$i]);//取得文件类型289           if(!is_array($filePath))290           {291           $fileNewName_str=$filePath.‘-‘.($j).‘.‘.$fileType_str;292           }293           else294           {295           $fileNewName_str=$filePath_arr[$i].‘.‘.$fileType_str;296           }297           copy($fileTempName_arr[$i],$fileNewName_str);//上传文件298           unlink($fileTempName_arr[$i]);//删除缓存文件299 300           //---------------存储文件信息--------------------//301           $doFile_arr=explode(‘/‘,$fileNewName_str);302           $doFile_num_int=count($doFile_arr)-1;303           $reFileInfo_arr[$j][‘name‘]=$doFile_arr[$doFile_num_int];304           $reFileInfo_arr[$j][‘type‘]=$fileType_str;305           $reFileInfo_arr[$j][‘size‘]=$this->change_size_express($fileSize_arr[$i]);306       }307    }308    return $reFileInfo_arr;309 }310 311 /******************备份文件夹*********************/312 }313 314 ?>

 

PHP常用的文件操作函数集锦