Manuel PHP
Précédent		Suivant

CXXVII. 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().

Table des matières
ssh2_auth_hostbased_file -- Identification en utilisant une clé d'hôte publique
ssh2_auth_none -- Identification en tant que "none"
ssh2_auth_password -- Identification via SSH en utilisant un mot de passe en clair
ssh2_auth_pubkey_file -- Identification en utilisant une clé publique
ssh2_connect -- Connexion à un serveur SSH
ssh2_exec -- Exécute une commande sur un serveur distant
ssh2_fetch_stream -- Parcours un flux étendu de données
ssh2_fingerprint -- Récupère l'empreinte d'un serveur distant
ssh2_methods_negotiated -- Retourne une liste de méthodes négociées
ssh2_publickey_add -- Ajoute une clé publique autorisée
ssh2_publickey_init -- Initialise un Publickey Subsystem (sous-système de clé publique)
ssh2_publickey_list -- Liste les clés publiques actuellement autorisées
ssh2_publickey_remove -- Supprime un clé publique autorisée
ssh2_scp_recv -- Demande un fichier via SCP
ssh2_scp_send -- Envoie un fichier via SCP
ssh2_sftp_lstat -- Statue un lien symbolique
ssh2_sftp_mkdir -- Crée un dossier
ssh2_sftp_readlink -- Retourne la cible d'un lien symbolique
ssh2_sftp_realpath -- Résoud le chemin réel d'un chemin fourni
ssh2_sftp_rename -- Renomme un fichier distant
ssh2_sftp_rmdir -- Efface un dossier
ssh2_sftp_stat -- Statue un fichier sur un système de fichiers distant
ssh2_sftp_symlink -- Crée un lien symbolique
ssh2_sftp_unlink -- Efface un fichier
ssh2_sftp -- Initialise un sous-système SFTP
ssh2_shell -- Demande un shell intéractif
ssh2_tunnel -- Ouvre un tunnel à travers un serveur distant

Précédent	Sommaire	Suivant
SDO_DAS_XML::saveDocumentToString	Niveau supérieur	ssh2_auth_hostbased_file