fbsql_query

fbsql_query -- Exécute une requête sur un serveur FrontBase

Description

resource fbsql_query ( string query [, resource link_identifier])

fbsql_query( ) envoie la requête query à la base de données courante , sur le serveur représenté par sa connexion link_identifier . Si link_identifier est omis , la dernière connexion ouverte est utilisée . Si aucune connexion n' a été ouverte , fbsql_query( ) essaie d'établir une connexion en appelant la fonction fbsql_connect( ) sans aucun argument .

La requête doit être terminée par un point-virgule !

fbsql_query( ) retourne une ressource en cas de succès , ou FALSE , en cas d 'échec .

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

Exemple 1 . Exemple avec fbsql_query( ) (1 )

 
?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( ) (2 )

 
?php

 
$result

 
=

 
fbsql_query(

 
"SELECT

 
my_col

 
FROM

 
my_tbl"

 
)

 
or

 
die

 
("Invalid

 
query")

 
;

 
?





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

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

Pour les requêtes SELECT , fbsql_query( ) retourne une ressource de résultat , que vous pouvez passer à fbsql_result( ) . Lors vous avez fini de lire le résultat , vous pouvez libérer les ressources utilisées en appelant fbsql_free_result( ) . Cependant , la mémoire sera automatiquement libérée à la fin du script .

Voir aussi fbsql_affected_rows( ) , fbsql_db_query( ) , fbsql_free_result( ) , fbsql_result( ) , fbsql_select_db( ) et fbsql_connect( ) .