用php获取本周,上周,本月,上月,本季度日期的代码
生活随笔
收集整理的這篇文章主要介紹了
用php获取本周,上周,本月,上月,本季度日期的代码
小編覺得挺不錯的,現在分享給大家,幫大家做個參考.
1. 前言 ADODB 是 Active Data Objects Data Base 的簡稱，它是一種 PHP 存取數據庫的函式組件?，F在 SFS3 系統 (校園自由軟件交流網學務系統) 計劃的主持人陳瑩光老師，決定采用此一組件，為了讓更多有心參與該項目的伙伴們能夠順利加入發展的行列，小弟認為有必要把 ADODB 的中文入門介紹寫出來，以方便伙伴們參考備查。?
-
雖然 PHP 是建構 Web 系統強有力的工具，但是 PHP 存取數據庫的功能，一直未能標準化，每一種數據庫，都使用另一種不同且不兼容的應用程序接口(API)。為了填補這個缺憾，因此才有 ADODB 的出現。一旦存取數據庫的接口予以標準化，就能隱藏各種數據庫的差異，若欲轉換至其它不同的數據庫，將變得十分容易。?
目前 ADODB 支持的數據庫種類非常地多，例如：MySQL, PostgreSQL, Interbase, Informix, Oracle, MS SQL 7, Foxpro, Access, ADO, Sybase, DB2 以及一般的 ODBC (其中 PostgreSQL、Informix、Sybase 的driver 是由自由軟件社群發展之后貢獻出來的)。?
使用 ADODB 最大的優點之一是：不管后端數據庫如何，存取數據庫的方式都是一致的，開發設計人員不必為了某一套數據庫，而必須再學習另一套不同的存取方法，這大大減輕開發人員的知識負擔，過去的知識往后仍可繼續使用，轉移數據庫平臺時，程序代碼也不必做太大的更動。?
其實 ADODB 這樣的發展理念，并不是首創的，DBI 比 ADODB 出現得更早，它提供 Perl 存取數據庫時，使用一致的 API 呼叫接口。相信用過 Perl + DBI 的朋友，再來用 ADODB 時，會有一種似曾相識的感覺。?
另外，ADODB 對用過 ASP 的人而言，應該不陌生，這類朋友對 ADODB 應該很容易接受。?
我們來看一下，ADODB 的簡單用法：?
<?php?
// 引入 adodb 的 inc 檔，才能呼叫 adodb 提供的函式?
include('adodb/adodb.inc.php');?
// 選擇連接的數據庫種類，以建立聯機對象，?
// 一旦對象建立，即可使用其成員函式來處理數據庫。?
// 以下 $conn 即此一物件(object)?
$conn = &ADONewConnection('mysql');?
// 要不要顯示偵錯訊息，false 不要，true 要。?
// $conn->debug = false;?
$conn->debug = true;?
// 連接數據庫?
// 用法：$conn->Connect('主機', '使用者', '密碼', '數據庫');?
// 用例：?
$conn->Connect('localhost', 'piza', 'ooo123', 'test');?
// 若欲采用持續性連接，上式可換用 PConnect：?
// $conn->PConnect('localhost', 'piza', 'ooo123', 'test');?
// 設定 sql 命令?
$sql = "insert into t values ('abcde', 18)";?
// 執行 sql 命令?
$rs = $conn->Execute($sql);?
// 檢查執行結果，若 $rs == false，則呼叫 $conn 對象的成員函式 ErrorMsg()?
if (!$rs) print $conn->ErrorMsg(); else print "OK!";?
?>?
結果如下：?
---------------------------------------------?
(mysql): insert into t values ("abcde",18)?
---------------------------------------------?
OK!?
若把偵錯關掉，即 $conn->debug=false，則結果如下：?
OK!?
以下，逐步為各位介紹：使用 ADODB 的重點方法。?
2. 安裝?
ADODB 的首頁在：http://php.weblogs.com/ADOdb，目前(2002/10/24)最新版是：2.42 版，可至 ADODB 下載或至臺南縣教網中心 FTP 下載。?
安裝 ADODB 的方法超極簡單，只要下載、解壓、放入適當位置，即可完成 ! 如下所示：?
1. 下載：?
$ ncftp ftp.tnc.edu.tw?
cd sysop/ADODB?
get adodb242.tgz?
2. 解壓：?
假設我把 adodb242.tgz 放入 /var/www/html 中?
$ cp adodb242.tgz /var/www/html?
$ tar xvzf adodb242.tgz?
如下所示：?
adodb/adodb-cryptsession.php?
adodb/adodb-csvlib.inc.php?
adodb/adodb-errorhandler.inc.php?
adodb/adodb-errorpear.inc.php?
adodb/adodb-lib.inc.php?
adodb/adodb-pager.inc.php?
....以下省略....?
現在，您在 /var/www/html/adodb 已安裝好 ADODB 了。?
3. 引入 ADODB?
一旦安裝好 ADODB，使用前，應把 ADODB 相關的含入文件引入您的程序中。adodb 目錄放在任何位置無所謂，只要能指向正確路徑文件名即可。一般而言，您的程序代碼只須引入 adodb.inc.php。?
作法如下：?
在您的 PHP 程序中：?
include('路徑/adodb/adodb.inc.php');?
或?
include_once('路徑/adodb/adodb.inc.php');?
例：?
若您的程序和 adodb 在同一目錄下：?
.?
..?
adodb/?
something.php*?
則：?
include('adodb/adodb.inc.php');?
即可。?
若位置是在某一個目錄 somedir 中：?
.?
..?
adodb?
somedir/something.php?
則必須使用：?
include('../adodb/adodb.inc.php');?
除了 adodb.inc.php 這個含入檔，ADODB 還提供許多 adodb-*.inc.php 的含入檔，這些多半是為驅動某些數據庫的特殊用法而設的。?
若是引入 adodb-session.php 則可讓您將 session 存入數據庫中來維護運用。?
若是引入 adodb-pager.inc.php，可方便您做分頁顯示。?
若是引入 adodb-errorhandler.inc.php，可讓您自訂錯誤處理訊息。?
若是含入 adodb-pear.inc.php，可讓您使用 PHP4 的 PEAR DB 語法來使用 ADODB。此時，尚可使用 DSN 連接數據庫的字符串設定。如 $dsn="mysql://piza:ooo123@localhost/test";?
若是引入 tohtml.inc.php，可幫您在程序代碼中，方便將取出的記錄，轉成 HTML 的表格(table)來顯示。?
若是引入 toexport.inc.php，可讓您方便地輸出 CSV 檔或以 tab 分隔字段的數據文件。?
若是引入 rsfilter.inc.php，可讓您在使用記錄之前，預做過濾處理。?
若是引入 pivottable.inc.php，可讓您使用 pivot table 功能(俗稱 cross-tabulations)。?
注意 ! adodb.inc.php 是一定要引入的，其它，則視您要使用那一個功能，再引入該含入檔即可。?
4. 選用數據庫種類，建立聯機對象?
由于 ADODB 使用對象導向的作法，因此您在引入檔之后，接著請視您后端數據庫的種類，建立一個聯機對象。作法如下：?
以 MySQL 數據庫為例：?
$conn = &ADONewConnection('mysql');?
注：NewADOConnection 和 ADONewConnection 是一樣的，二者皆可使用。?
上例中的 'mysql' 是指數據庫的 drvier 的種類，ADODB 會據此呼叫對應的數據庫 driver。?
其它常用的 driver 有：access、ado、ado_access、ado_mssql、db2、vfp、ibase、borland_ibase、informix、imformix72、mssql、oci8、odbc、postgres、postgres64、postgres7、sqlanywhere、sybase....等等。?
我們稱建立的對象 $conn 為一 ADOConnection 對象，它代表與數據庫的連接事務，皆透過這個對象來處理。ADOConnection 對象會提供許多處理的方法，以對象導向的說法，這些方法稱為成員函式，這是外界存取此一對象的接口。?
一旦聯機對象建立之后，就有許多對象函式可供您使喚啦 ! 請看下一節的介紹。?
5. 偵錯模式?
程序開發的過程，為了方便查出出現問題可能的地方，通常我們會打開偵錯模式，俟程序功能確實穩定之后，再將它關閉。ADODB 提供偵錯模式，存取數據庫時，能顯示其運作方式。?
打開偵錯模式，使用法：?
$conn->debug=true?
關閉偵錯模式，使用法：?
$conn->debug=false?
6. 連接數據庫?
接著，使用 $conn 聯機對象的 Connect 或 PConnect 函式來連接特定的數據庫，此時必須提供 DSN (Data Source Names)相關數據，DSN 可能包括：主機名稱、數據庫使用者、數據庫密碼、數據庫名稱。不同的數據庫種類，DSN 可能可以省略其中若干項。以 MySQL 而言，則上述四者都要提供。?
該函式會傳回 true 或 false，用以表示是否連接成功。?
用例：?
// 格式：$conn->Connect('主機', '使用者', '密碼', '數據庫');?
$conn->Connect('localhost', 'piza', 'ooo123', 'test');?
或者，采持續性連接：?
// 格式：$conn->PConnect('主機', '使用者', '密碼', '數據庫');?
$conn->PConnect('localhost', 'piza', 'ooo123', 'test');?
若欲探查是否有聯機成功，可用一個變量來接取傳回值：?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
$cok = $conn->Connect($mch, $user, $pwd, $database);?
或者，采持續性連接：?
$cok = $conn->PConnect($mch, $user, $pwd, $database);?
if (!$cok) { echo "無法連接數據庫 $database"; exit; }?
7. 設定 sql 命令語法、執行 sql 命令?
接下來，您就可以設計您要執行的 sql 命令語法，然后付諸執行。?
$sql = "這里放 SQL 的命令語法";?
$rs = $conn->Execute($sql);?
其中，$rs 為回傳的結果，若 $rs == false，則表示執行失敗，您必須仔細檢查一下。?
您不一定要把命令語法放在 $sql 變量中，也可以直接放入 Execute( ) 括號中。若命令較短無妨，若命令較長，我建議您還是用一個變量 $sql 來設定命令字符串吧 !?
下一節開始，為各位介紹 SQL 的基本命令，如：Insert、Select、Update、Delete 等等的用法。?
8. 插入記錄(Insert)?
Insert 的用法如下：?
// $name 為字符串，$year 為數字?
$name='abcde';?
$year=18;?
// 插入一筆記錄，命令的大小寫無妨，但數據表 t 及變量則大小寫有分別 !?
$sql = "INSERT INTO t VALUES ('$name', $year)";?
// $sql = "insert into t values ('$name', $year)"; 亦可。?
// 執行?
$rs = $conn->Execute($sql);?
// 檢查執行結果，進行錯誤處理；若正常，則繼續其它動作....?
if (!$rs) print $conn->ErrorMsg();?
....以下省略....?
ErrorMsg() 是錯誤顯示的函式，它會取出錯誤訊息，并顯示出來。?
另外，ADODB 提供一種 記錄集(RecordSet) 函式 GetInsertSQL()，可幫您產生 Insert 的語法。?
例子如下：?
<?php?
// 引入 ADODB?
include('adodb/adodb.inc.php');?
// 建立聯機對象?
$conn = &ADONewConnection('mysql');?
// 偵錯?
$conn->debug=true;?
// DSN 四項基本數據設定?
$mch="localhost";?
$user="root";?
$pwd="jack168";?
$database="test";?
// 連接至數據庫 test?
$conn->PConnect($mch, $user, $pwd, $database);?
// 產生一筆空記錄?
$sql = "select * from t where year=-1";?
$rs = $conn->Execute($sql);?
// 用一個空數組來裝要更新的數據?
$r = array();?
$r['name']='john';?
$r['year']=28;?
// 用 GetInsertSQL 函式來制作一個完整的 sql 命令，此 sql 命令放在 $insertSQL 中?
$insertSQL = $conn->GetInsertSQL($rs, $r);?
// 執行插入?
$conn->Execute($insertSQL);?
$conn->Close();?
?>?
偵錯訊息如下：?
-----------------------------------------------------------?
(mysql): select * from t where year=-1?
-----------------------------------------------------------?
(mysql): INSERT INTO t ( name, year ) VALUES ( 'john', 28 )?
-----------------------------------------------------------?
9. 取出記錄(Select)?
Select 的用法如下：?
<?php?
// 引入 ADODB?
include('adodb/adodb.inc.php');?
// 建立聯機對象?
$conn = &ADONewConnection('mysql');?
// 不偵錯?
$conn->debug=false;?
// DSN 四項基本數據設定?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
// 連接至數據庫 test?
$conn->PConnect($mch, $user, $pwd, $database);?
// 執行 Select 由表格 t 取出數據，?
// 它會傳回一個 ADORecordSet 記錄集對象 $rs (RecordSet)?
// 實際上 $rs 是一個 cursor 指標，它擁有目前的記錄(row 或稱 record)，?
// 該記錄的所有字段數據的內容，存放在 fields 這個數組之中?
// ，以數字為索引，第一個由 0 開始?
$rs = &$conn->Execute('select * from t');?
// 若 $rs 為 false，則秀出錯誤訊息?
if (!$rs) {?
print $conn->ErrorMsg();?
} else {?
// 當尚未到達 記錄集 $rs 的結束位置(EOF：End Of File)時，(即：還有記錄尚未取出時)?
while (!$rs->EOF) {?
// 秀出所有字段，$FieldCount() 會傳回字段總數?
for ($i=0, $max=$rs->FieldCount(); $i < $max; $i++) {?
print $rs->fields[$i] . " ";?
}?
// 移至下一筆記錄?
$rs->MoveNext();?
// 換列?
echo "<br>\n";?
}?
}?
$rs->Close(); // 可不用?
$conn->Close(); // 可不用?
?>?
$rs->fields[] 數組是由 PHP 的數據庫擴展功能產生的，某些擴展功能并不支持使用字段名稱當作索引。?
若欲使用名稱當作索引，也就是俗稱的 hash 或 associative arrays，則需使用全域變量 $ADODB_FETCH_MODE 加以指定。?
以下設定：使用數字索引 $ADODB_FETCH_MODE= ADODB_FETCH_NUM;?
以下設定：使用名稱索引 $ADODB_FETCH_MODE= ADODB_FETCH_ASSOC;?
下面是使用名稱索引的例子：?
<?php?
// 引入 ADODB?
include('adodb/adodb.inc.php');?
// 建立聯機對象?
$conn = &ADONewConnection('mysql');?
// 不偵錯?
$conn->debug=false;?
// DSN 四項基本數據設定?
$mch="localhost";?
$user="root";?
$pwd="jack168";?
$database="test";?
// 連接至數據庫 test?
$conn->PConnect($mch, $user, $pwd, $database);?
// 執行 sql 之前，指定使用名稱索引?
$ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;?
// 執行 Select，它會傳回一個 ADORecordSet 記錄集對象 $rs?
// 實際上 $rs 是一個 cursor 指標，它擁有目前的記錄內容，?
// 該記錄存放在 fields 這個數組之中?
$rs = &$conn->Execute('select * from t');?
// 若 $rs 為 false，則秀出錯誤訊息?
if (!$rs) {?
print $conn->ErrorMsg();?
} else {?
// 當尚未到達記錄集結束位置(EOF)時，?
while (!$rs->EOF) {?
// 秀出所有字段?
print $rs->fields['name'] . " " . $rs->fields['year'];?
// 移至下一筆記錄?
$rs->MoveNext();?
// 換列?
echo "<br>\n";?
}?
}?
$rs->Close(); // 可不用?
$conn->Close(); // 可不用?
?>?
10. 取出記錄(使用 FetchRow)?
這里示范 FetchRow 的用法：?
$sql = "select * from t";?
$rs = $conn->Execute($sql);?
if ($rs) {?
while( $ar = $rs->FetchRow() ) {?
print $ar['name'] ." " . $ar['year'];?
print "<br>\n";?
}?
}?
FetchRow() 會將取出的記錄傳回，您可用一個 array 來接取。?
注意 ! 使用 FetchRow() 就不必再用 MoveNext()，FetchRow 內部會自動完成移至下一筆記錄的動作。?
11. 更新記錄(Update)?
您可以用傳統的方式：?
$sql ="UPDATE t SET name='john', year=28 WHERE year=18";?
$conn->Execute($sql);?
也可以用以下這種方式：?
<?php?
// 引入 ADODB?
include('adodb/adodb.inc.php');?
// 建立聯機對象?
$conn = &ADONewConnection('mysql');?
// 偵錯?
$conn->debug=true;?
// DSN 四項基本數據設定?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
// 連接至數據庫 test?
$conn->PConnect($mch, $user, $pwd, $database);?
// 選擇要更新的那一筆記錄?
$sql = "select * from t where year=18";?
$rs = $conn->Execute($sql);?
// 用一個空數組來裝要更新的數據?
$r = array();?
$r['name']='john';?
$r['year']=28;?
// 用 GetUpdateSQL 函式來制作一個完整的 sql 命令，此 sql 命令放在 $updateSQL 中?
$updateSQL = $conn->GetUpdateSQL($rs, $r);?
// 執行更新?
$conn->Execute($updateSQL);?
$conn->Close();?
?>?
偵錯訊息如下：?
-------------------------------------------------------------?
(mysql): select * from t where year=18?
-------------------------------------------------------------?
(mysql): UPDATE t SET name = 'john', year = 28 WHERE year=18?
-------------------------------------------------------------?
12. 刪除記錄(Delete)?
刪除記錄很簡單，采傳統方式即可： $sql = "DELETE FROM t WHERE year=18";?
$rs = $conn->Execute($sql);?
13. 使用字段對象(Field Objects)?
這里示范字段對象 FetchField 的用法，用以取得字段名稱及字段型態：?
$sql = "select * from t";?
$rs = &$conn->Execute($sql);?
if ($rs) {?
while (!$rs->EOF) {?
// 取出第二個字段?
$f = $rs->FetchField(1);?
// 印出字段名稱 及 字段型態?
print $f->name . ":" . $f->type;?
$rs->MoveNext();?
print "<br>\n";?
}?
}?
另外，ADODB 提供一個 RecordSet 函式 MetaType()，可將原始的字段型態轉成一般型態代碼：?
C : 字符?
X : text?
B : blob?
D : 日期?
T : timestamp?
L : 布爾值或位?
I : 整數?
N : 數字型態，包括：自動增加、數值、浮點數、實數及整數?
R : serial、自動增加?
用例：?
$f = $rs->FetchField(1);?
// 印出字段名稱 及 字段型態的代碼?
print $f->name . ":" . $rs->MetaType($f->type);?
14. 簡單分頁(Pager)?
ADODB 提供一種簡單分頁顯示記錄的方法，使用前，要將 adodb-pager.inc.php 引入。?
<?php?
include('adodb/adodb.inc.php');?
// 引入分頁功能?
include('adodb/adodb-pager.inc.php');?
// 啟動 session?
session_start();?
$db = ADONewConnection('mysql');?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
$db->Connect($mch, $user, $pwd, $database);?
$sql = "select * from t";?
// 產生 pager 對象?
$pager = new ADODB_Pager($db, $sql);?
// 每一頁秀 5 筆記錄?
$pager->Render($rows_per_page=5);?
?>?
結果如下：?
Figure 1. 簡單分頁功能?
每頁顯示記錄的數目是由 Render() 來控制的，若沒有傳入指定的 row 數給 Render()，默認值每頁秀 10 筆。?
另外，字段名稱也可以改變，如下示范：?
<?php?
include('adodb/adodb.inc.php');?
// 引入分頁功能?
include('adodb/adodb-pager.inc.php');?
// 啟動 session?
session_start();?
$db = ADONewConnection('mysql');?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
$db->Connect($mch, $user, $pwd, $database);?
$sql = "select name as '姓名', year as '年紀' from t";?
// 產生 pager 對象?
$pager = new ADODB_Pager($db, $sql);?
// 每一頁秀 5 筆記錄?
$pager->Render($rows_per_page=5);?
?>?
結果如下：?
Figure 2. 改變字段名稱?
15. 輸出 CSV 檔?
ADODB 提供輸出 CSV 檔的方法，使用前，要將 toexport.inc.php 引入。?
<?php?
include('adodb/adodb.inc.php');?
// 引入輸出 CSV 文件功能?
include('adodb/toexport.inc.php');?
$db = ADONewConnection('mysql');?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
$db->Connect($mch, $user, $pwd, $database);?
$sql = "select name as '姓名', year as '年紀' from t";?
$rs = $db->Execute($sql);?
// 秀出 CSV 格式?
print rs2csv($rs);?
?>?
結果如下：?
姓名,年紀?
abcde,45?
yyy,20?
ppp,34?
mmm,13?
hhh,41?
rrr,65?
kkk,29?
miso,154?
sss,89?
abc,18?
abcde,0?
uyt,58?
john,28?
也可用 tab 分隔字段，使用 rs2tab 方法如下：?
print rs2tab($rs, false);?
注: false 表示不顯示字段名稱?
結果如下：?
abcde 45?
yyy 20?
ppp 34?
mmm 13?
hhh 41?
rrr 65?
kkk 29?
miso 154?
sss 89?
abc 18?
abcde 0?
uyt 58?
john 28?
若是 print rs2tab($rs, true);?
結果如下：?
姓名 年紀?
abcde 45?
yyy 20?
ppp 34?
mmm 13?
hhh 41?
rrr 65?
kkk 29?
miso 154?
sss 89?
abc 18?
abcde 0?
uyt 58?
john 28?
也可以將結果由標準輸出(STDOUT)顯示，使用 rs2tabout 方法如下：?
print rs2tabout($rs);?
執行結果如下：?
Figure 1. 在console中顯示結果?
也可以存成 CSV 檔：?
// 檔案路徑?
$path = "/tmp/test.csv";?
// 開檔供寫入?
$fhd = fopen($path, "w");?
// 若開檔成功?
if ($fhd) {?
// 則寫入 CSV?
rs2csvfile($rs, $fhd);?
// 也可以使用 rs2tabfile($rs, $fhd);?
// 關檔?
fclose($fhd);?
}?
結果如下：?
[ols3@p web]$ cat /tmp/test.csv?
姓名,年紀?
abcde,45?
yyy,20?
ppp,34?
mmm,13?
hhh,41?
rrr,65?
kkk,29?
miso,154?
sss,89?
abc,18?
abcde,0?
uyt,58?
john,28?
16. 取出一定筆數的記錄 (使用 SelectLimit)?
ADODB 提供一個 ADOConnect 函式 SelectLimit，可供您取出一定筆數的記錄，用法如下：?
$conn->Connect($mch, $user, $pwd, $database);?
rs = $conn->SelectLimit("Select * from t", 3, 1);?
// 取出 3 筆、在第 1 筆之后?
// 秀出這 3 筆記錄?
if ($rs) {?
while( $ar = $rs->FetchRow() ) {?
print $ar['name'] ." " . $ar['year'];?
print "<br>\n";?
}?
}?
上式是說：在第 1 筆記錄之后，取出 3 筆，也就是第 2、3、4 筆記錄。?
結果如下：?
--------------------------------------?
(mysql): select * from t LIMIT 1,3?
--------------------------------------?
注意 ! SelectLimit 的寫法剛好和 MySQL 語法相反 !
-
雖然 PHP 是建構 Web 系統強有力的工具，但是 PHP 存取數據庫的功能，一直未能標準化，每一種數據庫，都使用另一種不同且不兼容的應用程序接口(API)。為了填補這個缺憾，因此才有 ADODB 的出現。一旦存取數據庫的接口予以標準化，就能隱藏各種數據庫的差異，若欲轉換至其它不同的數據庫，將變得十分容易。?
目前 ADODB 支持的數據庫種類非常地多，例如：MySQL, PostgreSQL, Interbase, Informix, Oracle, MS SQL 7, Foxpro, Access, ADO, Sybase, DB2 以及一般的 ODBC (其中 PostgreSQL、Informix、Sybase 的driver 是由自由軟件社群發展之后貢獻出來的)。?
使用 ADODB 最大的優點之一是：不管后端數據庫如何，存取數據庫的方式都是一致的，開發設計人員不必為了某一套數據庫，而必須再學習另一套不同的存取方法，這大大減輕開發人員的知識負擔，過去的知識往后仍可繼續使用，轉移數據庫平臺時，程序代碼也不必做太大的更動。?
其實 ADODB 這樣的發展理念，并不是首創的，DBI 比 ADODB 出現得更早，它提供 Perl 存取數據庫時，使用一致的 API 呼叫接口。相信用過 Perl + DBI 的朋友，再來用 ADODB 時，會有一種似曾相識的感覺。?
另外，ADODB 對用過 ASP 的人而言，應該不陌生，這類朋友對 ADODB 應該很容易接受。?
我們來看一下，ADODB 的簡單用法：?
<?php?
// 引入 adodb 的 inc 檔，才能呼叫 adodb 提供的函式?
include('adodb/adodb.inc.php');?
// 選擇連接的數據庫種類，以建立聯機對象，?
// 一旦對象建立，即可使用其成員函式來處理數據庫。?
// 以下 $conn 即此一物件(object)?
$conn = &ADONewConnection('mysql');?
// 要不要顯示偵錯訊息，false 不要，true 要。?
// $conn->debug = false;?
$conn->debug = true;?
// 連接數據庫?
// 用法：$conn->Connect('主機', '使用者', '密碼', '數據庫');?
// 用例：?
$conn->Connect('localhost', 'piza', 'ooo123', 'test');?
// 若欲采用持續性連接，上式可換用 PConnect：?
// $conn->PConnect('localhost', 'piza', 'ooo123', 'test');?
// 設定 sql 命令?
$sql = "insert into t values ('abcde', 18)";?
// 執行 sql 命令?
$rs = $conn->Execute($sql);?
// 檢查執行結果，若 $rs == false，則呼叫 $conn 對象的成員函式 ErrorMsg()?
if (!$rs) print $conn->ErrorMsg(); else print "OK!";?
?>?
結果如下：?
---------------------------------------------?
(mysql): insert into t values ("abcde",18)?
---------------------------------------------?
OK!?
若把偵錯關掉，即 $conn->debug=false，則結果如下：?
OK!?
以下，逐步為各位介紹：使用 ADODB 的重點方法。?
2. 安裝?
ADODB 的首頁在：http://php.weblogs.com/ADOdb，目前(2002/10/24)最新版是：2.42 版，可至 ADODB 下載或至臺南縣教網中心 FTP 下載。?
安裝 ADODB 的方法超極簡單，只要下載、解壓、放入適當位置，即可完成 ! 如下所示：?
1. 下載：?
$ ncftp ftp.tnc.edu.tw?
cd sysop/ADODB?
get adodb242.tgz?
2. 解壓：?
假設我把 adodb242.tgz 放入 /var/www/html 中?
$ cp adodb242.tgz /var/www/html?
$ tar xvzf adodb242.tgz?
如下所示：?
adodb/adodb-cryptsession.php?
adodb/adodb-csvlib.inc.php?
adodb/adodb-errorhandler.inc.php?
adodb/adodb-errorpear.inc.php?
adodb/adodb-lib.inc.php?
adodb/adodb-pager.inc.php?
....以下省略....?
現在，您在 /var/www/html/adodb 已安裝好 ADODB 了。?
3. 引入 ADODB?
一旦安裝好 ADODB，使用前，應把 ADODB 相關的含入文件引入您的程序中。adodb 目錄放在任何位置無所謂，只要能指向正確路徑文件名即可。一般而言，您的程序代碼只須引入 adodb.inc.php。?
作法如下：?
在您的 PHP 程序中：?
include('路徑/adodb/adodb.inc.php');?
或?
include_once('路徑/adodb/adodb.inc.php');?
例：?
若您的程序和 adodb 在同一目錄下：?
.?
..?
adodb/?
something.php*?
則：?
include('adodb/adodb.inc.php');?
即可。?
若位置是在某一個目錄 somedir 中：?
.?
..?
adodb?
somedir/something.php?
則必須使用：?
include('../adodb/adodb.inc.php');?
除了 adodb.inc.php 這個含入檔，ADODB 還提供許多 adodb-*.inc.php 的含入檔，這些多半是為驅動某些數據庫的特殊用法而設的。?
若是引入 adodb-session.php 則可讓您將 session 存入數據庫中來維護運用。?
若是引入 adodb-pager.inc.php，可方便您做分頁顯示。?
若是引入 adodb-errorhandler.inc.php，可讓您自訂錯誤處理訊息。?
若是含入 adodb-pear.inc.php，可讓您使用 PHP4 的 PEAR DB 語法來使用 ADODB。此時，尚可使用 DSN 連接數據庫的字符串設定。如 $dsn="mysql://piza:ooo123@localhost/test";?
若是引入 tohtml.inc.php，可幫您在程序代碼中，方便將取出的記錄，轉成 HTML 的表格(table)來顯示。?
若是引入 toexport.inc.php，可讓您方便地輸出 CSV 檔或以 tab 分隔字段的數據文件。?
若是引入 rsfilter.inc.php，可讓您在使用記錄之前，預做過濾處理。?
若是引入 pivottable.inc.php，可讓您使用 pivot table 功能(俗稱 cross-tabulations)。?
注意 ! adodb.inc.php 是一定要引入的，其它，則視您要使用那一個功能，再引入該含入檔即可。?
4. 選用數據庫種類，建立聯機對象?
由于 ADODB 使用對象導向的作法，因此您在引入檔之后，接著請視您后端數據庫的種類，建立一個聯機對象。作法如下：?
以 MySQL 數據庫為例：?
$conn = &ADONewConnection('mysql');?
注：NewADOConnection 和 ADONewConnection 是一樣的，二者皆可使用。?
上例中的 'mysql' 是指數據庫的 drvier 的種類，ADODB 會據此呼叫對應的數據庫 driver。?
其它常用的 driver 有：access、ado、ado_access、ado_mssql、db2、vfp、ibase、borland_ibase、informix、imformix72、mssql、oci8、odbc、postgres、postgres64、postgres7、sqlanywhere、sybase....等等。?
我們稱建立的對象 $conn 為一 ADOConnection 對象，它代表與數據庫的連接事務，皆透過這個對象來處理。ADOConnection 對象會提供許多處理的方法，以對象導向的說法，這些方法稱為成員函式，這是外界存取此一對象的接口。?
一旦聯機對象建立之后，就有許多對象函式可供您使喚啦 ! 請看下一節的介紹。?
5. 偵錯模式?
程序開發的過程，為了方便查出出現問題可能的地方，通常我們會打開偵錯模式，俟程序功能確實穩定之后，再將它關閉。ADODB 提供偵錯模式，存取數據庫時，能顯示其運作方式。?
打開偵錯模式，使用法：?
$conn->debug=true?
關閉偵錯模式，使用法：?
$conn->debug=false?
6. 連接數據庫?
接著，使用 $conn 聯機對象的 Connect 或 PConnect 函式來連接特定的數據庫，此時必須提供 DSN (Data Source Names)相關數據，DSN 可能包括：主機名稱、數據庫使用者、數據庫密碼、數據庫名稱。不同的數據庫種類，DSN 可能可以省略其中若干項。以 MySQL 而言，則上述四者都要提供。?
該函式會傳回 true 或 false，用以表示是否連接成功。?
用例：?
// 格式：$conn->Connect('主機', '使用者', '密碼', '數據庫');?
$conn->Connect('localhost', 'piza', 'ooo123', 'test');?
或者，采持續性連接：?
// 格式：$conn->PConnect('主機', '使用者', '密碼', '數據庫');?
$conn->PConnect('localhost', 'piza', 'ooo123', 'test');?
若欲探查是否有聯機成功，可用一個變量來接取傳回值：?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
$cok = $conn->Connect($mch, $user, $pwd, $database);?
或者，采持續性連接：?
$cok = $conn->PConnect($mch, $user, $pwd, $database);?
if (!$cok) { echo "無法連接數據庫 $database"; exit; }?
7. 設定 sql 命令語法、執行 sql 命令?
接下來，您就可以設計您要執行的 sql 命令語法，然后付諸執行。?
$sql = "這里放 SQL 的命令語法";?
$rs = $conn->Execute($sql);?
其中，$rs 為回傳的結果，若 $rs == false，則表示執行失敗，您必須仔細檢查一下。?
您不一定要把命令語法放在 $sql 變量中，也可以直接放入 Execute( ) 括號中。若命令較短無妨，若命令較長，我建議您還是用一個變量 $sql 來設定命令字符串吧 !?
下一節開始，為各位介紹 SQL 的基本命令，如：Insert、Select、Update、Delete 等等的用法。?
8. 插入記錄(Insert)?
Insert 的用法如下：?
// $name 為字符串，$year 為數字?
$name='abcde';?
$year=18;?
// 插入一筆記錄，命令的大小寫無妨，但數據表 t 及變量則大小寫有分別 !?
$sql = "INSERT INTO t VALUES ('$name', $year)";?
// $sql = "insert into t values ('$name', $year)"; 亦可。?
// 執行?
$rs = $conn->Execute($sql);?
// 檢查執行結果，進行錯誤處理；若正常，則繼續其它動作....?
if (!$rs) print $conn->ErrorMsg();?
....以下省略....?
ErrorMsg() 是錯誤顯示的函式，它會取出錯誤訊息，并顯示出來。?
另外，ADODB 提供一種 記錄集(RecordSet) 函式 GetInsertSQL()，可幫您產生 Insert 的語法。?
例子如下：?
<?php?
// 引入 ADODB?
include('adodb/adodb.inc.php');?
// 建立聯機對象?
$conn = &ADONewConnection('mysql');?
// 偵錯?
$conn->debug=true;?
// DSN 四項基本數據設定?
$mch="localhost";?
$user="root";?
$pwd="jack168";?
$database="test";?
// 連接至數據庫 test?
$conn->PConnect($mch, $user, $pwd, $database);?
// 產生一筆空記錄?
$sql = "select * from t where year=-1";?
$rs = $conn->Execute($sql);?
// 用一個空數組來裝要更新的數據?
$r = array();?
$r['name']='john';?
$r['year']=28;?
// 用 GetInsertSQL 函式來制作一個完整的 sql 命令，此 sql 命令放在 $insertSQL 中?
$insertSQL = $conn->GetInsertSQL($rs, $r);?
// 執行插入?
$conn->Execute($insertSQL);?
$conn->Close();?
?>?
偵錯訊息如下：?
-----------------------------------------------------------?
(mysql): select * from t where year=-1?
-----------------------------------------------------------?
(mysql): INSERT INTO t ( name, year ) VALUES ( 'john', 28 )?
-----------------------------------------------------------?
9. 取出記錄(Select)?
Select 的用法如下：?
<?php?
// 引入 ADODB?
include('adodb/adodb.inc.php');?
// 建立聯機對象?
$conn = &ADONewConnection('mysql');?
// 不偵錯?
$conn->debug=false;?
// DSN 四項基本數據設定?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
// 連接至數據庫 test?
$conn->PConnect($mch, $user, $pwd, $database);?
// 執行 Select 由表格 t 取出數據，?
// 它會傳回一個 ADORecordSet 記錄集對象 $rs (RecordSet)?
// 實際上 $rs 是一個 cursor 指標，它擁有目前的記錄(row 或稱 record)，?
// 該記錄的所有字段數據的內容，存放在 fields 這個數組之中?
// ，以數字為索引，第一個由 0 開始?
$rs = &$conn->Execute('select * from t');?
// 若 $rs 為 false，則秀出錯誤訊息?
if (!$rs) {?
print $conn->ErrorMsg();?
} else {?
// 當尚未到達 記錄集 $rs 的結束位置(EOF：End Of File)時，(即：還有記錄尚未取出時)?
while (!$rs->EOF) {?
// 秀出所有字段，$FieldCount() 會傳回字段總數?
for ($i=0, $max=$rs->FieldCount(); $i < $max; $i++) {?
print $rs->fields[$i] . " ";?
}?
// 移至下一筆記錄?
$rs->MoveNext();?
// 換列?
echo "<br>\n";?
}?
}?
$rs->Close(); // 可不用?
$conn->Close(); // 可不用?
?>?
$rs->fields[] 數組是由 PHP 的數據庫擴展功能產生的，某些擴展功能并不支持使用字段名稱當作索引。?
若欲使用名稱當作索引，也就是俗稱的 hash 或 associative arrays，則需使用全域變量 $ADODB_FETCH_MODE 加以指定。?
以下設定：使用數字索引 $ADODB_FETCH_MODE= ADODB_FETCH_NUM;?
以下設定：使用名稱索引 $ADODB_FETCH_MODE= ADODB_FETCH_ASSOC;?
下面是使用名稱索引的例子：?
<?php?
// 引入 ADODB?
include('adodb/adodb.inc.php');?
// 建立聯機對象?
$conn = &ADONewConnection('mysql');?
// 不偵錯?
$conn->debug=false;?
// DSN 四項基本數據設定?
$mch="localhost";?
$user="root";?
$pwd="jack168";?
$database="test";?
// 連接至數據庫 test?
$conn->PConnect($mch, $user, $pwd, $database);?
// 執行 sql 之前，指定使用名稱索引?
$ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;?
// 執行 Select，它會傳回一個 ADORecordSet 記錄集對象 $rs?
// 實際上 $rs 是一個 cursor 指標，它擁有目前的記錄內容，?
// 該記錄存放在 fields 這個數組之中?
$rs = &$conn->Execute('select * from t');?
// 若 $rs 為 false，則秀出錯誤訊息?
if (!$rs) {?
print $conn->ErrorMsg();?
} else {?
// 當尚未到達記錄集結束位置(EOF)時，?
while (!$rs->EOF) {?
// 秀出所有字段?
print $rs->fields['name'] . " " . $rs->fields['year'];?
// 移至下一筆記錄?
$rs->MoveNext();?
// 換列?
echo "<br>\n";?
}?
}?
$rs->Close(); // 可不用?
$conn->Close(); // 可不用?
?>?
10. 取出記錄(使用 FetchRow)?
這里示范 FetchRow 的用法：?
$sql = "select * from t";?
$rs = $conn->Execute($sql);?
if ($rs) {?
while( $ar = $rs->FetchRow() ) {?
print $ar['name'] ." " . $ar['year'];?
print "<br>\n";?
}?
}?
FetchRow() 會將取出的記錄傳回，您可用一個 array 來接取。?
注意 ! 使用 FetchRow() 就不必再用 MoveNext()，FetchRow 內部會自動完成移至下一筆記錄的動作。?
11. 更新記錄(Update)?
您可以用傳統的方式：?
$sql ="UPDATE t SET name='john', year=28 WHERE year=18";?
$conn->Execute($sql);?
也可以用以下這種方式：?
<?php?
// 引入 ADODB?
include('adodb/adodb.inc.php');?
// 建立聯機對象?
$conn = &ADONewConnection('mysql');?
// 偵錯?
$conn->debug=true;?
// DSN 四項基本數據設定?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
// 連接至數據庫 test?
$conn->PConnect($mch, $user, $pwd, $database);?
// 選擇要更新的那一筆記錄?
$sql = "select * from t where year=18";?
$rs = $conn->Execute($sql);?
// 用一個空數組來裝要更新的數據?
$r = array();?
$r['name']='john';?
$r['year']=28;?
// 用 GetUpdateSQL 函式來制作一個完整的 sql 命令，此 sql 命令放在 $updateSQL 中?
$updateSQL = $conn->GetUpdateSQL($rs, $r);?
// 執行更新?
$conn->Execute($updateSQL);?
$conn->Close();?
?>?
偵錯訊息如下：?
-------------------------------------------------------------?
(mysql): select * from t where year=18?
-------------------------------------------------------------?
(mysql): UPDATE t SET name = 'john', year = 28 WHERE year=18?
-------------------------------------------------------------?
12. 刪除記錄(Delete)?
刪除記錄很簡單，采傳統方式即可： $sql = "DELETE FROM t WHERE year=18";?
$rs = $conn->Execute($sql);?
13. 使用字段對象(Field Objects)?
這里示范字段對象 FetchField 的用法，用以取得字段名稱及字段型態：?
$sql = "select * from t";?
$rs = &$conn->Execute($sql);?
if ($rs) {?
while (!$rs->EOF) {?
// 取出第二個字段?
$f = $rs->FetchField(1);?
// 印出字段名稱 及 字段型態?
print $f->name . ":" . $f->type;?
$rs->MoveNext();?
print "<br>\n";?
}?
}?
另外，ADODB 提供一個 RecordSet 函式 MetaType()，可將原始的字段型態轉成一般型態代碼：?
C : 字符?
X : text?
B : blob?
D : 日期?
T : timestamp?
L : 布爾值或位?
I : 整數?
N : 數字型態，包括：自動增加、數值、浮點數、實數及整數?
R : serial、自動增加?
用例：?
$f = $rs->FetchField(1);?
// 印出字段名稱 及 字段型態的代碼?
print $f->name . ":" . $rs->MetaType($f->type);?
14. 簡單分頁(Pager)?
ADODB 提供一種簡單分頁顯示記錄的方法，使用前，要將 adodb-pager.inc.php 引入。?
<?php?
include('adodb/adodb.inc.php');?
// 引入分頁功能?
include('adodb/adodb-pager.inc.php');?
// 啟動 session?
session_start();?
$db = ADONewConnection('mysql');?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
$db->Connect($mch, $user, $pwd, $database);?
$sql = "select * from t";?
// 產生 pager 對象?
$pager = new ADODB_Pager($db, $sql);?
// 每一頁秀 5 筆記錄?
$pager->Render($rows_per_page=5);?
?>?
結果如下：?
Figure 1. 簡單分頁功能?
每頁顯示記錄的數目是由 Render() 來控制的，若沒有傳入指定的 row 數給 Render()，默認值每頁秀 10 筆。?
另外，字段名稱也可以改變，如下示范：?
<?php?
include('adodb/adodb.inc.php');?
// 引入分頁功能?
include('adodb/adodb-pager.inc.php');?
// 啟動 session?
session_start();?
$db = ADONewConnection('mysql');?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
$db->Connect($mch, $user, $pwd, $database);?
$sql = "select name as '姓名', year as '年紀' from t";?
// 產生 pager 對象?
$pager = new ADODB_Pager($db, $sql);?
// 每一頁秀 5 筆記錄?
$pager->Render($rows_per_page=5);?
?>?
結果如下：?
Figure 2. 改變字段名稱?
15. 輸出 CSV 檔?
ADODB 提供輸出 CSV 檔的方法，使用前，要將 toexport.inc.php 引入。?
<?php?
include('adodb/adodb.inc.php');?
// 引入輸出 CSV 文件功能?
include('adodb/toexport.inc.php');?
$db = ADONewConnection('mysql');?
$mch="localhost";?
$user="piza";?
$pwd="ooo123";?
$database="test";?
$db->Connect($mch, $user, $pwd, $database);?
$sql = "select name as '姓名', year as '年紀' from t";?
$rs = $db->Execute($sql);?
// 秀出 CSV 格式?
print rs2csv($rs);?
?>?
結果如下：?
姓名,年紀?
abcde,45?
yyy,20?
ppp,34?
mmm,13?
hhh,41?
rrr,65?
kkk,29?
miso,154?
sss,89?
abc,18?
abcde,0?
uyt,58?
john,28?
也可用 tab 分隔字段，使用 rs2tab 方法如下：?
print rs2tab($rs, false);?
注: false 表示不顯示字段名稱?
結果如下：?
abcde 45?
yyy 20?
ppp 34?
mmm 13?
hhh 41?
rrr 65?
kkk 29?
miso 154?
sss 89?
abc 18?
abcde 0?
uyt 58?
john 28?
若是 print rs2tab($rs, true);?
結果如下：?
姓名 年紀?
abcde 45?
yyy 20?
ppp 34?
mmm 13?
hhh 41?
rrr 65?
kkk 29?
miso 154?
sss 89?
abc 18?
abcde 0?
uyt 58?
john 28?
也可以將結果由標準輸出(STDOUT)顯示，使用 rs2tabout 方法如下：?
print rs2tabout($rs);?
執行結果如下：?
Figure 1. 在console中顯示結果?
也可以存成 CSV 檔：?
// 檔案路徑?
$path = "/tmp/test.csv";?
// 開檔供寫入?
$fhd = fopen($path, "w");?
// 若開檔成功?
if ($fhd) {?
// 則寫入 CSV?
rs2csvfile($rs, $fhd);?
// 也可以使用 rs2tabfile($rs, $fhd);?
// 關檔?
fclose($fhd);?
}?
結果如下：?
[ols3@p web]$ cat /tmp/test.csv?
姓名,年紀?
abcde,45?
yyy,20?
ppp,34?
mmm,13?
hhh,41?
rrr,65?
kkk,29?
miso,154?
sss,89?
abc,18?
abcde,0?
uyt,58?
john,28?
16. 取出一定筆數的記錄 (使用 SelectLimit)?
ADODB 提供一個 ADOConnect 函式 SelectLimit，可供您取出一定筆數的記錄，用法如下：?
$conn->Connect($mch, $user, $pwd, $database);?
rs = $conn->SelectLimit("Select * from t", 3, 1);?
// 取出 3 筆、在第 1 筆之后?
// 秀出這 3 筆記錄?
if ($rs) {?
while( $ar = $rs->FetchRow() ) {?
print $ar['name'] ." " . $ar['year'];?
print "<br>\n";?
}?
}?
上式是說：在第 1 筆記錄之后，取出 3 筆，也就是第 2、3、4 筆記錄。?
結果如下：?
--------------------------------------?
(mysql): select * from t LIMIT 1,3?
--------------------------------------?
注意 ! SelectLimit 的寫法剛好和 MySQL 語法相反 !
總結
以上是生活随笔為你收集整理的用php获取本周,上周,本月,上月,本季度日期的代码的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： FCKeditor 2.6 精简版
- 下一篇： 53个要点提高PHP编程效率