README

(master)

为php ssh2扩展提供了一个面向对象的包装器。

要求

您需要PHP版本5.3+并安装SSH2扩展。

安装

将库添加到项目的最佳方式是使用composer。

$ composer require herzult/php-ssh:~1.0

用法

连接配置

要建立SSH连接，您必须首先定义其配置。为此，创建一个包含所有必需参数的Configuration实例。

<?php

// simple configuration to connect "my-host"
$configuration = new Ssh\Configuration('my-host');

可用的配置类有

• Configuration
• SshConfigFileConfiguration

连接配置和公私钥认证都可以从ssh配置文件（如~/.ssh/config）中获取

<?php

// simple configuration to connect "my-host"
$configuration = new Ssh\SshConfigFileConfiguration('/Users/username/.ssh/config', 'my-host');
$authentication = $configuration->getAuthentication('optional_passphrase', 'optional_username');

创建会话

会话是访问由库提供的SSH功能的主要入口点。

<?php

// ... the configuration creation

$session = new Ssh\Session($configuration);

认证

认证类允许您通过SSH会话进行认证。当您为会话定义认证时，它将在连接时进行认证。

<?php

$configuration = new Ssh\Configuration('myhost');
$authentication = new Ssh\Authentication\Password('John', 's3cr3t');

$session = new Session($configuration, $authentication);

可用的认证有

• None：基于用户名的认证
• Password：密码认证
• PublicKeyFile：使用公钥进行认证
• HostBasedFile：使用公钥主机密钥进行认证
• Agent：使用ssh-agent进行认证

从SshConfigFileConfiguration进行认证

如果您使用ssh配置文件，可以按以下方式加载认证和配置

<?php

$configuration = new Ssh\SshConfigFileConfiguration('~/.ssh/config', 'my-host');

$session = new Session($configuration, $configuration->getAuthentication());

这将从您的配置文件中的Host和Identity声明中获取您的公钥和私钥。

子系统

一旦您通过SSH会话进行了认证，您就可以使用子系统。

Sftp

您可以使用getSftp()方法轻松访问会话的sftp子系统

<?php

// the session creation

$sftp = $session->getSftp();

请参阅Ssh\Sftp类以获取有关可用方法的更多详细信息。

Publickey

会话还提供了getPublickey()方法来访问publickey子系统

<?php

// ... the session creation

$publickey = $session->getPublickey();

请参阅Ssh\Publickey类以获取有关可用方法的更多详细信息。

Exec

会话提供了getExec()方法来访问exec子系统

<?php

// ... the session creation

$exec = $session->getExec();

echo $exec->run('ls -lah');

请参阅Ssh\Exec类以获取更多详细信息。