Mini-HOWTO Sybase-PHP-Apache

Copyright 2001 Tyson Lloyd Thwaites. Ce document peut être distribué selon les termes et conditions énoncés dans la licence GNU Free Documentation License.

Pour ce mini-guide, nous considérons que vous avez déjà installé Linux sur votre machine. Ce mini-guide s'appuie sur la RedHat 6.2. N'hésitez pas à me communiquer vos remarques si vous tentez l'installation avec une autre distribution.

Dans un premier temps, vous devez désinstaller les packages rpms apache et mod_php. Ceci devrait marcher :

    # rpm -e apache
    # rpm -e httpd
    # rpm -e mod_php
    # rpm -e php

Cela devrait avoir désinstallé ce qu'il fallait. Pour en être sûr, faites :

    # rpm -qa | less

et vérifiez qu'il n'y a plus de packages apache ou php.

Téléchargez Sybase ASE pour Linux sur http://www.sybase.com/downloads. Sybase-ASE 11.0.3.3 est libre en mode production. Ce mini-guide s'appuie sur cette version.

Tout d'abord, installez les rpms Sybase en tant que root :

    # rpm -ivh sybase-ase-11_0_3_3-6_i386.rpm
    # rpm -ivh sybase-doc-11_0_3_3-6_i386.rpm
    # rpm -ivh sybase-ocsd-10_0_4-6_i386.rpm

Pour plus d'information sur la configuration de Sybase, consultez les instructions du fichier /opt/sybase/doc/howto/howto-ase-quickstart.html. Ce document étant très précis, il est inutile d'en dire davantage ici.

    export: sybase-ase-11.0.3.3: not a legal variable name

# export SYBASE=/opt/sybase
export SYBASE=`rpm -q --queryformat \
		'%{installprefix}\n' sybase-ase-11.0.3.3`

export SYBASE=/opt/sybase
#export SYBASE=`rpm -q --queryformat \
#		'%{installprefix}\n' sybase-ase-11.0.3.3`

Après avoir installé Sybase, vous devez mettre en place l'environnement Linux pour accepter des connexions de clients à votre serveur de base de données.

Il faut pour cela renseigner quelques variables d'environnement dans /etc/profile. Ouvrez /etc/profile en tant que root et ajoutez les lignes suivantes :

    export SYBASE=/opt/sybase
    export SYBPLATFORM=linux
    export LD_LIBRARY_PATH=$SYBASE/lib
    export LC_ALL=default
    export PATH="$SYBASE/bin:$PATH"
    export DSQUERY=SYBASE

Ensuite vous devez changer les permissions du répertoire Sybase. Cela résoud quelques problèmes de connexion entre PHP et Sybase. Exécutez la commande suivante en tant que root :

chown -R sybase:sybase /opt/sybase

Pour vérifier que l'environnement Sybase foncitonne, entrez les commandes :

    # su - nobody
    $ isql -Usa -P
    1> sp_helpdb
    2> go

Vous devriez voir une liste de bases de données. Pour vérifier que vous pouvez utiliser la base de données exemple, saisissez :

    1> use pubs2
    2> go
    1> select * from titles
    2> go

Si vous obtenez une liste, vous avez réussi la configuration de Sybase.

    unset LANG; unset LC_ALL; \

    # ln -s /opt/sybase/install/rc.sybase /etc/rc.d/init.d/sybase
    # ln -s /etc/rc.d/init.d/sybase /etc/rc.d/rc3.d/S15sybase
    # ln -s /etc/rc.d/init.d/sybase /etc/rc.d/rc3.d/K15sybase

    # ./configure --prefix=/usr/local/apache

Téléchargez la dernière version de php, et désarchivez-la.

Placez-vous dans le répertoire php et lancez le script ./configure. Vous devez passer quelques options à ce script. Pour permettre à php d'accéder au moteur Sybase, utilisez --with-sybase-ct. Pour préciser le serveur web avec lequel php doit s'interfacer (ici apache), utilisez : --with-apache.

Voilà un exemple complet de la commande configure, avec les deux options décrites ci-dessus, ainsi que d'autres options utiles :

    # ./configure --with-apache=../apache_1.3.19
      --with-sybase-ct=/opt/sybase --enable-bcmath --enable-calendar
      --enable-ctype --enable-exif --enable-ftp --enable-gd-imgstrttf
      --with-gd --enable-trans-sid --enable-shmop --enable-sockets
      --enable-sysvsem --enable-sysvshm --enable-wddx

Si le script configure s'est achevé avec succès, vous pouvez enchaîner :

    # make && make install

PHP devrait se compiler sans accroc. Après l'installation, vous devez copier le fichier php.ini :

    # cp php.ini-optimized /usr/local/lib/php.ini

Maintenant il faut changer quelques éléments dans /usr/local/lib/php.ini. Positionnez les paramètres avec les valeurs suivantes :

    magic_quotes_sybase = on
    sybct.min_server_severity = 11
    sybct.min_client_severity = 11

J'aime bien compléter avec ça :

    register_globals = on
    include_path=.:/usr/local/lib/php

Vous avez maintenant terminé l'installation de php.

Maintenant retournez dans le répertoire dans lequel vous avez désarchivé apache. Saisissez les commandes suivantes :

    # ./configure --activate-module=src/modules/php4/libphp4.a
    # make && make install

Ca ne devrait poser aucun problème. Une fois fait, éditez le fichier /usr/local/apache/conf/httpd.conf et décommentez la ligne :

    AddType application/x-httpd-php .php

Cela prévient apache d'utiliser le module php pour les fichiers avec une extension .php. Vous pouvez aussi ajouter d'autres extensions à la fin de la ligne, par exemple :

    AddType application/x-httpd-php .php .php3 .html .htm

Maitenant que vous avez installé tous les éléments nécessaires, vous êtes prêts à tester votre système.

Déjà, assurez-vous qu'apache et Sybase soient lancés :

    # /usr/local/apache/bin/apachectl start
    # /opt/sybase/install/rc.sybase start

Déplacez vous dans le répertoire /usr/local/apache/htdocs. Créer un fichier test.php et insérez-y les lignes suivantes :

        <?php
                $connexion = sybase_connect("SYBASE", "sa", "");
                sybase_select_db("pubs2");
                $requete = sybase_query("select * from titles", $con);

                echo sybase_result($requete, 1, 1);

                sybase_close($connexion);
        ?>

Sauvez le fichier et accéder à l'adresse suivante avec votre navigateur :

    http://localhost/test.php

Si vous voyez apparaître du texte, bravo ! Vous avez terminé l'installation de Linux/Apache/PHP/Sybase-ASE. Sinon ... bon courage. Vérifiez que vous avez bien installé la base de données pubs2. Si vous n'êtes pas sûrs, essayer la commande :

    # isql -Usa -P < /opt/sybase/scripts/installpubs2

Envoyez moi un mail (en anglais) si vous rencontrez des problèmes, ou si vous souhaitez me soumettre des corrections et des ajouts. Mais s'il vous plaît, ne m'écrivez que si vous avez déjà tout testé dans ce mini-guide ! Merci.

Une fois que votre système fonctionne, savourez votre victoire. Je vous suggère aussi d'aller manger un morceau. Après ça, il vous reste quelques points à régler.

La toute PREMIERE que vous devriez faire est de changer le mot de passe pour l'utilisateur 'sa'. Par défaut, il est vide. Pour modifier le mot de passe de sa, taper l'instruction suivante à l'aide d'isql :

        1> sp_password null, 'new_pass123', 'sa'
        2> go

Cela va modifier le mot de passe. Vous devez désormais le passer en tant que paramètre de connexion à Sybase. De même, il faudra le spécifier à Sybase lorsque vous lancerez isql, ce qui peut être fait grâce à l'option '-P'.

Vous souhaitez peut-être installer le client Windows. Vous le trouverez sur un CD si vous achetez une copie d'ASE auprès de Sybase. Sinon, si vous utilisez la version libre 11.0.3.3, vous pouvez télécharger une version de démonstration de ASE 12.0 pour NT, et n'installer que les composants 'ASE Plugin for Sybase Central', 'ASE ODBC Driver', et 'Sybase Central'.

Merci de faire parvenir en anglais à l'auteur vos questions et commentaires relatifs à la version originale de ce document à l'adresse <tyson.lloydthwaites -CHEZ- ite -POINT- com -POINT- au>.

N'hésitez pas à faire parvenir tout commentaire relatif à la version française de ce document à <commentaires CHEZ traduc POINT org> en précisant le nom et la version du document auquel vous faites référence.