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]  view plain copy

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.           else  
104.           {  
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.        else  
131.        {  
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_int  
144.           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，不存在返回false  
155.           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;//转换为K  
179.           $unit_str='KB';  
180.             if($fileSizeNew_int>1024)  
181.              {  
182.               $fileSizeNew_int=$fileSizeNew_int/1024;//转换为M  
183.               $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_str 
193. $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或true 
242. */  
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.        else  
251.        {  
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_arr 
263. */  
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.           else  
294.           {  
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. ?>