Secure Shell 2

説明

ssh2.shell:// ssh2.exec:// ssh2.tunnel:// ssh2.sftp:// ssh2.scp:// PHP 4.3.0 以降（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://

説明

利用法

オプション

例