[edit] Last updated: Fri, 10 Feb 2012

Oracle 関数 (PDO_OCI)

導入

警告

この拡張モジュールは、 実験的 なものです。この拡張モジュールの動作・関数名・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。このモジュールは自己責任で使用してください。

PDO_OCI は、OCI ライブラリを通じて PHP から Oracle データベースへのアクセスを可能にするための PHP Data Objects (PDO) インターフェースを実装したドライバです。

インストール手順

--with-pdo-oci[=DIR] で PDO Oracle OCI 拡張モジュールをインストールします。オプションの [=DIR] には、Oracle のホームディレクトリを指定することができます。 [=DIR] のデフォルトは、環境変数 $ORACLE_HOME の値です。

--with-pdo-oci=instantclient,prefix,version で、Oracle Instant Client SDK を指定します。prefix および version は環境にあわせて設定します。

// $ORACLE_HOME を使う例
$ ./configure --with-pdo-oci

// OIC for Linux 10.2.0.3 の RPM を /usr プレフィックスで使う例
$ ./configure --with-pdo-oci=instantclient,/usr,10.2.0.3


If you're getting the "I'm too dumb to find oci.h" error, try creating a variety of paths.  One variety uses just the major and minor of your OIC version (eg, 11.2 for 11.2.0.2) and another variety uses client64 as well as client.



Something like this (for 11.2.0.2):

ln -s /usr/include/oracle/11.2.0.2/ /usr/include/oracle/11.2

ln -s /usr/include/oracle/11.2/client /usr/include/oracle/11.2/client64

ln -s /usr/lib/oracle/11.2.0.2/ /usr/lib/oracle/11.2

ln -s /usr/lib/oracle/11.2/client /usr/lib/oracle/11.2/client64



This should cover your bases for 64-bit systems, as well as PHP patched to use the major.minor version number only.  See also PHP bug #44989.

redlorry919 at gmail dot com 10-Jun-2011 12:15


Take note of the note at the top, this really is an experimental extension. I had a problem trying to read data from Oracle which resulted in some strange behaviour in PHP. i.e. foreach loops not ending, with no error messages. I also managed to get the data from Oracle into an array in PHP, but then couldn't return the array from a function.





After pulling my hair out for a day, it turned out to be a CLOB column in Oracle that caused the strange behaviour in PHP. I assume this extension doesn't fully support them.





Instead I've typecast it within the SQL to a VARCHAR2 which seems to resolve it:





SELECT CAST(columnx AS VARCHAR2(4000)) AS columnx ...





It might help someone else having similar issues.

geompse at gmail dot com 28-Jun-2010 06:49


Notice the red block at the beginning of this page... pdo_oci is HIGHLY experimental.



Even though it is under dev from 2004, it lakes today support for things that _do_ matters :

 - bind a varchar2 of 3500 chars 

 - get selected metas

 - left join with blobs/clobs

 - etc.



For the story, since we use pdo_pgsql in our software, I thought it would be viable to use pdo_oci for running under Oracle. After a long battle, I finally won :



1) If requested driver has a non-experimental pdo version available, use it.

2) else (well, for pdo_oci at least), use an abstraction layer of your own.

3) you're done.



What I did in more details...



2 "main" classes for being compliant with "$obj instanceof PDO" or such :

 - class PhpDb extends PDO

 - class PhpDbStatement extends PDOStatement

2 "abstract" classes that defines what PDO actually does :

 - abstract class PhpDbAbstract

 - abstract class PhpDbAbstractStatement

And at last for each driver, 2 classes doing the abstraction :

 - class PhpDbDriverOracle extends PhpDbAbstract

 - class PhpDbDriverOracleStatement extends PhpDbAbstractStatement



"main" classes are accessed from your script, simply replace "new PDO" with "new PhpDb".

"abstract" classes are mainly there for the documentation :p

"driver" classes do the job in background, they are instances by the main classes.



My PhpDb will be in an open source project sooner or later, search google or mail me !

av01 at bugfix dot cc 03-Apr-2010 05:57


In order to get this compiled on my CentOS 5.4 x86_64 box, I had to do some extra settings that might be useful for others:



Install oracle-instantclient11.2-basic and oracle-instantclient11.2-devel RPMs from Oracle



Create some symbolic links because configure contains some outdated assumptions about path names and doesn't care about 64-bit systems:

ln -s /usr/lib/oracle/11.2/client64 /usr/lib/oracle/11.2/client

ln -s /usr/include/oracle/11.2/client64  /usr/lib/oracle/11.2/client/include



Add the following to your configure command:

--with-pdo-oci=shared,instantclient,/usr,11.2

sixd at php dot net 26-Jun-2009 08:53


From the PHP 5.3 UPGRADING file:



- The PDO_OCI php_pdo_oci8.dll library (for use with Oracle version 8 client

  libraries) is no longer being built [with PHP 5.3]. Instead, use php_pdo_oci.dll (note no

  '8') with Oracle 10 or 11 client libraries. Connection to other database

  versions is still supported.

fernando dot wendt at gmail dot com 20-Jan-2009 02:18


To enable PDO support on PHP for Oracle Instant Client 11.1.x, you should follow the syntax above in the compile command, just as pointed by Andrew http://bugs.php.net/bug.php?id=39312, taking by default you have installed the OIC at /usr/lib/oracle (instant client and sdk at subfolder):



./configure --with-oci8=shared,instantclient,/usr/lib/oracle

--with-pdo-oci=instantclient,/usr/lib/oracle,11.1



Just saying your release version from the Oracle OIC.



It compiles fine then.



Best regards.

ken at xpressconnex dot com 05-Feb-2008 05:17


Wow, cursade.  That's a lot of typing to use the lite client.



Try this:



$db = '//hostname/servicename'; //e.g. '//192.168.1.1/orcl'

$user = 'username';

$pass = 'password';



$conn = new PDO($db,$user,$pass);

moc.aciremi@yvelj 01-Jun-2006 09:25


A Statement of Warning:



PDO::oci does not support REF CURSORS.



This is mentioned nowhere (until now!) on this page. 



And now you know!



If you want ref cursors avoid PDO for now. 



My Reference for this claim:

http://www.oracle.com/technology/pub/articles/

php_experts/otn_pdo_oracle5.html



GREAT article, excellent piece, really. It's not clear to me 

how old this document is, but it must have some dust on it, 

given it's references to "PHP5.1 ...' which is a little way off yet' "

... as of 2006-06-01, PHP5.1 has been with us for quite some time.

cursade at hotmail dot com 21-Apr-2006 08:29


if oracle and oracle instant client has been installed,

without db in the same host



For UNIX/LINUX，set $LD_LIBRARY_PATH

appent your instant client path  and  client/lib path to it,



For windows set PATH like this



After set the path ,set TNS_ADMIN everioment ,point to 

where  tnsnames.ora located.



Then,you can use service name to connect to your Database



Test coding



<?php

$param = $_POST;

$db_username = "youusername";

$db_password = "yourpassword";

$db = "oci:dbname=yoursid";

$conn = new PDO($db,$db_username,$db_password);

$name = $param['module'];

$file = $param['file'];

$stmt = $conn->exec("INSERT INTO AL_MODULE (AL_MODULENAME, AL_MODULEFILE) VALUES ('$name', '$file')");



?>

cursade at hotmail dot com 20-Apr-2006 11:43


If instant client has been installed but the full oracle client

not yet ,you can use pdo to connect to oracle database

like following coding:



<?php

$tns = "  

(DESCRIPTION =

    (ADDRESS_LIST =

      (ADDRESS = (PROTOCOL = TCP)(HOST = yourip)(PORT = 1521))

    )

    (CONNECT_DATA =

      (SERVICE_NAME = orcl)

    )

  )

       ";

$db_username = "youname";

$db_password = "yourpassword";

try{

    $conn = new PDO("oci:dbname=".$tns,$db_username,$db_password);

}catch(PDOException $e){

    echo ($e->getMessage());

}

?>

add a note

Oracle 関数 (PDO_OCI)

導入

インストール手順

目次