oci_parse

(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)

oci_parsePrepara una sentencia de Oracle para su ejecución

Descripción

oci_parse ( resource $connection , string $sql_text ) : resource

Prepara la sentencia dada por sql_text usando la conexión connection y devuelve el identificador de sentencia, el cual puede usarse con oci_bind_by_name(), oci_execute() y demás funciones.

Los identificadores de sentencia pueden liberarse con oci_free_statement() o estableciendo la variable a NULL.

Parámetros

connection

Un identificador de conexión de Oracle devuelto por oci_connect(), oci_pconnect(), o oci_new_connect().

sql_text

La sentencia SQL o PL/SQL.

Las sentencias SQL no deberían finalizar con un punto y coma (";"). Las sentencias PL/SQL sí deberían finalizar con un punto y coma (";").

Valores devueltos

Devuelve el gestor de sentencia en caso de éxito, o FALSE en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de oci_parse() para sentencias SQL

<?php

$conn 
oci_connect('hr''welcome''localhost/XE');

// Analizar la sentencia. Observe que no hay punto y coma final en la sentencia SQL
$stid oci_parse($conn'SELECT * FROM employees');
oci_execute($stid);

echo 
"<table border='1'>\n";
while (
$row oci_fetch_array($stidOCI_ASSOC+OCI_RETURN_NULLS)) {
    echo 
"<tr>\n";
    foreach (
$row as $item) {
        echo 
"    <td>" . ($item !== null htmlentities($itemENT_QUOTES) : "") . "</td>\n";
    }
    echo 
"</tr>\n";
}
echo 
"</table>\n";

?>

Ejemplo #2 Ejemplo de oci_parse() para sentencias PL/SQL

<?php

/*
  Antes de ejecutar el programa de PHP, cree 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;

// Cuando se analizan programas PL/SQL, debería existir un punto y coma 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'$p240);

oci_execute($stid);

print 
"$p2\n";   // imprime 16

oci_free_statement($stid);
oci_close($conn);

?>

Notas

Nota:

Esta función no valida sql_text. La única manera de averiguar si sql_text es una sentencia SQL o PL/SQL válida es ejecutarla.

Ver también