PHP4手册:函数库及函数(十六) 文件系统函式库-3

--------------------------------------------------------------------------------
 函式:is_file() 
--------------------------------------------------------------------------------
 

档案系统函式库

is_file
测试档案是否为正常档案。

语法: boolean is_file(string filename);

传回值: 布林值

函式种类: 档案存取

 
 
内容说明 

本函式传回 true 值则表示指定的 filename 存在并为正常的档案。传回值放在快取缓冲区中，可以参考 clearstatcache()。

 
 
参考 

is_dir()  is_link()
 

--------------------------------------------------------------------------------
 函式:is_link() 
--------------------------------------------------------------------------------
 

档案系统函式库

is_link
测试档案是否为连结档。

语法: boolean is_link(string filename);

传回值: 布林值

函式种类: 档案存取

 
 
内容说明 

本函式传回 true 值则表示指定的 filename 存在并为符号连结档 (symbolic link)。传回值放在快取缓冲区中，可以参考 clearstatcache()。

 
 
参考 

is_dir()  is_file()  

--------------------------------------------------------------------------------
 函式:is_readable() 
--------------------------------------------------------------------------------
 

档案系统函式库

is_readable
测试档案是否可读取。

语法: boolean is_readable(string filename);

传回值: 布林值

函式种类: 档案存取

 
 
内容说明 

本函式传回 true 值则表示指定的 filename 存在并且可读取。传回值放在快取缓冲区中，参考 clearstatcache()。

 
 
参考 

is_writeable()  

--------------------------------------------------------------------------------
 函式:is_writeable() 
--------------------------------------------------------------------------------
 

档案系统函式库

is_writeable
测试档案是否可写入。

语法: boolean is_writeable(string filename);

传回值: 布林值

函式种类: 档案存取

 
 
内容说明 

本函式传回 true 值则表示指定的 filename 存在并且可读取。参数 filename 也可以是目录名称，用来测试该目录是否可写入。传回值放在快取缓冲区中，参考 clearstatcache()。

 
 
参考 

readable()   
 

--------------------------------------------------------------------------------
 函式:link() 
--------------------------------------------------------------------------------
 

档案系统函式库

link
建立硬式连结。

语法: int link(string target, string link);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式建立硬式连结，用来将参数 link 连结至 target。

 
 
参考 

symlink()  readlink()  linkinfo()  

--------------------------------------------------------------------------------
 

--------------------------------------------------------------------------------
 函式:linkinfo() 
--------------------------------------------------------------------------------
 

档案系统函式库

linkinfo
取得连结资讯。

语法: int linkinfo(string path);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式使用系统呼叫 lstat，传回 UNIX 上 C 语言 stat 结构型态的 st_dev 栏位。传回 0 或 false 表示发生错误。

 
 
参考 

symlink()  readlink()  link()  
 

--------------------------------------------------------------------------------
 函式:mkdir() 
--------------------------------------------------------------------------------
 

档案系统函式库

mkdir
建立目录。

语法: int mkdir(string pathname, int mode);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式建立参数 pathname 目录，参数 mode 以八进位的方式指定 (在参数前加 0) 比较不会出错。传回 true 表示成功，失败则传回 false。

 
 
使用范例 

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

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

 
参考 

rmdir()  

--------------------------------------------------------------------------------
 函式:pclose() 
--------------------------------------------------------------------------------
 

档案系统函式库

pclose
关闭档案。

语法: int pclose(int fp);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式用来关闭以 popen() 开启的管道档案。而参数 fp 必需是有效的，且使用 popen() 开启的档案。传回结处理档案的结束状态。

 
 
参考 

popen()  

--------------------------------------------------------------------------------
 函式:popen() 
--------------------------------------------------------------------------------
 

档案系统函式库

popen
开启档案。

语法: int popen(string command, string mode);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式执行指令开档，而该档案是用管道方式处理的档案。用本函式开启的档案只能是单向的 (只能读或只能写)，而且一定要用 pclose() 关闭。在档案操作上可使用 fgets()、fgetss() 与 fputs()。若是开档发生错误，传回 false 值。

 
 
使用范例 

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

 
参考 

pclose()  

--------------------------------------------------------------------------------
 函式:readfile() 
--------------------------------------------------------------------------------
 

档案系统函式库

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() 
--------------------------------------------------------------------------------
 

档案系统函式库

readlink
传回符号连结 (symbolic link) 目标档。

语法: string readlink(string path);

传回值: 字串

函式种类: 档案存取

 
 
内容说明 

本函式和 C 语言的同名函式用法相同，传回符号连结的档案。若发生错误则传回 0。

 
 
参考 

symlink()  linkinfo()  
 

--------------------------------------------------------------------------------
 函式:rename() 
--------------------------------------------------------------------------------
 

档案系统函式库

rename
更改档名。

语法: int rename(string oldname, string newname);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式可将旧档名 oldname 改成新档名 newname。成功则传回 true、失败则传回 false。
 

--------------------------------------------------------------------------------
 函式:rewind() 
--------------------------------------------------------------------------------
 

档案系统函式库

rewind
重置开档的读写位置指标。

语法: int rewind(int fp);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式重置档案的读写位置指标到标案的开头处。发生错误则传回 0。档案 fp 必须是有效且用 fopen() 开启的档案。

 
 
使用范例 

fseek ftell 

--------------------------------------------------------------------------------
 函式:rmdir() 
--------------------------------------------------------------------------------
 

档案系统函式库

rmdir
删除目录。

语法: int rmdir(string dirname);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式可用来删除目录。欲删除的路径必须是空的目录，且权限必须要合乎要求。发生错误则传回 0。

 
 
参考 

mkdir()  
 

--------------------------------------------------------------------------------
 函式:stat() 
--------------------------------------------------------------------------------
 

档案系统函式库

stat
取得档案相关资讯。

语法: array stat(string filename);

传回值: 阵列

函式种类: 档案存取

 
 
内容说明 

本函式可?集档案的相关资讯，并传回阵列。阵列的元素依序如下：

装置名称 (device) 
inode 值 
inode 档案模式 
参照到该档的名称总数，含 link 档。 
拥有者的 UID 
拥有者的 GID 
若为字元或装置设备则为装置型态 (限系统支援 st_blksize 方有效，Windows 系列传回 -1) 
位元组为单位的档案长度 
最后存取时间 
最后修改时间 
最后更动时间 
档案系统的区块大小 (限系统支援 st_blksize 方有效，Windows 系列传回 -1) 
匹配的区块数 
传回值放在快取缓冲区中，参考 clearstatcache()。 

--------------------------------------------------------------------------------
 函式:lstat() 
--------------------------------------------------------------------------------
 

档案系统函式库

lstat
取得连结档相关资讯。

语法: array lstat(string filename);

传回值: 阵列

函式种类: 档案存取

 
 
内容说明 

本函式可?集连结档案的相关资讯，并传回阵列。阵列的元素依序如下：

装置名称 (device) 
inode 值 
连结 (link) 到该档的总数。 
拥有者的 UID 
拥有者的 GID 
若为字元或装置设备则为装置型态 (限系统支援 st_blksize 方有效，Windows 系列传回 -1) 
位元组为单位的档案长度 
最后存取时间 
最后修改时间 
最后更动时间 
档案系统的区块大小 (限系统支援 st_blksize 方有效，Windows 系列传回 -1) 
匹配的区块数 
传回值放在快取缓冲区中，参考 clearstatcache()。 

--------------------------------------------------------------------------------
 函式:symlink() 
--------------------------------------------------------------------------------
 

档案系统函式库

symlink
建立符号连结 (symbolic link)。

语法: int symlink(string target, string link);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式可用来建立符号连结。从参数 target 连结到 link 处。建立硬式连结可用 link() 函式。

 
 
参考 

link()  readlink()  linkinfo()  
 

--------------------------------------------------------------------------------
 函式:tempnam() 
--------------------------------------------------------------------------------
 

档案系统函式库

tempnam
建立唯一的临时档。

语法: string tempnam(string dir, string prefix);

传回值: 字串

函式种类: 档案存取

 
 
内容说明 

本函式可建立一个临时档，档名不会与同目录中的档案重覆。传回字串就是建立的临时档名。若发生错误则传回空字串。

 
 
使用范例 

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

--------------------------------------------------------------------------------
 函式:touch() 
--------------------------------------------------------------------------------
 

档案系统函式库

touch
设定最后修改时间。

语法: int touch(string filename, int [time]);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式可用来设定最后修改时间。若有指定参数 time，则依指定的时间；若无指定时间，则为伺服器的时间。和 UNIX 的同名指令一样，若档案不存在，则会建立 filename 档案。成功则传回 true 值，其它失败时则传回 false。
 

--------------------------------------------------------------------------------
 函式:umask() 
--------------------------------------------------------------------------------
 

档案系统函式库

umask
改变目前的档案属性遮罩 umask。

语法: int umask(int [mask]);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式用来设定 PHP 的 umask 值。此值是 mask 与 0777 运算的值，传回旧的 umask 值。当参数 mask 不存在时，本函式将传回目前的 umask 值。

--------------------------------------------------------------------------------
 函式:unlink() 
--------------------------------------------------------------------------------
 

档案系统函式库

unlink
删除档案。

语法: int unlink(string filename);

传回值: 整数

函式种类: 档案存取

 
 
内容说明 

本函式删除档案 filename，用法像 UNIX 中 C 语言呼叫的同名函式 unlink()。当发生错误则传回 0 或 false。

 
 
参考 

rmdir()