# oci_parse

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

oci_parse — Prepara 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($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 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', $p2, 40);
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

- oci_execute() - Ejecuta una sentencia
- oci_free_statement() - Libera todos los recursos asociados con una sentencia o cursor