เรียบเรียงจากเอกสารต้นฉบับ ADOdb MySQL Tutorial ปรับปรุงเพิ่มเติมปลาย ปี 2022 มีทั้งเนื้อหาเก่า และ Feature ใหม่ของ Lib ตัวนี้

มาท้าวความกันก่อนปกติการเขียน เชื่อมต่อ mysql เราจะใช้โค้ดประมาณด้านล่างนี้ ซึ่งคนที่เขียนมาเราก็จะฝึกกับโค้ดประมาณนี้สำหรับเริ่มหัดเขียน

// ทำการติดต่อไปยังฐานข้อมูล
$db = mysql_connect("localhost", "root", "password");
mysql_select_db("mydb",$db);
// ใช้คำสั่ง SQL
$result = mysql_query("SELECT * FROM employees",$db);
if ($result === false) die("failed");
// วนลูปแถวข้อมูลที่ได้มา
while ($fields = mysql_fetch_row($result)) {
// วนลูป field ในแถวข้อมูล
for ($i=0, $max=sizeof($fields); $i < $max; $i++) {
print $fields[$i].' ';
}
print "\n";
}

include("adodb.inc.php");
$db = NewADOConnection('mysql');
$db->Connect("localhost", "root", "password", "mydb");
$result = $db->Execute("SELECT * FROM employees");
if ($result === false) die("failed");
while (!$result->EOF) {
for ($i=0, $max=$result->FieldCount(); $i < $max; $i++)
print $result->fields[$i].' ';
$result->MoveNext();
print "\n";
}

$db = NewADOConnection('oracle');

include("adodb.inc.php");
$db = NewADOConnection('mysql');
$db->Connect("localhost", "root", "password", "mydb");

$result = $db->Execute("SELECT * FROM employees");
if ($result === false) die("failed");

while (!$result->EOF) {
for ($i=0, $max=$result->FieldCount(); $i < $max; $i++)
print $result->fields[$i].' ';
$result->MoveNext();
print "
n";
}

    $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
    $rs1 = $db->Execute('select * from table');
    $ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;
    $rs2 = $db->Execute('select * from table');
    print_r($rs1->fields); // shows array([0]=>'v0',[1] =>'v1')
    print_r($rs2->fields); // shows array(['col1']=>'v0',['col2'] =>'v1')

$recordset->Move($pos) 

$recordset->RecordCount() 

$recordset->GetArray() 

rs2html($recordset) ​

include('adodb.inc.php');
include('tohtml.inc.php'); /* includes the rs2html function */
$conn = &ADONewConnection('mysql');
$conn->PConnect('localhost','userid','password','database');
$rs = $conn->Execute('select * from table');
rs2html($rs); /* recordset to html table */

ID = 3
TheDate = mktime(0,0,0,8,31,2001) /* 31st August 2001 */
Note = sugar why don't we call it off

    $sql = "INSERT INTO table (id, thedate,note) values ("
    . $ID . ','
    . $db->DBDate($TheDate) .','
    . $db->qstr($Note).")";
    $db->Execute($sql);

เรา สามารถค้นหาข้อมูลเกี่ยวกับ field หรือ column ต่างๆ ได้โดยการใช้ method FetchField($fieldoffset) ซึ่งจะคืนค่า object ที่มี 3 คุณลักษณะ คือ name, type และ max_length

$recordset = $conn->Execute("select adate from table");
$f0 = $recordset->FetchField(0);

$f0->name มีข้อมูลของ 'adate'
$f0->type ถูกกำหนดให้เป็น 'date'
และ max_length จะไม่มีค่า ซึ่งถูกกำหนดให้เป็น -1

C: character and varchar types
X: text or long character (eg. more than 255 bytes wide).
B: blob or binary image
D: date
T: timestamp
L: logical (boolean)
I: integer
N: numeric (float, double, money)

$recordset = $conn->Execute("select adate from table");
$f0 = $recordset->FetchField(0);
$type = $recordset->MetaType($f0->type, $f0->max_length);
print $type; /* should print 'D' */

สนับสนุนการใช้ Select Limit และ Top  

$connection->CacheExecute($secs2cache, $sql) 

$connection->CacheSelectLimit($secs2cache, $sql, $nrows, $offset)

สนับสนุนการตรวจสอบการทำงาน ของ Database Server เรียกว่าเป็น Database Monitor Tools
ADODB รองรับเรื่องของ query logging, ประสิทธิภาพของ cpu, การทำงานของระบบเคสที่กล่าวไปในหัวข้อนี้ ก็สามารถ monitor ได้ โดยใช้งานผ่าน Object newPerfMonitor 

ตัวอย่างโค้ด

$db = newAdoConnection('db2');
$db->connect('','user','password','database');
/*
 * Initialize the performance monitoring module
 */
$perf = NewPerfMonitor($db);

ถ้าเราจะ Log ดู SQL เพิ่มคำสั่งตามนี้

/*
 * Enable logging
 */
$db->logSql();
 
/*
* Execute a statement, it will be logged to the adodb_logsql table.
*/
$result = $db->execute("SELECT * FROM act");
 
 
/*
 * Disable logging
 */
$db->logSql(false);

ADODB จะเอาข้อมูล Query ทั้งหมดที่รันภายได้การเปิด Log นี้ไว้ในตาราง adodb_logsql ถ้าต้องการจะเคียร์ Log ก็สามารถใช้คำสั่ง $db->clearSql(); ได้เลย ง่ายมากๆ

มาดูส่วนของ การ Monitor CPU กันบ้าง

$perf = newPerfMonitor($db);
echo $perf->healthCheck();

ผมที่ได้ ประมาณนี้

ปัจจุบัน ADODB รองรับ PHP 8.1 แล้ว