Um das SQL Anywhere PHP-Modul unter Linux oder Solaris zu verwenden, müssen Sie das Shared Object aus dem SQL Anywhere-Installationsverzeichnis kopieren und zur PHP-Installation hinzufügen. Sie können optional einen Eintrag in die PHP-Initialisierungsdatei php.ini einfügen und damit das Modul laden, damit Sie es nicht manuell in jedem Skript laden müssen.

♦  So installieren Sie das PHP-Modul unter Linux/Solaris

1. Suchen Sie die php.ini-Datei Ihrer PHP-Installation und öffnen Sie sie in einem Texteditor. Suchen Sie die Zeile, in der der Standort des extension_dir-Verzeichnisses angegeben wird. Wenn extension_dir nicht auf ein bestimmtes Verzeichnis gesetzt ist, wird empfohlen, es so einzustellen, dass es zur Erhöhung der Systemsicherheit auf ein isoliertes Verzeichnis zeigt.

2. Kopieren Sie das Shared Object aus dem lib32 oder lib64-Unterverzeichnis Ihrer SQL Anywhere-Installation in das Verzeichnis, das im extension_dir-Eintrag in der Datei php.ini angegeben ist. Ihre Wahl des Shared Objects wird von der installierten Version von PHP und davon abhängen, ob es eine 32-Bit- oder eine 64-Bit-Version ist.

   Hinweis

   Wenn Ihre PHP-Version neuer als das von SQL Anywhere bereitgestellte Shared Object ist, sollten Sie das neueste bereitgestellte Shared Object verwenden. Beachten Sie, dass ein SQL Anywhere PHP-Modul der Version 5.2.x nicht mit PHP der Version 5.3.x funktioniert.

   Hinweise über die zu verwendende Version des Shared Object finden Sie unter Auswahl des PHP-Moduls.

3. Sie können optional die folgende Zeile in den Abschnitt Dynamic Extensions der php.ini-Datei einfügen, um den SQL Anywhere PHP-Treiber automatisch zu laden. Der Eintrag muss das kopierte Shared Object bezeichnen, und zwar

   extension=php-5.x.y_sqlanywhere.so

   oder bei einem threadsicheren Shared Object

   extension=php-5.x.y_sqlanywhere_r.so

   Dabei gilt : 5.x.y ist die Versionsnummer des PHP-Shared Object, das im vorherigen Schritt kopiert wurde.

   Speichern und schließen Sie php.ini.

   Eine Alternative zum automatischen Laden des PHP-Treibers besteht darin, ihn jeweils manuell in den Skripten zu laden, die ihn benötigen. Weitere Hinweise finden Sie unter SQL Anywhere PHP-Modul konfigurieren.

4. Bevor Sie das PHP-Modul benutzen, prüfen Sie, ob Ihre PHP-Ausführungsumgebung für SQL Anywhere eingerichtet ist. Abhängig von der verwendeten Shell müssen Sie das Konfigurationsskript für die Umgebung Ihres Webservers bearbeiten und den entsprechenden Befehl hinzufügen, um das SQL Anywhere-Konfigurationsskript aus dem SQL Anywhere-Installationsverzeichnis aufzurufen:

   Verwendete Shell	Befehl
   sh, ksh oder bash	. /bin32/sa_config.sh
   csh oder tcsh	source /bin32/sa_config.csh

   Die 32-Bit-Version der SQL Anywhere PHP-Erweiterungs-DLL erfordert, dass das bin 32-Verzeichnis in Ihrem Pfad enthalten ist. Die 64-Bit-Version der SQL Anywhere PHP-Erweiterungs-DLL erfordert, dass das bin64-Verzeichnis in Ihrem Pfad enthalten ist.

   Die Konfigurationsdatei, in der diese Zeile eingefügt werden soll, hängt von den verschiedenen Webservern und den verschiedenen Linux-Distributionen ab. Hier sind einige Beispiele für den Apache-Server mit den angegebenen Distributionen:

   • RedHat/Fedora/CentOS   /etc/sysconfig/httpd

   • Debian/Ubuntu   /etc/apache2/envvars

   Der Webserver muss nach der Bearbeitung seiner Umgebungskonfiguration neu gestartet werden.

5. Führen Sie an einer Eingabeaufforderung den folgenden Befehl aus, um die SQL Anywhere-Beispieldatenbank zu starten.

   dbeng11 Beispielverzeichnis/demo.db

6. An einer Eingabeaufforderung wechseln Sie ins Unterverzeichnis sdk/php/examples Ihrer SQL Anywhere Studio-Installation. Geben Sie folgenden Befehl ein:

   php test.php

   Meldungen wie die folgende sollten angezeigt werden. Wenn der PHP-Befehl nicht erkannt wird, vergewissern Sie sich, dass PHP in Ihrem Pfad enthalten ist.

   Installation successful Using php-5.2.6_sqlanywhere.so Connected successfully

7. Im Anschluss stoppen Sie den Datenbankserver.

Weitere Hinweise finden Sie unter PHP-Testseiten erstellen.