Руководство по PHP
Пред. |  | След.

# ftp_alloc

(PHP 5)

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

## Описание

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

Посылает команду `ALLO` FTP серверу для резервирования места под отгружаемый файл.

> Замечание: Многие FTP серверы не поддерживают эту команду. Такие серверы возвращают код неудачи (`FALSE`), что означает отсутствие поддержки этой команды, или код успешного выполнения (`TRUE`), означающий, что в резервировании нет необходимости и клиенту следует продолжать, будто операция была выполнена успешно. По этой причине эту функцию следует использовать с серверами, которые требуют обязательного резервирования.

## Список параметров

`ftp_stream`

  Идентификатор соединения с FTP сервером

`filezise`

  Количество байтов для резервирования.

`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_fput()

Пред. | Начало | След.
Функции для работы с FTP | Уровень выше | ftp_cdup