Provides an object-oriented wrapper for the php ssh2 extension.
You need PHP version 5.3+ with the SSH2 extension.
The best way to add the library to your project is using composer.
$ composer require herzult/php-ssh:~1.0
To establish an SSH connection, you must first define its configuration. For that, create a Configuration instance with all the needed parameters.
<?php
// simple configuration to connect "my-host"
$configuration = new Ssh\Configuration('my-host');The available configuration classes are:
ConfigurationSshConfigFileConfiguration
Both connection configuration and public/private key authentication can be obtained from a ssh config file such as ~/.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');The session is the central access point to the SSH functionality provided by the library.
<?php
// ... the configuration creation
$session = new Ssh\Session($configuration);The authentication classes allow you to authenticate over a SSH session. When you define an authentication for a session, it will authenticate on connection.
<?php
$configuration = new Ssh\Configuration('myhost');
$authentication = new Ssh\Authentication\Password('John', 's3cr3t');
$session = new Session($configuration, $authentication);The available authentication are:
Nonefor username based authenticationPasswordfor password authenticationPublicKeyFileto authenticate using a public keyHostBasedFileto authenticate using a public hostkeyAgentto authenticate using an ssh-agent
If you use an ssh config file you can load your authentication and configuration from it as follows:
<?php
$configuration = new Ssh\SshConfigFileConfiguration('~/.ssh/config', 'my-host');
$session = new Session($configuration, $configuration->getAuthentication());This will pick up your public and private keys from your config file Host and Identity declarations.
Once you are authenticated over a SSH session, you can use the subsystems.
You can easily access the sftp subsystem of a session using the getSftp() method:
<?php
// the session creation
$sftp = $session->getSftp();See the Ssh\Sftp class for more details on the available methods.
The session also provides the getPublickey() method to access the publickey subsystem:
<?php
// ... the session creation
$publickey = $session->getPublickey();See the Ssh\Publickey class for more details on the available methods.
The session provides the getExec() method to access the exec subsystem
<?php
// ... the session creation
$exec = $session->getExec();
echo $exec->run('ls -lah');See the Ssh\Exec class for more details.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent