[Xunsearch PHP-SDK](http://www.xunsearch.com) v1.4.8 API 參考文檔
# XSDatabase
[All Packages](#)| [方法(函數)](#)
| 包 | [XS.util.db](#) |
|-----|-----|
| 繼承關系 | abstract class XSDatabase |
| 子類 | [XSDatabaseMySQL](#), [XSDatabaseMySQLI](#), [XSDatabasePDO](#), [XSDatabasePgSQL](#), [XSDatabaseSQLite](#), [XSDatabaseSQLite3](#) |
| 版本 | 1.0.0 |
| 源代碼 | [sdk/php/util/XSDataSource.class.php](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php) |
數據庫操作基類定義了 SQL 數據庫源的四個基本操作: connect/query/close/setUtf8
### Public 方法
[隱去繼承來的方法](#)
| 名稱 | 描述 | 定義于 |
|-----|-----|-----|
| [close()](#) | 關閉數據庫連接 | XSDatabase |
| [connect()](#) | 連接數據庫 | XSDatabase |
| [query()](#) | 查詢 SQL 語句 | XSDatabase |
| [query1()](#) | 查詢數據庫首行 | XSDatabase |
| [setUtf8()](#) | 設置數據庫字符集為 UTF-8 | XSDatabase |
### 方法明細
close()方法
<table class="summaryTable"><tr><td colspan="3"><div class="signature2">abstract public void <b>close</b>()</div></td></tr></table>
**源碼:**[sdk/php/util/XSDataSource.class.php#L433](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php#L433) (**[顯示](#)**)
`abstract?public?function?close();`
關閉數據庫連接
connect()方法
<table class="summaryTable"><tr><td colspan="3"><div class="signature2">abstract public void <b>connect</b>(array $param)</div></td></tr><tr><td class="paramNameCol">$param</td> <td class="paramTypeCol">array</td> <td class="paramDescCol">連接參數, 采用 parse_url 解析, 可能包含: scheme,user,pass,host,path,table,dbname ...</td></tr></table>
**源碼:**[sdk/php/util/XSDataSource.class.php#L428](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php#L428) (**[顯示](#)**)
`abstract?public?function?connect($param);`
連接數據庫
query()方法
<table class="summaryTable"><tr><td colspan="3"><div class="signature2">abstract public mixed <b>query</b>($sql)</div></td></tr><tr><td class="paramNameCol">$sql</td> <td class="paramTypeCol"></td> <td class="paramDescCol"></td></tr><tr><td class="paramNameCol">{return}</td> <td class="paramTypeCol">mixed</td> <td class="paramDescCol">非 SELECT 語句返回執行結果(true/false), SELECT 語句返回所有結果行的數組</td></tr></table>
**源碼:**[sdk/php/util/XSDataSource.class.php#L439](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php#L439) (**[顯示](#)**)
`abstract?public?function?query($sql);`
查詢 SQL 語句
query1()方法
<table class="summaryTable"><tr><td colspan="3"><div class="signature2">public 查詢結果首行, <b>query1</b>(string $sql)</div></td></tr><tr><td class="paramNameCol">$sql</td> <td class="paramTypeCol">string</td> <td class="paramDescCol"></td></tr><tr><td class="paramNameCol">{return}</td> <td class="paramTypeCol">查詢結果首行,</td> <td class="paramDescCol">失敗或無數據則返回 false</td></tr></table>
**源碼:**[sdk/php/util/XSDataSource.class.php#L455](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php#L455) (**[顯示](#)**)
`public?function?query1($sql)
{
????$sql?=?preg_replace('/?limit\s+(\d+)(?:\s*,\s*(\d+)|\s+offset\s+(\d+))?\s*$/i',?'',?$sql);
????$sql?.=?'?LIMIT?1';
????$res?=?$this->query($sql);
????return?(is_array($res)?&&?isset($res[0]))???$res[0]?:?false;
}`
查詢數據庫首行
setUtf8()方法
<table class="summaryTable"><tr><td colspan="3"><div class="signature2">public bool <b>setUtf8</b>()</div></td></tr><tr><td class="paramNameCol">{return}</td> <td class="paramTypeCol">bool</td> <td class="paramDescCol">如果數據庫能直接輸出 UTF-8 編碼則返回 true 否則返回 false</td></tr></table>
**源碼:**[sdk/php/util/XSDataSource.class.php#L445](https://github.com/hightman/xunsearch/blob/master/sdk/php/util/XSDataSource.class.php#L445) (**[顯示](#)**)
`public?function?setUtf8()
{
????return?false;
}`
設置數據庫字符集為 UTF-8
Copyright ? 2008-2011 by [杭州云圣網絡科技有限公司](http://www.xunsearch.com)
All Rights Reserved.
- 權威指南
- 新手上路
- 最新主要變動
- 概述
- 關于 Xunsearch PHP-SDK
- 安裝、升級
- 體驗 demo 項目
- 開發規范
- 開發流程
- 了解基礎對象
- 基礎對象概述
- XS 項目
- XSException 異常
- XSDocument 文檔
- XSIndex 索引管理
- XSSearch 搜索
- XSTokenizer 分詞接口
- 編寫項目配置文件
- 項目配置詳解
- 自定義分詞器
- 編寫第一個配置文件
- 管理索引
- 索引概述
- 添加文檔
- 更新、修改文檔
- 刪除文檔
- 清空索引
- 平滑重建索引
- 使用索引緩沖區
- 自定義SCWS詞庫
- 使用搜索
- 搜索概述
- 構建搜索語句
- 獲取搜索匹配結果
- 獲取搜索匹配數量
- 獲取熱門搜索詞
- 獲取相關搜索詞
- 搜索建議和糾錯
- 按字段值分面搜索
- 使用輔助工具
- RequiredCheck 運行檢測
- Indexer 索引管理器
- Quest 搜索測試工具
- SearchSkel 生成搜索代碼
- IniWizzard 配置文件向導
- Logger 搜索日志管理
- 專題
- 同義詞搜索功能
- 在SDK中使用SCWS分詞
- API 指南
- XS
- XS
- XSCommand
- XSComponent
- XSDocument
- XSErrorException
- XSException
- XSFieldMeta
- XSFieldScheme
- XSIndex
- XSSearch
- XSServer
- XS.tokenizer
- XSTokenizer
- XSTokenizerFull
- XSTokenizerNone
- XSTokenizerScws
- XSTokenizerSplit
- XSTokenizerXlen
- XSTokenizerXstep
- XS.util
- XSCsvDataSource
- XSDataFilter
- XSDatabaseDataSource
- XSDebugFilter
- XSJsonDataSource
- XSUtil
- XS.util.db
- XSDatabase
- XSDatabaseMySQL
- XSDatabaseMySQLI
- XSDatabasePDO
- XSDatabasePDO_MySQL
- XSDatabasePDO_PgSQL
- XSDatabasePDO_SQLite
- XSDatabasePgSQL
- XSDatabaseSQLite
- XSDatabaseSQLite3
- XS.utilf
- XSDataSource
- 其它文檔
- 關于 xunsearch
- 特色和優勢
- Xunsearch 架構簡圖
- 下載 Xunsearch
- 商業服務與支持
- XunSearch 授權許可證