ftp_alloc

(PHP 5, PHP 7, PHP 8)

ftp_alloc — 為要上傳的文件分配空間

說明

ftp_alloc(resource $ftp_stream, int $filesize, string &$result = ?): bool

向遠程 FTP 服務(wù)器發(fā)送 ALLO 命令， 來為要上傳的文件分配空間。

注意:

很多 FTP 服務(wù)器不支持ALLO 命令。 如果服務(wù)器不支持此命令，將會返回錯誤碼（false）， 返回成功碼（true）表示預(yù)分配空間不是必需的， 客戶端可以繼續(xù)操作了。 因此，請僅對需要強制預(yù)分配空間服務(wù)器使用此函數(shù)。

參數(shù)

ftp_stream

FTP 連接標示符。

filesize

要分配的空間，以字節(jié)為單位。

result

如果提供此參數(shù)，那么服務(wù)器的響應(yīng) 會以文本方式設(shè)置到 result 中。

返回值

成功時返回 true， 或者在失敗時返回 false。

范例

示例 #1 ftp_alloc() 函數(shù)例程

<?php

$file = "/home/user/myfile";

// 連接服務(wù)器
$conn_id = ftp_connect('ftp.example.com');
$login_result = ftp_login($conn_id, 'anonymous', 'user@example.com');

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);

?>

參見

  • ftp_put() - 上傳文件到 FTP 服務(wù)器
  • ftp_fput() - 上傳一個已經(jīng)打開的文件到 FTP 服務(wù)器