(PHP 5 < 5.4.0, PECL sqlite >= 1.0.3)
sqlite_exec -- SQLiteDatabase::exec — Esegue una query priva di risultato in un dato database
$dbhandle
, string $query
[, string &$error_msg
] )$query
, resource $dbhandle
)Stile orientato agli oggetti (metodo):
$query
[, string &$error_msg
] )
Esegue un'espressione SQL, indicata da query
sul database
(specificato dal parametro
dbhandle
).
SQLite esegue molteplici query separate da punto e virgola, in questo modo si può eseguire un batch di istruzioni SQL caricate da un file o racchiuse in uno script.
dbhandle
Risorsa SQLite Database; restituita da sqlite_open () quando usato in modo procedurale. Questo parametro non è richiesto nel metodo ad oggetti.
query
Query da eseguire.
I dati all'interno della query devono essere il risultato della funzione escape.
error_msg
La variabile indicata sarà riempita se si verifica un errore. Questo è particolarmente importante perché gli errori di sintassi di SQL non possono essere scaricati utilizzando la funzione sqlite_last_error().
Nota: Due sintassi alternative sono supportate per compatibilità con altre estensioni di database (come MySQL). La forma preferita è la prima, dove il parametro
dbhandle
è il primo parametro per la funzione.
Questa funzione restituisce un risultato booleano; TRUE
per successo o FALSE
per insuccesso.
Se si deve eseguire una query che restituisca un risultato, guardare sqlite_query().
I nomi delle colonne restituiti da
SQLITE_ASSOC
e da SQLITE_BOTH
saranno
maiuscoli o minuscoli in base al valore del parametro di configurazione
sqlite.assoc_case
.
Versione | Descrizione |
---|---|
5.1.0 |
Aggiunto il parametro error_msg
|
Example #1 Esempio procedurale
<?php
$dbhandle = sqlite_open('mysqlitedb');
$query = sqlite_exec($dbhandle, "UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error);
if (!$query) {
exit("Errore nella query: '$error'");
} else {
echo 'Numero di righe modificate: ', sqlite_changes($dbhandle);
}
?>
Example #2 Esempio ad oggetti
<?php
$dbhandle = new SQLiteDatabase('mysqlitedb');
$query = $dbhandle->queryExec("UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error);
if (!$query) {
exit("Errore nella query: '$error'");
} else {
echo 'Numero di righe modificate: ', $dbhandle->changes();
}
?>