ocinlogon
(PHP 3 >= 3.0.8, PHP 4, PHP 5)
ocinlogon -- Oracle データベースに接続し、新規接続にログオン、
新規セッションを返す
説明
resource
ocinlogon ( string username, string password [, string db [, string charset]] )
ocinlogon()は、Oracle 8 データベースへの新規接続を
作成し、ログオンします。
オプションの3番目のパラメータには、ローカルOracleインスタンスの名前か
tnsnames.ora における接続先のエントリ名を指定することができます。
オプションの3番目のパラメータが指定されない場合、
PHP は接続先のデータベースを定義するために環境変数 ORACLE_SID (Oracle
インスタンス)または TWO_TASK (tnsnames.ora) を使用します。
ocinlogon() は強制的に新規接続を作成します。
一連のトランザクションを独立して実行する必要がある場合にこの関数を
使用する必要があります。デフォルトでは、接続は、
ocilogon() を使用した場合はページレベルで共有され、
ociplogon() を使用した場合は Web サーバープロセス
レベルで共有されます。
ocinlogon() を使用して複数の接続をオープンした場合、
コミットおよびロールバックは指定した接続のみに適用されます。
Oracle サーバーのバージョン 9.2
以降を使用している場合、新規接続を確立する際に
charset パラメータを指定することができます。
Oracleサーバー < 9.2 を使用している場合、このパラメータは無視され、
かわりに環境変数 NLS_LANG が使用されます。
以下の例は、接続がどのように分割されるかを示すものです。
例 1. ocinlogon() の例
<?php echo "<html><pre>"; $db = "";
$c1 = ocilogon("scott", "tiger", $db); $c2 = ocinlogon("scott", "tiger", $db);
function create_table($conn) { $stmt = ociparse($conn, "create table scott.hallo (test varchar2(64))"); ociexecute($stmt); echo $conn . " created table\n\n"; }
function drop_table($conn) { $stmt = ociparse($conn, "drop table scott.hallo"); ociexecute($stmt); echo $conn . " dropped table\n\n"; }
function insert_data($conn) { $stmt = ociparse($conn, "insert into scott.hallo values('$conn' || ' ' || to_char(sysdate,'DD-MON-YY HH24:MI:SS'))"); ociexecute($stmt, OCI_DEFAULT); echo $conn . " inserted hallo\n\n"; }
function delete_data($conn) { $stmt = ociparse($conn, "delete from scott.hallo"); ociexecute($stmt, OCI_DEFAULT); echo $conn . " deleted hallo\n\n"; }
function commit($conn) { ocicommit($conn); echo $conn . " committed\n\n"; }
function rollback($conn) { ocirollback($conn); echo $conn . " rollback\n\n"; }
function select_data($conn) { $stmt = ociparse($conn, "select * from scott.hallo"); ociexecute($stmt, OCI_DEFAULT); echo $conn . "----selecting\n\n"; while (ocifetch($stmt)) { echo $conn . " <" . ociresult($stmt, "TEST") . ">\n\n"; } echo $conn . "----done\n\n"; }
create_table($c1); insert_data($c1);
select_data($c1); select_data($c2);
rollback($c1);
select_data($c1); select_data($c2);
insert_data($c2); commit($c2);
select_data($c1);
delete_data($c1); select_data($c1); select_data($c2); commit($c1);
select_data($c1); select_data($c2);
drop_table($c1); echo "</pre></html>"; ?>
|
|
注意:
この関数は PHP >= 5.0.0 以降 oci_new_connect()
に改名されました。
下位互換性のため、 ocinlogon()
も使用することができますが、推奨されません。