Instalacja

To rozszerzenie » PECL nie jest dołączane do PHP. Informacje na temat instalacji tego rozszerzenia PECL można znaleźć w podręczniku w rozdziale zatytułowanym Instalacja rozszerzeń PECL. Dodatkowe informacje, takie jak nowe wersje, pliki do pobrania, pliki źródłowe, informacje o opiekunach czy rejestr zmian, można znaleźć tutaj: » http://pecl.php.net/package/ingres.

Biblioteki DLL tego rozszerzenia PECL można pobrać z » http://esd.ingres.com/product/drivers/PHP/.

Aby te funkcje były dostępne należy » pobrać i skompilować to rozszerzenie używając opcji konfiguracji Ingres --with-ingres[=DIR] , gdzie DIR jest katalogiem instalacji Ingres. Jeśli zmienna środowiskowa II_SYSTEM nie jest poprawnie ustawiona, należy użyć opcji --with-ingres=DIR aby określić katalog docelowy instalacji Ingres.

Kod PHP napisany dla wersji 2.x i późniejszych nie jest kompatybilny z poprzednimi wersjami rozszerzenia PHP. Jednakże jest możliwe uruchomienie dwóch niekompatybilnych wydań w tym samym środowisku PHP poprzez ustawienie opcji --enable-ingres2 . Ta opcja konfiguracyjna zmienia nazwę rozszerzenia na ingres2, tym samym zmienia nazwy funkcji, ustawienia konfiguracji i stałe. Gdy ta opcja jest włączona, to na przykład funkcja ingres_connect() staje się: ingres2_connect().

Aby używać tego rozszerzenia, musi być określona systemowa zmienna środowiskowa II_SYSTEM. Użytkownicy systemów Linux i UNIX muszą zdefiniować np. ścieżkę do bibliotek współdzielonych LD_LIBRARY_PATH. Gdy rozszerzenie jest używane z serwerem Apache, to zmienne muszą być wyraźnie określone w pliku konfiguracyjnym serwera Apache. Dodatkowo dyrektywa PassEnv jest wymagana dla rozszerzenia Ingres, aby zostały prawidłowo załadowane biblioteki współdzielone. Na przykład:

<IfModule mod_env.c>
    PassEnv II_SYSTEM
    PassEnv LD_LIBRARY_PATH
</IfModule>

Informacja:

Przykłady konfiguracji Ingres dla różnych serwerów WWW i systemów operacyjnych znajdują się pod adresem: » http://community.ingres.com/wiki/Ingres_Articles#Ingres_and_Web_Servers.