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