...

...

@@ -8,65 +8,34 @@

8

8

<section xml:id="oci8.requirements">

9

9

&reftitle.required;

10

10

<para>

11

-

The OCI8 1.4 extension is included with PHP 5.3, PHP 5.4 and PHP

12

-

5.5. It is also available

13

-

from <link xmlns="http://docbook.org/ns/docbook"

14

-

xmlns:xlink="http://www.w3.org/1999/xlink"

15

-

xlink:href="&url.pecl;">PECL</link>. A newer OCI8 2.0 version is

16

-

available only from <link xmlns="http://docbook.org/ns/docbook"

17

-

xmlns:xlink="http://www.w3.org/1999/xlink"

18

-

xlink:href="&url.pecl;">PECL</link>. OCI8 1.4 requires Oracle

19

-

12<emphasis>c</emphasis>, 11<emphasis>g</emphasis>,

20

-

10<emphasis>g</emphasis> or 9<emphasis>i</emphasis>R2 client

21

-

libraries and will install on PHP 4.3.9 onwards. OCI8 2.0 requires

22

-

Oracle 12<emphasis>c</emphasis>, 11<emphasis>g</emphasis> or

23

-

10<emphasis>g</emphasis> client libraries and will install on PHP

24

-

5.2 onwards.

11

+

OCI8 3.0 is included with PHP 8. It is also available from &link.pecl;. For

12

+

PHP 7, use OCI8 2.2 from &link.pecl;. OCI8 requires Oracle

13

+

10<emphasis>g</emphasis> or later Oracle client libraries.

25

14

</para>

26

15

<para>

27

-

If the Oracle Database is on the same machine as PHP, the database

28

-

software already contains the necessary libraries. When PHP is on

29

-

a different machine, use the free

16

+

If the Oracle Database is on the same machine as PHP, the database software

17

+

already contains the necessary libraries and header files. When PHP is on a

18

+

different machine, use the free

30

19

<link xlink:href="&url.oracle.instant.client;">Oracle Instant Client</link> libraries.

31

20

</para>

32

21

<para>

33

-

To use Oracle Instant Client, install the <literal>basic</literal>

34

-

or <literal>basiclite</literal> Oracle Instant Client ZIP file or

35

-

RPM package. When building PHP from source code, also install

36

-

the <literal>sdk</literal> ZIP file or <literal>devel</literal> RPM

37

-

package.

22

+

To use Oracle Instant Client, install the <literal>Basic</literal>

23

+

or <literal>Basic Light</literal> Oracle Instant Client ZIP file, RPM

24

+

package, or DMG package. When building OCI8 from source code, also install

25

+

the Instant Client <literal>SDK</literal>.

38

26

</para>

39

27

<para>

40

28

You must run PHP with the same, or a more recent, version of the

41

29

Oracle libraries that OCI8 was built with.

42

30

</para>

43

-

<para>

44

-

On Windows, the php_oci8 DLL needs Oracle client libraries from version

45

-

10<emphasis>g</emphasis>R2 or greater. In PHP 5.3 up to and

46

-

including PHP 5.3.5, the php_oci8_11g DLL requires Oracle

47

-

11<emphasis>g</emphasis>R1 or greater client libraries. From PHP

48

-

5.3.6 the php_oci8_11g DLL requires Oracle

49

-

11<emphasis>g</emphasis>R2 or greater client libraries. The

50

-

php_oci8_12c DLL from PECL requires Oracle

51

-

12<emphasis>c</emphasis>R1 client libraries. With some versions of

52

-

Instant Client you may additionally

53

-

need <filename>mfc71.dll</filename>

54

-

and <filename>msvcr71.dll</filename> libraries.

55

-

</para>

56

31

<note>

57

32

<para>

58

-

If OCI8 uses 9<emphasis>i</emphasis>R2 client libraries, then PHP

59

-

can connect to Oracle Database 8<emphasis>i</emphasis>,

60

-

9<emphasis>i</emphasis>R2, 10<emphasis>g</emphasis> or

61

-

11<emphasis>g</emphasis>. If OCI8 uses 10<emphasis>g</emphasis>R2

62

-

client libraries, the database can be 9<emphasis>i</emphasis>R2,

63

-

10<emphasis>g</emphasis>, 11<emphasis>g</emphasis> or

64

-

12<emphasis>c</emphasis>. If OCI8 uses 11<emphasis>g</emphasis>

65

-

client libraries, the database can be 9<emphasis>i</emphasis>R2,

66

-

10<emphasis>g</emphasis>, 11<emphasis>g</emphasis> or

67

-

12<emphasis>c</emphasis>. If OCI8 uses 12<emphasis>c</emphasis>

68

-

client libraries, the database can be 10<emphasis>g</emphasis>R2,

69

-

11<emphasis>g</emphasis> or 12<emphasis>c</emphasis>.

33

+

Oracle's standard client-server network interoperability allows connections

34

+

between different versions of Oracle Client and Oracle Database. For

35

+

certified configurations see Oracle Support's Doc ID 207303.1. In

36

+

summary, Oracle Client 19, 18 and 12.2 can connect to Oracle Database 11.2

37

+

or greater. Oracle Client 12.1 can connect to Oracle Database 10.2 or

38

+

greater. Oracle Client 11.2 can connect to Oracle Database 9.2 or greater.

70

39

</para>

71

40

</note>

72

41

<note>

73

42