[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.