ftp_alloc
(PHP 5, PHP 7)
ftp_alloc — Резервирует место на диске для закачиваемого файла
Описание
$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_id, filesize($file), $result)) {
echo "Место на сервере успешно зарезервировано. Отправляю $file.\n";
ftp_put($conn_id, '/incoming/myfile', $file, FTP_BINARY);
} else {
echo "Не удалось зарезервировать место на сервере. Ответ сервера: $result\n";
}
ftp_close($conn_id);
?>
Смотрите также
- ftp_put() - Загружает файл на FTP-сервер
- ftp_fput() - Загружает предварительно открытый файл на FTP-сервер