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 statement using wildcards.
DB_ERROR_NEED_MORE_DATA NULL Too few data for filling the prepared SQL statment. Check the number of wildcards given in the SQL statement 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 chosen. Check the DSN in connect().
every other error code  Database specific error Check the database related section of the PHP-Manual to detect the reason for this error. In the most cases a misformed SQL statement. I.e. using LIMIT in a SQL-Statement 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 wildcards.

See Introduction - Execute for general using and an example.

See

prepare() , execute()