标题：PHP 文件系统函数库 (3)
出处：沧海一粟
时间：Sat, 14 Apr 2007 08:33:10 +0000
作者：jed
地址：http://www.dzhope.com/post/288/

内容：
is_file　测试文件是否为正常文件。
　　语法： boolean is_file(string filename);
　　返回值： 布尔值
　　函数种类： 文件存取
　　内容说明： 本函数返回 true 值则表示指定的 filename 存在并为正常的文件。返回值放在快取缓冲区中，可以参考 clearstatcache()。
　　参考： is_dir() is_link()

　　is_link　测试文件是否为链接文件。
　　语法： boolean is_link(string filename);
　　返回值： 布尔值
　　函数种类： 文件存取
　　内容说明： 本函数返回 true 值则表示指定的 filename 存在并为符号链接文件 (symbolic link)。返回值放在快取缓冲区中，可以参考 clearstatcache()。
　　参考： is_dir() is_file()

　　is_readable　测试文件是否可读取。
　　语法： boolean is_readable(string filename);
　　返回值： 布尔值
　　函数种类： 文件存取
　　内容说明： 本函数返回 true 值则表示指定的 filename 存在并且可读取。返回值放在快取缓冲区中，参考 clearstatcache()。
　　参考： is_writeable() 

　　is_writeable　测试文件是否可写入。
　　语法： boolean is_writeable(string filename);
　　返回值： 布尔值
　　函数种类： 文件存取
　　内容说明： 本函数返回 true 值则表示指定的 filename 存在并且可读取。参数 filename 也可以是目录名称，用来测试该目录是否可写入。返回值放在快取缓冲区中，参考 clearstatcache()。
　　参考： readable()

　　link　建立硬式链接。
　　语法： int link(string target, string link);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数建立硬式链接，用来将参数 link 链接至 target。
　　参考： symlink() readlink() linkinfo()

　　linkinfo　取得链接信息。
　　语法： int linkinfo(string path);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数使用系统呼叫 lstat，返回 UNIX 上 C 语言 stat 结构类型的 st_dev 字段。返回 0 或 false 表示发生错误。
　　参考： symlink() readlink() link()

　　mkdir　建立目录。
　　语法： int mkdir(string pathname, int mode);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数建立参数 pathname 目录，参数 mode 以八进位的方式指定 (在参数前加 0) 比较不会出错。返回 true 表示成功，失败则返回 false。

　　使用范例，下例就是用八进位的例子，建立 /path/to/my/dir 目录，该目录只有拥有者及 root 等级可读写执行，其它人无法使用。

　　<?php
　　　　mkdir("/path/to/my/dir", 0700);
　　?> 


　　参考： rmdir()

　　pclose　关闭文件。
　　语法： int pclose(int fp);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数用来关闭以 popen() 打开的管道文件。而参数 fp 必需是有效的，且使用 popen() 打开的文件。返回结处理文件的结束状态。
　　参考： popen() 

　　popen　打开文件。
　　语法： int popen(string command, string mode);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数执行指令开档，而该文件是用管道方式处理的文件。用本函数打开的文件只能是单向的 (只能读或只能写)，而且一定要用 pclose() 关闭。在文件操作上可使用 fgets()、fgetss() 与 fputs()。若是开档发生错误，返回 false 值。

　　使用范例

　　<?
　　　　$fp = popen( "/bin/ls", "r" );
　　?> 


　　参考： pclose()

　　readfile　输出文件。
　　语法： int readfile(string filename);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数读取文件，并将文件内容写入标准输出设备中。返回值是读取的文件大小。若有错误返回 false 值，可以在函数前面加入 @，变成 @readfile，就可以隐藏起来。和 fopen() 用法一样，若参数 filename 为 "http：//......" 则本函数利用 HTTP 1.0 协议与服务器连接，文件指针则指到服务器返回文件的起始处。若参数 filename 为 "ftp：//......." 则本函数会与服务器连接，文件指针指到指定的文件处。若 FTP 服务器没有支持被动模式 (passive mode ftp) 则返回失败值。打开的 FTP 文件可以是读取或写入其中之一，但不能读或写二种同时使用。其它的情形，本函数打开本地的文件，文件的指针则指向打开的文件。若开档失败，则返回 false 值。
　　参考： fpassthru() file() fopen() 

　　readlink　返回符号链接 (symbolic link) 目标档。
　　语法： string readlink(string path);
　　返回值： 字符串
　　函数种类： 文件存取
　　内容说明： 本函数和 C 语言的同名函数用法相同，返回符号链接的文件。若发生错误则返回 0。
　　参考： symlink() linkinfo() 

　　rename　更改档名。
　　语法： int rename(string oldname, string newname);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数可将旧档名 oldname 改成新档名 newname。成功则返回 true、失败则返回 false。

　　rewind　重置开档的读写位置指针。
　　语法： int rewind(int fp);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数重置文件的读写位置指针到标案的开头处。发生错误则返回 0。文件 fp 必须是有效且用 fopen() 打开的文件。

　　使用范例
　　fseek ftell 

　　rmdir　删除目录。
　　语法： int rmdir(string dirname);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数可用来删除目录。欲删除的路径必须是空的目录，且权限必须要合乎要求。发生错误则返回 0。
　　参考： mkdir() 

　　stat　取得文件相关信息。
　　语法： array stat(string filename);
　　返回值： 数组
　　函数种类： 文件存取
　　内容说明： 本函数可蒐集文件的相关信息，并返回数组。数组的元素依序如下：

　　装置名称 (device) 
　　inode 值
　　inode 文件模式
　　参照到该档的名称总数，含 link 档。
　　拥有者的 UID 
　　拥有者的 GID 

　　若为字符或装置设备则为装置类型 (限系统支持 st_blksize 方有效，Windows 系列返回 -1) 
　　位组为单位的文件长度
　　最后存取时间
　　最后修改时间
　　最后改动时间
　　文件系统的区块大小 (限系统支持 st_blksize 方有效，Windows 系列返回 -1) 
　　匹配的区块数
　　返回值放在快取缓冲区中，参考 clearstatcache()。

　　lstat　取得链接文件相关信息。
　　语法： array lstat(string filename);
　　返回值： 数组
　　函数种类： 文件存取
　　内容说明： 本函数可蒐集链接文件的相关信息，并返回数组。数组的元素依序如下：

　　装置名称 (device) 
　　inode 值
　　链接 (link) 到该文件的总数。
　　拥有者的 UID 
　　拥有者的 GID 

　　若为字符或装置设备则为装置类型 (限系统支持 st_blksize 方有效，Windows 系列返回 -1) 
　　位组为单位的文件长度
　　最后存取时间
　　最后修改时间
　　最后改动时间
　　文件系统的区块大小 (限系统支持 st_blksize 方有效，Windows 系列返回 -1) 
　　匹配的区块数
　　返回值放在快取缓冲区中，参考 clearstatcache()。

　　symlink　建立符号链接 (symbolic link)。
　　语法： int symlink(string target, string link);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数可用来建立符号链接。从参数 target 链接到 link 处。建立硬式链接可用 link() 函数。
　　参考： link() readlink() linkinfo()

　　tempnam　建立只一的临时档。
　　语法： string tempnam(string dir, string prefix);
　　返回值： 字符串
　　函数种类： 文件存取
　　内容说明： 本函数可建立一个临时档，档名不会与同目录中的文件重覆。返回字符串就是建立的临时档名。若发生错误则返回空字符串。

　　使用范例

　　<?
　　　　$tmpfname = tempnam( "/tmp", "HAHA" );
　　?> 



　　touch　配置最后修改时间。
　　语法： int touch(string filename, int [time]);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数可用来配置最后修改时间。若有指定参数 time，则依指定的时间；若无指定时间，则为服务器的时间。和 UNIX 的同名指令一样，若文件不存在，则会建立 filename 文件。成功则返回 true 值，其它失败时则返回 false。

　　umask　改变目前的文件属性遮罩 umask。
　　语法： int umask(int [mask]);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数用来配置 PHP 的 umask 值。此值是 mask 与 0777 运算的值，返回旧的 umask 值。当参数 mask 不存在时，本函数将返回目前的 umask 值。

　　unlink　删除文件。
　　语法： int unlink(string filename);
　　返回值： 整数
　　函数种类： 文件存取
　　内容说明： 本函数删除文件 filename，用法像 UNIX 中 C 语言呼叫的同名函数 unlink()。当发生错误则返回 0 或 false。
　　参考： rmdir()




Generated by Bo-blog 2.1.1 Release