PHP マニュアル: Secure Shell 2

説明

ssh2.shell:// ssh2.exec:// ssh2.tunnel:// ssh2.sftp:// ssh2.scp:// （PECL）

注意: このラッパーはデフォルトでは有効になっていません
ssh2.*:// ラッパーを使用するには、 » PECL から » SSH2 拡張モジュールをインストールする必要があります。

ssh2 ラッパーでは、URL のホスト部分に接続リソースを渡すことで既にオープンしている接続を再利用することが可能です。

利用法

ssh2.shell://user:pass@example.com:22/xterm
ssh2.exec://user:pass@example.com:22/usr/local/bin/somecmd
ssh2.tunnel://user:pass@example.com:22/192.168.0.1:14
ssh2.sftp://user:pass@example.com:22/path/to/filename

オプション

**ラッパーの概要**
属性	ssh2.shell	ssh2.exec	ssh2.tunnel	ssh2.sftp	ssh2.scp
allow_url_fopen で制約される	Yes	Yes	Yes	Yes	Yes
読み込み許可	Yes	Yes	Yes	Yes	Yes
書き込み許可	Yes	Yes	Yes	Yes	No
追加許可	No	No	No	Yes（サーバーがサポートしている場合）	No
同時読み書き許可	Yes	Yes	Yes	Yes	No
stat のサポート	No	No	No	Yes	No
unlink のサポート	No	No	No	Yes	No
rename のサポート	No	No	No	Yes	No
mkdir のサポート	No	No	No	Yes	No
rmdir のサポート	No	No	No	Yes	No

**コンテキストオプション**
名前	使用法	デフォルト
`session`	再利用する接続済みの ssh2 リソース
`sftp`	再利用する割り当て済みの sftp リソース
`methods`	Key exchange, hostkey, cipher, compression, および MAC methods
`callbacks`
`username`	接続するユーザー名
`password`	パスワード認証に使用するパスワード
`pubkey_file`	認証に使用する公開鍵ファイル
`privkey_file`	認証に使用する秘密鍵ファイル
`env`	設定する環境変数の連想配列
`term`	pty を割り当てる際の端末エミュレート方式
`term_width`	pty を割り当てる際の端末の幅
`term_height`	pty を割り当てる際の端末の高さ
`term_units`	term_width および term_height の単位	`SSH2_TERM_UNIT_CHARS`

例

例1 アクティブな接続からストリームをオープンする

<?php
$session = ssh2_connect('example.com', 22);
ssh2_auth_pubkey_file($session, 'username', '/home/username/.ssh/id_rsa.pub',
                                            '/home/username/.ssh/id_rsa', 'secret');
$stream = fopen("ssh2.tunnel://$session/remote.example.com:1234", 'r');
?>

例2 $session を有効にしておかないといけない!

ssh2.*://$session ラッパーを使うには、リソース変数 $session をキープしておかないといけません。次のコードは、期待通りには動きません。

<?php
$session = ssh2_connect('example.com', 22);
ssh2_auth_pubkey_file($session, 'username', '/home/username/.ssh/id_rsa.pub',
                                            '/home/username/.ssh/id_rsa', 'secret');
$connection_string = "ssh2.sftp://$session/";
unset($session);
$stream = fopen($connection_string . "path/to/file", 'r');
?>

この例では、unset() のところでセッションを閉じてしまいます。なぜなら、$connection_string が持つのが $session への参照ではなく、単にそれを文字列にキャストしたものだからです。これは、unset が暗黙のうちに呼ばれた場合にも起こりえます (関数などの) スコープを抜けるときに発生する可能性があります。

ssh2://

説明

利用法

オプション

例