XSDatabasePDO · Xunsearch 中文文檔

[Xunsearch PHP-SDK](http://www.xunsearch.com) v1.4.8 API 參考文檔 # XSDatabasePDO [All Packages](#)| [屬性](#)| [方法(函數)](#) | 包 | [XS.util.db](#) | |-----|-----| | 繼承關系 | abstract class XSDatabasePDO ?[XSDatabase](#) | | 子類 | [XSDatabasePDO_MySQL](#), [XSDatabasePDO_PgSQL](#), [XSDatabasePDO_SQLite](#) | | 版本 | 1.0.0 | | 源代碼 | [sdk/php/util/XSDataSource.class.php](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php) | 面向對象的 PDO 擴展基類 ### Protected 屬性 [隱去繼承來的屬性](#) | 名稱 | 類型 | 描述 | 定義于 | |-----|-----|-----|-----| | [obj](#) | | | XSDatabasePDO | ### Public 方法 [隱去繼承來的方法](#) | 名稱 | 描述 | 定義于 | |-----|-----|-----| | [close()](#) | 關閉數據庫 | XSDatabasePDO | | [connect()](#) | 連接數據庫 | XSDatabasePDO | | [query()](#) | 執行 SQL 語句 | XSDatabasePDO | | [query1()](#) | 查詢數據庫首行 | [XSDatabase](#) | | [setUtf8()](#) | 設置數據庫字符集為 UTF-8 | [XSDatabase](#) | ### Protected 方法 [隱去繼承來的方法](#) | 名稱 | 描述 | 定義于 | |-----|-----|-----| | [makeDsn()](#) | 提取參數內容生成 PDO 連接專用的 DSN | XSDatabasePDO | ### 屬性明細 obj屬性 protected **$obj**; ### 方法明細 close()方法 <table class="summaryTable"><tr><td colspan="3"><div class="signature2">public void <b>close</b>()</div></td></tr></table> **源碼:**[sdk/php/util/XSDataSource.class.php#L833](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php#L833) (**[顯示](#)**) `public?function?close() { ????$this->obj?=?null; }` 關閉數據庫 connect()方法 <table class="summaryTable"><tr><td colspan="3"><div class="signature2">public void <b>connect</b>(array $param)</div></td></tr><tr><td class="paramNameCol">$param</td> <td class="paramTypeCol">array</td> <td class="paramDescCol">連接參數, 包含: user, pass ...</td></tr></table> **源碼:**[sdk/php/util/XSDataSource.class.php#L818](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php#L818) (**[顯示](#)**) `public?function?connect($param) { ????$dsn?=?$this->makeDsn($param); ????$user?=?isset($param['user'])???$param['user']?:?'root'; ????$pass?=?isset($param['pass'])???$param['pass']?:?''; ????try?{ ????????$this->obj?=?new?PDO($dsn,?$user,?$pass); ????}?catch?(PDOException?$e)?{ ????????throw?new?XSException($e->getMessage()); ????} }` 連接數據庫具體的每個類必須實現 [makeDsn](#) 來將參數轉換為 dsn #### 參見 - [makeDsn](#) makeDsn()方法 <table class="summaryTable"><tr><td colspan="3"><div class="signature2">abstract protected void <b>makeDsn</b>(array $param)</div></td></tr><tr><td class="paramNameCol">$param</td> <td class="paramTypeCol">array</td> <td class="paramDescCol"></td></tr></table> **源碼:**[sdk/php/util/XSDataSource.class.php#L859](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php#L859) (**[顯示](#)**) `abstract?protected?function?makeDsn($param);` 提取參數內容生成 PDO 連接專用的 DSN query()方法 <table class="summaryTable"><tr><td colspan="3"><div class="signature2">public mixed <b>query</b>(string $sql)</div></td></tr><tr><td class="paramNameCol">$sql</td> <td class="paramTypeCol">string</td> <td class="paramDescCol">要執行的 SQL 語句</td></tr><tr><td class="paramNameCol">{return}</td> <td class="paramTypeCol">mixed</td> <td class="paramDescCol"></td></tr></table> **源碼:**[sdk/php/util/XSDataSource.class.php#L843](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php#L843) (**[顯示](#)**) `public?function?query($sql) { ????//echo?"[DEBUG]?SQL:?$sql\n"; ????$res?=?$this->obj->query($sql); ????if?($res?===?false)?{ ????????$info?=?$this->obj->errorInfo(); ????????throw?new?XSException('SQLSTATE['?.?$info[0]?.?']?['?.?$info[1]?.?']?'?.?$info[2]); ????} ????$ret?=?$res->fetchAll(PDO::FETCH_ASSOC); ????return?$ret; }` 執行 SQL 語句 Copyright ? 2008-2011 by [杭州云圣網絡科技有限公司](http://www.xunsearch.com) All Rights Reserved.