PHP Handbuch
Zurück |  | Weiter

# sqlite_exec

(PHP 5)

sqlite_exec

(no version information, might be only in CVS)

SQLiteDatabase->exec -- Führt eine Abfrage ohne Ergebnis in einer definierten Datenbank aus

## Beschreibung

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

Objektorientierter Stil (Methode):

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

Führt eine SQL-Anweisung, die durch `query` gesetzt wurde, mit dem Datenbank-Handle (definiert durch den Parameter `dbhandle`) aus.

Warnung
SQLite kann mehrere, durch Semikolon getrennte Anweisungen ausführen. Dadurch kann man eine Reihe von Anweisungen aus einer Datei oder einem eingebetteten Skript laden und ausführen.

## Parameter Liste

`dbhandle`

  Die Ressource der SQLite-Datenbank, die bei prozeduraler Benutzung von sqlite_open() zurückgegeben wurden. Der Parameter wird bei der objektorientierten Methode nicht benötigt.

`query`

  Die auszuführende Anweisung.

`error_msg`

  Die angegebene Variable wird bei einem Fehler gefüllt. Das ist insbesondere deswegen wichtig, weil SQL-Syntaxfehler nicht durch die Funktion sqlite_last_error() abgerufen werden können.

> Anmerkung: Zwei alternative Syntaxen werden für die Kompatibilität mit anderen Datenbank-Erweiterungen (wie z.B. MySQL) unterstützt. Die bevorzugte Form ist die erste, bei der der Parameter `dbhandle` der erste Parameter der Funktion ist.

## Rückgabewerte

Die Funktion liefert ein boolsches Ergebnis; `TRUE` bei Erfolg, ansonsten `FALSE`. Wenn man eine Abfrage ausführen möchte, die Zeilen zurück liefern soll, sollte man bei sqlite_query() gucken.

Die Groß- und Kleinschreibung der Spaltennamen, die von `SQLITE_ASSOC` und `SQLITE_BOTH` zurückgegeben werden, wird entsprechend der Konfigurationsdirektive sqlite.assoc_case geändert.

## ChangeLog

Version | Beschreibung
--- | ---
5.1.0 | Parameter `error_msg` wurde hinzugefügt

## Beispiele

Beispiel 1. Prozedurales Beispiel
`<?php $dbhandle = sqlite_open('mysqlitedb'); $query = sqlite_exec($dbhandle, "UPDATE benutzer SET email='jDoe@example.com' WHERE benutzername='jDoe'", $error); if (!$query) { exit("Fehler in der Abfrage: '$error'"); } else { echo 'Anzahl geänderter Zeilen: ', sqlite_changes($dbhandle); } ?>`

Beispiel 2. Objektorientiertes Beispiel
`<?php $dbhandle = new SQLiteDatabase('mysqlitedb'); $query = $dbhandle->queryExec("UPDATE benutzer SET email='jDoe@example.com' WHERE benutzername='jDoe'", $error); if (!$query) { exit("Fehler in der Abfrage: '$error'"); } else { echo 'Anzahl geänderter Zeilen: ', $dbhandle->changes(); } ?>`

## Siehe auch

sqlite_query()
sqlite_unbuffered_query()
sqlite_array_query()

Zurück | Zum Anfang | Weiter
sqlite_escape_string | Nach oben | sqlite_factory