ssh2://

ssh2:// — Secure Shell 2

Descripción

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

Nota: Esta envoltura no está habilitada por omisión
Para poder usarse la envoltura ssh2.*:// debe instalarase la extensión » SSH2 disponible en » PECL.

Además de permitir hacer un login tradicional en la URI, la envoltura ssh2 también puede reutilizar las conexiones ya abiertas, proporcionando el recurso de conexión en el apartado host de la URL.

Uso

  • ssh2.shell://usuario:contraseña@ejemplo.com:22/xterm
  • ssh2.exec://usuario:contraseña@ejemplo.com:22/usr/local/bin/comando
  • ssh2.tunnel://usuario:contraseña@ejemplo.com:22/192.168.0.1:14
  • ssh2.sftp://usuario:contraseña@ejemplo.com:22/ruta/a/fichero

Opciones

Resumen de la Envoltura
Atributo ssh2.shell ssh2.exec ssh2.tunnel ssh2.sftp ssh2.scp
Restringido por allow_url_fopen Sí Sí Sí Sí Sí
Permite Lecturas Sí Sí Sí Sí Sí
Permite Escrituras Sí Sí Sí Sí No
Permite Añadir contenidos No No No Sí (cuando esté soportado por el servidor) No
Permite Lecturas y Escrituras Simultáneas Sí Sí Sí Sí No
Permite usar la función stat() No No No Sí No
Permite usar la función unlink() No No No Sí No
Permite usar la función rename() No No No Sí No
Permite usar la función mkdir() No No No Sí No
Permite usar la función rmdir() No No No Sí No

Opciones de contexto
Nombre Uso Valor por omisión
session Recurso ssh2 preconectado a utilizar  
sftp Recurso sftp preubicado a reutilizar  
methods métodos a usar de entre Key exchange, hostkey, cipher, compression, y MAC  
callbacks    
username Nombre de usuario con el que conectar  
password Contraseña a utilizar en autenticación con contraseña  
pubkey_file Nombre del fichero con la clave pública que se usará para autenticar  
privkey_file Nombre del fichero con la clave privada que se usará para autenticar  
env Array asociativo con las variables de entorno que se van a asignar  
term Tipo de emulación del terminal a solicitar cuando se asigne un pty (pseudo terminal)  
term_width Ancho del terminal solicitado cuando se asigne un pty  
term_height Altura del terminal solicitado cuando se asigne un pty  
term_units Unidades a usar con term_width y con term_height SSH2_TERM_UNIT_CHARS

Ejemplos

Ejemplo #1 Abriendo un flujo a partir de una conexión activa

<?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');
?>

Ejemplo #2 ¡La variable $session debe permanecer disponible!

Para utilizar la envoltura ssh2.*://$session debe mantenerse el recurso $session disponible. El código siguiente no tendrá el efecto deseado:

<?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');
?>

unset() cierra la sesión, ya que $connection_string no contiene una referencia a la variable $session, simplemente una representación de la cadena derivada de ella. Esto también ocurre cuando unset() va implícito porque se sale del ámbito (como dentro de una función).