PHPからOracleへの接続方法

2019年12月9日2020年3月10日

PHPからOracleへ接続する機会が少ないかと思いますが、今回、PHPで提案したシステムが、お客様の基幹システム側のOracleを使っている（一元化する）ため、PHPからOracleへの接続せざるを得ない状態に陥ってしまいました。
ネット上に情報がありますが、古かったり、足りなかったりすることで、分かれば、正常30分くらいの作業なのに、苦労して一日を使ってしまいました。あとからの方が、筆者の苦しみを二度と味わわないため、ここでWindows環境において、PHPからOracleへの接続方法を紹介したいと思います。

前提条件

Windows環境

接続方法

PHPからOracleへの接続方法は下記の通り、４つのステップだけで完成できます。
＜PHPからOracleへの接続方法＞
１．OCIをインストール
２．環境変数を設定
３．Oracle拡張モジュールDLLをインストール
４．php.iniを設定

今から見ますと、非常に簡単ですが、何も知らない方にとって、何か必要、何を注意、何を設定すれば良い、このファイルは本当に必要、この設定が大丈夫など、当初の筆者と同じように、半信半疑、とても難しい作業ではないかと思います。
実際に、上記の方法に落とし穴があります。それは、Oracleのバージョンによって、OCIの依存するMSVCが必要する場合があります。更に、MSVCをインストールするだけではなく、正しいMSVCバージョンをインストールしない限り、Oracleへの接続がうまくできません。ですので、正確に言えば、PHPからOracleへの接続方法は下記の通りです。

＜PHPからOracleへの正しい接続方法＞
１．OCIをインストール
　１.１．MSVCをインストール
２．環境変数を設定
３．Oracle拡張モジュールDLLをインストール
４．php.iniを設定

１．OCIをインストール

下記のURLから、Oracleのバージョンに応じて、必要なOCIをダウンロードし、ローカルに解凍します。（分かりやすく説明するため、ここは、「c:\instantclient_12_1」に解凍したことにします。）

＜Windows 32bit＞
https://www.oracle.com/database/technologies/instant-client/microsoft-windows-32-downloads.html

＜Windows 64bit＞
https://www.oracle.com/database/technologies/instant-client/winx64-64-downloads.html

ちなみに、OCIとは、Oracle Call Interfaceの略で、ネイティブなC言語ベースのインタフェースです。C言語で作られていたので、これはMSVCが必要となる理由です。

１.１．MSVCをインストール

オプションですが、Oracleのバージョンが12.1以上であれば、このステップが必要となります。前述の通り、必ず、必要となったMSVC(Microsoft Visual Studio XXXX Redistributable)をインストールしてください。

MSVCのダウンロード場所は、下記の通りです。（No.１でOCIをインストールするURLからもたどり着けると思います。）

https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads

追記：上記URLからダウンロードできなくなりました。下記からダウンロードしてください。
Microsoft Visual C++ 2010 再頒布可能パッケージ＜Windows 64bit＞
https://www.microsoft.com/ja-jp/download/details.aspx?id=14632

もう一度言わせてくだい。
勘違いしないように、注意してほしいのは、例えば、Oracle 12.1のOCIの場合、MSVC2010が必要ですが、最新版のMSVC2019をインストールしたら、申し訳ございません、Oracleへ接続できません。いくら頑張って設定し直しても、無駄です。エラーでまくりです。（
筆者はここではまってしまいました。）

正しいMSVCをインストールしないと、Apacheの場合、下記のようなエラーログを吐き出します。

２．環境変数を設定

Windowsの環境変数画面を開いて、（ユーザー環境変数ではなく）システム環境変数ブロックのPath変数に、No.１の「c:\instantclient_12_1」を追加します。

環境変数を設定せずに、No.１のDLLファイルをPHPのlibフォルダに入れても可能ですが、PHPのオリジナルライブラリに、外来種を入れるのは、分離の考え方から考えますと、やはり、やめたほうがよいではないかと思います。変なエラーが発生時に、原因が分からなくなる可能性が極めて高いし。

※環境変数を変更したら、PCを再起動したほうが無難だと思います。作業をスムーズに進めるように、再起動しましょう。

３．Oracle拡張モジュールDLLをインストール

PHPバージョンとOracleバージョンによって、このステップが必要となる場合があります。実際にこのステップがオプションですね。（筆者の場合、このステップが必要となったため、オプションではなく、ワンランクを上げました。すみませんでした!! m(_ _)m ）
当時のプロジェクトは、古いシステムと同じ筐体なので、PHP5.3を使って、Oracle12へ接続する要件でした。PHP5.3は、Oracle10,11の拡張モジュールDLLを提供してありましたが、Oracle12の拡張モジュールDLLを提供てなかったため、独自でインストールせざるを得ない状況になりました。

インストールする前に、下記の情報を事前に把握できたら、スムーズに進めると思います。（その理由はすぐ説明します。）
１．PHPのバージョン（「phpinfo()のVersion」から判断できます）
２．PHPのThread Safety（「phpinfoのThread Safety」から判断できます）
３．Windowsが32bitか64bitか

拡張モジュールDLLのダウンロード先が、下記の通りです。
https://pecl.php.net/package/oci8

上記のURLに、「Description」で記述の通り、PHPのバージョンによって、拡張モジュールDLLの内容が変わりますので、ご注意ください。（筆者の場合、PHP5.3なので、「oci8-1.4.10」となりました）

PHPのバージョンを決めて、該当する拡張モジュールDLLの「DLL」リンクをクリックしたら、次の画面が表示されて、中に、更にいくつのリンクが表示されると思います。（筆者の場合、「https://pecl.php.net/package/oci8/1.4.10/windows」となります。）
どのリンクが必要な拡張モジュールDLLかというと、それは、上記の３点で決めると思います。
例：筆者の場合
１．PHPのバージョン:5.3
２．PHPのThread Safety: enabled ⇒Thread Safe (TS)
３．Windowsが32bitか64bitか：x64 ⇒　該当ないため、32bitの「5.3 Thread Safe (TS) x86 」を決めました。

上記からダウンロードした拡張モジュールDLLを解凍し、今回はOracle 12に接続しますので、「php_oci8_12c.dll」ファイルをPHPの「ext」フォルダにコピーします。
もう一度言わせてくだい。このステップはオプションです。必要な拡張モジュールDLLが既に存在する場合、この手順は不要です。ご注意ください。

４．php.iniを設定

いよいよ、最終ステップに入ります。筆者の場合、ここまでは、８時間くらいかかりました。悲しいですね。。。。
さて、No.３でインストールした、または、そもそも存在した、Oracle拡張モジュールDLLをphp.ini設定からコメントアウトすれば、このステップの作業が終わりです。

まとめ

ここまで、PHPからOracleへの接続方法を紹介しました。いかがでしょうか、MSVCバージョンのところが分かれば、実に簡単ですよね。設定作業が完了したら、テスト作業も必要となると思いますが、その作業は、後日に、別途で紹介させていただきます。それでは、また！（何かの不明な点等ございましたら、ぜひ連絡ください。）