(PHP 4 >= 4.0.6, PHP 5)
fbsql_query — Wysyła zapytanie do serwera FrontBase
Wysyła zapytanie do bieżącej bazy danych na serwerze.
Jeśli wykonanie zapytania się powiedzie, możemy wywołać fbsql_num_rows() aby się dowiedzieć jak dużo wierszy zostało zwróconych przez instrukcję SELECT, lub fbsql_affected_rows() żeby wykryć ile wierszy zostało przetworzonych przez instrukcję DELETE, INSERT, REPLACE, lub UPDATE.
Zapytanie SQL do wykonania.
Informacja: Zapytanie powinno zawsze kończyć się średnikiem.
Identyfikator połączenia FrontBase zwrócony przez fbsql_connect() lub fbsql_pconnect().
Jeśli link jest opcjonalny i nie zostanie podany, funkcja spróbuje znaleźć otwarte połączenie do serwera FrontBase i jeśli takiego połączenia nie znajdzie, spróbuje utworzyć je tak jak fbsql_connect() byłaby wywołana bez argumentów
fbsql_query() zwraca TRUE (nie zero) lub FALSE aby wskazać, czy zapytanie zostało wykonane prawidłowo. Zwrócenie TRUE oznacza, że zapytanie było prawidłowe i mogło zostać wykonane przez serwer. Funkcja nie informuje o liczbie przetworzonych lub zwróconych wieszy. Jest całkiem możliwe, że zapytanie było prawidłowe, jednak nie przetworzyło ani nie zwróciło żadnych wierszy.
Dla instrukcji SELECT fbsql_query() zwraca nowy identyfikator wyniku, który możemy przekazać do fbsql_result().
fbsql_query() może się nie powieść i zwrócić FALSE jeśli nie mamy uprawnień dostępu do tabel określonych w zapytaniu.
Poniższe zapytanie ma nieprawidłową składnię, a zatem wywołanie fbsql_query() się nie powiedzie i zwróci FALSE:
Example #1 Przykład fbsql_query()
<?php
$result = fbsql_query("SELECT * WHERE 1=1")
or die ("Nieprawidłowe zapytanie");
?>
Poniższe zapytanie ma nieprawidłową składnię, jeżeli kolumna nie jest kolumną w tabeli tabela, tak więc wywołanie fbsql_query() się nie powiedzie i zwróci FALSE:
Example #2 Przykład fbsql_query()
<?php
$result = fbsql_query ("SELECT kolumna FROM tabela;")
or die ("Nieprawidłowe zapytanie");
?>