Function:cs_sql_query
cs_sql_query (var Datei, var SQL Query)
Als Datei wird im Regelfall nur __FILE__ übergeben, ein in PHP vordefinierter Wert, der den Dateinamen weiterreicht, um im Fehlerfall den Ursprung zu finden.
Die Anfrage ist ein vollständiges SQL-Query und sollte daher keine Befehle enthalten, die vom SQL-Standard abweichen ( SQL 2003 Core bzw. vorher SQL 99). Folgende SQL-Befehle sollten z.B. vermieden werden: ALTER TABLE CHANGE ... , ALTER TABLE ALTER ...
Um den Erfolg auszuwerten, liefert die Funktion im Fehlerfall den Integer 0 und bei Erfolg einen Array mit dem Element affected_rows zurück, in dem als Integer die Anzahl der betroffenen Datensätze enthalten ist.
Beispiel:
$query_result = cs_sql_query(__FILE__, "UPDATE {pre}_squads SET squads_name = 'test' WHERE squads_id = 3");
Dies setzt den Squadnamen bei dem Squad mit der ID 3 auf den Wert test. Da 3 eine Integerzahl ist, ist hier kein escapen notwendig.Beispiel 2:
$query_result = cs_sql_query(__FILE__, "UPDATE {pre}_users SET users_url = 'http://clansphere.de' WHERE users_email = '" . cs_sql_escape($email) . "'");
Dieses Beispiel setzt die URL des Benutzers, wessen E-Mail Adresse in der Variable $email gespeicher ist, auf http://clansphere.de. Da der Wert aus einer Variablen stammt, ist es extrem wichtig, den Wert zu escapen.
| Function:cs_sql_option« | Function:cs_sql_query | »Function:cs_sql_select |
