Description

ssh2.shell:// ssh2.exec:// ssh2.tunnel:// ssh2.sftp:// ssh2.scp:// (PECL)

Note: Cette enveloppe n'est pas activée par défaut
Pour utiliser l'enveloppe ssh2://, l'extension » SSH2 disponible sur » PECL doit être installée.

En plus d'accepter les identifications traditionnelles via l'URI, l'enveloppe ssh2 réutilisera les connexions ouvertes en passant la ressource de connexion dans la partie hôte de l'URL.

Utilisation

ssh2.shell://user:pass@example.com:22/xterm
ssh2.exec://user:pass@example.com:22/usr/local/bin/somecmd
ssh2.tunnel://user:pass@example.com:22/192.168.0.1:14
ssh2.sftp://user:pass@example.com:22/path/to/filename

Options

Résumé de l'enveloppe

Attribut ssh2.shell ssh2.exec ssh2.tunnel ssh2.sftp ssh2.scp

Restreint par allow_url_fopen Oui Oui Oui Oui Oui

Autorise la lecture Oui Oui Oui Oui Oui

Autorise l'écriture Oui Oui Oui Oui Non

Autorise l'ajout Non Non Non Oui (lorsque supporté par le serveur) Non

Autorise la lecture et l'écriture simultanément Oui Oui Oui Oui Non

Support de la fonction stat() Non Non Non Oui Non

Support de la fonction unlink() Non Non Non Oui Non

Support de la fonction rename() Non Non Non Oui Non

Support de la fonction mkdir() Non Non Non Oui Non

Support de la fonction rmdir() Non Non Non Oui Non

**Résumé de l'enveloppe**
Attribut	ssh2.shell	ssh2.exec	ssh2.tunnel	ssh2.sftp	ssh2.scp
Restreint par allow_url_fopen	Oui	Oui	Oui	Oui	Oui
Autorise la lecture	Oui	Oui	Oui	Oui	Oui
Autorise l'écriture	Oui	Oui	Oui	Oui	Non
Autorise l'ajout	Non	Non	Non	Oui (lorsque supporté par le serveur)	Non
Autorise la lecture et l'écriture simultanément	Oui	Oui	Oui	Oui	Non
Support de la fonction stat()	Non	Non	Non	Oui	Non
Support de la fonction unlink()	Non	Non	Non	Oui	Non
Support de la fonction rename()	Non	Non	Non	Oui	Non
Support de la fonction mkdir()	Non	Non	Non	Oui	Non
Support de la fonction rmdir()	Non	Non	Non	Oui	Non

Options de contexte

Nom Utilisation Défaut

session ressource ssh2 pré-connectée à réutiliser

sftp ressource sftp pré-allouée à réutiliser

methods méthodes d'échange de clés, hostkey, cipher, compression, et MAC, à utiliser

callbacks

username Nom de l'utilisateur pour la connexion

password Mot de passe à utiliser lors d'une identification par mot de passe

pubkey_file Nom du fichier contenant la clé publique à utiliser lors de l'identification

privkey_file Nom du fichier contenant la clé privée à utiliser lors de l'identification

env Tableau associatif de variables d'environnement à définir

term Type d'émulation de terminal à demander lors de l'allocation d'un pty

term_width Largeur du terminal à demander lors de l'allocation d'un pty

term_height Hauteur du terminal à demander lors de l'allocation d'un pty

term_units Unités à utiliser avec term_width et term_height SSH2_TERM_UNIT_CHARS

**Options de contexte**
Nom	Utilisation	Défaut
`session`	ressource ssh2 pré-connectée à réutiliser
`sftp`	ressource sftp pré-allouée à réutiliser
`methods`	méthodes d'échange de clés, hostkey, cipher, compression, et MAC, à utiliser
`callbacks`
`username`	Nom de l'utilisateur pour la connexion
`password`	Mot de passe à utiliser lors d'une identification par mot de passe
`pubkey_file`	Nom du fichier contenant la clé publique à utiliser lors de l'identification
`privkey_file`	Nom du fichier contenant la clé privée à utiliser lors de l'identification
`env`	Tableau associatif de variables d'environnement à définir
`term`	Type d'émulation de terminal à demander lors de l'allocation d'un pty
`term_width`	Largeur du terminal à demander lors de l'allocation d'un pty
`term_height`	Hauteur du terminal à demander lors de l'allocation d'un pty
`term_units`	Unités à utiliser avec term_width et term_height	`SSH2_TERM_UNIT_CHARS`

Exemples

Exemple #1 Ouverture d'un flux depuis une connexion active

<?php
$session = ssh2_connect('example.com', 22);
ssh2_auth_pubkey_file($session, 'username', '/home/username/.ssh/id_rsa.pub',
                                            '/home/username/.ssh/id_rsa', 'secret');
$stream = fopen("ssh2.tunnel://$session/remote.example.com:1234", 'r');
?>

Exemple #2 La variable $session doit rester disponible !

Afin d'utiliser l'enveloppe ssh2.*://$session, la variable de ressource $session doit être conservée. Le code ci-dessous n'aura pas l'effet escompté :

<?php
$session = ssh2_connect('example.com', 22);
ssh2_auth_pubkey_file($session, 'username', '/home/username/.ssh/id_rsa.pub',
                                            '/home/username/.ssh/id_rsa', 'secret');
$connection_string = "ssh2.sftp://$session/";
unset($session);
$stream = fopen($connection_string . "path/to/file", 'r');
?>

La fonction unset() clôt la session, car la variable $connection_string ne contient pas de référence à la variable $session, mais uniquement une chaîne dérivée. Ceci survient également lorsque la fonction unset() est implicite, lors d'une sortie du scope (comme dans une fonction).