蔡逸竹

《PHP》『MySQL函式庫』mysql_affected_rows 取得先前操作MySQL所受到影響的列的數目

mysql_affected_rows ---  取得先前操作MySQL所受到影響的列的數目

語法 : int mysql_affected_rows ([int link_identifier])

說明 :

mysql_affected_rows( )傳回最後查詢為INSERT、UPDATE或DELETE所影響的列數目，如果沒有指定連結identifier，則假定使用最後開啟的連結。

如果最後的查詢為DELETE，而且無WHERE指令，所有的記錄將會全部從TABLE中刪除，但此函式將會傳回0。

最後的查詢若是使用SELECT指令，則本函式是無效的。

[ 本帖最後由 蔡逸竹 於 2006-9-24 12:15 編輯 ]

蔡逸竹

mysql_change_user ---  更改連線的使用者

語法 : int mysql_change_user (string user, string password [, string database [, int link_identifier]])

說明 :

mysql_change_user( )更改目前連線的使用者，或依照給予的非必需選項link_identifier來連結。如果有指定資料庫，當使用者更改完成時這將是預設或是目前的資料庫，如果新的使用者和密碼授權失敗時，則維持原先的使用者。

注意 : 此函式在PHP3.0.13中引進，且需要MySQL 3.23.3以上的版本

蔡逸竹

mysql_close ---  關閉MySQL連線

語法 : int mysql_close ([int link_identifier])

說明 :

成功則傳回true，失敗則傳回false。

mysql_close( )關閉連結到MySQL資料庫的連線，如果沒有指定link_identifier，將會關閉最後與MySQL的連線。

注意 : 這通常是非必需的，非持續(persistent)連結所開啟的連結會在程式的執行完成後自動地關閉連結。

mysql_close( )將無法關閉由mysql_pconnect( )所產生的持續連結

Example :

<?php

    $link = mysql_connect ("kraemer", "marliesle", "secret") or die ("Could not connect");

    print ("Connected successfully");

    mysql_close ($link);

?>

參考 : mysql_connect( )  mysql_pconnect( )

蔡逸竹

mysql_connect ---  開啟MySQL伺服器連線

語法 : int mysql_connect ([string hostname [:port] [:/path/to/socket] [, string username [, string password]]])

說明 :

成功則傳回一正數的MySQL連結identifier，失敗則傳回錯誤訊息。

mysql_connect( )建立MySQL伺服器連結，所有的參數都是非必需的，如果都沒給參數值，則預設上假定是( 'localhost' , 擁有伺服器處理的使用者名稱 , 沒有密碼)。

hostname也可以包含埠號，例如 : "hostname:port"或是socket路徑，例如 : ":/path/to/socket"

注意 : PHP3.0B4中增加了提供":port" ， PHP3.0.10中增加了提供":/path/to/socket"，你可使用'@'(@mysql_connect( ) )來抑制錯誤時所傳回的訊息。

假使第二次以相同的參數來呼叫mysql_connect( )，將不會建立新的連結，但會傳回先前開啟的結連identifier來替代。

程式執行結束後，將會立刻關閉連結到伺服器，除非提早呼叫mysql_close( )來關閉。

Example :

<?php

   $link = mysql_connect ("kraemer", "marliesle", "secret") or die ("Could not connect");

   print ("Connected successfully");

   mysql_close ($link);

?>

參考 :  mysql_pconnect( )  mysql_close( )

蔡逸竹

mysql_create_db ---  新增一個MySQL資料庫

語法 : int mysql_create_db (string database name [, int link_identifier])

說明 :

mysql_create_db( )試著在伺服器上建立一個新的資料庫。

Example :

<?php

   $link = mysql_pconnect ("kron", "jutta", "geheim") or die ("Could not connect");

   if (mysql_create_db ("my_db")) {

         print ("Database created successfully\n");

   } else {

            printf ("Error creating database: %s\n", mysql_error ());

     }

?>

相容的mysql_createdb( )也可以使用

參考 : mysql_drop_db( )

蔡逸竹

mysql_data_seek ---  移動內部指標

語法 : int mysql_data_seek (int result_identifier, int row_number)

說明 :

成功則傳回true，失敗則傳回false。

mysql_data_seek( )移動MySQL內部的列指標到指定列的數目，之後以呼叫mysql_fetch_row( )將會傳回此列。

row_number起始值為0。

Example :

<?php

    $link = mysql_pconnect ("kron", "jutta", "geheim") or die ("Could not connect");

    mysql_select_db ("samp_db") or die ("Could not select database");

    $query = "SELECT last_name, first_name FROM friends";

    $result = mysql_query ($query) or die ("Query failed");

     # fetch rows in reverse order

    for ($i = mysql_num_rows ($result) - 1; $i >=0; $i--) {

             if (!mysql_data_seek ($result, $i)) {

                    printf ("Cannot seek to row %d\n", $i); continue;

             }

            if(!($row = mysql_fetch_object ($result)))

                   continue;

           printf ("%s %s<BR>\n", $row->last_name, $row->first_name);

   }

   mysql_free_result ($result);

?>

蔡逸竹

mysql_db_query ---  送出MySQL查詢

語法 : int mysql_db_query (string database, string query [, int link_identifier])

說明 :

成功則傳回一正數的MySQL查詢結果identifier，失敗則傳回false。

mysql_db_query( )選擇一個資料庫且在此資料庫執行查詢，如果非必需選項link_identifier沒有指定，此函式會試著去找出開啟的MySQL連結，如果找不到時，它會試著去建立一個，就像是以呼叫無任何參數的mysql_connect( )。

相容的mysql( )也可以使用。

參考 : mysql_connect( )

蔡逸竹

mysql_drop_db --- 刪除MySQL資料庫

語法 : int mysql_drop_db (string database_name [, int link_identifier])

說明 :

成功則傳回true，失敗則傳回false。

mysql_drop_db( )試著從伺服器刪除一整個資料庫。

相容的mysql_dropdb( )也可以使用。

參考 : mysql_create_db( )

蔡逸竹

mysql_errno --- 從先前MySQL操作傳回錯誤訊息代號

語法 : int mysql_errno ([int link_identifier])

說明 :

從最後的MySQL函式傳回錯誤訊息代號，如果沒有發生錯誤則傳回0(zero)。

從MySQL資料庫所傳回來的錯誤可以使用mysql_errno( )來獲得錯誤代號，注意 : 此函式只從最近執行MySQL函式 (不包含mysql_error( )與mysql_errno( ) )傳回錯誤代碼，因此如果你想要使用它，請在呼叫其它MySQL函式之前確保你已檢查其值。

Example :

<?php

    mysql_connect("marliesle");

    echo mysql_errno().": ".mysql_error()."<BR>";

    mysql_select_db("nonexistentdb");

    echo mysql_errno().": ".mysql_error()."<BR>";

    $conn = mysql_query("SELECT * FROM nonexistenttable");

    echo mysql_errno().": ".mysql_error()."<BR>";

?>

參考 : mysql_error( )

蔡逸竹

mysql_error --- 從先前MySQL操作傳回錯誤訊息

語法 : int mysql_error ([int link_identifier])

說明 :

從最後的MySQL函式傳回錯誤訊息代號，如果沒有發生錯誤則傳回0(zero)。

從MySQL資料庫所傳回來的錯誤可以使用mysql_error( )來獲得錯誤訊息，注意 : 此函式只從最近執行MySQL函式 (不包含mysql_error( )與mysql_errno( ) )傳回錯誤訊息，因此如果你想要使用它，請在呼叫其它MySQL函式之前確保你已檢查其值。

Example :

<?php

    mysql_connect("marliesle");

    echo mysql_errno().": ".mysql_error()."<BR>";

    mysql_select_db("nonexistentdb");

    echo mysql_errno().": ".mysql_error()."<BR>";

    $conn = mysql_query("SELECT * FROM nonexistenttable");

    echo mysql_errno().": ".mysql_error()."<BR>";

?>

參考 : mysql_errno( )