array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.ftp-alloc.php', 1 => 'ftp_alloc', ), 'up' => array ( 0 => 'ref.ftp.php', 1 => 'Функции FTP', ), 'prev' => array ( 0 => 'ref.ftp.php', 1 => 'Функции FTP', ), 'next' => array ( 0 => 'function.ftp-append.php', 1 => 'ftp_append', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ftp/functions/ftp-alloc.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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);
?>