PHP 文件系统函数库 (3) 晴

jed , 2007-4-14 08:33 , 代码编程 , 评论(0) , 阅读(6260) , Via 本站原创 | |
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()

Tags:
发表评论

昵称

网址

电邮

打开HTML 打开UBB 打开表情 隐藏 记住我 [登入] [注册]