(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)
oci_parse — Prepara una consulta SQL con Oracle
Prepara la consulta sql
utilizando la conexión
connection
y devuelve el identificador de consulta
que podrá ser utilizado con las funciones oci_bind_by_name(),
oci_execute(), etc.
Los identificadores de consulta pueden ser liberados
utilizando la función oci_free_statement()
o definiendo la variable correspondiente al valor
null
.
connection
Un identificador de conexión Oracle, devuelto por la función oci_connect(), oci_pconnect() o oci_new_connect().
sql
La consulta SQL o PL/SQL.
Las consultas SQL no deben terminar con un punto y coma (";"). Las consultas PL/SQL deben terminar con un punto y coma (";").
Devuelve un manejador de consulta en caso de éxito, o false
si ocurre un error.
Ejemplo #1 Ejemplo con oci_parse()
<?php
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
// Análisis de la consulta. Note que no hay un punto y coma al final de la consulta SQL
$stid = oci_parse($conn, 'SELECT * FROM employees');
oci_execute($stid);
echo "<table border='1'>\n";
while ($row = oci_fetch_array($stid, OCI_ASSOC+OCI_RETURN_NULLS)) {
echo "<tr>\n";
foreach ($row as $item) {
echo " <td>" . ($item !== null ? htmlentities($item, ENT_QUOTES) : "") . "</td>\n";
}
echo "</tr>\n";
}
echo "</table>\n";
?>
Ejemplo #2 Ejemplo con oci_parse() y una consulta PL/SQL
<?php
/*
Antes de ejecutar este código PHP, debe crear un procedimiento almacenado en
SQL*Plus o SQL Developer:
CREATE OR REPLACE PROCEDURE myproc(p1 IN NUMBER, p2 OUT NUMBER) AS
BEGIN
p2 := p1 * 2;
END;
*/
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
$p1 = 8;
// Al analizar PL/SQL, debe haber un punto y coma al final de la cadena
$stid = oci_parse($conn, 'begin myproc(:p1, :p2); end;');
oci_bind_by_name($stid, ':p1', $p1);
oci_bind_by_name($stid, ':p2', $p2, 40);
oci_execute($stid);
print "$p2\n"; // muestra 16
oci_free_statement($stid);
oci_close($conn);
?>
Nota:
Esta función no valida la consulta
sql
. La única forma de saber si la consultasql
es válida es ejecutándola.