安装php ssh2扩展
本文目的
花了一下午时间，终于弄清楚了如何在php中使用libssh2扩展。在这个过程中遇到了一些问题，在解决问题的过程中加深了对php和ssh2的理解。所以，还是决定抽点时间回顾整个过程，作为备忘。
什么是php的ssh2扩展
Php ssh2扩（以下简称PECL/ssh2），允许在php程序中远程执行系统命令和文件传输，不需要在被监控的机器上单独开发和部署类似agnet的“木马”程序，大大降低了运维成本。
Php ssh2扩展需要的依赖库
- openssl： 加密算法集合，C语言实现
- libssh2：ssh2协议库库，C语言实现
- PECL/ssh2: libssh2的php扩展，允许php程序调用libssh2中的函数
依赖关系：PECL/ssh2 –> libssh2 –> openssl
安装过程
[openssl]
|
$ cd openssl.x.x.x $ ./configure --prefix=/your/openssl/home $ make $ make install |
[libssh2]
|
$ cd libsshxxxx $ ./configure --with-libssl-prefix=/your/openssl/home LIBS=-ldl $ make $ make install |
PS: 配置中的“LIBS=-ldl”十分重要，如果不设置，如果不设置会导致“dlclose无法链接等错误”
[PECL/ssh2]
|
$ cd ssh2x.x.x $ phpize $ ./configure --with-php-config=/your/php/home/bin/php-config LIBS =-ldl $ make $ make install $ vi php.ini (添加extension=ssh2.so) $ cp ssh2.so /php.ini/extention_dir $ cd /apache/bin $ apachectl restart (重启apache，使ssh2扩展生效) $ php –I | grep ssh2 (检查PECL/ssh2是否安装成功，什么都没有标识没有成功) |
PS: 配置中的“LIBS=-ldl”十分重要，如果不设置，会导致“libssh2 version >= 0.4 not found”错误，可以通过查看config.log，定位具体的bug位置，与安装libssh类似。
Php ssh2 API例子
通过PECL/ssh2相关API远程操作计算机时，首先需要获取链接，使用函数:
|
session ssh2_connect($host, $port) |
获取链接后，需要进行验证，也就是登录，ssh2提供三种登入方式：
- public key : 通过公钥和密钥进行验证，需要使用openssl生成工密钥，然后将公钥上传到需要远程访问机器的指定目录。特点比较安全，但是不太方便。PECL/ssh2支持。
- password : 直接通过用户名和密码登录。特点是很方便，但是不安全，密码必须已明文的方式传给ssh2的api。PECL/ssh2支持。
- keyboard-interactive：需要用户手动输入密码，PECL/ssh2不支持。
可以通过下面的api获取服务器提供的验证方式：
|
mixed ssh2_auth_none ( resource $session , string $username ) |
返回值是一个验证方式的字符串数组。
下面的代码演示password方式验证并在远程调用”pwd”命令:
<?php
$host='ip_or_host';
$user='some_user';
$passwd='your_password';
// 链接远程服务器
$connection = ssh2_connect($host, 36000);
if (!$connection) die('connection to '.$host.':3600 failed');
echo 'connection OK<br/>';
// 获取验证方式并打印
$auth_methods = ssh2_auth_none($connection, $user);
print_r( $auth_methods.'<br/>');
if (in_array('password', $auth_methods ))
{
// 通过password方式登录远程服务器
if (ssh2_auth_password($connection, $user, $passwd))
{
echo $user.' login OK<br/>';
$stream = ssh2_exec($connection, "pwd"); // 执行php
stream_set_blocking($stream, true); // 获取执行pwd后的内容
if ($stream === FALSE) die("pwd failed");
echo 'pwd: '.stream_get_contents($stream).'<br/>';
}
else
{
die( $user.' login Failed<br/>');
}
}
?>
总结
安装php扩展的一般过程：
1. phpize，生成配置文件和makefile等
2. ./configure && make && make install
3. 边界php.ini，添加extension
4. 将编译的so文件考到extension_dir目录下
5. 重启apche
6. 查看phpinfo或“php –i| grep xxxx”输出的页面中是否存需要安装的扩展
PS: 配置过程中，如果发现一些问题，可以通过查看config.log查看问题发生位置。
参考资料
- Php ssh2 api官方文档，很清晰，注意下面的讨论：http://www.php.net/manual/en/ref.ssh2.php
- 安装步骤描述：http://www.cnblogs.com/edwardlost/archive/2011/04/02/2003097.html
