PHP常用库函数.pdf

-函数描述：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,intlength）；返回值：返回从文件中读取的字符串，文件由文件句柄file_handle 指定，读取长度将根据 length-1 尽可能的读取字符，支行结束或文章末尾。若出错，则返回false（0）。Fgetss 函数描述：string fgetss（int file_handle，int length）；返回值：与 fgets 相类似，只是在返回字符串时，试着剥去 HTML 或 PHP 代码。File 函数描述：array file（stringfilename）；返回值：函数返回一个数组，数组的元素一次是文件的每一行，数组下标从开始。若出错，则返回 false(0).File_e*ists 函数描述：int file_e*ists(string filename);说明：此函数用来确定文件是否存在。返回值：若存在，返回 true（1）；否则返回 false（0）。Fileatime函数描述：int fileatime（string filename）；返回值：以标准时间戳的格式，即从1971 年1月1日起以秒计，返回最近改变文件的时间。在Windows下返回文件的生成时间。Filectime函数描述：int filectime（string filename）；返回值：在 UNI*下，函数 filectime 返回以标准时间戳的格式，即从1971 年 1 月 1 日起以秒计，返回最近改变文件的时间。在Windows下返回文件的生成时间。Filegroup 函数描述：int filegroup（string filename）；返回值：在 UNI*下，返回所给文件的组标志符，若出错则返回 false（0）。在 windows 下总返回 false（0）。Fileinode 函数描述：int fileinode（string filename）；返回值：在 UNI*下，返回所给文件的 inode，若出错则返回false（0）。在 windows 下总返回 false（0）。Filemtime 函数描述：int filemtime（string filename）；返回值：函数 filemtime 返回以标准时间戳的格式，即从 1971 年 1 月 1 日起以秒计，返回最近改变文件的时间。该函数在 UNI*和 Windows下运行的结果一样。Fileowner 函数描述：int fileowner（string filename）；返回值：在UNI*下，函数返回文件所有者的用户标识符，若出错则返回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，stringmode）；说明：函数 fopen 根据参数 filename 和 mode 打开一个文件以便读写。若参数filename 以“”或“ftp:/”开始，则文件通过 Internet 用 http 或 ftp 协议打开；否则文件在本地系统内打开。如： 若模式带有“+”号，则为更新模式，它允许同时读和写；若字母“b”出现在模式的最后部分，则该文件被认为是二进制文件。（文件打开模式参见下表）文件打开模式表模 式 说 明 r 以只读模式打开一个文件，并将文件内部指针指向文件开头 r+以可读可写模式打开一个文件，并将文件内部指针指向文件开头w 以只写模式打开一个文件，并将原文件内容清空，并将文件内部指针指向文件开头；若指定文件不存在，则创建一个名为 filename 的新文件。w+以可读可写模式打开一个文件，并将原文件内容清空，并将文件内部指针指向文件开头；若指定文件不存在，则创建一个名为filename 的新文件。a 以.z.-只写模式打开一个文件，并将文件内部指针指向文件末尾；若指定文件不存在，则创建一个名为 filename 的新文件。a+以可读可写模式打开一个文件，并将文件内部指针指向文件末尾；若指定文件不存在，则创建一个名为 filename 的新文件。Fpassthru 函数描述：intfpassthru(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,intoffset）;说明：函数 fseek 修改 PHP 中一个已打开文件的内部指针，其偏移量即距离文件头的字节数等于参数 offset。返回值：若修改成功，函数 fseek 返回 0；否则返回-1。这需要读者注意。Ftell 函数描述：int ftell（int file_handle）;返回值：函数 ftell 返回 PHP 文件内部指针的偏移量。Fwrite 函数描述：int fwrite（int file_handle,string string,intlength）;说明：函数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_e*ecutable函数描述：int is_e*ecutable（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 函数描述：intis_readable(string filename);返回值：如果文件存在且可读，则函数is_readable 返回true(1);否则返回 false（0）。在 UNI*中，取决于文件的许可权，在Windows 中函数的返回值总为 true。Is_writeable 函数描述：int is_writeable(string filename);返回值：如果文件存在且可写，则函数is_writeable 返回 true（1）；否则返回false（0）。Link 函数描述：intlink(string source,string destination);说明：函数 link 生成一个硬。在 Windows 中，该函数不起任何作用，也不返回任何值。Mkdir 函数描述：int mkdir（string directory，int mode）；说明：函数 mkdir 用所给的名字创建一个新的目录，许可权根据模式参数进行设置。返回值：目录创建成功，返回 true(1);否则返回 false（0）。Opendir 函数描述：int opendir（stringdirectory）；返回值：函数 opendir 根据所给目录名 directory 返回一个目录句柄。Pclose函数描述：int pclose（int file_handle）；说明：关闭由 popen 函数打开的文件流。Popen函数描述：int popen（string mand，string mode）；说明：函数 popen 打开一个通向正在执行的命令的管道，该管道可读可写。返回值：函数 popen 返回一个文件句柄。Readdir函数描述：string readdir（int directory_handle）；返回值：函数 readdir 返回由目录句柄directory_handle 指定目录中的下一个文件的文件名。Readfile 函数描述：int readfile（string filename）；说明：用函数 readfile 读取所给的文件并直接发送给浏览器。若参数filename是以或ftp:/开头的，则相应地用http或ftp协议读取文件。Readgzfile与readfile类似，只是他作用于压缩文件。Readlink函数描述：string readlink（string filename）；返回值：函数 readlink 返回一个符号所指的路径；若出错，则返回 false（0）。Rename 函数.z.-描述：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（intdirectory_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 函数描述：inttouch（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 以或 ftp:/开头来指明文件。返回值：无。Require 函数描述：require（stringfilename）；说明：函数 require 使 PHP 编译器打开并执行所给的文件。该文件被看作普通的 PHP 脚本。也可以通过 URL 以或 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(stringvariable);返回值：函数 getenv 返回所给出的环境变量值；若出错，则返回 false（0）。Putenv函数描述：putenv（string variable）；说明：函数putenv 设置一个环境变量的值。Getallheaders 函数描述：array getallheader();返回值：函数 getallheader 返回在服务器和浏览器之间交换的所有头，其中有些将被转换为环境变量。Setcookie 函数描述：intsetcookie（string name,string value,int e*pire,string path,string domain,int secure）;返回值：如果设置成功，返回 true（1）；否则返回 false（0）。Gethostbyaddr 函数描述：string gethostbyaddr（string ip_address）;返回值：函数 gethostbyaddr 返回由 IP 地址指定的主机名。Gethostbyname 函数描述：string gethostbyname（string hostname）；返回.z.-值：函数 gethostbyname 返回由主机名 hostname 指定的主机的 IP 地址。Gethostbynamel函数描述：array Gethostbynamel（string hostname）；返回值：函数 Gethostbynamel 返回由主机名 hostname 指定的主机的 IP 地址列表。PHP 中的环境变量变 量 名 描 述AUTH_TYPE 该 变 量提供 用 来 访问 脚 本使 用的 认 证 协议（需本 地服 务 器 支持）GETEWAY_INTERFACE本地服务器支持的 CGI 版本 HTTP_USER_AGENT 用户浏览器的类型和版本 HTTP_FROM 用户的地址（在給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 函 数 描 述：intmysql_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,mi*ed 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.z.-session_register(string name);功能说明：在 session 中增加一个变量。参数说明：“stringname”变量名。返回值：逻辑类型变量。操作成功返回真值。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”需要解码的资料。返回值：逻辑类型变量。.z.