diff --git a/reference/sqlite3/sqlite3.xml b/reference/sqlite3/sqlite3.xml index b5c7eeebdb27..88c42d388b9f 100644 --- a/reference/sqlite3/sqlite3.xml +++ b/reference/sqlite3/sqlite3.xml @@ -263,21 +263,31 @@ SQLite3::OK - + + Returned from an authorizer callback to allow the action. + SQLite3::DENY - + + Returned from an authorizer callback to reject the entire SQL statement + with an error. + SQLite3::IGNORE - + + Returned from an authorizer callback to disallow the specific action + while still allowing the SQL statement to be compiled. See + SQLite3::setAuthorizer for the effect on each + action. + diff --git a/reference/sqlite3/sqlite3/enableextendedresultcodes.xml b/reference/sqlite3/sqlite3/enableextendedresultcodes.xml new file mode 100644 index 000000000000..1cf6202d0a7b --- /dev/null +++ b/reference/sqlite3/sqlite3/enableextendedresultcodes.xml @@ -0,0 +1,114 @@ + + + + + SQLite3::enableExtendedResultCodes + + Enables or disables the use of extended result codes + + + + + &reftitle.description; + + public boolSQLite3::enableExtendedResultCodes + boolenable&true; + + + Enables or disables the use of extended result codes, which are then + reported by SQLite3::lastErrorCode. + SQLite3::lastExtendedErrorCode is not affected by + this setting, and always returns the extended result code. + + + + + &reftitle.parameters; + + + enable + + + Whether to enable (&true;) or disable (&false;) the use of extended + result codes. + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.examples; + + <methodname>SQLite3::enableExtendedResultCodes</methodname> example + +enableExceptions(true); +$db->exec('CREATE TABLE t (a INTEGER UNIQUE)'); +$db->exec('INSERT INTO t VALUES (1)'); + +try { + $db->exec('INSERT INTO t VALUES (1)'); +} catch (Exception $e) { +} + +// The primary result code (SQLITE_CONSTRAINT), then the extended result +// code (SQLITE_CONSTRAINT_UNIQUE). +var_dump($db->lastErrorCode(), $db->lastExtendedErrorCode()); + +// Once enabled, SQLite3::lastErrorCode() reports the extended result code +// as well. +$db->enableExtendedResultCodes(); +var_dump($db->lastErrorCode()); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + SQLite3::lastExtendedErrorCode + SQLite3::lastErrorCode + + + + + diff --git a/reference/sqlite3/sqlite3/lasterrorcode.xml b/reference/sqlite3/sqlite3/lasterrorcode.xml index b685d0fcf46e..f107a4902aee 100644 --- a/reference/sqlite3/sqlite3/lasterrorcode.xml +++ b/reference/sqlite3/sqlite3/lasterrorcode.xml @@ -32,6 +32,15 @@ + + &reftitle.seealso; + + SQLite3::lastExtendedErrorCode + SQLite3::enableExtendedResultCodes + SQLite3::lastErrorMsg + + + + + + SQLite3::lastExtendedErrorCode + + Returns the numeric extended result code of the most recent failed + SQLite request + + + + + &reftitle.description; + + public intSQLite3::lastExtendedErrorCode + + + + Returns the numeric extended result code of the most recent failed SQLite + request. Unlike SQLite3::lastErrorCode, this method + always returns the extended result code, whether or not extended result + codes have been enabled with + SQLite3::enableExtendedResultCodes. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns an integer value representing the numeric extended result code of + the most recent failed SQLite request. + + + + + &reftitle.seealso; + + SQLite3::enableExtendedResultCodes + SQLite3::lastErrorCode + SQLite3::lastErrorMsg + + + + + diff --git a/reference/sqlite3/versions.xml b/reference/sqlite3/versions.xml index 48829a4f4a6d..506787119e3b 100644 --- a/reference/sqlite3/versions.xml +++ b/reference/sqlite3/versions.xml @@ -13,11 +13,13 @@ + - + +