Manual de PHP
Anterior	Apéndice M. Lista de Protocolos/Envolturas Soportadas	Siguiente

Shell Seguro 2

ssh2.shell:// ssh2.exec:// ssh2.tunnel:// ssh2.sftp:// ssh2.scp:// PHP 4.3.0 y superiores (PECL)

ssh2.shell://usuario:contrasenya@example.com:22/xterm
ssh2.exec://usuario:contrasenya@example.com:22/usr/local/bin/algun_comando
ssh2.tunnel://usuario:contrasenya@example.com:22/192.168.0.1:14
ssh2.sftp://usuario:contrasenya@example.com:22/ruta/hacia/archivo

Esta envoltura no se encuentra habilitada por defecto: Para usar las envolturas ssh2.*://, es necesario instalar la extensión SSH2 disponible desde PECL.

Además de aceptar detalles de inicio de sesión tradicionales tipo URI, las envolturas ssh2 reusan conexiones abiertas pasando el recurso de conexión en la porción host de la URL.

Ejemplo M-2. Abrir una secuencia desde una conexión activa


<?php
$sesion = ssh2_connect('example.com', 22);
ssh2_auth_pubkey_file($sesion, 'nombre_usuario',
                      '/home/usuario/.ssh/id_rsa.pub',
                      '/home/usuario/.ssh/id_rsa', 'secreto');
$secuencia = fopen("ssh2.tunnel://$sesion/remote.example.com:1234", 'r');
?>

Tabla M-8. Resumen de Envoltura

Atributo	ssh2.shell	ssh2.exec	ssh2.tunnel	ssh2.sftp	ssh2.scp
Restringido por allow_url_fopen.	Si	Si	Si	Si	Si
Permite lectura	Si	Si	Si	Si	Si
Permite escritura	Si	Si	Si	Si	No
Permite adición	No	No	No	Si (Cuando lo permite el servidor)	No
Permite Lectura y Escritura Simultánea	Si	Si	Si	Si	No
Soporta stat()	No	No	No	Si	No
Soporta unlink()	No	No	No	Si	No
Soporta rename()	No	No	No	Si	No
Soporta mkdir()	No	No	No	Si	No
Soporta rmdir()	No	No	No	Si	No

Tabla M-9. Opciones de contexto

Nombre	Uso	Predeterminado
`session`	Recurso ssh2 preconectado para reusar
`sftp`	Recurso sftp prereservado para reusar
`methods`	Métodos de intercambio de llave, llave de host, cifrado, compresión y MAC a usar
`callbacks`
`username`	Nombre de usuario para la conexión
`password`	Contraseña a usar con autenticación de contraseñas
`pubkey_file`	Nombre del archivo de llave pública a usar para la autenticación
`privkey_file`	Nombre del archivo de llave privada a usar para la autenticación
`env`	Matriz asociativa de variables de entorno a definir
`term`	Tipo de emulación de terminal para solicitar cuando se reserva una pty
`term_width`	Ancho de la terminal solicitada cuando se reserva una pty
`term_height`	Altura de la terminal solicitada cuando se reserva una pty
`term_units`	Unidades a usar con term_width y term_height	`SSH2_TERM_UNIT_CHARS`

Anterior	Inicio	Siguiente
Secuencias de Compresión	Subir	Secuencias de Audio