executeMultiple() joins the prepared SQL statment from prepare() with the given data and does the SQL query for every "row" in the $data array.
query handle from prepare()
a numeric array containing the data to insert into the query
Table 20-1. Possible PEAR_Error values
| Error code | Error message | Reason | Solution |
|---|---|---|---|
| DB_ERROR_INVALID | null | SQL statment handle is not valid. | Check correct processing of the SQL statment with prepare(). Note that executeMultiple() requires a handle to the statement returned by prepare(), not the statment itself. |
| 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 for prepare(). Check the count of entries in the array for $data. 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. |
This function can not be called statically
| Warning |
If an error occurs during execution, the function will be stopped. Possible remaining data will be unprocessed. |
See Introduction - Execute for general using and an example.