PHPfestチュートリアル：Oracle Database 10g Express EditionおよびZend Core for Oracle

PHP OCI8拡張モジュールの使用とOracle Database XEおよびZend Core for Oracleのインストールに関するステップ・バイ・ステップのガイド

2006年3月公開

Oracle Database XEおよびZend Core for Oracleのインストール

この項では次のインストールについて説明します。

• Oracle Database XE
• Zend Core for Oracle

• 512MBのメモリ
• 5GBのハードディスク・ドライブ領域
• Red Hat Enterprise Linux（RHEL）3
• RHEL 4
• Novell SUSE Linux Enterprise Server（SLES）9

Oracle Database XE

• データベースを必要とするPHP、Java、.NET、およびその他アプリケーションに取り組む開発者
• トレーニングまたは配置のために無料のスタータ・データベースを必要とするDBA
• 販売するアプリケーションおよび製品へのOracleデータベースの組込みを希望する独立系ソフトウェア・ベンダー（ISV）
• 無料のスタータ・データベースを必要とする教育機関および研究者

• SQL、PL/SQL
• Java、C、PHP
• Windows .NET
• Oracle Application Express
• C++、ODBC、OLE DB

• 4GBまでのユーザー・データ領域
• 単一のデータベース・インスタンス
• 単一のCPU
• 1GBまでのRAM

Oracle Database XEのインストール

1. rootとしてログインするかsuコマンドを実行します。

   su
   Password:
                             

2. oracle-xe-10.2.0.1-1.0.i386.rpmを/tmpへコピーし、ディレクトリを/tmpに変更します。

   cp oracle-xe-10.2.0.1-1.0.i386.rpm /tmp
   cd /tmp
                             

3. RPMをインストールします。

   rpm -ivh oracle-xe-10.2.0.1-1.0.i386.rpm
                             

   Oracle Database XEがインストールされます。
   
   
4. データベースを設定します。

   /etc/init.d/oracle-xe configure
                             

5. Oracle Application Expressのポートをデフォルト（8080）、Oracle Database Listenerのポートを1521に設定します。
   
   
6. デフォルト・ユーザーのパスワードを入力し、確認します。
   
   
7. リブート時にデータベースを自動的に開始するかどうかにより、YまたはNを入力します。 データベースおよびデータベース・リスナーが設定され、起動します。

Oracle Database XEインストールのテスト

1. Webブラウザを開き、以下を入力します。

   http://127.0.0.1:8080/apex
                             

2. インストール時に入力したパスワードを使用して、ユーザーsystemとしてログインします。

Zend Core for Oracle

Zend Core for Oracleのインストール

1. まだ済んでいない場合は、rootとしてログインするかsuコマンドを実行します。

   su
   Password:
                             

2. ZendCoreForOracle-v1.3.1-Linux-x86.tar.gzを/tmpへコピーし、ディレクトリを/tmpに変更します。

   cp ZendCoreForOracle-v1.3.1-Linux-x86.tar.gz /tmp
   cd /tmp
                             

3. ダウンロードしたZend Core for Oracleソフトウェアのコンテンツを抽出します。

   tar -zxf ZendCoreForOracle-v1.3.1-Linux-x86.tar.gz
                             

   ファイルは、ZendCoreForOracle-v1.3.1-Linux-x86というサブディレクトリに抽出されます。
   
   
4. ZendCoreForOracle-v1.3.1-Linux-x8にディレクトリを変更し、Zend Core for Oracleのインストールを開始します。

   cd ZendCoreForOracle-v1.3.1-Linux-x86
   ./install
                             

5. 最初のZend Core for Oracle Installationページで「OK」をクリックします。
   
6. Zend Core for Oracle V.1ページで「Exit」をクリックします。
7. ライセンス規約の受諾が指示されたら、「Yes」をクリックします。
8. 既存のPHPがインストールされている場合、既存のphp.iniファイルをバックアップし、上書きするように指示されます。 「Yes」をクリックします。
9. Zend Core for Oracleをインストールする場所を指定するよう指示されたら、デフォルトのまま（または、希望する場所を入力し）「OK」をクリックします。 インストーラがインストールに必要なファイルの抽出を開始します。
10. ウィンドウの進捗状況がすべてのソフトウェアのインストール完了を示したら、"Please enter the GUI password"と表示されます。 PasswordフィールドにZend Core Consoleにアクセスする際に使用する任意のパスワードを入力し、「OK」をクリックします。
11. "Verify the password"と表示されたら、前述の手順で指定したパスワードと同じパスワードを入力し、「OK」をクリックします。
12. Zend Coreサポート・ページで、Zend CoreおよびPHPコンポーネントの更新が可能な場合に、Zend Core Consoleを利用して通知するようZendネットワーク・ユーザーIDおよびパスワードをオプションとして入力する場合があります。 登録していないか、更新の通知を希望しない場合は、「No」をクリックします。
13. 次のページでは、Zend CoreインストールのためのWebサーバーを選択するよう指示されます。 LinuxとともにインストールされたデフォルトのApacheを選択します。 「OK」をクリックします。
14. Webサーバー選択の確認ページで、"Do you wish to proceed?"と表示されたら、「Yes」をクリックします。
15. 次のインストール・ページでは、"Please select an installation method for Apache 2.0.52"と表示されます。 Apacheモジュールを選択し、「OK」をクリックします。
16. 次のページで"Please select a virtual server for the Zend Core GUI"と表示されたら、Main Serverを選択し「OK」をクリックします。
17. 次のページで"Would you like to restart the Web Server"と表示されたら、「Yes」をクリックします。
18. 次のページで、apachectlスクリプトが更新されたことを示す通知が表示されます。 「OK」をクリックします。
19. 次のページでは、"Thank you for installing Zend Core for Oracle"と表示され、有用な設定コマンドおよびZend Coreエンジンの管理のためのWebページの一覧を得られます。 情報に注意し、「Exit」をクリックします。
20. 最後の確認ページが表示されます。 「OK」をクリックして、インストールを完了します。

Zend Core for Oracleの設定

1. Zend Core Administrationページにアクセスするため、Webブラウザに次のURLを入力します。 http://127.0.0.1/ZendCore
2. Zend Core for Oracleのインストール時に提供されたGUIパスワードを入力します。 「login >>>」アイコンをクリックします。
3. 「Configuration」タブをクリックし、設定オプションを表示します。
4. 「+」アイコンをクリックし、Error HandlingおよびLogging構成設定エントリを展開します。
5. display_errorsディレクティブをOnに設定し、開発時のHTMLスクリプト出力のエラー表示を有効化します。
6. 未保存の変更があるため、"Unsaved configuration"メッセージがページ・ヘッダーの下に表示されます。 「Save Settings」をクリックして、設定を保存します。
7. 設定に変更を加えたため、Apache Webサーバーを再起動する必要があります。 ページ・ヘッダー下に"Please Restart Apache"という通知メッセージが表示されます。 「Restart Server」をクリックして、Apacheサーバーを再起動します。
8. 「Logout」をクリックして、Zend Core for Oracle Administrationを終了します。

Zend Core for Oracleインストールのテスト

1. パブリック仮想ディレクトリをpublic_htmlとして作成します。 APACHE_HOME/conf/httpd.confを編集し、次の行から先頭の"#"を削除します。

   #UserDir public_html
                             

2. rootではない通常のユーザーとして、ホーム・ディレクトリにpublic_htmlというディレクトリを作成し、ディレクトリを変更します。その後、コマンド・ウィンドウに次のコマンドを入力します。

   cd $HOME
   mkdir public_html
   cd public_html
                             

3. 次のPHPコードを含むhello.phpファイルを作成します。

   <?php
   echo "Hello world!";
   ?>
                             

4. Webブラウザを開き、次のURLを入力します。

   http://127.0.0.1/~<username>/hello.php
                             

   ブラウザに"Hello world!"と表示されます。

PHPのOCI8拡張

<?php
  $conn = oci_connect('hr', 'hrpw', '//localhost/XE');

  $stid = oci_parse($conn, 'select city from locations');
  oci_execute($stid);

  print '<table border="1">';
  while ($row = oci_fetch_array($stid, OCI_RETURN_NULLS)) {
    print '<tr>';
    foreach ($row as $item) {
      print '<td>'.($item?htmlentities($item):' ').'</td>';
    }
    print '</tr>';
  }
  print '</table>';
?> 
                        

Oracleへの接続

$c = oci_connect($username, $password, $dbname)
                        

$c = oci_new_connect($username, $password, $dbname)
                        

$c = oci_pconnect($username, $password, $dbname)
                        

• oci8.max_persistent： キャッシュされる永久的接続の数を制限します。 制限に達した場合、すべてのoci_pconnect()コールはoci_connect()コールのように扱われます。 -1（デフォルト）に設定されている場合、制限がないことを意味します。
• oci8.persistent_timeout： Apacheプロセスがアイドル状態で永久的接続を維持する時間（秒）です。 有効期間の確認は、スクリプトによるOCI8関数の呼出しの有無に関わらず、PHPスクリプトの終了時に実行されます。 -1（デフォルト）に設定されていることは、タイムアウトがないことを意味します。 接続の有効期限が切れると、oci_pconnect()は新しい接続を作成します。
• oci8.ping_interval： oci_pconnect()の間に、Pingを発行するまでの時間（秒）です。 0に設定すると、oci_pconnect()が呼び出されるたびにPHPはデータベースにPingを発行します。 Pingを無効化するには-1と設定します。デフォルトの値は60秒です。 Pingが接続の切断を特定すると新しい接続が作成されます。

接続文字列

1. 簡易接続文字列
2. 完全な接続文字列
3. tnsnames.oraエイリアス

//hostname:port/service_name
                        

$c = oci_connect('hr', 'hrpw', '//localhost/XE');
                        

$db = MYDB2 = (DESCRIPTION =
                (ADDRESS = (PROTOCOL = TCP)
                  (HOST = mymachine.mydomain)(PORT = 1521))
                  (CONNECT_DATA =
                    (SERVER = DEDICATED)
                    (SERVICE_NAME = MYDB.AU.ORACLE.COM)))';

$c = oci_connect($un, $pw, $db);
                        

# tnsnames.ora
    MYDB2 = (DESCRIPTION =
              (ADDRESS = (PROTOCOL = TCP)
                (HOST = mymachine.mydomain)(PORT = 1521))
                (CONNECT_DATA =
                  (SERVER = DEDICATED)
                  (SERVICE_NAME = MYDB.AU.ORACLE.COM)))
                        

$c = oci_connect($un, $pw, 'MYDB2');
                        

$ORACLE_HOME/network/admin/tnsnames.ora
                        

/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/network/admin/tnsnames.ora
                        

Oracleの環境変数

#!/bin/sh

TNS_ADMIN=/usr/local/apache/conf
export TNS_ADMIN
echo Starting Apache
#export > /tmp/envvars
/usr/local/apache/bin/apachectl start
                        

接続の切断

oci_close($c);
                        

$c1 = oci_connect('hr', 'hrpw', '//localhost/XE');
$c2 = oci_connect('hr', 'hrpw', '//localhost/XE');

do_query($c1, 'select user from dual');
oci_close($c1);
do_query($c1, 'select user from dual');
do_query($c2, 'select user from dual');
oci_close($c2);
                        

ステートメントの実行

1. Parse - 実行のためにステートメントを準備します。
2. Bind - パフォーマンスとセキュリティの向上を図るため、オプションでWHERE句などのデータ値をバインドします。
3. Define - どのPHP変数が結果を格納するかを指定するオプションの手順です。
4. Execute - データベースでコマンドを実行し、結果をバッファします。
5. Fetch - 問合せの結果をデータベースから取得します。 OCI8には多くのフェッチ・ステートメントが用意されています。

問合せ

$stid = oci_parse($c, 'select * from locations');
oci_execute($stid, OCI_DEFAULT);
oci_fetch_all($stid, $res);
                        

$stid = oci_parse($c, "select * from locations where city = 'Sydney'");
                        

• oci_fetch_all()： すべての結果を一度に取得します。
• oci_fetch_array()： 任意の配列として次の行を取得します。
• oci_fetch_all()： 連想配列として次の行を取得します。
• oci_fetch_object()： オブジェクトとして新しい行を取得します。
• oci_fetch_row()： 整数の索引配列として次の行を取得します。
• oci_fetch()： 特定のフィールドの結果を返すoci_result()と共に使用されます。

$stid = oci_parse($c, "select city from locations");
oci_execute($stid, OCI_DEFAULT);
while ($res = oci_fetch_row($stid)) {
   echo $res[0] . "<br>\n";
}
                        

• oci8.default_prefetch： それぞれのデータベースでフェッチが実行された際に、Oracleから返されるレコードの数です。 デフォルトの値は10です。この設定を調整することで、大きな数の行を返す問合せのパフォーマンスを大幅に改善できます。 毎回可能な限りのデータを返すことで、データベース・サーバーの"ラウンド・トリップ"を最小化します。 Oracleはクライアントのバッファにあるデータをキャッシュし、PHPが要求した行のみをPHPにわたします。
• oci8.statement_cache_size： OCIクライアントのステートメント・キャッシュを有効化します。 デフォルトのステートメントは20です。 キャッシュは0を設定することで、無効化できます。クライアント側のステートメント・キャッシュにより、ステートメントのテキストでさえもデータベースに送られる必要がなくなり、ネットワーク・トラフィックとデータベースのサーバー・ロードがさらに削減されます。 Oracleセッションごとにキャッシュされるので、この機能は永久的接続が使用される場合に特に有用です。

Insert/Update/Delete/Create/Drop

$s = oci_parse($c1, "create table i1test (col1 number)");
$r = oci_execute($s, OCI_DEFAULT);

$s = oci_parse($c1, "insert into i1test values (1)");
$r = oci_execute($s, OCI_DEFAULT);
                        

トランザクション

$r = oci_execute($s, OCI_DEFAULT);
                        

$s = oci_parse($c, "insert into i2test values ('row 1')");
$r = oci_execute($s);

$s = oci_parse($c, "insert into i2test values ('row 2')");
$r = oci_execute($s, OCI_DEFAULT);
                        

エラー処理

$c = oci_connect("hr", "hr", "//localhost/XE");
if (!$c) {
  $e = oci_error();  // no resource passed
  var_dump($e);
}

$stid = oci_parse($c, "select city from locations");
if (!$stid) {
  $e = oci_error($c);   // connection resource passed
  var_dump($e);
}

$rc = oci_execute($stid, OCI_DEFAULT);
if (!$rc) {
  $e = oci_error($stid);  // statement resource passed
  var_dump($e);
}

$rc = oci_fetch_all($stid, $results);
if (!$rc) {
  $e = oci_error($stid);  // statement resource passed
  var_dump($e);
}
                        

バインド変数

$stid = oci_parse($c,
             "select last_name from employees where employee_id = :eidbv");
$myeid = 101;
oci_bind_by_name($stid, ":EIDBV", $myeid);
oci_execute($stid, OCI_DEFAULT);
oci_fetch_all($stid, $res);
echo "Last name is: ". $res['LAST_NAME'][0] ."\n";

// No need to re-parse
$myeid = 102;
oci_execute($stid, OCI_DEFAULT);
oci_fetch_all($stid, $res);
echo "Last name is: ". $res['LAST_NAME'][0] ."\n";
                        

バインド変数を使用しないことが決定している場合があります。 ステートメントがバインド変数を含む場合、オプティマイザは最終的に使用する可能性がある値に関するいかなる情報も所持しません。 データに大きな偏りがある場合は、値をハードコードする必要があります。 データがユーザーの入力から生成されている場合、整理する必要があります。

PL/SQLストアド・プロシージャ

$stid = oci_parse($c, "begin myproc('mydata', 123); end;");
oci_execute($stid, OCI_DEFAULT);
                        

PL/SQL REF CURSORS

CREATE OR REPLACE PACKAGE cv_types AS
  TYPE EmpInfoTyp is REF CURSOR;
  PROCEDURE EmpInfoRpt (jid IN VARCHAR, emp_cv IN OUT EmpInfoTyp);
END cv_types;
/

CREATE OR REPLACE PACKAGE BODY cv_types AS
PROCEDURE EmpInfoRpt (jid IN VARCHAR, emp_cv IN OUT EmpInfoTyp) AS
  BEGIN
    OPEN emp_cv FOR SELECT EMPLOYEE_ID, SALARY
                    FROM EMP_DETAILS_VIEW WHERE JOB_ID=jid;
   END;
END;
/
                        

$job_id = 'SA_MAN';
$stmt = "BEGIN cv_types.EmpInfoRpt(:jid, :rc); END;";

$stid = oci_parse($c, $stmt);
oci_bind_by_name($stid, ':jid', $job_id);

$refcur = oci_new_cursor($c); // pass the connection
oci_bind_by_name($stid, ':rc', $refcur, -1, OCI_B_CURSOR);

// Execute the call to EmpInfoRpt()
oci_execute($stid);

// Execute and fetch from the cursor
oci_execute($refcur);
echo '<table border="1">';
while($row = oci_fetch_assoc($refcur)) {
  echo '<tr>';
  foreach ($row as $c) {
    echo "<td>$c</td>";
  }
  echo '</tr>';
}
echo '</table>';
                        

ラージ・オブジェクト（LOBS）

$myv = 'a very large amount of binary data';

$lob = oci_new_descriptor($c, OCI_D_LOB);
$stid = oci_parse($c,
         'INSERT INTO mybtab (blobid, blobdata) '
       . 'VALUES(123, EMPTY_BLOB()) RETURNING blobdata INTO :blobdata');
oci_bind_by_name($stid, ':BLOBDATA', $lob, -1, OCI_B_BLOB);
oci_execute($stid, OCI_DEFAULT);

$lob->save($myv);
                        

$query = 'SELECT blobdata FROM mybtab WHERE blobid = 123';

$stmt = oci_parse ($conn, $query);
oci_execute($stmt, OCI_DEFAULT);
$arr = oci_fetch_assoc($stmt);
$result = $arr['BLOBDATA']->load();
                        

$arr['BLOBDATA']->seek(10, OCI_SEEK_SET);
$result = $arr['BLOBDATA']->read(50);
                        

Oracle Collections

SQL> drop table emails;

SQL> create table emails (
       user_id       varchar2(10),
       friend_name   varchar2(20),
       email_address varchar2(20));

SQL> create or replace type email_array as
       varray(100) of varchar2(20);
     /

SQL> create or replace type friend_array as
       varray(100) of varchar2(20);
     /

SQL> create or replace procedure update_address_book(
       p_user_id         in varchar2,
       p_friend_name        friend_array,
       p_email_addresses    email_array)
     is
     begin
       delete from emails where user_id = p_user_id;
       for i in 1 .. p_email_addresses.count loop
         insert into emails (user_id, friend_name, email_address)
                     values (p_user_id, p_friend_name(i),
                             p_email_addresses(i));
       end loop;
     end update_address_book;
     /
                        

$user_name      = 'cjones';
$friends_names  = array('alison', 'aslam');
$friends_emails = array('alison@example.com', 'aslam@example.com');

$friend_coll = oci_new_collection($c, 'FRIEND_ARRAY');
$email_coll  = oci_new_collection($c, 'EMAIL_ARRAY');

for ($i=0; $i < count($friends_names); $i++) {
  $friend_coll->append($friends_names[$i]);
  $email_coll->append($friends_emails[$i]);
}

$stid = oci_parse($c,
      "begin update_address_book(:name, :friends, :emails); end;");

oci_bind_by_name($stid, ':name',    $user_name);
oci_bind_by_name($stid, ':friends', $friend_coll, -1, OCI_B_NTY);
oci_bind_by_name($stid, ':emails',  $email_coll,  -1, OCI_B_NTY);

oci_execute($stid);
                        

SQL> drop table mytab;
SQL> create table mytab(name varchar2(20));

SQL> create or replace package mypkg as
       type arrtype is table of varchar2(20) index by binary_integer;
       procedure myproc(p1 in out arrtype);
     end mypkg;
     /

SQL> create or replace package body mypkg as
       cursor cur is select name from mytab;
       procedure myproc(p1 in out arrtype) is
         begin
         for i in 1 .. p1.count loop
           insert into mytab values (p1(i));
         end loop;
       end myproc;
     end mypkg;
     /
                        

$s = "BEGIN mypkg.myproc(:c1); END;";
$stid = oci_parse($c, $s);

$array = array("abc", "def", "ghi", "jkl", "mno");
oci_bind_array_by_name($stid, ":c1", $array, 5, -1, SQLT_CHR);
oci_execute($stid, OCI_DEFAULT);
oci_commit();
                        

SQL> select * from mytab;

NAME
--------------------
abc
def
ghi
jkl
mno
                        

グローバリゼーション

<language>_<territory>.<character set>
                        

GERMAN_GERMANY.AL32UTF8
                        

$c = oci_connect("hr", "hr", "//localhost/XE", 'ja16euc');
                        

XMLの使用

$query =
  'SELECT XMLELEMENT("Employees",
     XMLELEMENT("Name", employees.last_name), XMLELEMENT("Id", employees.employee_id)) as result
    FROM employees
    WHERE employee_id > 200';

$stid = oci_parse($c, $query);
oci_execute($stid, OCI_DEFAULT);
while ($row = oci_fetch_row($stid))
  foreach ($row as $item)
    echo htmlentities($item)." ";
                        

$query = "select dbms_xmlgen.getxml('
            select first_name
            from employees
            where department_id = 30') xml
          from dual";

$stid = oci_parse($c, $query);
oci_execute($stid, OCI_DEFAULT);
$res = oci_fetch_row($stid);
$mylob = $res[0]->load();       // treat result as a LOB descriptor
                        

<?xml version="1.0"?>
<ROWSET>
 <ROW>
  <FIRST_NAME>Den</FIRST_NAME>
 </ROW>
 <ROW>
  <FIRST_NAME>Alexander</FIRST_NAME>
 </ROW>
 <ROW>
  <FIRST_NAME>Shelli</FIRST_NAME>
 </ROW>
 <ROW>
  <FIRST_NAME>Sigal</FIRST_NAME>
 </ROW>
 <ROW>
  <FIRST_NAME>Guy</FIRST_NAME>
 </ROW>
 <ROW>
  <FIRST_NAME>Karen</FIRST_NAME>
 </ROW>
</ROWSET>
                        

Onward and Upward