微擎数据库操作相关函数文档说明

微擎系统数据库操作使用 PDO 兼容方式, 系统已对 PDO 兼容性进行检测及封装. 请使用以下函数进行数据库操作. 所有数据库操作均不进行错误提示, 如果要进行错误调试, 请在系统中配置为开发模式, 然后调用 pdo_debug 方法进行错误输出.

tablename – 转义数据表名

string tablename(string $table)
说明: 获取原始的数据表名, 微擎系统按照惯例在所有的表名增加了前缀来增强兼容性. 使用 tablename 函数, 方便将业务数据表名转换为原始的数据表名来进行数据库操作.
返回: 原始表名, 可以直接用于数据库查询操作

pdo – 初始化 pdo 对象实例

PDO pdo(bool $newinstance = false)
说明: 获取 pdo 对象实例, pdo 函数默认使用缓存起来的 PDO 对象, 可通过 $_W['pdo'] 或 $GLOBALS['pdo'] 方式直接获取默认的 PDO 对象. 如果要使用新的 PDO 实例, 请将 $newinstance 参数设置为 true
参数: $newinstance 是否要创建新实例
返回: PDO 对象

pdo_query – 执行一条非查询语句

int|bool pdo_query(string $sql, array $params = array())
说明: 执行一条非查询语句, 返回受影响的行数
参数:
	 $sql 要进行查询的语句, 其中可以包括查询绑定参数
	 $params 要绑定的参数集合
返回: 如果执行成功返回受影响的记录数, 失败将返回 false

pdo_insert – 执行一条数据插入

int|bool pdo_insert(string $table, array $data = array(), bool $replace = false)
说明: 对某条数据表插入一条新纪录
参数: 
	 $table 指明要操作的数据表
	 $data 要插入的数据记录, 格式为与数据表字段对应的关联数组
	 $replace 指明插入方式使用 INSERT 语句或是 REPLACE 语句(区别请参阅MySQL手册)
返回: 如果执行成功返回受影响的记录数(一般为数字 1), 失败将返回 false

pdo_insertid – 获取上次插入的自增数字主键

int pdo_insertid()
说明: 获得最后一次插入的自增数字主键
返回: 成功将返回数字主键, 失败将返回 0. 使用此函数时, 请注意保证 PDO 实例正确. 只有使用默认实例才有效.

pdo_delete – 删除记录

int|bool pdo_delete(string $table, array $filter = array(), string $gule = 'AND')
说明: 对某条数据表删除纪录
参数: 
	 $table 指明要操作的数据表
	 $filter 删除时要删选的条件数据, 格式为与数据表字段对应的关联数组
	 $gule 指明筛选条件的组合方式, 有效值为 AND(代表所有条件均需满足), OR(其中一种条件满足)
返回: 如果执行成功返回受影响的记录数(删除成功的行数), 失败将返回 false

pdo_update – 执行数据更新

int|bool pdo_update(string $table, array $data = array(), array $filter = array(), string $gule = 'AND')
说明: 对某条数据表更新特定纪录
参数: 
	 $table 指明要操作的数据表
	 $data 要更新的数据记录, 格式为与数据表字段对应的关联数组
	 $filter 删除时要更新的条件数据, 格式为与数据表字段对应的关联数组
	 $gule 指明筛选条件的组合方式, 有效值为 AND(代表所有条件均需满足), OR(其中一种条件满足)
返回: 如果执行成功返回受影响的记录数, 失败将返回 false. 如果数据无变动将会返回数字 0, 注意与错误返回值 false 区别.

pdo_fetchcolumn – 查询 SQL 语句并获得首行指定列的值

mixed|bool pdo_fetchcolumn(string $sql, array $params = array(), int $column = 0)
说明: 执行制定的查询语句, 返回首行指定列的值, 默认返回首行首列
参数:
	 $sql 要进行查询的语句, 其中可以包括查询绑定参数
	 $params 要绑定的参数集合
	 $column 要返回的列
返回: 如果执行成功将返回查询出来的数据结果首行指定列的值, 如果执行失败或指定的列无效将返回bool值 false

pdo_fetch – 按照 SQL 语句查询一条记录

array|bool pdo_fetch(string $sql, array $params = array())
说明: 按照语句及绑定参数获取一条记录, 绑定参数部分请参阅PHP手册 PDO部分
参数:
	 $sql 要进行查询的语句, 其中可以包括查询绑定参数
	 $params 要绑定的参数集合
返回: 如果执行成功将返回查询出来的数据结果(关联数组结构, 格式与查询结果结构相同), 如果执行失败将返回bool值 false

pdo_fetchall – 按照 SQL 语句查询所有记录

array|bool pdo_fetch(string $sql, array $params = array(), string $keyfiled此 = '')
说明: 按照语句及绑定参数获取一条记录, 绑定参数部分请参阅PHP手册 PDO部分
参数:
	 $sql 要进行查询的语句, 其中可以包括查询绑定参数
	 $params 要绑定的参数集合
	 $keyfield 返回的数据结果将以此字段的值为键名呈现为关联数组
返回: 如果执行成功将返回查询出来的数据结果(关联数组结构, 格式与查询结果结构相同), 如果执行失败将返回bool值 false

pdo_debug – 获取数据库操作记录列表

array pdo_debug(bool $output = true, array $append = array())
说明: 获取本次请求周期内所有的数据库操作记录, 也可以用来记录操作记录. 这个函数只有将系统配置中设置为开发模式才会生效
参数: 
	 $output 如果传递 true, 将会直接使用 print_r 打印所有操作记录; 如果传递 false, 则不会打印操作记录, 仅通过返回值返回 
	 $append 用于记录操作记录, 开发者通常不需要使用这个参数
返回: 返回本次请求生命周期内所有的操作记录