php-doc-en/reference/ingres-ii/configure.xml
Daniel Egeberg 96c9d88bad Converted to utf-8
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@297028 c90b9560-bf6c-de11-be94-00142212c4b1
2010-03-28 22:10:10 +00:00

83 lines
2.9 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="ingres.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
&pecl.moved;
&pecl.info;
<link xlink:href="&url.pecl.package;ingres">&url.pecl.package;ingres</link>.
</para>
<para>
You can download the DLL for this PECL extension from <link
xlink:href="&url.ingres.peclext;">&url.ingres.peclext;</link>.
</para>
<para>
To have these functions available, you must <link
xlink:href="&url.pecl.package;ingres">download</link> and compile
this extension, enabling Ingres support using the
<option role="configure">--with-ingres[=DIR]</option> option, where DIR is
the Ingres base directory. If the <varname>II_SYSTEM</varname> environment variable is not
set correctly you may need to use
<option role="configure">--with-ingres=DIR</option>
to specify your Ingres installation directory.
</para>
<para>
PHP code written for version 2.x and later is not backward-compatible with
earlier versions of this PHP extension. However, it is possible to run two
incompatible releases within the same PHP environment using the <option
role="configure">--enable-ingres2</option> option. This configuration option
renames the extension to ingres2, changing function names, configuration
settings, and constants. For example, with this option enabled,
<function>ingres_connect</function> becomes
<function>ingres2_connect</function>.
</para>
<para>
To use this extension the system environment variable II_SYSTEM must be
defined. Linux and UNIX users will also need to define the shared library
search path, for example, <varname>LD_LIBRARY_PATH</varname>. When used with the Apache web server
these variables must be
set explicitly in the startup script for Apache. In addition, the <literal>PassEnv</literal>
directive is required for the Ingres extension to load the correct shared
libraries. For example:
</para>
<example>
<title>Example usage of PassEnv for Ingres</title>
<programlisting>
<![CDATA[
<IfModule mod_env.c>
PassEnv II_SYSTEM
PassEnv LD_LIBRARY_PATH
</IfModule>
]]>
</programlisting>
</example>
<note>
<para>
For example configurations for different web servers and operating
systems see <link
xlink:href="&url.ingres.wiki;Ingres_Articles#Ingres_and_Web_Servers">&url.ingres.wiki;Ingres_Articles#Ingres_and_Web_Servers</link>.
</para>
</note>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->