1) int mysql_affected_rows([int link_id]); 在给定的连接中,返回由最近的DELETE、INSERT、REPLACE或者UPDATE语句所作用的行数。如果没有行被修改,则mysql_affected_rows()返回0,如果出现错误,则返回-1。
在SELECT查询之后,mysql_affected_rows()返回所选择的行数。但一般是与SELECT语句一道使用mysql_num_rows()。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("samp_db") or die("Could not select database"); $query="INSERT INTO
member(last_name,first_name,expiration)"."VALUES('Brown','Marcia','2002-6-3')"; $result=mysql_query( $query) or die("Query failed"); printf("%d row%s insertedn",mysql_affected_rows(),mysql_affected_rows()==1?" ":"s"); ?> |
(2) int mysql_close(int[link_id]);
关闭由link_id标识的与MySQL服务器的连接。如果没有指定连接,则mysql_close()关闭最近打开的连接。如果成功,则mysql_close()返回真,失败则返回假。对由mysql_pconnect()打开的永久连接,mysql_close()忽略相应的关闭请求,只是返回值。如果要关闭一个连接,就应该用mysql_connect()而不是mysql_pconnect()来打开它。
使用范例:
<?php $link=mysql_connect("localhost","sunsoft","suixiang") or die("Could not connect"); print("Connected successfully"); mysql_close( $link); ?> |
(3) int mysql_connect(string [hostname] [:port], string [username], string [password]);
本函式建立与 MySQL 伺服器的连线。其中所有的参数都可省略。当使用本函式却不加任何参数时,参数 hostname 的内定值为 localhost、参数 username 的内定值为 PHP 执行行程的拥有者、参数 password 则为空字串 (即没有密码)。而参数 hostname 后面可以加冒号与埠号,代表使用那个埠与 MySQL 连接。当然在使用资料库时,早点使用 mysql_close() 将连线关掉可以节省资源。
使用范例:
这是一位未具名网友提供的范例 (18-Feb-1999)
<?php $dbh = mysql_connect('localhost:3306','mcclain','standard'); mysql_select_db('admreqs'); $query = "insert into requests(date, request, email, priority,status) values
(NOW(),' $description', ' $email', ' $priority', 'NEW')"; $res = mysql_query( $query, $dbh); $query = "select max(id) from requests"; $res = mysql_query( $query, $dbh); $err = mysql_error(); if( $err){ echo "发生错误,请通知<a href=mailto:webmaster@my.site>站长</a>"; } $row = mysql_fetch_row( $res); echo "未来您使用的号码为: ". $row[0]; ?> |
(4) int mysql_create_db(string db_name [, int link_id]);
告诉由link_id标识的MySQL服务器用给定的名称来创建数据库。如果数据库创建成功,则返回真;如果出现错误,则返回假。必须在数据库有创建它的CREATE权限。可能利用mysql_query()较利用mysql_create_db()发布CREATE DATABASE 语句更为适合。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang"); or die("Could not connect"); if(mysql_create_db("my_db")) print("Database created successfullyn"); else print("Error creating database:%sn",mysql_error()); ?> |
(5) int mysql_data_seek(int result_id, int row_num);
由SELECT查询返回的每个结果集都有一个行游标,指示下一个提取行的函数(mysql_fetch_array()、mysql_fetch_object()或者mysql_fetch_row())调用将返回哪一行。mysql_data_seek()将给定结果集的指针设置到给定的行。行号的范围为0到mysql_num_rows()-1。如果行号合法,则mysql_data_seek()返回真,否则返回假。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("samp_db") or die("Could not select database"); $query="SELECT last_name,first_name FROM president"); $result=mysql_query( $query) or die("Query failed"); for( $i=mysql_num_rows( $result)-1; $i>=0; $i-) { if(!mysql_data_seek( $result, $i); { printf("Cannot seek to row %dn", $i); continue; } if(! $row=mysql_fetch_object( $result))) continue; printf("%d %s<BR>n", $row->last_name, $row->first_name); } mysql_free_result( $result); ?> |
(6) int mysql_db_query(string db_name, string query [, int link_id]);
mysql_db_query()除了提取一个额外的数据库名称参数,并在执行查询之前使它成为缺省的数据库为,与mysql_query()类似。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); print("Connected successfully"); $query="SELECT * FROM president"; $result=mysql_db_query("samp_db", $query) or die("Query failed"); ?> |
(7) int mysql_drop_db(string db_name, int [link_id]);
告诉由link_id标识的MySQL服务器用给定的名称来删除数据库。如果数据库删除成功,则返回真;如果出现错误,则返回假。必须有对数据库进行删除的DROP权限。
要小心这个函数;如果删除数据库,它就不存在了,且不能恢复。
使用mysql_query()较使用mysql_drop_db()发布DROP DATABASE 语句更为适合。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); if(mysql_drop_db("my_db")) print("Database dropped successfullyn"); else printf("Error dropping database:%sn",mysql_error()); ?> |
(8) int mysql_errno(int [link_id]);
对于给定的连接,返回含有最近返回状态的与MySQL相关的函数的错误号。零值意味着未出现错误。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); print("Connected successfully"); $query="SELECT * FROM president"; $result=mysql_query( $query) or die("Query failed,error code=".mysql_errno()); ?> |
(9) string mysql_error(int [link_id]);
对于给定的连接,返回含有最近返回状态的与MySQL相关的函数的错误消息字符串。空值意味着未出现错误。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); print("Connected successfully"); $query="SELECT * FROM president"; $result=mysql_query( $query) or die("query failed,error message=".mysql_error()); ?> |
(10)array mysql_fetch_array(int result, int [result_typ]);
本函式用来将查询结果 result 拆到阵列变数中。若 result 没有资料,则传回 false 值。而本函式可以说是 mysql_fetch_row() 的加强函式,除可以将传回列及数字索引放入阵列之外,还可以将文字索引放入阵列中。若是好几个传回栏位都是相同的文字名称,则最后一个置入的栏位有效,解决方法是使用数字索引或者为这些同名的栏位 (column) 取别名 (alias)。值得注意的是使用本函式的处理速度其实不会比mysql_fetch_row() 函式慢,要用哪个函式还是看使用的需求决定。参数 result_typ 是一个常数值,有以下几种常数 MYSQL_ASSOC、MYSQL_NUM 与 MYSQL_BOTH。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db") or die("Could not select database"); $query="SELECT last_name,first_name FROM president"; $result=mysql_query( $query) or die("Query failed"); while( $row=mysql_fetch_array( $result)) { printf("%s %s<BR> ", $row[0], $row[1]); printf("%s %s<BR> ", $row["last_name"], $row["first_name"]); } mysql_free_result( $result);
?> |
(11) object mysql_fetch_field(int result [,int col_num]); 返回结果集中给定列的相关元数据信息,如果没有这样的列,则返回假。如果省略col_num,则对mysql_fetch_field()的后继调用返回结果集后续列的信息。如果不再有剩余的列。则返回值为假。如果指定了col_num,则其取值范围为0到mysql_num_fields()-1。在此情况下,mysql_num_fields()返回给定列的相关信息,如果col_num超出范围,返回假。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db") or die("Could not select database"); $query="SELECT * FROM president"; $result=mysql_query( $query) or die("Query failed"); for( $i=0; $i<mysql_num_fields( $result); $i++) { printf("information for column %d:<BR> ", $i); $meta=mysql_fetch_field( $result); if(! $meta) { print("No information available<BR> "); continue; } print("<PRE> "); printf("blob: %s ", $meta->blob); printf("max_length: %s ", $meta->max_length); printf("multiple_key: %s ", $meta->multiple_key); printf("name: %s ", $meta->name); printf("not_null: %s ", $meta->not_null); printf("numeric: %s ", $meta->numeric); printf("primary_key: %s ", $meta->primary_key); printf("table: %s ", $meta->table); printf("type: %s ", $meta->type); printf("unique_key: %s ", $meta->unique_key); printf("unsigned: %s ", $meta->unsigned); printf("zerofill: %s ", $meta->zerofill); print("</PRE> "); } ?> |
(12) array mysql_fetch_lengths(int result);
本函式将 mysql_fetch_row() 处理过的最后一列资料的各栏位资料最大长度放在阵列变数之中。若执行失败则传回 false 值。传回阵列的第一笔资料索引值是 0。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db") or die("Could not select database"); $query="SELECT * FROM president" or die("Query failed"); $row_num=0; while(mysql_fetch_row( $result)) { ++ $row_num; printf("Lengths of values in row %d:<BR> ", $row_num); $len=mysql_fetch_lengths( $result); if(! $len) { print("No information available<BR> "); break; } print("<PRE> "); for( $i=0; $i<mysql_num_fields( $result); $i++) printf("Column %d: %s ", $i, $len[ $i]); print("</PRE> "); } ?> |
(13) object mysql_fetch_object(int result_id [, int result_typ]);
本函式用来将查询结果 result 拆到物件变数中。使用方法和 mysql_fetch_array() 几乎相同,不同的地方在于本函式传回资料是物件而不是阵列。若 result 没有资料,则传回 false 值。另外值得注意的地方是,取回的物件资料的索引只能是文字而不能用数字,这是因为物件的特性。物件资料的特性中所有的属性(property) 名称都不能是数字,因此只好乖乖使用文字字串当索引了。参数 result_typ是一个常数值,有以下几种常数 MYSQL_ASSOC、MYSQL_NUM 与 MYSQL_BOTH。关于速度方面,本函式的处理速度几乎和mysql_fetch_row() 及 mysql_fetch_array() 二函式差不多,要用哪个函式还是看使用的需求决定。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db") or die("Could not select database"); $query="SELECT last_name,first_name FROM president"; $result=mysql_query( $query) or die("Query failed"); while( $row=mysql_fetch_object( $result)) printf("%s %s<BR> ", $row->last_name, $row->first_name); mysql_free_result( $result); ?> |
(14) array mysql_fetch_row(int result);
作为一个数组返回给定结果集的下一行,如果没有更多的行,则返回假。列值可作为数组元素访问,在0到mysql_num_fields()-1范围内使用列索引。
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db") or die("Could not select database"); $query="SELECT last_name,first_name FROM president"; $result=mysql_query( $query) or die("Query failed"); while( $row=mysql_fetch_row( $result)) printf("%s %s<BR> ", $row[0], $row[1]); mysql_free_result( $result); ?> |
(15) string mysql_field_name(int result, int field_index);
返回结果集的给定列的名称。
col_num 的范围为0到mysql_num_fields()-1.
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db") or die("Could not select database"); $query="SELECT * FROM president"; $result=mysql_query( $query) or die("Query failed"); for( $i=0; $i<mysql_num_fields( $result); $i++) { printf("Name of column %d:", $i); $name=mysql_field_name( $result, $i); if(! $name) print("No name available<BR> "); else print(" $name<BR> "); } ?> |
(16) int mysql_field_seek(int result, int field_offset);
为随后的mysql_fetch_field()调用设置索引。发布没有明确列号的mysql_fetch_field()的下一次调用,将返回列col_num的信息。如果搜索成功,返回真,否则返回假。
col_num的范围为0到mysql_num_fields()-1.
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db") or die("Could not select database"); $query="SELECT * FROM president"; $result=mysql_query( $query) or die("Query failed"); for( $i=0; $i<mysql_num_fields( $result); $i++) { printf("Information for column %d:<BR> ", $i); if(!mysql_field_seek( $result, $i)) { print("Cannot seek to colum<BR> "); continue; } $meta=mysql_fetch_field( $result, $i); if(! $meta) { print("No information available<BR> "); continue; } print("<PRE> "); printf("blob: %s ", $meta->blob); printf("max_length: %s ", $meta->max_length); printf("multiple_key: %s ", $meta->multiple_key); printf("name: %s ", $meta->name); printf("not_null: %s ", $meta->not_null); printf("numeric: %s ", $meta->numeric); printf("primary_key: %s ", $meta->primary_key); printf("table: %s ", $meta->table); printf("type: %s ", $meta->type); printf("unique_key: %s ", $meta->unique_key); printf("unsigned: %s ", $meta->unsigned); printf("zerofill: %s ", $meta->zerofill); print("</PRE> "); } ?> |
(17) string mysql_field_table(int result_id, int col_num);
返回结果集给定列的表名。对于计算列,此名为空。
col_num的范围为0到mysql_num_fields()-1.
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db"); $query="SELECT * FROM president"; $result=mysql_query( $query) or die("Query failed"); for( $i=0; $i<mysql_num_fields( $result); $i++) { print("column $d:", $i); printf("Name %s ",mysql_field_name( $result, $i)); printf("Table %s ",mysql_field_nmae( $result, $i)); print"<BR> "; ?> |
(18) string mysql_field_type(int result_id, int col_num);
返回结果集给定列的类型名。类型名敬请等待参考本人的另外“MySQL列类型参考”。
col_num的范围为0到mysql_num_fields()-1.
使用范例:
<?php $link=pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db"); $query="SELECT * FROM president"; $result=mysql_query( $query) or die("Query failed"); for( $i=0; $i<mysql_num_fields( $result); $i++) { printf("colum %d:", $i); printf("Name %s, ",mysql_field_name( $result, $i)); printf("Type %s ",mysql_field_type( $result, $i)); } ?> |
(19) string mysql_field_flags(int result_id, int col_num);
作为字符串返回结果集中给定列的相关元数据信息,如果出现错误,则返回假。这个字符串由以空格分开的词组成,说明哪个列的标记值为真。对于假的标记,在字符串中给出相应的词。
col_num的范围为0到mysql_num_fields()-1.
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db"); $query="SELECT * FORM member"; $result=mysql_query( $query) or die("Query failed"); for( $i=0; $i<mysql_num_fields( $result); $i++) { printf("column %d:", $i); printf("Name %s, ",mysql_fields_name( $result, $i)); printf("Flags %s ",mysql_fields_flags( $result, $i)); } ?> |
(20) int mysql_field_len(int result, int field_offset);
返回结果集给定列中值可能的最大长度。
col_num的范围为0到mysql_num_fields()-1.
使用范例:
<?php $link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect"); mysql_select_db("stamp_db"); $query="SELECT * FROM member"; $result=mysql_query( $query) or die("Query failed"); for( $i=0; $i<mysql_num_fields( $result); $i++) { printf("Column %d:", $i); printf("Name %s, ",mysql_field_name( $result, $i)); printf("Len %d ",mysql_field_len( $result, $i)); print"<BR> "; } ?> |