PHP3中文文档（续6）

中文

字符串操作函数

    PHP3.0中的字符串操作功能是比较多的,重要的有以下这些:

    (1)echo,print,printf,sprintf

    用于输出字符串.字符串中如果有变量名则被替换成其值. 后两个函数类似于C的同名函数.

　

    (2)strchr, strlen, strtok, strrchr, strrev, strstr, strtolower, strtoupper, substr, ucfirst

    用的字符串操作函数,有些和C中的同名函数意义完全一致. strrev是把一个字符串翻转. strtolower和strtoupper是将字符串转换为小写和大写.ucfirst是把字符串的第一个字符变成大写. substr是返回字符串的一个子串,用法是:substr(字符串,头,长度).头位置是 从0算起的.如果是负数,则是从尾部向前数的意思.

　

    (3)Chr,Ord

    同名函数.

　

    (4)explode,implode,join

    与数组有关的函数. explode(字符串,分割符)返回一个将字符串在分割符处分开所产生的数组. implode(数组,分割符)返回一个将数组各元素之间插上分割符而成的字符串. join与implode意义相同.

　

    (5)Chop

    处理串尾部的空白.

　

    (6)htmlspecialchars

    将HTML特殊字符换成它们的名字,例如"
　

    (7)nl2br

    在HTML中的每一个回车前面加上"
".

　

    (8)AddSlashes,StripSlashes

    给字符串中按照需要加上"\"和去掉"\"，对于某些数据库，必须在要查询的字符加上和去掉"\"之后才能够查询.

　

    (9)parse_str

    将"name1=value1&name2=value2&..."类型的字符串分析成一些变量.

　

    例如: parse_str("a=1&b=2"); 生成$a与$b两个变量,值分别为1,2. 如果有两对名字/值的名字部分相同,则后一个的值覆盖前一个的. 如果这两对的名字尾部都有"[]",例如"a[]=1&a[]=2",则生成数组$a,两个元素分别为1,2.

正规表达式函数     

    PHP与其它跨平台语言(也许Java不在其列. :))类似,也有正规表达式功能. PHP3.0的正规表达式功能当然远远比不上Perl,但还是足够用的,主要函数有这么些:

    （1）ereg,eregi

    这是正规表达式匹配函数,前者是大小写有关匹配,后者则是无关的.

    用法: ereg(正规表达式,字符串,[匹配部分数组名]);

    PHP3.0中的正规表达式大体类似于grep中用的.

　

    (2)ereg_replace,eregi_replace

    这些是替换函数.

    用法:

    ereg_replace(正规表达式,替换串,原字符串);

    字符串处理函数中有一个strtr,是"翻译"函数,类似于Perl中的tr/.../.../,

    用法: strtr(字符串,"从","到");

    例如:strtr("aaabb","ab","cd")返回"cccdd".

    

    (3)split

    与explode函数有些类似,但这次可以在匹配某正规表达式的地方分割字符串.

    用法:

    split(正规表达式,字符串,[取出前多少项]);

文件操作函数

    PHP3.0中的文件操作函数大体和C的类似,但有一些扩充,特别是除了支持

    对本机文件的访问外,也支持对HTTP和FTP的URL进行访问,只要把这些URL作为文件名传递给文件操作函数就可以了.

    主要的文件操作函数有:

    (1)fclose, feof, fgetc, fgets, fopen, fputs, fseek, ftell, mkdir, readlink, rename, rewind, rmdir, stat, unlink

    这些函数的功能和C语言中的同名函数类似.

　

    (2)chgrp, chmod, chown, copy

    这些函数的含义也都很容易理解:

chgrp(文件名,组);

chmod(文件名,模式);

chown(文件名,用户);

copy(源文件名,目标文件名);

    需要注意的是：这些函数用的是文件名而不是fopen返回的文件号.

　

    (3)file_exists, fileatime, filectime, filegroup, fileinode, filemtime, fileowner, filesize, filetype, fileperms, fileumask, is_dir, is_executable, is_file, is_link, is_readable, is_writeable

    这些是文件信息函数,大多接受一个文件名作为参数.

　

    (4)fgetss

    用法:

    fgetss(文件号,最大长度);

    读取文件的一行或直到最大长度(类似于fgets),但去掉所有的 HTML和PHP标记.

　

    (5)file

    用法:

    file(文件名);

    返回一个数组,每一个元素是文件中的一行.

　

    (6)tempnam

    用法:

    tempnam(目录名,前缀);

    返回一个临时文件名.

　

    (7)basename, dirname

    取得文件路径中的文件名部分和目录名部分. 在Windows系统下,"/"和"\"都可以作为目录分割符,其他系统下只有"/"可以.

目录遍历函数     

    PHP中的目录遍历功能本来也很普通,但它却具有一种"面向对象"的形式, 所以也提一下:

    (1)dir, opendir

    用法:

    $d = dir("目录名");

    $handle = opendir("目录名");

    前者返回一个目录对象,后者返回一个目录句柄. 前者返回的对象有handle和path两个属性,第一个就相当于opendir 返回的句柄,第二个就是目录名本身.访问时用$d->handle和$d->path.

　

    (2)read, readdir, rewind, rewinddir, close, closedir

    三组中每组的前一个是目录对象的方法,用"对象->方法()"调用, 后一个是函数,用"函数名(目录句柄)"调用. read是返回目录中的下一个文件名. rewind是回到目录的第一个文件名. close是关闭目录,不再遍历.

　

    (3)chdir

    转换PHP的工作目录.

时间函数

    PHP中的时间函数有这么些:

    (1)date

    用法:

    date(格式,[时间]);

    如果没有时间参数,则使用当前时间. 格式是一个字符串,其中以下字符有特殊意义:

U 替换成从一个起始时间(好象是1970年1月1日)以来的秒数Y 替换成4位的年号.

y 替换成2位的年号.

F 替换成月份的英文全称.

M 替换成月份的英文简称.

m 替换成月份数.

z 替换成从当年1月1日以来的天数.

d 替换成日数.

l 替换成星期几的英文全称.

D 替换成星期几的英文简称.

w 替换成星期几(数字).

H 替换成小时数(24小时制).

h 替换成小时数(12小时制).

i 替换成分钟数.

s 替换成秒数.

A 替换成"AM"或"PM".

a 替换成"am"或"pm".

S 替换成序数字后缀,例如:"st","nd","rd","th".

    函数返回作过了替换的格式串.

　

    (2)getdate(时间)

    返回一个哈希表,各下标是:

"seconds" -- 秒数

"minutes" -- 分数

"hours" -- 小时数

"mday" -- 日数

"mon" -- 月份数

"year" -- 年号

"yday" -- 1月1日以来的天数

"weekday" -- 星期几,英文全称

"month" -- 月份,英文全名

　

(3)gmdate

    与date类似,但先将时间转换成格林威治标准时.

　

    (4)mktime

用法:

mktime(小时数,分数,秒数,月,日,年); 返回一个时间值,可用于其他函数.

　

    (5)time

用法:

time(); 返回1970年1月1日零点以来的秒数.

　

(6)microtime

用法:

microtime(); 返回一个字符串,用空格分成两部分,后一部分相当于time()

的返回值,前一部分是微秒数.

    

    (7)checkdate

用法:

checkdate(月,日,年); 返回逻辑真或逻辑假. 如果:

年在1900和32767之间(包括1900与32767);
月在1到12之间;
日在该月的允许日数范围内(考虑了闰年);

则返回逻辑真.

　

    (8)set_time_limit

    用法:

set_time_limit(秒数);

规定从该句运行时起程序必须在指定秒数内运行结束, 超时则程序出错退出.

图象函数

    PHP中有一组图像函数,可以动态生成gif格式的图像数据流并输出到 服务器. 为了这组函数能够工作,系统中必须有gd库的支持.如果是在Unix下, 应该在编译PHP之前先取得gd的源码并编译之,生成libgd.a和一些.h文件,分别拷到系统的库目录和头文件目录中(例如/usr/lib和/usr/include);如果是在Windows下,PHP3.0的安装程序会安装一个gd.dll文件,在程序中加一句'dl("gd.dll");'即可使用图像函数.

    主要的图像函数有:

    (1)ImageCreate(宽度,高度)

    返回一个图像描述符.

　

    (2)ImageCreateFromGif(文件名);

    返回一个图像描述符.

　

    (3)ImageColorAllocate(图像描述符,红,绿,蓝);

    返回一个颜色描述符.由于Gif图像只能有256色,必须先对它分配调色板, 这个语句就是分配一个调色板项.

　

    (4)ImageColorTransparent(图像描述符,颜色描述符);

    指定某颜色为透明色.

　

    (5)ImageArc(图像描述符,圆心横坐标,圆心纵坐标,椭圆宽,椭圆高,起始角,终止角,颜色描述符);

    ImageChar(图像描述符,字体,x,y,字符,颜色描述符);

    ImageCharUp(图像描述符,字体,x,y,字符,颜色描述符);

    ImageCopyResized(目标图像描述符,源图像描述符,目标x,目标y,源x,源y,目标宽,目标高,源宽,源高);

    ImageDashedLine(图像描述符,x1,y1,x2,y2,颜色描述符);

    ImageFill(图像描述符,起始点x,起始点y,颜色描述符);

    ImageFilledPolygon(图像描述符,各顶点数组,顶点数,颜色描述符);

    ImageFilledRectangle(图像描述符,x1,y1,x2,y2,颜色描述符);

    ImageFillToBorder(图像描述符,起始点x,起始点y,边界色,填充色);

    ImageLine(图像描述符,x1,y1,x2,y2,颜色描述符);

    ImagePolygon(图像描述符,各顶点数组,顶点数,颜色描述符);

    ImageRectangle(图像描述符,x1,y1,x2,y2,颜色描述符);

    ImageSetPixel(图像描述符,x,y,颜色描述符);

    ImageString(图像描述符,字体,x,y,字符串,颜色描述符);

    ImageStringUp(图像描述符,字体,x,y,字符串,颜色描述符);

    这些都是画图函数,需要略做解释的就是多边形的顶点数组内依次存放着 第一点x,第一点y,第二点x,第二点y,...

　

    (6)ImageLoadFont(文件名);

    文件应该是一个位图字体文件,返回一个字体号.系统缺省带有1-5字体号, 可以直接使用.

　

    (7)ImageSX,ImageSY

    分别得到一个图像的宽度和高度,接收一个图像描述符参数.

　

    (8)ImageColorAt(图像描述符,x,y);

    ImageColorClosest(图像描述符,红,绿,蓝);

    ImageColorExact(图像描述符,红,绿,蓝);

    ImageColorSet(图像描述符,颜色描述符,红,绿,蓝);

    ImageColorsForIndex(图像描述符,颜色描述符);

    ImageColorsTotal(图像描述符);

    前三个返回一个颜色描述符.ImageColorExact如果找不到匹配则返回-1.

    ImageColorsForIndex返回一个三项的数组,元素分别是红,绿,蓝值.

    ImageColorsTotal返回总颜色数.

　

    (9)ImageFontHeight,ImageFontWidth

    接收一个字体号作为参数.

　

    (10)ImageGif(图像描述符,[文件名]);

    如无文件名,则将gif数据流送往浏览器.这时程序一开始应该有一句: Header("Content-type: image/gif")

　

    (11)ImageDestroy(图像描述符);

    图像函数中有一个小Bug(至少在PHP3.0RC和PHP3.0RC3 For Unix的源码中已经发现,现在www.php.net上的下载文件应该已经更改),就是ImageSetPixel总是在(y,y)处画点,不管x的值是什么,不过这个问题不是很大.

数据库函数(部分)

    PHP的数据库功能应该说是它最有用的功能之一.它的特点就是内置了对很多数据库的支持,而不再需要重新扩充.

    Perl和Tcl也都是常用的跨平台语言,都有很强的字符能力,前者字符能力更 强一些,性能更高一些;而后者有GUI能力.它们都可以扩充以支持数据库,但这时如果仍旧希望应用程序有跨平台能力,则需要在各种平台上各自扩充,比如在Unix平台上对Perl扩充DBI包,在Windows 95/NT下对Perl扩充Win32::ODBC包,有时候这是很麻烦的.而PHP由于内置了数据库支持,就为编程人员省去了这些麻烦.

    对各种数据库,访问函数并不完全相同,例如那些基于SQL的数据库显然不能用和dBase或dbm相同的方式访问.以下比较详细地介绍以下MiniSql和MySql数据库的访问函数:

　

    mSQL(mini SQL)是一种小型的关系数据库,性能不是太好,对SQL语言的支持也不够完全,但在一些网络数据库应用中是足够了.

    MySQL是mSQL的一个变种,性能有所提高,增加了用户访问控制. 这两种数据库都是通过SQL语言访问的,但MySQL基本支持全部SQL92规范, 只是"select ... where select .."不支持,另外还扩充了一些数据类型,而mSQL 则基本上不支持任何嵌套SQL语句,也不支持"update set column1=column1-1"这样的语句.

    mSQL由于较简单,在运行简单的SQL语句时速度比MySQL略快,而MySQL在 线程和索引上下了功夫,运行复杂的SQL语句时比mSQL,PostgreSQL,Oracle等都要快一些. 安全性方面,mSQL通过ACL文件设定各主机上各用户的访问权限,缺省是全部可读/写,而MySQL通过一个授权库设定用户名,口令和访问权限,较可靠一些mSQL的存储能力不是很清楚,MySQL的存储能力受文件系统限制,例如在Linux下不能超过2G(3G?记不清楚了).

    mSQL与MySQL既然本来就是差不多的两个东西,PHP中对它们的访问语句也都差不多,例如msql_close与mysql_close就分别完成同样的关闭动作.所以以下介绍时只对mysql介绍,msql的访问语句只需换个前缀即可(特殊情况另行说明).

　

    注意:mSQL与MySQL访问函数都需要有相应的权限才能运行.

    (1)mysql_connect(主机,用户名,口令);

    返回一个连接号.

    注意:mysql各用户的口令可以随该用户所在机器IP地址不同而改变.另外,mSQL没有用户名机制,所以msql_connect只需要一个主机参数. 主机可以是IP地址或域名.

　

    (2)mysql_create_db(数据库名);

　

    (3)mysql_select_db(数据库名,连接号);

    连接一个数据库.

　

    (4)mysql_query(SQL语句,连接号);

    如果SQL语句是select,则返回一个结果号.否则返回的值可以不理会.

    如果失败,返回false.

　

    (5)mysql_fetch_array(结果号);

    取出下一行,返回一个数组.可以用数字下标访问(第一个字段是下标 0),也可以用字符串下标访问(即使用各字段名). 如已取了最后一行,返回 false.

　

    (6)mysql_fetch_field(结果号,[字段序号]);

    如无字段序号,取下一个字段. 返回一个哈希表,下标有: name, table, max_length, not_null, primary_key, unique_key, multiple_key, numeric, blob, type, unsigned, zerofill 各下标的意思应该比较明白了.

　

    (7)mysql_num_rows(结果号);mysql_num_fields(结果号);

　

    (8)mysql_free_result(结果号);

　

    (9)mysql_list_dbs();mysql_list_tables(数据库名);

    

    (10)mysql_close(连接号);

　

    (11)mysql_pconnect(主机,用户名,口令);

    与mysql_connect完全相似,但建立一个"永久连接",该连接一经建立永不关闭,即使使用mysql_close函数或程序执行完毕也不关闭.下一次试图建立永久连接时,系统如发现已存在一个永久连接,则直接返回该连接号而不重新创建.