Secure Shell 2

Descripción

ssh2.shell:// ssh2.exec:// ssh2.tunnel:// ssh2.sftp:// ssh2.scp:// PHP 4.3.0 y superior (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).

ssh2://

Descripción

Uso

Opciones

Ejemplos