ftp_site

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_site — SITEコマンドをサーバーに送信する

説明

function ftp_site(FTP\Connection $ftp, string $command): bool

ftp_site() は、指定された SITE コマンドを FTP サーバーに送信します。

SITE コマンドの規格は統一されていないため、サーバーにより仕様が異なります．ファイルのパーミッションやグループメンバーの設定のような処理を行う際には有用です。

パラメータ

ftp: FTP\Connection クラスのインスタンス
command: SITE コマンド。このパラメータはエスケープされないので、スペースやその他の文字を含むファイル名は問題を引き起こす可能性があることに注意してください。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン	説明
8.1.0	引数 `ftp` は、FTP\Connection のインスタンスを期待するようになりました。これより前のバージョンでは、resource を期待していました。

例

例1 SITE コマンドを FTP サーバーに送信する

<?php
// FTP サーバーに接続する
$ftp = ftp_connect('ftp.example.com');
if (!$ftp) die('Unable to connect to ftp.example.com');

// "user" として、パスワード "pass" でログインする
if (!ftp_login($ftp, 'user', 'pass')) die('Error logging into ftp.example.com');


// FTP サーバーに "SITE CHMOD 0600 /home/user/privatefile" コマンドを発行する
if (ftp_site($ftp, 'CHMOD 0600 /home/user/privatefile')) {
   echo "Command executed successfully.\n";
} else {
   die('Command failed.');
}
?>

参考

ftp_raw() - FTP サーバーに任意のコマンドを送信する

関連キーワード:

サーバー送信 site user Connection example command インスタンス期待 connect pass home privatefile Command option size 規格統一仕様パーミッショングループメンバー有用エスケープスペース