ssh2://

ssh2:// — 安全外壳协议 2

说明

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

注意: 该封装器默认没有激活
为了使用 ssh2.*:// 封装协议，你必须安装来自 » PECL 的 » SSH2 扩展。

除了支持传统的 URI 登录信息，ssh2 封装协议也支持通过 URL 的主机（host）部分来复用打开连接。

用法

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

可选项

**封装协议概要**
属性	ssh2.shell	ssh2.exec	ssh2.tunnel	ssh2.sftp	ssh2.scp
受 allow_url_fopen 影响	Yes	Yes	Yes	Yes	Yes
允许读取	Yes	Yes	Yes	Yes	Yes
允许写入	Yes	Yes	Yes	Yes	No
允许追加	No	No	No	Yes（当服务器支持的时候）	No
允许同时读和写	Yes	Yes	Yes	Yes	No
支持 stat()	No	No	No	Yes	No
支持 unlink()	No	No	No	Yes	No
支持 rename()	No	No	No	Yes	No
支持 mkdir()	No	No	No	Yes	No
支持 rmdir()	No	No	No	Yes	No

**上下文选项（Context）**
名称	用法	默认
`session`	重复使用预连接的 ssh2 资源
`sftp`	重复使用预先分配的 sftp 资源
`methods`	密钥交换（key exchange）、主机密钥（hostkey）、cipher、压缩和 MAC 方法
`callbacks`
`username`	以该用户名连接
`password`	使用的密码来进行密码验证
`pubkey_file`	用于验证的公钥（public key）文件
`privkey_file`	用于验证的私钥（private key）文件
`env`	需要设置的环境变量的关联数组
`term`	在分配一个 pty 时请求的终端类型
`term_width`	在分配一个 pty 时请求的终端宽度
`term_height`	在分配一个 pty 时请求的终端宽度高度
`term_units`	term_width 和 term_height 的单位	`SSH2_TERM_UNIT_CHARS`

范例

示例 #1 从一个活跃的连接中打开流


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

示例 #2 $session 变量必须保持可用！

为了使用 ssh2.*://$session 封装协议，必须保留 $session 资源变量。下面的代码就不会有预期的效果：


<?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() 会关闭 session，因为 $connection_string 不保存对 $session 变量的引用，只是源自它的字符串转换。当离开（像函数）作用域隐性调用 unset() 时，也会发生这种情况。

add a note

User Contributed Notes 4 notes

down

exptom ¶

8 years ago


The "password" context option can also be used to provide the passphrase for the keyfile supplied by "privkey_file" and "pubkey_file".

Note this bug: https://bugs.php.net/bug.php?id=58573
Encrypted keys may not work unless you build libssh2 against openssl. (It only worked for me on Debian Wheezy once I recompiled the library).

down

bluej100 at gmail dot com ¶

9 years ago


Be aware that opendir is currently broken on sftp root directories, but you can work around it by appending a dot. See https://bugs.php.net/bug.php?id=64169 and http://stackoverflow.com/a/16238476/69173.

down

guilhem at no dot spam dot answeb dot net ¶

4 years ago


Please beware of a PHP bug, noted by thomas at gielfeldt dot dk, that you must intval() the connection variable before putting it in the connection string :

<?php
$connection = ssh2_connect('shell.example.com', 22);
ssh2_auth_password($connection, 'username', 'password');
$sftp = ssh2_sftp($connection);
// See: https://bugs.php.net/bug.php?id=73597
$stream = fopen("ssh2.sftp://" . intval($sftp) . "/path/to/file", 'r');
?>

down

-2

thomas at gielfeldt dot dk ¶

5 years ago


<?php
// Connect with public key.
$session = ssh2_connect('example.com', 22);
$result = ssh2_auth_pubkey_file($session, 'remote-username', '/home/local-username/.ssh/id_rsa.pub',
                                                             '/home/local-username/.ssh/id_rsa', 
                                                             'secret');
// Setup sftp stream wrapper
$sftp = ssh2_sftp($session);
// See: https://bugs.php.net/bug.php?id=73597
$connection_string = 'ssh2.sftp://' . intval($sftp);

// List files in remote homedir.
$i = new \RecursiveDirectoryIterator("$connection_string/home/remote-username");
$r = new \RecursiveIteratorIterator($i);
foreach ($r as $f) {
    print $f->getPathname() . "\n";
}
?>

add a note

官方地址：https://www.php.net/manual/en/wrappers.ssh2.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库 JAVA 面试 NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 PHP 8.1 ADORecordSet对象 adodb手册 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 mysql面试题 PHPMailer设置utf8 PHPMailer字符集CharSet PHP json解析（json_decode）页面工具 [原创]诡异的php-fpm超时问题 php中几种注释规范 php上周一、本周一、下周一日期 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 php扩展开发 PHP获取指定函数定义在哪个文件中及行号

略微加速

PHP官方手册 - 互联网笔记

ssh2://

说明

用法

可选项

范例

User Contributed Notes 4 notes