PHP4 與 MySQL 資料庫操作函數詳解

I

說PHP就不能不提MySQL，而要講MySQL，那麼PHP也是必然要被提起。PHP的迅速崛起，離不開MySQL，而MySQL的廣泛應用，也與PHP休戚相關。

下面詳細分析PHP4中與MySQL相關操作的函數（共32個，開頭都為mysql_）：

<1>. 串連資料庫伺服器(database server)的函數（2個）：

(1).mysql_connect()
格式：int mysql_connect(string [hostname] [ort],string [username],string [password]);

參數中的port參數表示資料庫伺服器的連接埠號碼，一般用它的預設連接埠號碼就可以了。
如果不填任何參數，則預設的hostname為localhost，username為root，password為空白。

函數執行成功，返回一個int 類型的串連號(link_identifier)，執行失敗，返回false值。

例子：

$connect = mysql_connect("localhost","user","password");
if($connect) echo "Connect Successed!"; //串連成功，顯示Connect Successed!
else echo "Connect Failed!"; //串連失敗，顯示Connect Failed!

?>

在上例中，如mysql_connect()執行失敗，將顯示系統的錯誤提示，而後繼續往下執行。那，該如何屏蔽這些系統的錯誤提示並在失敗後結束程式？
在MySQL中，允許在資料庫函數之前加上@符號，屏蔽系統的錯誤提示，同時用die()函數給出更易理解的錯誤提示，然後die()函數將自動結束程式。

上例可以改為：

$connect = @mysql_connect("localhost","user","password") or die ("Unable to connect database server!");

?>

如mysql_connect()執行失敗，將顯示 Unable to connect database server!後，退出程式。

(2).mysql_pconnect()
格式：int mysql_pconnect(string [hostname] [ort],string [username],string [password]);
此函數與(1)的mysql_connect()基本相同，區別在於：

--------- 當資料庫操作結束之後 ，由(1)的mysql_connect()建立的串連將自動關閉，而(2)的mysql_pconnect()建立的串連將繼續存在，是一種穩固持久的串連。
--------- 在(2)的mysql_pconnect()，每次串連前，都會檢查是否有使用同樣的hostname，use，password的串連，如果有，則直接使用這個串連號。
--------- (1)的mysql_connect()建立的串連可以用mysql_close()關閉，而(2)的mysql_pconnect()不能用mysql_close()來關閉。

<2>.關閉資料庫連接函數(1個)：

mysql_close()
格式：int mysql_close(int link_identifier);
關閉由mysql_connect()函數建立的串連，執行成功，返回ture值，失敗則返回false值。

例子如下：

$connect = @mysql_connect("hostname","user","password") or die("Unable to connect database server!");

$close = @mysql_close($connect) or die ("Unable to close database server connect!");

?>

註：mysql_close()不能關閉由mysql_pconnect()函數建立的串連。

<3>.選擇資料庫函數(1個)：

mysql_select_db()
格式：int mysql_select_db(string database name , int link_identifier);
選擇指定的database name ，成功，返回1個真值（True），失敗，則返回1個False值
例子1：
$select = mysql_select_db(\'forum\' , $connect);
if($select)
{echo "connect db forum successed!";}
else
{echo "connect db forum failed!";}
?>

例子2：
$select = mysql_select_db("forum",$connect) or die("Can not connect this DB!");
?>

註：此函數相當於在MySQL中的USE語句：如 USE forum

<4>.SQL查詢函數(2個)：

1、mysql_query()
格式：int mysql_query(string sqlquery , int link_identifier);
向伺服器發一段標準SQL語句請求。如果失敗，則返回一False值。

例子：
$connect = mysql_connect($hostname,$user,$pwd);
$select = mysql_select_db($dbname,$connect);
$query = mysql_query($sql , $connect);
if($query) echo "Successed !";
else echo "Failed !";
?>
此函數一定要與mysql_select_db()函數配合使用，單獨使用它就沒有意義了！

2、mysql_db_query()
格式：int mysql_db_query(string database , string sqlquery , int link_identifier);

在此函數中必須指定資料庫名database和SQL語句sqlquery，如失敗則返回False。

例子：

$connect = mysql_connect($hostname , $user , $pwd);
$query = mysql_db_query($dbname , $sql , $connect);
if($query) echo "Successed !";
else echo "Failed !";
?>

mysql_db_query()與mysql_query()的區別就在於前者可以不用使用mysql_select_db()來選擇資料庫database，而在執行SQL語句的同時，進行選擇資料庫。
<5>.資料庫記錄操作函數(5個)：

1、mysql_fetch_array()
格式：array mysql_fetch_array(int query);

執行成功，返回1個數組，該數組儲存有下一條記錄的值，如執行失敗，則返回False值。
返回的數組既可以用下標來表示，也可以用欄位名來表示。

例子：
$query = mysql_query($sql , $connect);
while($arrary = mysql_fetch_array($query))
{

echo $array[column1]." | ".$array[column2];
//echo $array[0]." | ".$array[1];

}
?>
Note : 數組的下標是從0開始的！

2、mysql_fetch_row()
格式：array = mysql_fetch_row(int query);

與1的mysql_fetch_array()函數功能基本相同。區別在於mysql_fetch_row()只能以數組下標來表示。
成功返回1個數組，失敗返回False值。

例子：
$query = mysql_query($sql , $connect);
while($row = mysql_fetch_row($query))
{
echo $row[0] . " | " . $row[1] . "
";
}
?>
Note : mysql_fetch_row()函數只能用數組下標來表示，並從0開始。
另：mysql_fetch_row()比mysql_fetch_array()執行速度快，並且都是對下一行資料進行讀取。

3、mysql_result()
格式：int mysql_result(int query , int row , string filedname);

在mysql_result()中，參數row必須從0開始，參數filedname必須是真實的欄位名，不能用下標來表示。
執行成功，返回由資料庫中取出的欄位的數值，失敗則返回False值。

例子：
$query = mysql_query($sql , $connect);
echo mysql_result($query , 0 , "column1")."
";
echo mysql_result($query , 1, "column1")."
";
echo mysql_result($query , 2, "column1")."
";
?>

Note : 此函數功能少，但使用方便。

4、mysql_fetch_object()
格式： object mysql_fetch_object(int query)

能對指定的欄位進行迴圈讀取，執行成功，將以對象object的形式返回數值，失敗則返回False值。

例子：
$query = mysql_query($sql , $connect);
while($object = mysql_fetch_object($query))
{
echo $object->column1 . "
";
echo $object->column2 . "
";
echo $object->column3 . "
";
}
?>

Note : mysql_fetch_object()函數執行成功後返回的是1個對象object ！
操作如下：
$object->欄位名

5、mysql_data_seek()
格式：int mysql_data_seek(int row , int query);
移動遊標到指定的行(row_number)
執行成功，返回真值，失敗，返回False值。
此函數可以與mysql_fetch_array()或mysql_fetch_row()配合使用，即在使用mysql_data_seek()函數之後，就可以用mysql_fetch_array()或mysql_fetch_row()函數來顯示指定的行了。

例子：
$query = mysql_query($sql , $connect);
$seek = mysql_data_seek($query , 2);
$arrary = mysql_fetch_array($query);
echo $array[column1]."
";
echo $array[column2]."
";
?>

<6>.資料庫級database的操作函數(2個)：

1、mysql_create_db()
格式：int mysql_create_db(string database name , int link_identifier);

通過程式來建立1個資料庫database，當然你也可以用mysql_query()或者mysql_db_query()函數來建立或刪除database

但我們可以用這個函數更為方便地建立1個database。
成功返回1個真值，失敗，則返回1個false。

例子：

$connect = mysql_connect("$hostname","$user","$pwd");
$create = mysql_create_db("dbtest" , $connect);
if($create) echo "create database dbtest successed!";
else echo "create database dbtest failed!";

?>

2、mysql_drop_db()
格式：int mysql_drop_db(string database name , int link_identifier);

通過程式來刪除1個資料庫database。

但我們可以用這個函數更為方便地刪除1個database。
成功返回1個真值，失敗，則返回1個false。

例子：

$connect = mysql_connect("$hostname","$user","$pwd");
$create = mysql_drop_db("dbtest" , $connect);
if($create) echo "drop database dbtest successed!";
else echo "drop database dbtest failed!";

?>

Note : 如用mysql_query()或mysql_db_query()，則SQL語句應為：
(1)create database dbtest
(2)drop database dbtest
7) 資料庫資訊函數（2個）：

1、mysql_fetch_field()
格式：object mysql_fetch_field(int query , int [field_offset]);

返回1個對象，即一雜湊表，下標有：
table : 表名
name : 欄位名
max_length : 該欄位的最大長度
not_null : 欄位為not null則返回1，否則返回0
primary_key : 欄位為primary key則返回1，否則返回0
unique_key : 欄位為unique key則返回1，否則返回0
multiple_key : 欄位為非unique key則返回1，否則返回0
numeric : 欄位為numeric則返回1，否則返回0
blob : 欄位為blob則返回1，否則返回0
type : 欄位的類型
unsigned : 欄位為unsigned則返回1，否則返回0
zerofill : 欄位為zero filled則返回1，否則返回0

引用格式為：對象名->下標名

使用此函數可以得到表名、欄位名、類型.......

例子：

$query = mysql_query($sql , $connect);
while($object = mysql_fetch_field($query))
{
echo "table name : ".$object->table."
";
echo "field name : ".$object->name."
";
echo "primary key : ".$object->primary_key."
";
echo "not null : ".$object->not_null."
";
echo "field type : ".$object->type."
";
echo "field max length : ".$object->max_length."
";
}
?>

Note : 雜湊表的是從0座標開始的，即第一個欄位為雜湊表中的0項。
如果我們想直接得到雜湊表的第三項即第三個欄位的資訊，可用如下格式：
$query = mysql_query($sql , $connect);
$object = mysql_fetch_field($query , 2);
echo "table name : ".$object->table."
";
echo "field name : ".$object->name."
";
echo "primary key : ".$object->primary_key."
";
echo "not null : ".$object->not_null."
";
echo "field type : ".$object->type."
";
echo "field max length : ".$object->max_length."
";
?>

其實這也可以通過下面這個函數來達到同樣的目的。

2、mysql_field_seek()
格式：int mysql_field_seek(int $query , int field_offset);

將遊標移到指定的欄位上。
例子：

$query = mysql_query($sql , $connect);
$seek = mysql_field_seek($query , 2);
$object = mysql_fetch_field($query);
echo "table name : ".$object->table."
";
echo "field name : ".$object->name."
";
echo "primary key : ".$object->primary_key."
";
echo "not null : ".$object->not_null."
";
echo "field type : ".$object->type."
";
echo "field max length : ".$object->max_length."
";
?>

這樣也達到與上例同樣的要求。

8) 取資料庫名和表名（2個）：

1、mysql_list_dbs()
格式： int mysql_list_dbs(int link_identifier);
取得所有可用的資料庫名(database name)。

例子：

$connect = mysql_connect($host , $usr ,$pwd);
$dbs = mysql_list_dbs($connect);
$rows = mysql_num_rows($dbs);
echo "database total : ".$rows;
$i = 0;
while($i<$rows)
{
$db_name[$i] = mysql_tablename($dbs , $i);
echo $db_name[$i];
$i++;
}
?>
即可依次顯示出MySQL中所有的資料庫名字（database name ）。
Note : 相當於MySQL中的 show databases命令

2、mysql_list_tables()
格式：int mysql_list_tables(string database name);
顯示該資料庫下所有的表的名字Table name。

例子：

$connect = mysql_connect($host , $usr , $pwd);
$tables = mysql_list_tables("mysql");
$rows = mysql_num_rows($tables);
echo "Table total : ".$rows;
$i = 0;
while($i<$rows)
{
$table_name[$i] = mysql_tablename($tables , $i);
echo $table_name[$i];
$i++;
}

?>

即可依次顯示出mysql下所有的表的名字
Note : 相當於MySQL中的 show tables命令(先要用 use mysql命令選中1個資料庫)
（出處：風閃）