ftp_alloc
(PHP 5, PHP 7, PHP 8)
ftp_alloc — 為要上傳的檔案分配空間
說明
ftp_alloc(resource
$ftp_stream
, int $filesize
, string &$result
= ?): bool
向遠端 FTP 伺服器發送 ALLO
命令,
來為要上傳的檔案分配空間。
注意:
很多 FTP 伺服器不支援
ALLO
命令。 如果伺服器不支援此命令,將會返回錯誤碼(false
), 返回成功碼(true
)表示預分配空間不是必需的, 客戶端可以繼續操作了。 因此,請僅對需要強制預分配空間伺服器使用此函式。
參數
-
ftp_stream
-
FTP 連線標示符。
-
filesize
-
要分配的空間,以位元組為單位。
-
result
-
如果提供此參數,那麼伺服器的響應 會以文字方式設定到
result
中。
返回值
成功時返回 true
, 或者在失敗時返回 false
。
範例
示例 #1 ftp_alloc() 函式例程
<?php
$file = "/home/user/myfile";
// 連線伺服器
$conn_id = ftp_connect('ftp.example.com');
$login_result = ftp_login($conn_id, 'anonymous', '[email protected]');
if (ftp_alloc($conn_id, filesize($file), $result)) {
echo "Space successfully allocated on server. Sending $file.\n";
ftp_put($conn_id, '/incomming/myfile', $file, FTP_BINARY);
} else {
echo "Unable to allocate space on server. Server said: $result\n";
}
ftp_close($conn_id);
?>