対話式のシェルを要求する

説明

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

リモートエンド上のシェルをオープンし、そのためのストリームを割り当てます。

パラメータ

session: ssh2_connect() のコールによって取得した SSH 接続リンク ID。
termtype: termtype は対象システムの /etc/termcap に記載されたエントリの一つに相当します。
env: env には、対象の環境に設定する名前/値の組の連想配列を渡すことができます。
width: 仮想端末の幅。
height: 仮想端末の高さ。
width_height_type: width_height_type は SSH2_TERM_UNIT_CHARS あるいは SSH2_TERM_UNIT_PIXELS のいずれかです。

戻り値

成功した場合、ストリームリソースを返します。失敗した場合に false を返します.

例

例1 対話シェルのリクエスト

<?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() - リモートサーバー上でコマンドを実行する
ssh2_tunnel() - リモートサーバーを経由するトンネルをオープンする
ssh2_fetch_stream() - 拡張データストリームを取得する