cullylarson / ssh-commands
A library for executing remote commands, via SSH. Supports exit status, standard output, and error output.
Requires
- php: >=5.3.0
- cullylarson/local-commands: ~1.0
Requires (Dev)
- phpunit/phpunit: ~4.0
This package is not auto-updated.
Last update: 2024-12-21 19:10:40 UTC
README
A library for executing remote commands, via SSH, with support for exit codes, standard output, and error output. It fills in a gap present in the PECL ssh2 library.
Install
curl -s http://getcomposer.org/installer | php
php composer.phar require cullylarson/ssh-commands
Usage
-
Create an ssh2 connection resource.
<?php $session = ssh2_connect("localhost", 22, array('hostkey'=>'ssh-rsa')) or die("Couldn't connect."); ssh2_auth_agent($session, "my_username") or die("Couldn't authenticate.");
If you're using RSA, and you got an auth error, you might need to run this command:
$ eval `ssh-agent -s` && ssh-add
-
Create an instance of
Cully\Ssh\Command
, passing your connection resource to the constructor.<?php $command = new Cully\Ssh\Command($session);
-
Execute your command. The
exec
function takes the command you want to execute (e.g.ls
), and optionally, the current working directory (the folder from which you want to execute the command), and an array of environment variables to make available to the command.<?php $command->exec("ls");
-
Alternatively, you can execute commands using the
execTerm
function. This exposes all of the parameters that ssh2_exec takes, except for the connection resource (since it was passed in the construtor), and$cwd
.<?php $command->execTerm("ls");
-
At this point, you have access to a few results:
<?php $command->success(); // whether the command succeeded $command->failure(); // whether the command failed $command->getCommand(); // the last command executed $command->getExitStatus(); // the exit status of the last command executed $command->getOutput(); // the standard output from the last command $command->getError(); // the error output from the last command
The exec
Function
-
$command
(string) The command you want to execute (e.g.ls
). -
$cwd
(string) (optional, default: null) The current working directory (the folder you want to execute the command in). -
$env
(array) (optional, default: []) An array of environment variable that you want to make available to the command.
The execTerm
Function
-
$command
(string) The command you want to execute (e.g.ls
). -
$cwd
(string) (optional, default: null) The current working directory (the folder you want to execute the command in). -
The rest of the parameters are the same as those passed to ssh2_exec.