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 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 : » 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