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)。
其他函数
Include
函数描述:include (string filename);
说明:函数include使PHP编译器打开并执行所给的文件。该文件被看作普通的PHP脚本。也可以通过URL以http://或ftp://开头来指明文件。
返回值:无。
Require
函数描述:require (string filename);
说明:函数require使PHP编译器打开并执行所给的文件。该文件被看作普通的PHP脚本。也可以通过URL以http://或ftp://开头来指明文件。
返回值:无。
从表面上看,函数include和require的作用是相同的,我们可以用它们将一些包含已编写代码的文件引入到PHP程序中。在这些文件中,主要存储需要重复使用的常量、变量声明和一些函数的声明和定义。函数include和require的使用,可以使复杂的PHP程序变得简洁明了。
但在实际执行过程中,这两个函数有着很大的差别。函数require通常放在PHP程序的最前面,PHP程序开始执行,就会先读入require所指定的文件,将它变成PHP程序的一部分。常用的自定义函数可以通过这种方法引入PHP程序。而函数include通常放在PHP程序的循环结构中,每次程序运行include语句,就将include所指定的文件引入PHP程序执行一遍。
Header
函数描述:int header(string http_header);
说明:函数hader发送一个http头标给浏览器,需要注意的是,函数必须将任何输出发送给浏览器之前调用。
返回值:如果发送成功,函数header返回true(1);否则返回false(0)。
Getenv
函数描述:string getenv(string variable);
返回值:函数getenv返回所给出的环境变量值;若出错,则返回false(0)。
Putenv
函数描述:putenv(string variable);
说明:函数putenv设置一个环境变量的值。
Getallheaders
函数描述:array getallheader();
返回值:函数getallheader返回在服务器和浏览器之间交换的所有头,其中有些将被转换为环境变量。
Setcookie
函数描述:int setcookie(string name,string value,int expire ,string path,string domain,int secure);
返回值:如果设置成功,返回true(1);否则返回false(0)。
Gethostbyaddr
函数描述:string gethostbyaddr(string ip_address);
返回值:函数gethostbyaddr返回由IP地址指定的主机名。
Gethostbyname
函数描述:string gethostbyname(string hostname);
返回值:函数gethostbyname返回由主机名hostname指定的主机的IP地址。
Gethostbynamel
函数描述:array Gethostbynamel(string hostname);
返回值:函数Gethostbynamel返回由主机名hostname指定的主机的IP地址列表。
PHP中的环境变量
变 量 名 描 述
AUTH_TYPE 该变量提供用来访问脚本使用的认证协议(需本地服务器支持)
GETEWAY_INTERFACE 本地服务器支持的CGI版本
HTTP_USER_AGENT 用户浏览器的类型和版本
HTTP_FROM 用户的E-mail地址(在給HTML表单提供了默认值的情况下才能使用)
PATH_INFO 调用脚本的HTML请求的路径信息
REMOTE_ADDR 用户的IP地址
REMOTE_HOST 用户所使用的计算机的域名
SCRIPT_NAME 脚本的路径名
SERVER_NAME 服务器的主机名
SERVER_PORT 本地web服务器监听的端口号
SERVER_PROTOCOL 服务器使用的网络协议的版本
SERVER_SOFTWARE Web服务器的名称和版本
PHP数据库函数(基于MySQL)
PHP关于MySQL数据库的函数有几十个,这里只介绍常用的一些,目的是能够快速上手。如果实践中需要更多的库函数,可以翻阅PHP函数手册。
Mysql_connect
函数描述:int mysql_connect(string [hostname] ,string [username] , string [password]);
说明:mysql_connect是最常用一个函数,它用来建立和指定主机上的Mysql数据库的连接。三个参数均是可选选取项,默认值分别是:localhost、服务器进程的所有者及空串。其中,hostname可包含端口号,可写为:hostname:port。
在该PHP脚本运行结束时,连接被自动关闭,当然也可经用mysql_close来提前结束该连接。如果想建成立永久性连接,可使用函数mysql_pconnect。除了这一点外,这个函数是和mysql_connect完全相同。
返回值:连接成功后会返回一个MySQL连接标识符,失败时返回 false。
mysql_select_db
函数描述: int mysql_select_db(string database_name , int [link_identifier]);
说明:mysql_select_db用来根据连接标识符在该数据库服务器上选取数据库作为当前的数据库。如果不特别声明连接标识符,则默认为是上一次打开的连接。该函数使用前必须调用Mysql_connect函数。
返回值:选取成功后返回true,失败时返回false。
Mysql_query
函数描述:int mysql_query(string query ,int [link_identifier]);
说明:mysql_query用来根据连接标识符向该数据库服务器的当前数据库发送查询,如果连接标识符默认,则默认为是上一次打开的连接。Query为标准SQL语句。
返回值:成功后返回一个结果标识符,失败时返回false。
Mysql_fetch_row
函数描述:int mysql_fetch_row(int result);
说明:mysql_fetch_row用来查询结果的一行保存至数组,该数组下标从0开始,每一个数组元素对应一个域。通过循环,可以将查询结果全部获得。
返回值:返回下行的所有域值,并将其保存至一个数组中,没有行时返回false。
Mysql_fetch_array
函数描述:array int result);
说明:mysql_fetch_array和mysql_fetch_row功能基本相同,只不过它除了可以用从0开始的偏移量作索引,还可以用域名作索引。
返回值返回下一行的所有域值,并将其保存至一个数组中,没有行时返回false。
Mysql_num_rows
函数描述:int (string result);
说明:mysql_num_rows用于计算查询结果中所得行的数目。
返回值:返回查询结果中所得行的数目。
Mysql_result
函数描述:int mysql_result(int result , int row , mixed field);
说明:mysql_resultet 用于获取结果集中指定域的数据。Field可以是一个偏移量,也可以是列名,如果列有别名,还可以用这外别名。
返回值:返回结果集中指定行、指定偏听偏信移量的数据。
Mysql_close
函数描述:int mysql_close(int [link_identifier]);
说明:mysql_close用于关闭当前与数据库服务器的连接。
返回值:成功后返回true,失败时返回false。
Session函数
Session_start
函数描述:boolean session_start(void);
功能说明:session_start函数的功能是初始化一个新的session,如果已经存在一个为该用户服务的session,则连接原有的session。
参数说明:无。
返回值:逻辑类型变量,且值永远为真。
Session_destroy
函数描述:boolean session_destroy(void);
功能说明session_destroy结束原有的session 。
参数说明:无。
返回值:逻辑类型变量,且值永远为真。
Session¬_register
函数描述:boolean session_register(string name);
功能说明:在session中增加一个变量。
参数说明:“string name”变量名。
返回值:逻辑类型变量。操作成功返回真值。
Session_unregister
函数说明:boolean session_unregister(string name);
功能说明:在session中删除一个变量。
参数说明:“string name”变量名。
返回值:逻辑类型变量。操作成功返回真值。
Session_is_registered
函数描述:boolean session_is_registered(string name);
功能说明:检查session中是否存在所指定的变量。
参数说明:“string name”变量名。
返回值:逻辑类型变量。
Session_encode
函数描述:boolean session_encode(void);
功能说明:session_encode函数对当前的session资料编码,PHP4采用哈希编码。
参数说明:无。
返回值:逻辑类型变量。编码成功则返回真值。
Session_decode
函数描述:boolean session_decode(string data);
功能说明:session_decode可以编过码的资料解码。
参数说明:“string data”需要解码的资料。
返回值:逻辑类型变量。