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 )

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

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

   3  检查文件是否存在

    boolfile_exists ( string filename )

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

=====================================PHP文件操作类=========================================

<?php
/***************************************************************************************
文件名：File.cls.php
文件简介：类clsFile的定义，对文件操作的封装
版本：2.0  最后修改日期：2011-8-23
****************************************************************************************/
!defined('INIT_PHPV') && die('No direct script access allowed');
class clsFile
{
   private $fileName_str;         //文件的路径
   private $fileOpenMethod_str;   //文件打开模式

   function __construct($fileName_str='',$fileOpenMethod_str='readOnly')//路径，默认为空；模式，默认均为只读
   {
       //构造函数，完成数据成员的初始化
       $this->fileName_str=$fileName_str;
       $this->fileOpenMethod_str=$fileOpenMethod_str;
   }

   function __destruct()
   {
       //析构函数
   }

   public function __get($valName_val)//欲取得的数据成员名称
   {
       //特殊函数，取得指定名称数据成员的值
          return $this->$valName_val;
   }

   private function on_error($errMsg_str='Unkown Error!',$errNo_int=0)//错误信息，错误代码
   {
        echo '程序错误：'.$errMsg_str.'错误代码：'.$errNo_int;//出错处理函数
   }

   public function open()
   {
       //打开相应文件，返回文件资源标识
          //根据fileOpenMethod_str选择打开方式
          switch($this->fileOpenMethod_str)
          {
                 case 'readOnly':
                    $openMethod_str='r';      //只读，指针指向文件头
                    break;
                 case 'readWrite':
                    $openMethod_str='r+';     //读写，指针指向文件头
                    break;
                 case 'writeAndInit':
                    $openMethod_str='w';      //只写，指针指向文件头将大小截为零，不存在则创建
                    break;
                 case 'readWriteAndInit':
                    $openMethod_str='r+';     //读写，指针指向文件头将大小截为零，不存在则创建
                    break;
                 case 'writeAndAdd':
                    $openMethod_str='a';      //只写，指针指向文件末尾，不存在则创建
                    break;
                 case 'readWriteAndAdd':
                    $openMethod_str='a+';     //读写，指针指向文件末尾，不存在则创建
                    break;
                 default:
                    $this->on_error('Open method error!',310);//出错处理
                    exit;
          }

          //打开文件
          if(!$fp_res=fopen($this->fileName_str,$openMethod_str))
          {
                 $this->on_error('Can\'t open the file!',301);//出错处理
                 exit;
          }

          return $fp_res;
   }

   public function close($fp_res)//由open返回的资源标识
   {
       //关闭所打开的文件
          if(!fclose($fp_res))
          {
                 $this->on_error('Can\'t close the file!',302);//出错处理
                 exit;
          }
   }

   public function write()//$fp_res,$data_str,$length_int:文件资源标识，写入的字符串，长度控制
   {
       //将字符串string_str写入文件fp_res，可控制写入的长度length_int
          //判断参数数量，调用相关函数
          $argNum_int=func_num_args();//参数个数

          $fp_res=func_get_arg(0);          //文件资源标识
          $data_str=func_get_arg(1);        //写入的字符串

          if($argNum_int==3)
          {
                 $length_int=func_get_arg(2);  //长度控制
              if(!fwrite($fp_res,$data_str,$length_int))
              {
                    $this->on_error('Can\'t write the file!',303);//出错处理
                    exit;
              }
          }
          else
          {
                 if(!fwrite($fp_res,$data_str))
              {
                    $this->on_error('Can\'t write the file!',303);//出错处理
                    exit;
              }
          }
   }

   public function read_line()//$fp_res,$length_int:文件资源标识，读入长度
   {
       //从文件fp_res中读入一行字符串，可控制长度
          //判断参数数量
          $argNum_int=func_num_args();
          $fp_res=func_get_arg(0);

          if($argNum_int==2)
          {
              $length_int=func_get_arg(1);
              if($string_str=!fgets($fp_res,$length_int))
              {
                    $this->on_error('Can\'t read the file!',304);//出错处理
                    exit;
              }
              return $string_str;
       }
       else
       {
              if(!$string_str=fgets($fp_res))
              {
                    $this->on_error('Can\'t read the file!',304);//出错处理
                    exit;
              }
              return $string_str;
          }
   }

   public function read($fp_res,$length_int)//文件资源标识，长度控制
   {
       //读入文件fp_res，最长为length_int
          if(!$string_str=fread($fp_res,$length_int))
          {
                 $this->on_error('Can\'t read the file!',305);//出错处理
                 exit;
          }
          return $string_str;
   }

   public function is_exists($fileName_str)//文件名
   {
       //检查文件$fileName_str是否存在，存在则返回true，不存在返回false
          return file_exists($fileName_str);
   }

/******************取得文件大小*********************/
/*
取得文件fileName_str的大小
$fileName_str 是文件的路径和名称
返回文件大小的值
*/
   public function get_file_size($fileName_str)//文件名
   {
       return filesize($fileName_str);
   }

/******************转换文件大小的表示方法*********************/
/*
$fileSize_int文件的大小，单位是字节
返回转换后带计量单位的文件大小
*/
   public function change_size_express($fileSize_int)//文件名
   {
       if($fileSize_int>1024)
       {
          $fileSizeNew_int=$fileSize_int/1024;//转换为K
          $unit_str='KB';
            if($fileSizeNew_int>1024)
             {
              $fileSizeNew_int=$fileSizeNew_int/1024;//转换为M
              $unit_str='MB';
             }
          $fileSizeNew_arr=explode('.',$fileSizeNew_int);
          $fileSizeNew_str=$fileSizeNew_arr[0].'.'.substr($fileSizeNew_arr[1],0,2).$unit_str;
       }
       return $fileSizeNew_str;
   }
/******************重命名文件*********************/
/*
将oldname_str指定的文件重命名为newname_str
$oldName_str是文件的原名称
$newName_str是文件的新名称
返回错误信息
*/
   public function rename_file($oldName_str,$newName_str)
   {
          if(!rename($oldName_str,$newName_str))
          {
                 $this->on_error('Can\'t rename file!',308);
                 exit;
          }
   }

/******************删除文件*********************/
/*
将filename_str指定的文件删除
$fileName_str要删除文件的路径和名称
返回错误信息
*/
   public function delete_file($fileName_str)//
   {
          if(!unlink($fileName_str))
          {
                 $this->on_error('Can\'t delete file!',309);//出错处理
                 exit;
          }
   }

/******************取文件的扩展名*********************/
/*
取filename_str指定的文件的扩展名
$fileName_str要取类型的文件路径和名称
返回文件的扩展名
*/
   public function get_file_type($fileName_str)
   {
          $fileNamePart_arr=explode('.',$fileName_str);
          while(list(,$fileType_str)=each($fileNamePart_arr))
          {
           $type_str=$fileType_str;
          }
           return $type_str;
   }

/******************判断文件是否是规定的文件类型*********************/
/*
$fileType_str规定的文件类型
$fileName_str要取类型的文件路径和名称
返回false或true
*/
   public function is_the_type($fileName_str,$fileType_arr)
   {
       $cheakFileType_str=$this->get_file_type($fileName_str);
       if(!in_array($cheakFileType_str,$fileType_arr))
       {
        return false;
          }
       else
       {
          return true;
       }
   }

/******************上传文件，并返回上传后的文件信息*********************/
/*
$fileName_str本地文件名
$filePath上传文件的路径，如果$filePath是str则上传到同一目录用一个文件命名，新文件名在其加-1，2，3..，如果是arr则顺序命名
$allowType_arr允许上传的文件类型，留空不限制
$maxSize_int允许文件的最大值，留空不限制
返回的是新文件信息的二维数组：$reFileInfo_arr
*/
   public function upload_file($fileName_str,$filePath,$allowType_arr='',$maxSize_int='')
{
       $fileName_arr=$_FILES[$fileName_str]['name'];  //文件的名称
       $fileTempName_arr=$_FILES[$fileName_str]['tmp_name'];  //文件的缓存文件
       $fileSize_arr=$_FILES[$fileName_str]['size'];//取得文件大小
       $reFileInfo_arr=array();
       $num=count($fileName_arr)-1;
       for($i=0;$i<=$num;$i++)
      {
           if($fileName_arr[$i]!='')
        {
          if($allowType_arr!='' and !$this->is_the_type($fileName_arr[$i],$allowType_arr))//判断是否是允许的文件类型
          {
           $this->on_error('The file is not allowed type!',310);//出错处理
           break;
          }

          if($maxSize_int!='' and $fileSize_arr[$i]>$maxSize_int)
          {
           $this->on_error('The file is too big!',311);//出错处理
           break;
          }

          $j=$i+1;
          $fileType_str=$this->get_file_type($fileName_arr[$i]);//取得文件类型
          if(!is_array($filePath))
          {
          $fileNewName_str=$filePath.'-'.($j).'.'.$fileType_str;
          }
          else
          {
          $fileNewName_str=$filePath_arr[$i].'.'.$fileType_str;
          }
          copy($fileTempName_arr[$i],$fileNewName_str);//上传文件
          unlink($fileTempName_arr[$i]);//删除缓存文件

          //---------------存储文件信息--------------------//
          $doFile_arr=explode('/',$fileNewName_str);
          $doFile_num_int=count($doFile_arr)-1;
          $reFileInfo_arr[$j]['name']=$doFile_arr[$doFile_num_int];
          $reFileInfo_arr[$j]['type']=$fileType_str;
          $reFileInfo_arr[$j]['size']=$this->change_size_express($fileSize_arr[$i]);
      }
   }
   return $reFileInfo_arr;
}

/******************备份文件夹*********************/
}

?>