PHP函数库分类十四.doc

PHP函数库分类十四4. Directories(一) chdir- 改变目录chdir改变目录说明boolchdir(string$directory)将 PHP 的当前目录改为directory。参数directory新的当前目录返回值成功时返回TRUE， 或者在失败时返回FALSE.范例Example #1chdir()例子以上例程的输出类似于：/home/vincent/home/vincent/public_html注释Note:当启用 安全模式时， PHP 会在执行脚本时检查被脚本操作的目录是否与被执行的脚本有相同的 UID（所有者）。 chroot- 改变根目录chroot改变根目录说明boolchroot(string$directory)将当前进程的根目录改变为directory。本函数仅在系统支持且运行于 CLI，CGI 或嵌入 SAPI 版本时才能正确工作。此外本函数还需要 root 权限。参数directory新目录返回值成功时返回TRUE， 或者在失败时返回FALSE.注释Note:此函数未在 Windows 平台下实现。 closedir- 关闭目录句柄closedir关闭目录句柄说明voidclosedir(resource$dir_handle)关闭由dir_handle指定的目录流。流必须之前被opendir()所打开。参数dir_handle目录句柄的resource，之前由opendir()所打开的。范例Example #1closedir()例子 getcwd- 取得当前工作目录getcwd取得当前工作目录说明stringgetcwd(void)取得当前工作目录。返回值成功则返回当前工作目录，失败返回FALSE。在某些 Unix 的变种下，如果任何父目录没有设定可读或搜索模式，即使当前目录设定了，getcwd()还是会返回FALSE。有关模式与权限的更多信息见chmod()。范例Example #1getcwd()例子以上例程的输出类似于：/home/didou/home/didou/cvs opendir- 打开目录句柄opendir打开目录句柄说明resourceopendir(string$path,resource$context )打开一个目录句柄，可用于之后的closedir()，readdir()和rewinddir()调用中。参数path要打开的目录路径contextcontext参数的说明见手册中的Streams API一章。返回值如果成功则返回目录句柄的resource，失败则返回FALSE。如果path不是一个合法的目录或者因为权限限制或文件系统错误而不能打开目录，opendir()返回FALSE并产生一个 E_WARNING 级别的 PHP 错误信息。可以在opendir()前面加上“”符号来抑制错误信息的输出。更新日志版本说明5.0.0path支持ftp:/URL wrapper4.3.0path可以是任何支持目录列表的 URL，不过在 PHP 4 中只有file:/URL wrapper 支持此功能范例Example #1opendir()例子以上例程的输出类似于：filename: . : filetype: dirfilename: . : filetype: dirfilename: apache : filetype: dirfilename: cgi : filetype: dirfilename: cli : filetype: dir readdir- 从目录句柄中读取条目readdir从目录句柄中读取条目说明stringreaddir(resource$dir_handle)返回目录中下一个文件的文件名。文件名以在文件系统中的排序返回。参数dir_handle目录句柄的resource，之前由opendir()打开返回值成功则返回文件名，失败返回FALSE。范例Example #1 列出目录中的所有文件请留意下面例子中检查readdir()返回值的风格。这里明确地测试返回值是否全等于（值和类型都相同更多信息参见比较运算符）FALSE，否则任何目录项的名称求值为FALSE的都会导致循环停止（例如一个目录名为“0”）。Example #2 列出当前目录的所有文件并去掉.和. rewinddir- 倒回目录句柄rewinddir倒回目录句柄说明voidrewinddir(resource$dir_handle)将dir_handle指定的目录流重置到目录的开头。参数dir_handle目录句柄的resource，之前由opendir()打开 scandir- 列出指定路径中的文件和目录scandir列出指定路径中的文件和目录说明arrayscandir(string$directory,int$sorting_order,resource$context )返回一个array，包含有directory中的文件和目录。参数directory要被浏览的目录sorting_order默认的排序顺序是按字母升序排列。如果使用了可选参数sorting_order（设为 1），则排序顺序是按字母降序排列。contextcontext参数的说明见手册中的Streams API一章。返回值成功则返回包含有文件名的array，如果失败则返回FALSE。如果directory不是个目录，则返回布尔值FALSE并生成一条E_WARNING级的错误。范例Example #1 一个简单的scandir()例子以上例程的输出类似于：Array( 0 = . 1 = . 2 = bar.php 3 = foo.txt 4 = somedir)Array( 0 = somedir 1 = foo.txt 2 = bar.php 3 = . 4 = .)Example #2scandir()在 PHP 4 中的实现以上例程的输出类似于：Array( 0 = . 1 = . 2 = bar.php 3 = foo.txt 4 = somedir)Array( 0 = somedir 1 = foo.txt 2 = bar.php 3