ssh2_shell

(PECL ssh2 >= 0.9.0)

ssh2_shell — Request an interactive shell

说明

ssh2_shell ( resource $session , string $term_type = "vanilla" , array|null $env = null , int $width = 80 , int $height = 25 , int $width_height_type = SSH2_TERM_UNIT_CHARS ) : resource|false

Open a shell at the remote end and allocate a stream for it.

参数

session: An SSH connection link identifier, obtained from a call to ssh2_connect().
term_type: term_type should correspond to one of the entries in the target system's /etc/termcap file.
env: env may be passed as an associative array of name/value pairs to set in the target environment.
width: Width of the virtual terminal.
height: Height of the virtual terminal.
width_height_type: width_height_type should be one of SSH2_TERM_UNIT_CHARS or SSH2_TERM_UNIT_PIXELS.

返回值

Returns a stream 资源(resource) on success, 或者在失败时返回 false.

范例

Example #1 Requesting an interactive shell


<?php
$connection = ssh2_connect('shell.example.com', 22);
ssh2_auth_password($connection, 'username', 'password');

$stream = ssh2_shell($connection, 'vt102', null, 80, 24, SSH2_TERM_UNIT_CHARS);
?>

参见

ssh2_exec() - Execute a command on a remote server
ssh2_tunnel() - Open a tunnel through a remote server
ssh2_fetch_stream() - Fetch an extended data stream

User Contributed Notes

nogueiraconsultoria at gmail dot com 29-Jul-2020 01:25


I get it a work script for multiple commands. This script return  output of each command on array, indexed by the "command".



Att: ssh2_cmd() dont work for multiple commands, thus ssh2_shell(). Attencion for de EOL on witch type of SO. I used "\n" at the end of witch command, but maybe other options like "<br>, ; , etc);



        $connection = ssh2_connect($input_host_ip, 22);



        if (false === $connection) {

                error_log("ERROR fun??o SSH_UMTELECOM: Connection failed!\n",3,$log_file);

                exit();

        }else{

                if($debugar){error_log("SSH_UMTELECOM: Connection success to $input_host_ip!\n",3,$log_file);}



                $auth = @ssh2_auth_password($connection, $user, $pass);

                if (false === $auth) {

                        error_log("ERROR fun??o SSH_UMTELECOM: Authentication failed on $input_host_ip (user: $user)!\n",3,$log_file);

                        exit();

                }else{

                        if($debugar){error_log("SSH_UMTELECOM: Authentication success to $input_host_ip!\n",3,$log_file);}



                        error_log("Iniciando Stream: $connection\n",3,$log_file);

                        $output_array = array();

                        $shell = ssh2_shell($connection, 'vt100');



                        foreach($input_cmd as $cmd){

                                if($debugar){error_log("shell: $cmd\n",3,$log_file);}

                                $output_stream = ""; # Limpa variável para cada intera??o

                                fwrite($shell, "$cmd\n"); # N?o esquecer o "\n" ao término de cada comando

                                #stream_set_blocking($shell, true); # N?o funciona, aguarda infinitamente

                                sleep(2); # 2 segundos para redes com alta latência

                                while($output_streams = fgets($shell)){

                                        $output_stream .= $output_streams;

                                        flush();# Limpa o conteúdo para a próxima intera??o

                                }

                                $output_array[] = $output_stream; # Reune cada retorno em seu respectivo comando

                        }

                        fclose($shell); # Gracius logout from shell

                }# Fim if false === $auth

        }# Fim if false === $conenection

tuxedobob at mac dot com 08-Apr-2014 08:37


Keep in mind that when using ssh2_shell, the remote system's EOL may not be the same as PHP's EOL, so it may not be safe to use PHP_EOL. The native EOL for Windows is \r\n, while Unix is typically merely \n, and classic Mac for some reason is \r.



If you're running PHP on Windows (\r\n) and sshing into a Unix box (\n) you're going to end up sending extra lines. My experience so far is that it just acts as though you typed nothing, which may cause issues with password prompts.



Oh, and \n\r? Don't do that. Nobody does that.

tsschulz at gmx dot net 11-Jan-2011 08:07


In my case the ssh2_shell doesn't work every time. There were many problems:

- If I use stream_get_contents, the command(s) never executed

- with while ($buf = fgets...) the loop never stops

- without sleep(1) before stream_set_blocking, the command wasn't execute every time. Anyone knows why?

That's what I made, and it works - but I think it isn't what it should be:

<?php

        $strCommand = 'tar -C /path/to/extract -xjf /path/from/file.tar.bz2';

        $sshStream = ssh2_shell($this->sshSession, 'xterm', null, 120, 24, SSH2_TERM_UNIT_CHARS); 

        fwrite($sshStream, $strCommand . PHP_EOL);

        sleep(1);

        stream_set_blocking($sshStream, true);

        $sshUntarRetval = "";

        while ($buf = fgets($sshStream,4096)) {

        flush();

            $sshUntarRetval .= $buf;

            if (strpos($buf, 'tar -C') !== false)

            {

                break;

            }

        }

        fclose($sshStream);

?>

stefanov at uk dot ibm dot com 02-May-2008 08:26


Do not use \n to end the command. Some server will fail to process. Use always the standard for PHP end of line: PHP_EOL



'suri at suribala dot com"'s example should be modified as follows (also change the double quotes to single, for better performance):



<?php



$con=ssh2_connect('192.168.0.1', 22);

ssh2_auth_password($con, 'user', 'password');

$shell=ssh2_shell($con, 'xterm');

fwrite( $shell, 'cd /dir_one;'.PHP_EOL);

fwrite( $shell, 'ls -la;'.PHP_EOL);

fwrite( $shell, 'cd /dir_two;'.PHP_EOL);

fwrite( $shell, 'ls -la;'.PHP_EOL);



?>



Cheers,



Pimmy

josh at hydril dot com 12-Jul-2007 04:49


To run a shell script with all the variables that you would have when logged in interactively add bash -l or sh --login infront of your command.  The script I use creates a shell script, copies the script to the box with ssh2_scp_send, then executes the script with ssh2_exec.  Hope this helps somebody.



<?php



//Example



$script1 = "bash -l /etc/rc.d/rc.httpd restart";



$connection = ssh2_connect('shell.example.com', 22);

ssh2_auth_password($connection, 'username', 'password');



$stream = ssh2_exec($connection, $script1);

?>

vgopu1 at gmail dot com 09-Jul-2007 01:17


Hi,



we could also use shell_exec to execute multiple related commands

separated by semicolon (;).



 And I figured out  problem that sometimes arise related to the execution of complex java c/c++ programs. All we need to do is to set the required environment variables. I have a environment variable in .bash_profile. This variable would be set when I log into my account normally through shell. But when we use ssh2_connect(), the environment variables in the .bash_profile are not set, all we need to do is export the required environment variables with shell_exec();



example:



$conn = ssh2_connect($ipaddress);

ssh2_auth_password($conn,$username,$passwd);

$cmd1="/path/to/program1";

$cmd2="/path/to/program2";

$env1="export Variable_name1=path1";

$env2="export Variable_name2=path2" 

$stream = ssh2_exec($connection,"$env1; $env2; $cmd1; $cmd2");//this would execute all the //commands and return 

// stream 

stream_set_blocking($stream, true);

while($o=fgets($stream)){

echo $o.'<br>';

}



...

...



Thanks,

Vikram Gopu .

http:\\my.lsu.edu/vgopu1

galvao at galvao dot eti dot br 18-Dec-2006 09:03


In response to webmaster at spectreanime dot com:



"For some obscur reasons, just after ur command, u need to make a sleep to be sure, that the command has reached the server and is running"



Actually what you must do is set the blocking of the string to true, so it waits until the server sends data to the STDOUT before echoing it. 



So, instead of:



sleep(1);



Just do:



stream_set_blocking($stdio, true);



Best regards,

webmaster at spectreanime dot com 08-Jun-2005 01:38


// Connection to SSH server

        echo "Connexion SSH ";

        if (!($resource=@ssh2_connect("192.168.0.1"))) {

                echo "[FAILED]<br />";

                exit(1);

        }

        echo "[OK]<br />";

                                                                                                                                                             

        // Authentification by login/passwd

        echo "Authentification ";

        if (!@ssh2_auth_password($resource,"root","your_password")) {

                echo "[FAILED]<br />";

                exit(1);

        }

        echo "[OK]<br />";

                                                                                                                                                             

        // We need a shell

        echo "Shell stdio ";

        if (!($stdio = @ssh2_shell($resource,"xterm"))) {

                echo "[FAILED]<br />";

                exit(1);

        }

        echo "[OK]<br />";

                                                                                                                                                             

        // Execution of any command

        // Be careful to add an '\n' at the  end of the command

        $command = "/bin/ls /tmp\n";

        fwrite($stdio,$command);

                                                                                                                                                             

        // IMPORTANT

        // For some obscur reasons, just after ur command, u need to make a sleep to be sure, that the command has reached the server and is running

        sleep(1);

        

        // Then u can fetch the stream to see what happens on stdio

        while($line = fgets($stdio)) {

                flush();

                echo $line."<br />";

        }

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       

        // It's always cleaner to close all stream

        fclose($stdio);



I truly hope i'll help someone :)

suri at suribala dot com 14-Feb-2005 05:03


Using ssh_exec, one could execute only one command at a time. However, ssh_shell, offers greater flexibility.





Here is an example:





<?php





$con=ssh2_connect('192.168.0.1', 22);


ssh2_auth_password($con, "user", "password");


$shell=ssh2_shell($con, 'xterm');


fwrite( $shell, "cd /dir_one\n");


fwrite( $shell, "ls -la\n");


fwrite( $shell, "cd /dir_two\n");


fwrite( $shell, "ls -la\n");





?>





Thanks Sara for your implementation and your help !