PHP 手册
后退 |  | 前进

# sqlite_exec

(PHP 5)

sqlite_exec

(no version information, might be only in CVS)

SQLiteDatabase->exec -- Executes a result-less query against a given database

## 说明

bool sqlite_exec ( resource dbhandle, string query [, string &error_msg] )
bool sqlite_exec ( string query, resource dbhandle )

Object oriented style (method):

class SQLiteDatabase {
bool queryExec ( string query [, string &error_msg] )
}

Executes an SQL statement given by the query against a given database handle (specified by the dbhandle parameter).

警告
SQLite will execute multiple queries separated by semicolons, so you can use it to execute a batch of SQL that you have loaded from a file or have embedded in a script.

## 参数

dbhandle

  The SQLite Database resource; returned from sqlite_open() when used procedurally. This parameter is not required when using the object-oriented method.

query

  The query to be executed.

error_msg

  The specified variable will be filled if an error occurs. This is specially important because SQL syntax errors can't be fetched using the sqlite_last_error() function.

> 注: 为兼容其它数据库（例如 MySQL），支持另两种替代的语法。推荐用第一种，dbhandle 参数作为函数的第一个参数。

## 返回值

This function will return a boolean result; `TRUE` for success or `FALSE` for failure. If you need to run a query that returns rows, see sqlite_query().

由 `SQLITE_ASSOC` 和 `SQLITE_BOTH` 返回的列名会根据 sqlite.assoc_case 配置选项的值来决定大小写。

## 更新日志

版本 | 说明
--- | ---
5.1.0 | Added the error_msg parameter

## 范例

例子 1. Procedural example

`<?php $dbhandle = sqlite_open('mysqlitedb'); $query = sqlite_exec($dbhandle, "UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error); if (!$query) { exit("Error in query: '$error'"); } else { echo 'Number of rows modified: ', sqlite_changes($dbhandle); } ?>`

例子 2. Object-oriented example

`<?php $dbhandle = new SQLiteDatabase('mysqlitedb'); $query = $dbhandle->queryExec("UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error); if (!$query) { exit("Error in query: '$error'"); } else { echo 'Number of rows modified: ', $dbhandle->changes(); } ?>`

## 参见

sqlite_query()
sqlite_unbuffered_query()
sqlite_array_query()

后退 | 起点 | 前进
sqlite_escape_string | 上一级 | sqlite_factory