(PHP 4 >= 4.0.6, PHP 5, PHP 7)
fbsql_query — Realiza una consulta FrontBase
$query
[, resource $link_identifier
[, int $batch_size
]] )
Envia la query a la base de datos activa en el
servidor.
Si la consulta tiene éxito, se puede llamar fbsql_num_rows() para saber cuantas filas se devolvieron para una instrucción SELECT, o fbsql_affected_rows() para saber cuantas filas se vieron afectadas por una instrucción DELETE, INSERT, REPLACE, o UPDATE.
queryLa consulta SQL a ejecutar.
Nota:
La cadena de consulta debe acabar siempre con punto y coma.
link_identifierUn identificador de enlace FrontBase devuelto por fbsql_connect() o fbsql_pconnect().
Es opcional y si no se especifica, la función intentará encontrar un enlace abierto al servidor FrontBase y de no encontrarse ningún enlace abierto intentará crear uno como si fbsql_connect() fuese invocada sin parámetros.
batch_size
fbsql_query() devuelve TRUE (non-zero) o FALSE
para indicar si la consulta tuvo éxito. Un valor devuelto
TRUE implica que la consulta significa que la consulta es lícita y podría ser ejecutada por
el servidor. No indica nada acerca del número de filas
afectadas o devueltas. Es perfectamente posible que una consulta
tenga éxito pero no devuelva o afecte ninguna fila.
Para instrucciones SELECT, fbsql_query() devuelve un nuevo identificador de resultado que se puede pasar a fbsql_result().
fbsql_query() también fallará y devolverá FALSE si
no se tiene permiso para acceder a la(s) tabla(s) referidas por la consulta.
La siguiente consulta es sintácticamente inválida, así que
fbsql_query() falla y devuelve FALSE:
Ejemplo #1 Ejemplo fbsql_query()
<?php
$result = fbsql_query("SELECT * WHERE 1=1")
or die ("Consulta inválida");
?>
La siguiente consulta es semánticamente inválida si
my_col no es una columna de la tabla
my_tbl, así que fbsql_query()
falla y devuelve FALSE:
Ejemplo #2 Ejemplo fbsql_query()
<?php
$result = fbsql_query ("SELECT my_col FROM my_tbl;")
or die ("Consulta inválida");
?>