安装php ssh2扩展

trssc

　　本文目的
　　花了一下午时间，终于弄清楚了如何在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