<!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>