fbsql_query

(PHP 4 >= 4.0.6, PHP 5)

fbsql_queryEx�cute une requ�te sur un serveur FrontBase

Description

resource fbsql_query ( string $query [, resource $link_identifier [, int $batch_size ]] )

Envoie la requ�te query � la base de donn�es courante, sur le serveur.

Lorsque la requ�te r�ussit, vous pouvez utilisez fbsql_num_rows() pour savoir combien de lignes ont �t� retourn�es par une requ�te SELECT, ou fbsql_affected_rows() pour les autres requ�tes (DELETE, INSERT, REPLACE et UPDATE).

Liste de param�tres

query

La requ�te SQL � ex�cuter.

Note: La requ�te doit toujours se terminer par un point virgule.

link_identifier

Un identifiant de lien FrontBase retourn� par la fonction fbsql_connect() ou la fonction fbsql_pconnect().

Si ce param�tre est optionnel et qu'il n'est pas sp�cifi�, la fonction tentera de trouver un lien ouvert vers le serveur FrontBase et un tel lien n'est pas trouv�, la fonction tentera d'en cr�er un, de la m�me fa�on que si la fonction fbsql_connect() est appel�e sans aucun argument.

batch_size

Valeurs de retour

fbsql_query() retourne une ressource en cas de succ�s, ou FALSE, en cas d'�chec. Si TRUE est retourn�, cela signifie que la requ�te est correcte et qu'elle peut �tre ex�cut�e par le serveur. Cela n'indique rien sur le nombre de lignes concern�es ou retourn�es. Il est tout � fait possible qu'une requ�te r�ussisse mais qu'aucune ligne ne soit affect�e ni retourn�e.

Pour les requ�tes SELECT, fbsql_query() retourne une ressource de r�sultat, que vous pouvez passer � fbsql_result().

fbsql_query() �chouera si vous n'avez pas les droits d'acc�s sur l'une des bases de donn�es utilis�es dans la requ�te.

Exemples

La requ�te suivante est invalide, et fbsql_query() �chouera puis retournera FALSE :

Exemple #1 Exemple avec fbsql_query()

<?php
$result 
fbsql_query("SELECT * WHERE 1=1")
    or die (
"Requ�te invalide");
?>

La requ�te suivante est invalide si my_col n'est pas une colonne dans la table my_tbl : fbsql_query() �chouera puis retournera FALSE :

Exemple #2 Exemple avec fbsql_query()

<?php
$result 
fbsql_query ("SELECT my_col FROM my_tbl;")
    or die (
"Requ�te invalide");
?>

Voir aussi