Manuel PHP
Précédent |  | Suivant

# CXLVI. Shell2 sécurisé

# 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 http://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.

> 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

> Compiler PECL/ssh2 sans utiliser les commandes PEAR : Plutôt que d'utiliser pear install ssh2 pour automatiquement télécharger et installer PECL/ssh2, vous pouvez télécharger l'archive depuis PECL. Depuis la racine de l'archive décompressée, exécutez : phpize && ./configure --with-ssh2 && make pour générer ssh2.so. Une fois compilé, continuez l'installation depuis l'étape 4 ci-dessus.

Des 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 : http://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().

Précédent | Sommaire | Suivant
PDO::sqliteCreateFunction | Niveau supérieur | ssh2_auth_hostbased_file