ftp_alloc

(PHP 5, PHP 7)

ftp_allocРезервирует место на диске для закачиваемого файла

Описание

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

Посылает команду ALLO FTP-серверу для резервирования места под загружаемый файл.

Замечание:

Многие FTP-серверы не поддерживают эту команду. Такие серверы возвращают код неудачи (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''user@example.com');

if (
ftp_alloc($conn_idfilesize($file), $result)) {
  echo 
"Место на сервере успешно зарезервировано.  Отправляю $file.\n";
  
ftp_put($conn_id'/incoming/myfile'$fileFTP_BINARY);
} else {
  echo 
"Не удалось зарезервировать место на сервере. Ответ сервера: $result\n";
}

ftp_close($conn_id);

?>

Смотрите также

  • ftp_put() - Загружает файл на FTP-сервер
  • ftp_fput() - Загружает предварительно открытый файл на FTP-сервер