Seule difficulté, installer le module SSH pour PHP. Ce que je décris ici.
Ensuite, les bouts de codes exemple sont sur la doc de PHP.

Côté serveur Debian

J’étais parti de l’installation PECL directement, ça plante, il manquait des petits bouts côté Debian. Je montre pour l’exemple :

srv:~# pecl install ssh2 "channel://pecl.php.net/ssh2-0.11.2"
Failed to download pecl/ssh2 within preferred state "stable", latest release is version 0.11.2, stability "beta", use "channel://pecl.php.net/ssh2-0.11.2" to install
downloading ssh2-0.11.2.tgz ...
Starting to download ssh2-0.11.2.tgz (22,740 bytes)
........done: 22,740 bytes
[...]
checking for ssh2 files in default path... not found
configure: error: The required libssh2 library was not found.  You can obtain that package from http://sourceforge.net/projects/libssh2/
ERROR: `/tmp/pear/temp/ssh2/configure --with-ssh2' failed

Donc, il faut d’abord installer tout ça :

srv:~# apt-cache search libssh2
libnet-ssh2-perl - Perl module for the SSH 2 protocol
libssh2-1-dbg - SSH2 client-side library (debug package)
libssh2-1-dev - SSH2 client-side library (development headers)
libssh2-1 - SSH2 client-side library
libssh2-php - PHP Bindings for libssh2
python-libssh2 - Python binding for libssh2 library

srv:~# aptitude install libssh2-1-dev libssh2-php

Installation du module avec PECL

On peut donc enfin installer le module :

srv:~# pecl install ssh2 "channel://pecl.php.net/ssh2-0.11.2"
Failed to download pecl/ssh2 within preferred state "stable", latest release is version 0.11.2, stability "beta", use "channel://pecl.php.net/ssh2-0.11.2" to install
[...]
Build process completed successfully
Installing '/usr/lib/php5/20090626+lfs/ssh2.so'
install ok: channel://pecl.php.net/ssh2-0.11.2
configuration option "php_ini" is not set to php.ini location
You should add "extension=ssh2.so" to php.ini
aladdin:~# grep extension /etc/php5 -r
/etc/php5/conf.d/gd.ini:extension=gd.so
/etc/php5/conf.d/ssh2.ini:extension=ssh2.so
/etc/php5/conf.d/snmp.ini:extension=snmp.so

L’installation se charge toute seule d’activer l’extension ssh2.so dans les fichiers de conf PHP.

Exemple de code d’un transfert

define ("SSH_KEY","/path/to/.ssh/id_dsa");
define ("SSH_FINGERPRINT","BXXXXXXXXXXXXXXXXXXXXXX81"); # à récupérer la première fois
...
$ssh = ssh2_connect(SSH_SERVER,SSH_PORT);
if (ssh2_fingerprint ($ssh,SSH2_FINGERPRINT_MD5) != SSH_FINGERPRINT) { # bien penser à contrôler le fingerprint ; c'est dommage de s'en priver !
  echo "c'est mal";
}
if (!ssh2_auth_pubkey_file($ssh, SSH_LOGIN, SSH_KEY.".pub", SSH_KEY, '')) {
  echo "authentif par clef ratée";
}
...
if (@ssh2_scp_recv ($ssh, $fich_src, $fich_dest)) {
  echo "transfert OK";
}
...

Afin de creuser certaines baisses de perfs d’une base Oracle non loin de là, j’ai cherché un outil, si possible libre, pour obtenir facilement des infos du genre top-ten des requêtes les plus lancées, les plus longues, qui brassent le plus de données etc etc. Et de faire un EXPLAIN sur celles-ci pour trouver l’index qu’on a raté, l’algorithme pensé avec les pieds et ce genres de choses.

Comme Oracle est un lointain souvenir, je n’avais pas envie de me plonger dans la liste des tables V_$TRUC qui contiennent tout ceci, mais dont je n’ai aucune envie de me souvenir.

Quelques outils

Bilan, on trouve rapidement :

• l’Enterprise Manager d’Oracle (java, lourd, chiant, façon Oracle tout simplement)
• SpotLight de l’éditeur Quest Software (celui qui pond T.O.A.D). Ca balance du gros, mais c’est commercial, cher etc. Vu que tout est dans des tables et que j’ai simplement besoin d’un outil qui me présente ça lisiblement, c’est presque trop. M’enfin, si vous êtes fortunés, n’hésitez pas.
• Enfin, OracleToolBox sur http://www.oracletoolbox.org/

La configuration de OracleToolbox

Je livre ici 2/3 détails sur l’installation de Oracle Toolbox, après avoir ramé un peu.
C’est rapide, mais ça vaut sûrement le coup d’être résumé :

Couche Oracle

Il faut d’abord avoir une couche cliente Oracle et PHP/OCI8 fonctionnelle. Ca tombe bien je l’ai décrit ici : http://michauko.org/blog/2009/05/07/installer-le-client-oracle-sur-debianlenny-interco-avec-php/

Installation

Facile, il suffit de dézipper, par exemple dans /var/www/oracletoolbox/.

Variables globales

Il faut activer le passage de variables globales. C’est le choix de codage qui est fait avec l’application. Côté PHP, il s’agit d’un paramètre sensible permettant éventuellement quelques failles de sécurité.
Donc 2 options s’offrent à nous :

• la première, crade pour tester, c’est de passer à « On » la variable register_globals dans /etc/php5/apache2/php.ini
• la deuxième sera plutôt d’intégrer cette modification uniquement pour le répertoire /var/www/oracletoolbox/, décrit ci-dessous avec au passage la restriction d’accès à l’outil par htaccess.

htpasswd & register_globals

Pour protéger l’accès à l’outil, je propose une conf spécifique pour ce répertoire (/var/www/oracletoolbox/) qu’on décrira par exemple dans /etc/apache2/conf.d/oracletoolbox :

<Directory /var/www/oracletoolbox>
        AuthName "Acces restreint"
        AuthType Basic
        AuthUserFile /etc/oracle/toolbox.htpass
        <limit GET POST>
                require user toolbox
        </Limit>
        php_value register_globals 1
        <Files *.ini>
                Order allow,deny
                Deny from all
        </Files>

</Directory>

A noter le « php_value », qui évite d’activer « register_globals » sur toute l’installation Apache/PHP. Donc de la restreindre à l’application OracleToolbox.
La restriction sur les fichiers ini évitera qu’un gros malin récupère les mots de passe.

Pour créer un mot de passe associé au compte « toolbox » dans le fichier /etc/oracle/toolbox.htpass (emplacement complètement arbitraire), il faut utiliser l’outil htpasswd, comme d’hab :

srv:/# htpasswd -bc /etc/oracle/toolbox.htpass toolbox mon_pass
Adding password for user toolbox
srv:/# cat /etc/oracle/toolbox.htpass
toolbox:76X12345jNUkI

Déclaration des bases, tnsnames, tout ça

Le fichier « INSTALL » fourni dans le package donne tous les pré-requis logiciels, en incluant les lib GD, PNG etc. Du facile à installer si vous n’avez pas ces modules (php5-gd etc).
Ce fichier donne surtout quelques indices sur le reste de la configuration Oracle.
Il faudra donc jeter en vrac tous les logins/passwd des comptes Oracle qui vous permettront d’accéder à vos bases, dans /var/www/oracletoolbox/pswd.ini. L’outil testera tout ce qu’il trouve, quelle que soit la base à laquelle vous vous connectez, en espérant qu’un marchera.
Au premier lancement de l’outil (http://votre.serveur/oracletoolbox/), il vous demandera aussi où est votre fichier « tnsnames.ora » qui décrit vos bases et lesquelles vous voudrez « installer », c’est-à-dire rendre accessible depuis OracleToolbox. En gros, il se refait une copie locale de celles qui vous intéressent parmi toutes celles de votre tnsnames.ora. Soit. Si vous avez suivi ma doc de mise en place d’Oracle sur Debian, citée plus haut, le fichier est /etc/oracle/tnsnames.ora.
Tout ceci est au final stocké dans /var/www/oracletoolbox/tnsnames. Au besoin ça s’édite à la main, ça va plus vite.

Voilà, normalement-ça-marche ™.

LE bug corrigé & version Windows autonome

Il existe une version autonome (portable ?) pour windows embarquant un apache, php et le code source. Bref tout ce qu’il faut pour lancer l’outil (il manque peut-être le client Oracle et configuration à faire avant). Ca marche bien. Juste que chaque utilisateur doit avoir tout ça en local, faire tourner momentanément un Apache sur son PC etc.

A côté de cette version Windows, il y a le zip des sources dont je parle depuis le début. Ca marcherait sûrement sur un Windows avec un environnement Apache/PHP/Oracle déjà mis en place d’ailleurs.
Dans cette version, il y avait un léger bug dans le packaging (dans le zip), l’auteur m’a confirmé ça ce matin, qui faisait qu’un champ RAW d’Oracle était mal interpreté par PHP. Bref, ça merdait. Normalement, le package est corrigé ce jour et vous n’aurez pas de problème.
Si toutefois vous voyez une réaction comme ci-dessous dans le top-ten des « Disk/Buffer intensive request », vous êtes concerné, prenez le code de l’autre zip (celui pour windows) ou retéléchargez les sources si vous l’avez fait avant la correction :

OracleToolbox avec RAWTOHEX manquant

Allez, bonne analyse de perfs