Introduction

La liaison à la bibliothèque » libssh2 fournit un accès à des ressources (shell, exécution distante, tunneling, transfert de fichiers) sur une machine distante en utilisant un transport crypté sécurisé.

Installation

Les binaires Windows peuvent être trouvés sur » https://snaps.php.net/. Pour l'installation, téléchargez php_ssh2.dll dans le dossier spécifié par votre directive extension_dir du fichier php.ini. Activez-le en ajoutant extension=php_ssh2.dll dans votre fichier php.ini et redémarrez votre serveur web.

extension_dir=c:/php5/exts/
extension=php_ssh2.dll

 

Linux, BSD, et autres variantes *nix peuvent compiler cette extension en suivant les étapes suivantes :

• Téléchargez et installez » OpenSSL. Si vous installez OpenSSL via le système de paquetages de votre distribution, assurez-vous d'installer également les bibliothèques de développement. Elles seront typiquement paquetées sous le nom openssl-dev, openssl_devel, ou quelque chose comme cela.
• Téléchargez et installez » libssh2. Typiquement, cela signifie d'exécuter les commandes suivantes depuis les fichiers sources libssh2 : ./configure && make all install.
• Exécutez l'installeur Pear depuis PECL/ssh2: pear install ssh2
• Copiez le fichier ssh2.so depuis le dossier indiqué par le processus de compilation dans le dossier spécifié à l'intérieur du fichier spécifié par votre fichier php.ini, extension_dir.
• Ajoutez extension=ssh2.so dans votre php.ini.
• Redémarrez votre serveur web pour recharger votre configuration php.ini.

Note: Versions de développement Il n'y a actuellement aucune version stable de PECL/ssh2, pour forcer l'installation d'une version beta de PECL/ssh2, exécutez : pear install ssh2-beta

Des informations sur l'installation de ces extensions PECL peuvent être trouvées dans le chapitre du manuel intitulé Installation des extensions PECL. D'autres informations comme les notes sur les nouvelles versions, les téléchargements, les sources des fichiers, les informations concernant les mainteneurs ainsi qu'un CHANGELOG, peuvent être trouvées ici : » https://pecl.php.net/package/ssh2.

Note: Vous avez besoin de la version 0.4 ou supérieure de la bibliothèque libssh2 (ou supérieure, lisez les notes de versions).

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

SSH2_FINGERPRINT_MD5 (integer)

Flag permettant à la fonction ssh2_fingerprint() de demander l'empreinte de la clé de l'hôte en tant que hash MD5.

SSH2_FINGERPRINT_SHA1 (integer)

Flag permettant à la fonction ssh2_fingerprint() de demander l'empreinte de la clé de l'hôte en tant que hash SHA1.

SSH2_FINGERPRINT_HEX (integer)

Flag permettant à la fonction ssh2_fingerprint() de demander l'empreinte de la clé de l'hôte en tant que chaîne hexits.

SSH2_FINGERPRINT_RAW (integer)

Flag permettant à la fonction ssh2_fingerprint() de demander l'empreinte de la clé de l'hôte en tant que chaîne de caractères 8-bit.

SSH2_TERM_UNIT_CHARS (integer)

Flag spécifiant à la fonction ssh2_shell() que les paramètres width et height sont fournis sous la forme de taille de caractères.

SSH2_TERM_UNIT_PIXELS (integer)

Flag spécifiant à la fonction ssh2_shell() que les paramètres width et height sont fournis sous la forme de pixels.

SSH2_DEFAULT_TERM_WIDTH (integer)

Largeur par défaut du terminal demandé par la fonction ssh2_shell().

SSH2_DEFAULT_TERM_HEIGHT (integer)

Hauteur par défaut du terminal demandé par la fonction ssh2_shell().

SSH2_DEFAULT_TERM_UNIT (integer)

Unité par défaut du terminal demandé par la fonction ssh2_shell().

SSH2_STREAM_STDIO (integer)

Flag pour que la fonction ssh2_fetch_stream() demande un sous-canal STDIO.

SSH2_STREAM_STDERR (integer)

Flag pour que la fonction ssh2_fetch_stream() demande un sous-canal STDERR.

SSH2_DEFAULT_TERMINAL (string)

Type par défaut du terminal (e.g. vt102, ansi, xterm, vanilla) demandé par la fonction ssh2_shell().