文件操作函数
Basename
函数描述：string basename（string path）；
返回值：返回路径path底端的文件名。
Chdir
函数描述：int chdir（string directory）；
说明：函数chdir改变PHP脚本的默认路径。
返回值：如果改变成功，返回true（1），否则返回false（0）。
Chgrp
函数描述：int chgrp（string filename ，string group）；
说明：在UNIX中函数chgrp改变一个文件所在的组，但在Windows下该函数返回true（1）而无任何作用。
返回值：如果改变成功，返回true（1）；否则返回false（0）。
Chmod
函数描述：int chmod（string filename，int mode）；
说明：函数根参数mode给出的文件模式，对给出的文件设置UNIX权限。文件模式如下表：
返回值：如改变成功，返回true（1）；否则返回发false（0）。
文件模式表
|
模 式
|
描 述
|
|
0
|
文件不许访问
|
|
1
|
文件可执行
|
|
2
|
文件可写
|
|
4
|
文件可读
|
Chown
函数描述：int chown（string ，string user）；
说明：此函数改变文件所有者的名字。
返回值：如果改变成功，返回true（1）；否则，返回false（0）。
Closedir
函数描述：int closedir（int directory_handle）；
说明：在一个路径被函数opendir打开后，用此函数关闭该路径。
返回值：如果关闭成功，返回true（1）；否则，返回false（0）。
Copy
函数描述：int copy（string oldfilename ，string newfilename）；
说明：copy把由原参数oldfilename说明的文件复制到由目的参数newfilename说明的文件中。
返回值：如果复制成功，返回true（1）；否则，返回false（0）。
Dir
函数描述：obj dir（string directory）；
返回值：函数返回一个目录对象，该对象有两个属性：句柄和路径。句柄可被其他目录函数使用，路径是用来生成目录对象的字符串。如果出错，则返回false（0）。
Fclose
函数描述：int fclose(int file_handle);
说明：此函数关闭一个已打开的文件。参数file_handle为一个文件被打开时产生的句柄。
返回值：如果关闭成功，返回true（1）；否则，返回false（0）。
Feof
函数描述：int feof（int file_handle）;
说明：在读取文件时，PHP始终保持一个指向该文件末尾的指针。函数feof用以确定读取指针是否已到达文件末尾。
返回值：若文件读取指针达到文件末尾，函数feof返回ture（1）；否则返回false（0）。
Fgetc
函数描述：string fgetc（int file_handle）；
说明：参数file_handle是一个文件被打开时产生的句柄。
返回值：函数fgetc从一个已经对打开的文件中读取一个单个字符。如出错，则返回false（0）。
Fgets
函数描述：string fgets（int file_handle, int length）；
返回值：返回从文件中读取的字符串，文件由文件句柄file_handle指定，读取长度将根据length-1尽可能的读取字符，支行结束或文章末尾。若出错，则返回false（0）。
Fgetss
函数描述：string fgetss（int file_handle，int length）；
返回值：与fgets相类似，只是在返回字符串时，试着剥去HTML或PHP代码。
File
函数描述：array file（string filename）；
返回值：函数返回一个数组，数组的元素一次是文件的每一行，数组下标从开始。若出错，则返回false(0).
File_exists
函数描述：int file_exists(string filename);
说明：此函数用来确定文件是否存在。
返回值：若存在，返回true（1）；否则返回false（0）。
Fileatime
函数描述：int fileatime（string filename）；
返回值：以标准时间戳的格式，即从1971年1月1日起以秒计，返回最近改变文件的时间。在Windows下返回文件的生成时间。
Filectime
函数描述：int filectime（string filename）；
返回值：在UNIX下，函数filectime返回以标准时间戳的格式，即从1971年1月1日起以秒计，返回最近改变文件的时间。在Windows下返回文件的生成时间。
Filegroup
函数描述：int filegroup（string filename）；
返回值：在UNIX下，返回所给文件的组标志符，若出错则返回false（0）。在windows下总返回false（0）。
Fileinode
函数描述：int fileinode（string filename）；
返回值：在UNIX下，返回所给文件的inode，若出错则返回false（0）。在windows下总返回false（0）。
Filemtime
函数描述：int filemtime（string filename）；
返回值：函数filemtime返回以标准时间戳的格式，即从1971年1月1日起以秒计，返回最近改变文件的时间。该函数在UNIX和Windows下运行的结果一样。
Fileowner
函数描述：int fileowner（string filename）；
返回值：在UNIX下，函数返回文件所有者的用户标识符，若出错则返回false（0）。在windows下总返回false（0）。
Fileperms
函数描述：int fileperms（string filename）；
返回值：返回文件的许可权，若出错则返回false（0）。
Filesize
函数描述：int filesize（string filename）；
返回值：返回所给文件打消的字节数。
Filetype
函数描述：int filetype（string filename）；
返回值：函数filetype返回所给文件的类型作为描述的字符串，可能值为block,char,dir,fifo,file,link和unknown。
Fopen
函数描述：int fopen（string filename，string mode）；
说明：函数fopen根据参数filename和mode打开一个文件以便读写。若参数filename以“http://”或“ftp://”开始，则文件通过Internet用http或ftp协议打开；否则文件在本地系统内打开。
若模式带有“+”号，则为更新模式，它允许同时读和写；若字母“b”出现在模式的最后部分，则该文件被认为是二进制文件。（文件打开模式参见下表）
文件打开模式表
|
模 式
|
说 明
|
|
r
|
以只读模式打开一个文件，并将文件内部指针指向文件开头
|
|
r+
|
以可读可写模式打开一个文件，并将文件内部指针指向文件开头
|
|
w
|
以只写模式打开一个文件，并将原文件内容清空，并将文件内部指针指向文件开头；若指定文件不存在，则创建一个名为filename的新文件。
|
|
w+
|
以可读可写模式打开一个文件，并将原文件内容清空，并将文件内部指针指向文件开头；若指定文件不存在，则创建一个名为filename的新文件。
|
|
a
|
以只写模式打开一个文件，并将文件内部指针指向文件末尾；若指定文件不存在，则创建一个名为filename的新文件。
|
|
a+
|
以可读可写模式打开一个文件，并将文件内部指针指向文件末尾；若指定文件不存在，则创建一个名为filename的新文件。
|
Fpassthru
函数描述：int fpassthru(int file_handle);
返回值：函数fpassthru向浏览器输出文件，完成后将文件关闭。若出错则返回发false（0）。
Fputs
函数描述：int fputs（int file_handle,string output）;
说明：函数fputs将数据写入一个打开的文件。
返回值:如果写入成功，返回true(1)；否则返回false（0）。
Fread
函数描述：string fread（int file_handle,string length）;
返回值：函数fread返回从指定文件中读取的字符串，当字符串长度等于参数length或文件结束时，读取结束。若读取失败，则返回false（0）。
Fseek
函数描述：int fseek（int file_handle,int offset）;
说明：函数fseek修改PHP中一个已打开文件的内部指针，其偏移量即距离文件头的字节数等于参数offset。
返回值：若修改成功，函数fseek返回0；否则返回-1。这需要读者注意。
Ftell
函数描述：int ftell（int file_handle）;
返回值：函数ftell返回PHP文件内部指针的偏移量。
Fwrite
函数描述：int fwrite（int file_handle, string string, int [length]）;
说明：函数fwrite将字符串string写入由文件句柄file_handle指定的文件。若可选参数length给出，则当字符串string结束或写入长度达length时写入结束。
返回值：若写入成功，返回true(1);否则返回false（0）。
提示：以字符“gz”开始的库函数，用于对压缩文件的操作。
Gzclose
函数描述：int gzclose(int file_handle);
说明：关闭由gzopen打开的文件。
返回值：若关闭成功返回true（1）；否则返回false（0）。
（Gzof、Gzfile、Gzgetc、Gzgets、Gzgetss、Gzopen、Gzpassthru、Gzputs、Gzrewind、Gzseek、Gztell）与前面的文件操作函数类似。
Is_dir
函数描述：int is_dir(string filename);
返回值：若给出的参数filename是一个目录，则函数is_dir返回true（1）；否则返回false（0）。
Is_executable
函数描述：int is_executable（string filename）；
返回值：如果文件存在且可执行，返回true（1）；否则返回false（0）。
Is_file
函数描述：int is_file(string filename);
返回值：如果参数filename]所指的文件存在且是一个正常的文件，则函数is_file返回true（1）；否则返回false（0）。
Is_link
函数描述：int is_link(string dilename);
返回值：如果参数filename是符号连接，则函数is_link返回true（1）；否则返回false（0）。
Is_readable
函数描述：int is_readable(string filename);
返回值：如果文件存在且可读，则函数is_readable返回true(1);否则返回false（0）。在UNIX中，取决于文件的许可权，在Windows中函数的返回值总为true。
Is_writeable
函数描述：int is_writeable(string filename);
返回值：如果文件存在且可写，则函数is_writeable返回true（1）；否则返回false（0）。
Link
函数描述：int link(string source,string destination);
说明：函数link生成一个硬链接。在Windows中，该函数不起任何作用，也不返回任何值。
Mkdir
函数描述：int mkdir（string directory，int mode）；
说明：函数mkdir用所给的名字创建一个新的目录，许可权根据模式参数进行设置。
返回值：目录创建成功，返回true(1);否则返回false（0）。
Opendir
函数描述：int opendir（string directory）；
返回值：函数opendir根据所给目录名directory返回一个目录句柄。
Pclose
函数描述：int pclose（int file_handle）；
说明：关闭由popen函数打开的文件流。
Popen
函数描述：int popen（string command，string mode）；
说明：函数popen打开一个通向正在执行的命令的管道，该管道可读可写。
返回值：函数popen返回一个文件句柄。
Readdir
函数描述：string readdir（int directory_handle）；
返回值：函数readdir返回由目录句柄directory_handle指定目录中的下一个文件的文件名。
Readfile
函数描述：int readfile（string filename）；
说明：用函数readfile读取所给的文件并直接发送给浏览器。若参数filename是以
http://或ftp://开头的，则相应地用http或ftp协议读取文件。
Readgzfile
与readfile类似，只是他作用于压缩文件。
Readlink
函数描述：string readlink（string filename）；
返回值：函数readlink返回一个符号链接所指的路径；若出错，则返回false（0）。
Rename
函数描述：int rename（string old_name,string new_name）；
说明：函数rename将参数old_name指定的文件名改变为由参数new_name指定的文件名。
返回值：若改变成功，返回true（1）；否则返回false（0）。
Rewind
函数描述：int rewind（int file_handle）;
说明：函数rewind将PHP的内部文件指针移到文件头。
Rewinddir
函数描述：int rewinddir（int directory_handle）;
说明：函数rewinddir将PHP的内部指针重置到一目录列表的开头。
返回值：若重置成功，则函数rewinddir返回true（1）；否则返回false（0）。
Rmdir
函数描述：int rmdir（string directory）；
说明：利用函数rmdir可以删除一个目录。
返回值：若删除成功，则函数rmdir返回true（1）；否则返回false（0）。
Stat
函数描述：array stat（string filename）；
说明：函数stat执行C语言中的stat函数并返回一个由13个元素的数组。元素如表所示：
返回值：函数stat返回生成的数组。
函数stat的返回数组元素表
|
元 素 下 标
|
元 素 内 容
|
|
0
|
文件所在设备或驱动器字母
|
|
1
|
索引节点
|
|
2
|
文件模式
|
|
3
|
链接数
|
|
4
|
用户
|
|
5
|
文件所在组
|
|
6
|
设备类型或驱动器字母
|
|
7
|
文件大小
|
|
8
|
文件的最后访问时间
|
|
9
|
文件的最后修改时间
|
|
10
|
文件的最后改变或生成时间
|
|
11
|
块大小
|
|
12
|
块数目
|
Symlink
函数描述：int symlink（string source，string destination）;
说明：函数symlink用目的参数中的名字创建一个符号链接到源参数。
返回值：若创建成功，返回true(1);否则返回false（0）。
Touch
函数描述：int touch（string filename，string [time]）；
说明：函数将文件的最近修改时间设置为给出的时间time，time为从1970年1月1日起的秒数。若time默认，则使用当前时间。
Umask
函数描述：int umask（int [umask]）；
说明：函数返回文件创建时赋予的默认的许可权。
返回值：若给出了可选参数umask，则函数返回参数umask与0777的逻辑与。在Windows下，该函数不起任何作用，且返回false（0）。
Unlink
函数描述：int unlink（string filename）；
说明：函数unlink永久删除一个文件。
返回值：若删除成功，则函数unlink返回true（1）；否则返回false（0）。
