如何使用PHP SSH2模块执行远程Linux命令-linux运维-PHP中文网

如何使用PHP SSH2模块执行远程Linux命令

看不見的法師

发布： 2025-07-22 10:06:01

原创

806人浏览过

如何使用php ssh2模块执行远程linux命令

PHP SSH2扩展是一种在PHP程序中利用SSH（安全壳协议）进行远程操作的工具。它提供了加密连接的建立、执行远程命令、以及文件的上传和下载等功能，极大地方便了用户操作。以下是关于此扩展的详细使用指南和常见操作。

安装libssh2 要开始使用PHP SSH2扩展，首先需要安装libssh2库。以下是安装步骤：

wget https://libssh2.org/download/libssh2-1.11.0.tar.gz
tar -zxvf libssh2-1.11.0.tar.gz
cd libssh2-1.11.0/
./configure
make
sudo make install

登录后复制

PHP-SSH2扩展的官方下载地址是：https://www.php.cn/link/62f6e7ceadd1f1eb64fe5d6936e7122b

接着，安装PHP SSH2扩展：

立即学习“PHP免费学习笔记（深入）”；

wget https://pecl.php.net/get/ssh2-1.4.tgz
tar -zxvf ssh2-1.4.tgz
cd ssh2-1.4/
/usr/local/php-8.2.14/bin/phpize
./configure --with-php-config=/usr/local/php-8.2.14/bin/php-config
make
make install

登录后复制

完成后，需要在php.ini文件中添加扩展：

extension=ssh2

登录后复制

检查扩展是否安装成功：

/usr/local/php-8.2.14/bin/php -m|grep ssh2
ssh2

登录后复制

连接远程服务器使用PHP SSH2扩展的第一步是与远程SSH服务器建立连接。这需要提供服务器地址、端口号、用户名和密码。连接成功后，可以进行各种远程操作。以下是连接的示例：

行者AI

行者AI绘图创作，唤醒新的灵感，创造更多可能

100

查看详情

用户名和密码：

$connection = ssh2_connect('tinywan.com', 22);
$res = ssh2_auth_password($connection, "username", "password");
if ($res) {
    echo "Authentication Successful! ";
} else {
    echo "Authentication Failed! ";
    exit(255);
}

登录后复制

SSH密钥认证：

$connection = ssh2_connect('192.168.1.204', 22, ['hostkey' => 'ssh-rsa']);
$res = ssh2_auth_pubkey_file($connection, 'tinywan','/home/tinywan/.ssh/id_rsa.pub','/home/tinywan/.ssh/id_rsa');
if ($res) {
    echo "Public Key Authentication Successful\n";
} else {
    echo('Public Key Authentication Failed');
}

登录后复制

在上面的示例中，我们成功地连接到tinywan.com服务器的端口22，并使用了正确的用户名和密码进行身份验证。远程执行命令是PHP SSH2扩展的常见用途之一。以下是使用ssh2_exec()函数执行命令并输出结果的示例：

$connection = ssh2_connect('tinywan.com', 22);
ssh2_auth_password($connection, 'username', 'password');
$stream = ssh2_exec($connection, 'ls -l');
stream_set_blocking($stream, true);
echo stream_get_contents($stream);

登录后复制

在这个例子中，我们首先与服务器建立连接，然后使用ssh2_exec()执行ls -l命令。通过stream_set_blocking()设置流为阻塞模式，并使用stream_get_contents()获取流中的所有内容，最后输出远程命令的执行结果。上传和下载文件 PHP SSH2扩展还支持在服务器和本地计算机之间上传和下载文件。以下是使用ssh2_scp_send()和ssh2_scp_recv()函数的示例：

$connection = ssh2_connect('tinywan.com', 22);
ssh2_auth_password($connection, 'username', 'password');
ssh2_scp_send($connection, '/local_file', '/remote_file');
ssh2_scp_recv($connection, '/remote_file', '/local_file');

登录后复制

在这个例子中，我们使用ssh2_scp_send()将本地文件/local_file上传到远程服务器的/remote_file路径。同样，我们可以使用ssh2_scp_recv()从远程服务器下载文件到本地。错误处理在使用PHP SSH2扩展时，错误处理是必不可少的。连接、执行、上传和下载操作失败时，该扩展会返回错误代码和错误信息。以下是一个错误处理的示例：

$connection = ssh2_connect('tinywan.com', 22);
if (!$connection) {
    die('Connection failed.');
}
$auth = ssh2_auth_password($connection, 'username', 'password');
if (!$auth) {
    die('Authentication failed.');
}

登录后复制

使用if语句检查ssh2_connect()和ssh2_auth_password()函数的执行结果。如果这两个函数中的任何一个失败，它将抛出失败信息并终止脚本执行。

总结 PHP SSH2扩展为PHP程序提供了在SSH连接上进行远程操作的便捷方法，包括执行命令、文件传输等功能。在服务器管理和部署过程中，这是一个非常有用的工具。在使用时，注意错误处理以避免潜在问题。希望通过本文的介绍，您对PHP SSH2扩展的使用有了更深入的了解。

以上就是如何使用PHP SSH2模块执行远程Linux命令的详细内容，更多请关注php中文网其它相关文章！