DB_Common::query()

DB_Common::query() -- send a query to the database

Synopsis

require_once 'DB.php';

mixed &query (string $query [, array $params])

Description

Executes a SQL query

Parameter

string $query

the SQL query or the statement to prepare

array $params

the data to be added to the query

Return value

mixed - a new DB_Result/ DB_OK or a DB_Error, if fail

Throws

Table 20-1. Possible PEAR_Error values

Error codeError messageReasonSolution
DB_ERROR_INVALID null SQL statment for preparing is not valid. See the prepare() documentation, if you want to use a SQL statemt using wildcards.
DB_ERROR_NEED_MORE_DATA null To less data for filling the prepared SQL statment. Check the number of wild cards given in the SQL statment prepare(). Check the count of entries in the array for $params. The count of entries have to be equal to the number of wild cards.
DB_ERROR_NO_DB_SELECTED null No database was choosen. Check the DSN in connect().
every other error code  Database specific error Check the database related section of PHP-Manual to detect the reason for this error. In the most cases a misformed SQL statment. Ie. using LIMIT in a SQL-Statment for an Oracle database.

Note

This function can not be called statically

Note: query() can be used instead of prepare() and execute(), if you set the $params parameter and your query uses wild cards.

See Introduction - Execute for general using and an example.

See

prepare() , execute()