ftp_alloc

(PHP 5)

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

Описание

bool ftp_alloc ( resource $ftp_stream , int $filesize [, string &$result ] )

Посылает команду 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_id, filesize($file), $result)) {
  echo "Место на сервере успешно зарезервировано.  Отправляю $file.\n";
  ftp_put($conn_id, '/incomming/myfile', $file, FTP_BINARY);
} else {
  echo "Не удалось зарезервировать место на сервере. Ответ сервера: $result\n";
}

ftp_close($conn_id);

?>

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

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