(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)
oci_pconnect — Connect to an Oracle database using a persistent connection
$username
, string $password
[, string $connection_string
[, string $character_set
[, int $session_mode
]]] )Creates a persistent connection to an Oracle server and logs on.
Persistent connections are cached and re-used between requests, resulting in reduced overhead on each page load; a typical PHP application will have a single persistent connection open against an Oracle server per Apache child process (or PHP FastCGI/CGI process). See the Persistent Database Connections section for more information.
username
The Oracle user name.
password
The password for username
.
connection_string
접속을 위해 오라클 인스턴스를 포함합니다. » Easy Connect string이나 tnsnames.ora 파일의 Connect Name, 로컬 오라클 인스턴스의 이름일 수 있습니다.
지정하지 않으면, PHP는
접속할 오라클 인스턴스를 찾기 위해 TWO_TASK
(리눅스)나 LOCAL
(윈도우), 그리고 ORACLE_SID
등의 환경 변수를 사용합니다.
Easy Connect naming 방식을 사용하려면, PHP가 오라클 10g 이상의 클라이언트 라이브러리를 사용해야 합니다. 오라클 10g에서 Easy Connect string 형식은: [//]host_name[:port][/service_name] 입니다. 오라클 11g부터는: [//]host_name[:port][/service_name][:server_type][/instance_name] 입니다. 서비스 이름은 데이터베이스 서버에서 오라클 유틸리티 lsnrctl status를 실행하여 찾을 수 있습니다.
tnsnames.ora 파일은 오라클 넷 검색 경로에 있을 수 있습니다. $ORACLE_HOME/network/admin과 /etc 등을 포함합니다. TNS_ADMIN을 설정하여 $TNS_ADMIN/tnsnames.ora를 읽게 할 수도 있습니다. 웹 데몬이 이 파일에 읽기 권한을 가지도록 설정하십시오.
character_set
오라클 클라이언트 라이브러리가 사용할 문자셋을 결정합니다. 이 문자셋은 데이터베이스 문자셋과 일치하지 않아도 됩니다. 일치하지 않을 경우, 오라클이 데이베이스 문자셋과 데이터 변환을 수행합니다. 문자셋에 의존하는 것은 유용한 결과가 아닐 수 있습니다. 또한 변환 수행을 위한 시간 오버헤드가 추가됩니다.
지정하지 않을 경우,
오라클 클라이언트 라이브러리는
NLS_LANG
환경 변수를 통해 문자 셋을 결정합니다.
이 인수를 사용하면 접속에 필요한 시간을 줄일 수 있습니다.
session_mode
이 인수는 PHP 5 (PECL OCI8 1.1)부터 사용할
수 있고 다음 값을 받아들입니다:
OCI_DEFAULT
,
OCI_SYSOPER
, OCI_SYSDBA
.
OCI_SYSOPER
나
OCI_SYSDBA
를 지정하면, 이 함수는 외부 인증을 사용하여
권한을 가진 접속을 시도합니다.
권한을 가진 접속은 기본값으로 비활성화 되어 있습니다. 활성화하려면
oci8.privileged_connect
를 On으로 설정해야 합니다.
PHP 5.3 (PECL OCI8 1.3.4) introduced the
OCI_CRED_EXT
mode value. This tells Oracle to use
External or OS authentication, which must be configured in the
database. The OCI_CRED_EXT
flag can only be used
with username of "/" and a empty password.
oci8.privileged_connect
may be On or Off.
OCI_CRED_EXT
may be combined with the
OCI_SYSOPER
or
OCI_SYSDBA
modes.
OCI_CRED_EXT
is not supported on Windows for
security reasons.
Returns a connection identifier or FALSE
on error.
Example #1 Basic oci_pconnect() Example using Easy Connect syntax
<?php
// Connects to the XE service (i.e. database) on the "localhost" machine
$conn = oci_pconnect('hr', 'welcome', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
$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";
?>
See oci_connect() for further examples of parameter usage.
Note: Starting with PHP 5.1.2 and PECL OCI8 1.1, the lifetime and maximum number of persistent Oracle connections per PHP process can be tuned by setting the following configuration values: oci8.persistent_timeout, oci8.ping_interval and oci8.max_persistent.