(PHP 5, PHP 7, PHP 8)
ftp_alloc — Резервирует место на диске для закачиваемого файла
Посылает команду ALLO
FTP-серверу для резервирования
места под загружаемый файл.
Замечание:
Многие FTP-серверы не поддерживают эту команду. Такие серверы возвращают код неудачи (
false
), что означает отсутствие поддержки этой команды, или код успешного выполнения (true
), означающий, что в резервировании нет необходимости и клиенту следует продолжать, будто операция была выполнена успешно. По этой причине эту функцию следует использовать с серверами, которые требуют обязательного резервирования.
ftp
Экземпляр класса FTP\Connection.
size
Количество резервируемых байт.
response
Текстовое представление ответа сервера будет возвращено по ссылке
в аргумент response
, если он указан.
Функция возвращает true
в случае успешного выполнения или false
, если возникла ошибка.
Версия | Описание |
---|---|
8.1.0 |
Параметр ftp теперь ожидает экземпляр класса FTP\Connection;
раньше параметр ждал ресурс (resource).
|
Пример #1 Пример использования ftp_alloc()
<?php
$file = "/home/user/myfile";
/* соединение с сервером */
$ftp = ftp_connect('ftp.example.com');
$login_result = ftp_login($ftp, 'anonymous', 'user@example.com');
if (ftp_alloc($ftp, filesize($file), $result)) {
echo "Место на сервере успешно зарезервировано. Отправляю $file.\n";
ftp_put($conn_id, '/incoming/myfile', $file, FTP_BINARY);
} else {
echo "Не удалось зарезервировать место на сервере. Ответ сервера: $result\n";
}
ftp_close($ftp);
?>