oci_parse
(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)
oci_parse — 실행을 위해 Oracle 문을 준비합니다.
설명
oci_parse(resource $connection
, string $sql
): resource|false
connection
을 사용하여 sql
을 준비하고 oci_bind_by_name(), oci_execute() 및 기타 함수와 함께 사용할 수 있는 명령문 식별자를 반환합니다.
명령문 식별자는 oci_free_statement()를 사용하거나 변수를 null
로 설정하여 해제할 수 있습니다.
매개변수
connection
- oci_connect(), oci_pconnect() 또는 oci_new_connect()가 반환하는 Oracle 연결 식별자입니다.
sql
- SQL 또는 PL/SQL 문.
SQL 문은 세미콜론(";")으로 끝나지 않아야 합니다. PL/SQL 문은 세미콜론(";")으로 끝나야 합니다.
반환 값
성공 시 명령문 핸들을 반환하고 오류 시 false
를 반환합니다.
Examples
예제 #1 SQL 문에 대한 oci_parse() 예제
<?php
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
// Parse the statement. Note there is no final semi-colon in the SQL statement
$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";
?>
예제 #2 PL/SQL 문의 oci_parse() 예제
<?php
/*
Before running the PHP program, create a stored procedure in
SQL*Plus or 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;
// When parsing PL/SQL programs, there should be a final semi-colon in the string
$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"; // prints 16
oci_free_statement($stid);
oci_close($conn);
?>
노트
메모: 이 함수는 sql
의 유효성을 검사하지 않습니다. sql
이 유효한 SQL 또는 PL/SQL 문인지 확인하는 유일한 방법은 실행하는 것입니다.
기타
- oci_execute() - 명령문을 실행합니다.
- oci_free_statement() - 명령문 또는 커서와 관련된 모든 리소스를 해제합니다.