ftp_alloc
(PHP 5, PHP 7, PHP 8)
ftp_alloc — Резервирует место на диске для закачиваемого файла
Описание
Посылает команду ALLO FTP-серверу для резервирования
места под загружаемый файл.
Замечание:
Многие FTP-серверы не поддерживают эту команду. Такие серверы возвращают код неудачи (
false), что означает отсутствие поддержки этой команды, или код успешного выполнения (true), означающий, что в резервировании нет необходимости и клиенту следует продолжать, будто операция была выполнена успешно. По этой причине эту функцию следует использовать с серверами, которые требуют обязательного резервирования.
Список параметров
-
ftp -
An FTP\Connection instance.
-
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);
?>Смотрите также
- ftp_put() - Загружает файл на FTP-сервер
- ftp_fput() - Загружает предварительно открытый файл на FTP-сервер
add a note
