ifx_query(3) [php man page]
IFX_QUERY(3) 1 IFX_QUERY(3) ifx_query - Send Informix query SYNOPSIS
resource ifx_query (string $query, resource $link_identifier, [int $cursor_type], [mixed $blobidarray]) DESCRIPTION
Sends a $query to the currently active database on the server that's associated with the specified link identifier. For "select-type" queries a cursor is declared and opened. Non-select queries are "execute immediate". For either query type the number of (estimated or real) affected rows is saved for retrieval by ifx_affected_rows(3). If the contents of the TEXT (or BYTE) column allow it, you can also use ifx_textasvarchar(1) and ifx_byteasvarchar(1). This allows you to treat TEXT (or BYTE) columns just as if they were ordinary (but long) VARCHAR columns for select queries, and you don't need to bother with blob id's. With ifx_textasvarchar(0) or ifx_byteasvarchar(0) (the default situation), select queries will return BLOB columns as blob id's (integer value). You can get the value of the blob as a string or file with the blob functions (see below). PARAMETERS
o $query - The query string. o $link_identifier - The link identifier. o $cursor_def - This optional parameter allows you to make this a scroll and/or hold cursor. It's a bitmask and can be either IFX_SCROLL, IFX_HOLD, or both or'ed together. I you omit this parameter the cursor is a normal sequential cursor. o $blobidarray - If you have BLOB (BYTE or TEXT) columns in the query, you can add a $blobidarray parameter containing the corresponding "blob ids", and you should replace those columns with a "?" in the query text. RETURN VALUES
Returns valid Informix result identifier on success, or FALSE on errors. EXAMPLES
Example #1 Show all rows of the "orders" table as a HTML table <?php ifx_textasvarchar(1); // use "text mode" for blobs $res_id = ifx_query("select * from orders", $conn_id); if (! $res_id) { printf("Can't select orders : %s <br />%s<br /> ", ifx_error(), ifx_errormsg()); die; } ifx_htmltbl_result($res_id, "border="1""); ifx_free_result($res_id); ?> Example #2 Insert some values into the "catalog" table <?php // create blob id's for a byte and text column $textid = ifx_create_blob(0, 0, "Text column in memory"); $byteid = ifx_create_blob(1, 0, "Byte column in memory"); // store blob id's in a blobid array $blobidarray[] = $textid; $blobidarray[] = $byteid; // launch query $query = "insert into catalog (stock_num, manu_code, " . "cat_descr,cat_picture) values(1,'HRO',?,?)"; $res_id = ifx_query($query, $conn_id, $blobidarray); if (! $res_id) { /* ... error ... */ } // free result id ifx_free_result($res_id); ?> SEE ALSO
ifx_connect(3). PHP Documentation Group IFX_QUERY(3)
Check Out this Related Man Page
INGRES_QUERY(3) 1 INGRES_QUERY(3) ingres_query - Send an SQL query to Ingres SYNOPSIS
mixed ingres_query (resource $link, string $query, [array $params], [string $types]) DESCRIPTION
ingres_query(3) sends the given $query to the Ingres server. The query becomes part of the currently open transaction. If there is no open transaction, ingres_query(3) opens a new transaction. To close the transaction, you can call either ingres_commit(3) to commit the changes made to the database or ingres_rollback(3) to cancel these changes. When the script ends, any open transaction is rolled back (by calling ingres_rollback(3)). You can also use ingres_autocom- mit(3) before opening a new transaction to have every SQL query immediately committed. Note Related Configurations See also the ingres.describe, ingres.scrollable and ingres.utf8 directives in Runtime Configuration PARAMETERS
o $link - The connection link identifier. o $query - A valid SQL query (see the Ingres SQL reference guide) in the Ingres documentation. Data inside the query should be properly escaped. The following types of SQL queries cannot be sent with this function: o close (see ingres_close(3)) o commit (see ingres_commit(3)) o connect (see ingres_connect(3)) o disconnect (see ingres_close(3)) o get dbevent o prepare to commit o rollback (see ingres_rollback(3)) o savepoint o set autocommit (see ingres_autocommit(3)) oall cursor-related queries are unsupported o $params - An array of parameter values to be used with the query o $types - A string containing a sequence of types for the parameter values passed. When ingres.describe is enabled, this parameter can be ignored as the driver automatically fetches the expected parameter types from the server. +----------+------------------------------+---+---+ |Type code | | | | | | | | | | | Ingres type | | | | | | | | +----------+------------------------------+---+---+ | a | | | | | | | | | | | | | | | | BOOLEAN | | | | | | | | | b | | | | | | | | | | | | | | | | BYTE | | | | | | | | | B | | | | | | | | | | | | | | | | LONG BYTE/BLOB | | | | | | | | | c | | | | | | | | | | | | | | | | CHAR | | | | | | | | | d | | | | | | | | | | | | | | | | DATE/ANSIDATE/TIMESTAMP/TIME | | | | | | | | | f | | | | | | | | | | | | | | | | FLOAT | | | | | | | | | i | | | | | | | | | | | | | | | | INTEGER | | | | | | | | | L | | | | | | | | | | | | | | | | LONG TEXT | | | | | | | | | m | | | | | | | | | | | | | | | | MONEY | | | | | | | | | M | | | | | | | | | | | | | | | | LONG NVARCHAR | | | | | | | | | n | | | | | | | | | | | | | | | | NCHAR | | | | | | | | | N | | | | | | | | | | | | | | | | NVARCHAR | | | | | | | | | t | | | | | | | | | | | | | | | | TEXT | | | | | | | | | v | | | | | | | | | | | | | | | | VARCHAR | | | | | | | | | V | | | | | | | | | | | | | | | | LONG VARCHAR | | | | | | | | +----------+------------------------------+---+---+ RETURN VALUES
ingres_query(3) returns a query result identifier on success else it returns FALSE. To see if an error occurred use ingres_errno(3), ingres_error(3) or ingres_errsqlstate(3). EXAMPLES
Example #1 Send a simple select <?php $link = ingres_connect("demodb"); $result = ingres_query($link, "select * from user_profile"); while ($row = ingres_fetch_row($result)) { echo $row[1]; echo $row[2]; } ?> Example #2 Passing query parameters to ingres_query(3) <?php $link = ingres_connect("demodb"); $params[] = "Emma"; $query = "select * from user_profile where up_first = ?"; $result = ingres_query($link, $query, $params); while ($row = ingres_fetch_row($result)) { echo $row[1]; echo $row[2]; } ?> Example #3 Inserting a BLOB with parameter types <?php $link = ingres_connect("demodb"); //Open a photo $fh = fopen("photo.jpg","r"); $blob_data = stream_get_contents($fh); fclose($fh); //Prepare parameters $params[] = $blob_data; $params[] = 1201; //Define parameter types $param_types = "Bi"; $query = "update user_profile set up_image = ? where up_id = ?"; $result = ingres_query($link, $query , $params, $param_types); if (ingres_errno()) { echo ingres_errno() . "-" . ingres_error() . " "; } ingres_commit($link); ingres_close($link); ?> SEE ALSO
ingres_unbuffered_query(3), ingres_fetch_array(3), ingres_fetch_assoc(3), ingres_fetch_object(3), ingres_fetch_row(3), ingres_commit(3), ingres_rollback(3), ingres_autocommit(3), ingres_set_environment(3), ingres_errno(3), ingres_error(3). PHP Documentation Group INGRES_QUERY(3)