<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Installation</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ingres.requirements.html">Requirements</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ingres.configuration.html">Runtime Configuration</a></div>
<div class="up"><a href="ingres.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="ingres.installation" class="section">
<h2 class="title">Installation</h2>
<p class="para">
This <a href="http://pecl.php.net/" class="link external">» PECL</a> extension
is not bundled with PHP.
Information for installing this PECL extension may be
found in the manual chapter titled <a href="install.pecl.html" class="link">Installation
of PECL extensions</a>. Additional information such as new releases,
downloads, source files, maintainer information, and a CHANGELOG, can be
located here:
<a href="http://pecl.php.net/package/ingres" class="link external">» http://pecl.php.net/package/ingres</a>.
</p>
<p class="para">
You can download the DLL for this PECL extension from <a href="http://esd.ingres.com/product/drivers/PHP/" class="link external">» http://esd.ingres.com/product/drivers/PHP/</a>.
</p>
<p class="para">
To have these functions available, you must <a href="http://pecl.php.net/package/ingres" class="link external">» download</a> and compile
this extension, enabling Ingres support using the
<strong class="option configure">--with-ingres[=DIR]</strong>
option, where DIR is
the Ingres base directory. If the <var class="varname"><var class="varname">II_SYSTEM</var></var> environment variable is not
set correctly you may need to use
<strong class="option configure">--with-ingres=DIR</strong>
to specify your Ingres installation directory.
</p>
<p class="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 <strong class="option configure">--enable-ingres2</strong>
option. This configuration option
renames the extension to ingres2, changing function names, configuration
settings, and constants. For example, with this option enabled,
<span class="function"><a href="function.ingres-connect.html" class="function">ingres_connect()</a></span> becomes
<span class="function"><strong>ingres2_connect()</strong></span>.
</p>
<p class="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, <var class="varname"><var class="varname">LD_LIBRARY_PATH</var></var>. When used with the Apache web server
these variables must be
set explicitly in the startup script for Apache. In addition, the <em>PassEnv</em>
directive is required for the Ingres extension to load the correct shared
libraries. For example:
</p>
<div class="example" id="example-1205">
<p><strong>Example #1 Example usage of PassEnv for Ingres</strong></p>
<div class="example-contents">
<div class="cdata"><pre>
<IfModule mod_env.c>
PassEnv II_SYSTEM
PassEnv LD_LIBRARY_PATH
</IfModule>
</pre></div>
</div>
</div>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
For example configurations for different web servers and operating
systems see <a href="http://community.ingres.com/wiki/Ingres_Articles#Ingres_and_Web_Servers" class="link external">» http://community.ingres.com/wiki/Ingres_Articles#Ingres_and_Web_Servers</a>.
</p>
</p></blockquote>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ingres.requirements.html">Requirements</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ingres.configuration.html">Runtime Configuration</a></div>
<div class="up"><a href="ingres.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
