PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-config.php';
$ftp = ftp_connect($ftpHost, $ftpPort, 5);
if ($ftp === false) throw new RuntimeException('Нет соединения');
echo "Соединение есть; вход ещё не выполнен\n";
ftp_close($ftp);

Соединение есть; вход ещё не выполнен

Предусловие: свой FTP сервер доступен по FTP_HOST/FTP_PORT. Пять — секунды сетевого ожидания, а не число повторов. Функция читает приветствие сервера, но не проверяет пароль. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

try { ftp_connect('127.0.0.1', 2121, 0); }
catch (ValueError $error) { echo "Таймаут должен быть положительным\n"; }

Таймаут должен быть положительным

PHP 8.5 проверяет timeout до открытия соединения. Здесь сетевого запроса нет; неверное значение параметра отличается от false при сетевом отказе.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-config.php';
$ftp = ftp_ssl_connect($ftpHost, $ftpPort, 5);
if ($ftp === false) throw new RuntimeException('Нет FTP соединения');
try {
    if (!ftp_login($ftp, $ftpUser, $ftpPassword)) throw new RuntimeException('AUTH TLS или вход не удались');
    if (!ftp_pasv($ftp, true)) throw new RuntimeException('Нет passive');
    echo "Сервер принял защищённый вход\n";
} finally { ftp_close($ftp); }

Сервер принял защищённый вход

Требуется отдельный свой explicit FTPS стенд. ftp_ssl_connect само ещё не доказывает TLS: AUTH выполняется во время login. Эта функция не проверяет сертификат партнёра; пример демонстрирует механизм, а не достаточную защиту производственной интеграции. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

echo function_exists('ftp_ssl_connect') ? "FTPS функция доступна\n" : "Сборка без FTPS\n";
echo "SFTP требует другого клиента\n";

FTPS функция доступна
SFTP требует другого клиента

Ожидаемый вывод относится к сборке FTP с OpenSSL. Наличие функции не говорит о поддержке TLS выбранным сервером.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-config.php';
$ftp = ftp_connect($ftpHost, $ftpPort, 5);
if ($ftp === false) throw new RuntimeException('Нет сервера');
try {
    if (!ftp_login($ftp, $ftpUser, $ftpPassword)) throw new RuntimeException('Сервер отклонил вход');
    echo "Учебная учётная запись принята\n";
} finally { ftp_close($ftp); }

Учебная учётная запись принята

Имя и пароль не следует хранить в публичном PHP файле, выводить в ошибке или добавлять к URL журнала. Даже принятый пароль не гарантирует право удалить/загрузить файл. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-config.php';
$ftp = ftp_connect($ftpHost, $ftpPort, 5);
if ($ftp === false) throw new RuntimeException('Нет сервера');
try {
    $accepted = @ftp_login($ftp, $ftpUser, 'wrong-lesson-password');
    echo $accepted ? "Неожиданно принят\n" : "Отказ входа: проверьте учебные настройки\n";
} finally { ftp_close($ftp); }

Отказ входа: проверьте учебные настройки

Единственная намеренно неправильная попытка на своём стенде. @ убирает ожидаемый warning, результат всё равно обработан. В рабочем сервисе ограничивают повторы, иначе можно заблокировать аккаунт. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (!ftp_pasv($ftp, true)) throw new RuntimeException('Не включён passive');
echo "Для данных используется passive
";
} finally { ftp_close($ftp); }

Для данных используется passive

openLessonFtp уже входит и включает passive; повторный вызов здесь показывает именно настройку. В passive соединение данных инициирует клиент, что обычно удобнее за NAT. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
ftp_set_option($ftp, FTP_USEPASVADDRESS, false);
if (!ftp_pasv($ftp, true)) throw new RuntimeException('Нет passive');
$names = ftp_nlist($ftp, 'incoming');
if ($names === false) throw new RuntimeException('Data channel не открылся');
echo "Список получен через адрес управляющего соединения
";
} finally { ftp_close($ftp); }

Список получен через адрес управляющего соединения

Применять только к известной проблеме конфигурации PASV сервера за NAT. Это не универсальное ускорение и не снятие firewall; правильнее исправить объявляемый адрес и диапазон passive портов у администратора. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
echo ftp_close($ftp) ? "Соединение закрыто\n" : "Отказ закрытия\n";

Соединение закрыто

В этом примере операция закрытия — последняя. Объект может ещё находиться в переменной, но связь им уже не представлена. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
    $directory = ftp_pwd($ftp);
    if ($directory === false) throw new RuntimeException('Нет каталога');
    echo "Каталог прочитан\n";
} finally { ftp_close($ftp); }

Каталог прочитан

finally выполняется и после throw. Не вызывайте close второй раз через другую переменную, ссылающуюся на тот же FTP\Connection. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
echo ftp_quit($ftp) ? "Соединение закрыто\n" : "Отказ закрытия\n";

Соединение закрыто

В этом примере операция закрытия — последняя. Объект может ещё находиться в переменной, но связь им уже не представлена. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
    $directory = ftp_pwd($ftp);
    if ($directory === false) throw new RuntimeException('Нет каталога');
    echo "Каталог прочитан\n";
} finally { ftp_quit($ftp); }

Каталог прочитан

finally выполняется и после throw. Не вызывайте close второй раз через другую переменную, ссылающуюся на тот же FTP\Connection. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
echo ftp_get_option($ftp, FTP_TIMEOUT_SEC), " секунд\n";
} finally { ftp_close($ftp); }

5 секунд

В helper timeout задан при connect равным пяти. Значение не относится ко всему импорту и не задаёт срок выполнения PHP процесса. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
ftp_set_option($ftp, FTP_AUTOSEEK, false);
echo ftp_get_option($ftp, FTP_AUTOSEEK) === false ? "Автопозиционирование выключено\n" : "Включено\n";
try { ftp_get_option($ftp, -123); }
catch (ValueError $error) { echo "Неизвестная опция\n"; }
} finally { ftp_close($ftp); }

Автопозиционирование выключено
Неизвестная опция

Текущее PHP 8.5 поведение уточнено по исходникам: неизвестная опция бросает ValueError. Старое описание warning/false нельзя смешивать с корректным bool false выключенной опции. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
ftp_set_option($ftp, FTP_TIMEOUT_SEC, 8);
echo ftp_get_option($ftp, FTP_TIMEOUT_SEC), " секунд\n";
} finally { ftp_close($ftp); }

8 секунд

Это изменение уже открытого connection. Более длинный timeout не чинит неверный путь, права или firewall. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
try { ftp_set_option($ftp, FTP_AUTOSEEK, 1); }
catch (TypeError $error) { echo "Для AUTOSEEK требуется bool\n"; }
ftp_set_option($ftp, FTP_AUTOSEEK, true);
echo "Автопозиционирование включено\n";
} finally { ftp_close($ftp); }

Для AUTOSEEK требуется bool
Автопозиционирование включено

Value типизируется по option. В PHP 8.5 возвращается true либо выбрасывается ошибка; не рассчитывайте получить false для неверных настроек. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
echo $ftp instanceof FTP\Connection ? "Это FTP connection\n" : "Другой объект\n";
} finally { ftp_close($ftp); }

Это FTP connection

Connection не предоставляет методов get/put. Его передают первым аргументом процедурных ftp_* функций; это пример внутреннего класса без пользовательского API методов. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

try { $ftp = new FTP\Connection(); }
catch (Error $error) { echo "Используйте ftp_connect или ftp_ssl_connect\n"; }

Используйте ftp_connect или ftp_ssl_connect

Ни сеть, ни пароль в этом примере не используются. Внутренний final класс создаётся фабриками; сериализация для передачи соединения в другой процесс не поддерживается.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$directory = ftp_pwd($ftp);
if ($directory === false) throw new RuntimeException('PWD не выполнен');
echo $directory, "\n";
} finally { ftp_close($ftp); }

/

Ожидается / на описанном учебном стенде. Другой сервер вправе вернуть иной виртуальный путь. Это не локальный getcwd PHP. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$previous = ftp_pwd($ftp);
if ($previous === false) throw new RuntimeException('Неизвестно, куда возвращаться');
try {
    if (!ftp_chdir($ftp, 'incoming')) throw new RuntimeException('Нет incoming');
    echo "Работа внутри incoming\n";
} finally {
    if (!ftp_chdir($ftp, $previous)) throw new RuntimeException('Не восстановлен каталог');
}
} finally { ftp_close($ftp); }

Работа внутри incoming

Состояние текущего каталога принадлежит соединению. Другие функции, которым передали тот же объект, увидят смену каталога; сохранение/восстановление ограничивает этот побочный эффект. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (!ftp_chdir($ftp, 'incoming')) throw new RuntimeException('Нет доступа к incoming');
echo ftp_pwd($ftp), "\n";
} finally { ftp_close($ftp); }

/incoming

Путь relative к текущему FTP каталогу. Абсолютный /incoming относится к виртуальному корню аккаунта, который может быть отделён chroot от реального корня ОС. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (!ftp_chdir($ftp, '/incoming')) throw new RuntimeException('Нет папки');
$size = ftp_size($ftp, 'stock.csv');
if ($size < 0) throw new RuntimeException('Размер не получен');
echo $size > 0 ? "В папке есть непустая выгрузка\n" : "Выгрузка пуста\n";
} finally { ftp_close($ftp); }

В папке есть непустая выгрузка

Параметр не является URL и не требует urlencode. Разрешённые каталоги определяет ваш договор; не подставляйте в chdir произвольное поле из HTML формы. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (!ftp_chdir($ftp, '/incoming')) throw new RuntimeException('Нет incoming');
if (!ftp_cdup($ftp)) throw new RuntimeException('Не выполнен CDUP');
echo ftp_pwd($ftp), "\n";
} finally { ftp_close($ftp); }

/

Это один уровень вверх, а не возврат к каталогу, с которого начиналась произвольная операция. На корне результат зависит от политики сервера. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (!ftp_chdir($ftp, '/incoming')) throw new RuntimeException('Нет incoming');
if (!ftp_cdup($ftp)) throw new RuntimeException('Нет родителя');
if (!ftp_chdir($ftp, 'outgoing')) throw new RuntimeException('Нет соседней папки');
echo ftp_pwd($ftp), "\n";
} finally { ftp_close($ftp); }

/outgoing

Для реального обхода дерева храните исходный путь и глубину, ограничивайте рекурсию. CDUP не обещает доступ выше корня аккаунта. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$created = ftp_mkdir($ftp, 'outgoing/lesson-new');
if ($created === false) throw new RuntimeException('Не создан каталог');
echo "Папка создана\n";
} finally { ftp_close($ftp); }

Папка создана

Предусловие: outgoing существует, lesson-new ещё нет, пользователь имеет право создания. Это одна папка; отсутствующие родители не создаются автоматически. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$created = ftp_mkdir($ftp, 'outgoing/lesson-batch');
if ($created === false) throw new RuntimeException('MKD отклонён');
echo is_string($created) ? "Сервер вернул имя нового каталога\n" : "Неверный тип\n";
} finally { ftp_close($ftp); }

Сервер вернул имя нового каталога

Не проверяйте $created === true: успешный результат — строка пути. Повторный запуск с тем же именем обычно выдаст warning/false, а не «каталог теперь точно наш». Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$name = 'outgoing/lesson-empty';
if (ftp_mkdir($ftp, $name) === false) throw new RuntimeException('Учебная папка не создана');
if (!ftp_rmdir($ftp, $name)) throw new RuntimeException('Пустая папка не удалена');
echo "Учебная пустая папка убрана\n";
} finally { ftp_close($ftp); }

Учебная пустая папка убрана

Папку сначала создаёт сам пример; если она уже существовала, выполнение прекращается до удаления. Функция не выполняет рекурсивное удаление. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$name = 'outgoing/lesson-filled';
if (ftp_mkdir($ftp, $name) === false) throw new RuntimeException('Папка не создана');
$file = fopen('php://temp', 'w+b');
if ($file === false) throw new RuntimeException('Нет буфера');
try {
    fwrite($file, 'A42'); rewind($file);
    if (!ftp_fput($ftp, $name . '/keep.txt', $file)) throw new RuntimeException('Нет файла');
    echo @ftp_rmdir($ftp, $name) ? "Неожиданное удаление\n" : "Непустая папка сохранена\n";
} finally { fclose($file); }
} finally { ftp_close($ftp); }

Непустая папка сохранена

Остаются созданные примером папка/keep.txt для ручного осмотра. false может означать и отсутствие прав; функция не сообщает надёжно единственную причину. Не добавляйте автоматическое delete по всему серверу. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет буфера');
try {
    fwrite($stream, 'temporary'); rewind($stream);
    if (!ftp_fput($ftp, 'outgoing/lesson-delete.tmp', $stream)) throw new RuntimeException('Не загружено');
    if (!ftp_delete($ftp, 'outgoing/lesson-delete.tmp')) throw new RuntimeException('Не удалено');
    echo "Временный файл удалён\n";
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

Временный файл удалён

Предусловие: выделенный путь не используется другим процессом. Права на загрузку и удаление могут различаться. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$owned = ['outgoing/lesson-expired.csv'];
$requested = 'outgoing/lesson-expired.csv';
if (!in_array($requested, $owned, true)) throw new RuntimeException('Чужой путь');
if (!ftp_delete($ftp, $requested)) throw new RuntimeException('Удаление не подтверждено');
echo "Удалён только разрешённый экспорт\n";
} finally { ftp_close($ftp); }

Удалён только разрешённый экспорт

Требуется заранее созданный учебный lesson-expired.csv. Имя из HTTP запроса само по себе не является разрешением. Для скачивания поставщика сначала сохраняют и проверяют локальную копию, затем отмечают обработку; ранний delete способен потерять данные. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет буфера');
try {
    fwrite($stream, "sku,qty\nA42,7\n"); rewind($stream);
    if (!ftp_fput($ftp, 'outgoing/lesson-ready.part', $stream)) throw new RuntimeException('Передача не завершена');
    if (!ftp_rename($ftp, 'outgoing/lesson-ready.part', 'outgoing/lesson-ready.csv')) throw new RuntimeException('Переименование не выполнено');
    echo "Финальное имя назначено после передачи\n";
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

Финальное имя назначено после передачи

Получатель должен игнорировать .part; пути принадлежат одной учебной задаче. Атомарность замены/перезапись существующей цели зависят от сервера и файловой системы — одна функция не обещает универсальную транзакцию. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (ftp_mkdir($ftp, 'outgoing/lesson-draft') === false) throw new RuntimeException('Папка не создана');
if (!ftp_rename($ftp, 'outgoing/lesson-draft', 'outgoing/lesson-approved')) throw new RuntimeException('Папка не переименована');
echo "Название партии изменено\n";
} finally { ftp_close($ftp); }

Название партии изменено

ftp_rename подходит и файлам, и каталогам. Не предполагайте возможность перенести между разными файловыми системами/учётными корнями. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$permissions = ftp_chmod($ftp, 0644, 'outgoing/lesson-permissions.txt');
if ($permissions === false) throw new RuntimeException('CHMOD не поддержан или запрещён');
echo decoct($permissions), "\n";
} finally { ftp_close($ftp); }

644

Нужен заранее созданный свой файл и сервер с SITE CHMOD. Восьмеричная запись 0644 означает owner rw, group/other r. Десятичное 644 имеет другое числовое значение. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$result = ftp_chmod($ftp, 0600, 'outgoing/lesson-private.txt');
if ($result === false) throw new RuntimeException('Права не изменены');
echo $result === 0600 ? "Запрошены права владельца\n" : "Иной результат\n";
} finally { ftp_close($ftp); }

Запрошены права владельца

Требуется свой файл. Unix mode не заменяет ACL, политику FTP и шифрование канала. Возвращённое число отражает успешную команду, а не независимый аудит всех способов доступа. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (!ftp_get($ftp, 'stock-copy.csv', 'incoming/stock.csv', FTP_BINARY)) {
    throw new RuntimeException('Файл не скачан целиком');
}
echo file_get_contents('stock-copy.csv');
} finally { ftp_close($ftp); }

sku,qty
A42,7

Удалённый incoming/stock.csv имеет содержимое из начала главы. stock-copy.csv создаётся рядом с запускаемым скриптом: это файл сервера PHP, не папка Downloads браузера. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$partial = 'lesson-stock.part';
$final = 'lesson-stock.csv';
if (!ftp_get($ftp, $partial, 'incoming/stock.csv', FTP_BINARY)) throw new RuntimeException('Загрузка не завершена');
$input = fopen($partial, 'rb');
if ($input === false) throw new RuntimeException('Нет локальной копии');
try {
    $header = fgetcsv($input, null, ',', '"', '');
    if ($header !== ['sku', 'qty']) throw new RuntimeException('Неправильный заголовок');
} finally { fclose($input); }
if (!rename($partial, $final)) throw new RuntimeException('Локальное переименование не выполнено');
echo "Локальная выгрузка прошла проверку заголовка\n";
} finally { ftp_close($ftp); }

Локальная выгрузка прошла проверку заголовка

Выделенные пути принадлежат этой задаче. Проверка заголовка показана как первая ступень; она не проверяет каждую строку, подпись или идентичность версии выгрузки. При failure .part может остаться для диагностики. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет stream');
try {
    if (!ftp_fget($ftp, $stream, 'incoming/stock.csv', FTP_BINARY)) throw new RuntimeException('Не скачано');
    rewind($stream);
    echo stream_get_contents($stream);
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

sku,qty
A42,7

ftp_fget пишет в переданный stream и не возвращает его содержимое строкой. После записи указатель переместился, поэтому перед чтением нужен rewind. Владелец stream закрывает его сам. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет stream');
try {
    ftp_set_option($ftp, FTP_AUTOSEEK, false);
    if (!ftp_fget($ftp, $stream, 'incoming/stock.csv', FTP_BINARY, 8)) throw new RuntimeException('REST/GET не выполнен');
    rewind($stream);
    echo stream_get_contents($stream);
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

A42,7

Серверный файл начинается ровно с восьми ASCII байтов sku,qty и LF; сервер должен поддержать REST. AUTOSEEK выключен: локальный пустой stream пишет с текущей позиции 0, удалённый читает с 8. Это демонстрация двух разных указателей, не универсальный способ пропустить CSV заголовок. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (!ftp_put($ftp, 'outgoing/lesson-upload.csv', 'export.csv', FTP_BINARY)) throw new RuntimeException('Передача не завершена');
echo "CSV передан\n";
} finally { ftp_close($ftp); }

CSV передан

export.csv лежит рядом с примером и приложен ниже; outgoing существует на стенде. Второй аргумент — удалённое имя, третий — локальный файл. Браузерное имя $_FILES[name] не заменяет серверный путь $_FILES[tmp_name]. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$local = 'export.csv';
$remote = 'outgoing/lesson-size.csv';
$expected = filesize($local);
if ($expected === false) throw new RuntimeException('Нет локального размера');
if (!ftp_put($ftp, $remote, $local, FTP_BINARY)) throw new RuntimeException('Не передано');
$actual = ftp_size($ftp, $remote);
if ($actual < 0 || $actual !== $expected) throw new RuntimeException('Размер не подтверждён');
echo "Размер переданных байтов совпал\n";
} finally { ftp_close($ftp); }

Размер переданных байтов совпал

Нужна поддержка SIZE. Совпадение размера не является проверкой хеша; получатель ещё должен разобрать/принять файл. Загружайте уникальное имя партии, чтобы повтор не перезаписывал чужую выгрузку. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет stream');
try {
    fputcsv($stream, ['sku', 'qty'], ',', '"', '');
    fputcsv($stream, ['A42', 7], ',', '"', '');
    rewind($stream);
    if (!ftp_fput($ftp, 'outgoing/lesson-buffer.csv', $stream, FTP_BINARY)) throw new RuntimeException('Не передано');
    echo "CSV из буфера передан\n";
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

CSV из буфера передан

После fputcsv указатель в конце; без rewind отправлять будет нечего. php://temp может уйти из памяти во временный файл после порога — это не обещание нулевого использования диска. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('source.txt', 'rb');
if ($stream === false) throw new RuntimeException('Нет файла');
try {
    fgets($stream); // Skip the local service header.
    ftp_set_option($ftp, FTP_AUTOSEEK, false);
    if (!ftp_fput($ftp, 'outgoing/lesson-body.txt', $stream, FTP_BINARY)) throw new RuntimeException('Не передано');
    echo "Передано тело без локального заголовка\n";
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

Передано тело без локального заголовка

source.txt содержит служебную первую строку и тело. Выключенное AUTOSEEK делает намерение явным: читать с текущего локального указателя, записывать удалённую цель с начала. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (!ftp_append($ftp, 'outgoing/lesson-events.log', 'event.txt', FTP_BINARY)) throw new RuntimeException('APPE отклонён');
echo "Строка добавлена\n";
} finally { ftp_close($ftp); }

Строка добавлена

event.txt приложен; каждая запись уже заканчивается LF. append не вставляет разделитель сам. Сервер может создать отсутствующую цель по правилам APPE. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$rows = ["B17 reserved 3", "A42 released 1"];
if (file_put_contents('batch.log', implode("\n", $rows) . "\n") === false) throw new RuntimeException('Нет локальной пачки');
if (!ftp_append($ftp, 'outgoing/lesson-events.log', 'batch.log', FTP_BINARY)) throw new RuntimeException('Пачка не добавлена');
echo "Пачка отправлена одним APPE\n";
} finally { ftp_close($ftp); }

Пачка отправлена одним APPE

Повтор после неопределённого сетевого отказа может продублировать строки. Для событий с денежными/складскими последствиями нужен ID и дедупликация у получателя; сам append не идемпотентен. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$response = '';
$ok = @ftp_alloc($ftp, 14, $response);
echo $ok ? "Сервер разрешил продолжить\n" : "ALLO не поддержан или отклонён\n";
} finally { ftp_close($ftp); }

Для стенда с ALLO ожидается первая строка; для обычного сервера, отклоняющего ALLO, вторая. Полный response можно сохранить в защищённой диагностике; он не является стабильным машинным форматом. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$size = filesize('export.csv');
if ($size === false) throw new RuntimeException('Нет локального файла');
$response = '';
if (!ftp_alloc($ftp, $size, $response)) throw new RuntimeException('Этот стенд требует успешного ALLO');
if (!ftp_put($ftp, 'outgoing/lesson-allocated.csv', 'export.csv')) throw new RuntimeException('Передача не удалась');
echo "Обязательный ALLO и загрузка выполнены\n";
} finally { ftp_close($ftp); }

Обязательный ALLO и загрузка выполнены

Контекст: свой сервер явно требует/реализует предварительное резервирование. У многих серверов ALLO не поддержан или true означает лишь «предварительный резерв не нужен». Не вводите его как обязательный шаг любого FTP. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$state = ftp_nb_get($ftp, 'lesson-nb-copy.csv', 'incoming/stock.csv', FTP_BINARY);
while ($state === FTP_MOREDATA) {
    $state = ftp_nb_continue($ftp);
}
if ($state !== FTP_FINISHED) throw new RuntimeException('Передача не завершена');
echo file_get_contents('lesson-nb-copy.csv');
} finally { ftp_close($ftp); }

sku,qty
A42,7

Цикл продолжает ровно текущую операцию; FTP_MOREDATA не означает успех, FTP_FAILED не равен исключению. Пока transfer не завершён, не запускайте новую передачу на том же connection. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$deadline = hrtime(true) + 5_000_000_000;
$state = ftp_nb_get($ftp, 'lesson-nb-copy.csv', 'incoming/stock.csv', FTP_BINARY);
while ($state === FTP_MOREDATA) {
    if (hrtime(true) >= $deadline) throw new RuntimeException('Общий срок передачи истёк');
    $state = ftp_nb_continue($ftp);
}
if ($state !== FTP_FINISHED) throw new RuntimeException('Передача не завершена');
echo file_get_contents('lesson-nb-copy.csv');
} finally { ftp_close($ftp); }

sku,qty
A42,7

hrtime задаёт общий срок, который проверяется между вызовами continue. Сам continue способен ждать сетевой timeout: это не жёсткое прерывание ровно на пятой секунде. Для полного контроля длительности используют отдельный worker/клиент с соответствующим договором. При отказе finally закрывает connection; файл может остаться частичным. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет stream');
try {
$state = ftp_nb_fget($ftp, $stream, 'incoming/stock.csv', FTP_BINARY);
while ($state === FTP_MOREDATA) {
    $state = ftp_nb_continue($ftp);
}
if ($state !== FTP_FINISHED) throw new RuntimeException('Передача не завершена');
rewind($stream);
echo stream_get_contents($stream);
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

sku,qty
A42,7

Цикл продолжает ровно текущую операцию; FTP_MOREDATA не означает успех, FTP_FAILED не равен исключению. Пока transfer не завершён, не запускайте новую передачу на том же connection. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет stream');
try {
$deadline = hrtime(true) + 5_000_000_000;
$state = ftp_nb_fget($ftp, $stream, 'incoming/stock.csv', FTP_BINARY);
while ($state === FTP_MOREDATA) {
    if (hrtime(true) >= $deadline) throw new RuntimeException('Общий срок передачи истёк');
    $state = ftp_nb_continue($ftp);
}
if ($state !== FTP_FINISHED) throw new RuntimeException('Передача не завершена');
rewind($stream);
echo stream_get_contents($stream);
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

sku,qty
A42,7

hrtime задаёт общий срок, который проверяется между вызовами continue. Сам continue способен ждать сетевой timeout: это не жёсткое прерывание ровно на пятой секунде. Для полного контроля длительности используют отдельный worker/клиент с соответствующим договором. При отказе finally закрывает connection; файл может остаться частичным. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$state = ftp_nb_put($ftp, 'outgoing/lesson-ftp_nb_put.csv', 'export.csv', FTP_BINARY);
while ($state === FTP_MOREDATA) {
    $state = ftp_nb_continue($ftp);
}
if ($state !== FTP_FINISHED) throw new RuntimeException('Передача не завершена');
echo "Пачка передана\n";
} finally { ftp_close($ftp); }

Пачка передана

Цикл продолжает ровно текущую операцию; FTP_MOREDATA не означает успех, FTP_FAILED не равен исключению. Пока transfer не завершён, не запускайте новую передачу на том же connection. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$deadline = hrtime(true) + 5_000_000_000;
$state = ftp_nb_put($ftp, 'outgoing/lesson-ftp_nb_put.csv', 'export.csv', FTP_BINARY);
while ($state === FTP_MOREDATA) {
    if (hrtime(true) >= $deadline) throw new RuntimeException('Общий срок передачи истёк');
    $state = ftp_nb_continue($ftp);
}
if ($state !== FTP_FINISHED) throw new RuntimeException('Передача не завершена');
echo "Пачка передана\n";
} finally { ftp_close($ftp); }

Пачка передана

hrtime задаёт общий срок, который проверяется между вызовами continue. Сам continue способен ждать сетевой timeout: это не жёсткое прерывание ровно на пятой секунде. Для полного контроля длительности используют отдельный worker/клиент с соответствующим договором. При отказе finally закрывает connection; файл может остаться частичным. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет stream');
fwrite($stream, "sku,qty\nA42,7\n"); rewind($stream);
try {
$state = ftp_nb_fput($ftp, 'outgoing/lesson-ftp_nb_fput.csv', $stream, FTP_BINARY);
while ($state === FTP_MOREDATA) {
    $state = ftp_nb_continue($ftp);
}
if ($state !== FTP_FINISHED) throw new RuntimeException('Передача не завершена');
echo "Пачка передана\n";
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

Пачка передана

Цикл продолжает ровно текущую операцию; FTP_MOREDATA не означает успех, FTP_FAILED не равен исключению. Пока transfer не завершён, не запускайте новую передачу на том же connection. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет stream');
fwrite($stream, "sku,qty\nA42,7\n"); rewind($stream);
try {
$deadline = hrtime(true) + 5_000_000_000;
$state = ftp_nb_fput($ftp, 'outgoing/lesson-ftp_nb_fput.csv', $stream, FTP_BINARY);
while ($state === FTP_MOREDATA) {
    if (hrtime(true) >= $deadline) throw new RuntimeException('Общий срок передачи истёк');
    $state = ftp_nb_continue($ftp);
}
if ($state !== FTP_FINISHED) throw new RuntimeException('Передача не завершена');
echo "Пачка передана\n";
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

Пачка передана

hrtime задаёт общий срок, который проверяется между вызовами continue. Сам continue способен ждать сетевой timeout: это не жёсткое прерывание ровно на пятой секунде. Для полного контроля длительности используют отдельный worker/клиент с соответствующим договором. При отказе finally закрывает connection; файл может остаться частичным. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$state = ftp_nb_get($ftp, 'lesson-continue.csv', 'incoming/stock.csv');
while ($state === FTP_MOREDATA) {
    $state = ftp_nb_continue($ftp);
}
if ($state !== FTP_FINISHED) throw new RuntimeException('Не закончено');
echo file_get_contents('lesson-continue.csv');
} finally { ftp_close($ftp); }

sku,qty
A42,7

Начальную ftp_nb_get вызывают один раз; повтор внутри цикла переоткрывал бы операцию. Количество шагов зависит от размера/сети и не должно использоваться как процент готовности. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$stream = fopen('export.csv', 'rb');
if ($stream === false) throw new RuntimeException('Нет экспорта');
try {
    $state = ftp_nb_fput($ftp, 'outgoing/lesson-continue.csv', $stream);
    while ($state === FTP_MOREDATA) {
        $state = ftp_nb_continue($ftp);
    }
    if ($state !== FTP_FINISHED) throw new RuntimeException('Не отправлено');
    echo "Передача stream завершена\n";
} finally { fclose($stream); }
} finally { ftp_close($ftp); }

Передача stream завершена

При необходимости процент считают по объёму уже обработанного источника и отдельно завершающему подтверждению; позиция stream не доказывает принятие файла получателем. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$names = ftp_nlist($ftp, 'incoming');
if ($names === false) throw new RuntimeException('NLST не выполнен');
echo is_array($names) ? "Получен список имён\n" : "Неверный тип\n";
} finally { ftp_close($ftp); }

Получен список имён

Пустой массив — список без элементов, а не обязательно ошибка. Формат относительных/полных имён зависит от сервера; сначала посмотрите реальные значения на своём стенде. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$names = ftp_nlist($ftp, 'incoming');
if ($names === false) throw new RuntimeException('Нет списка');
foreach ($names as $name) {
    if (str_ends_with(strtolower($name), '.csv')) echo basename($name), "\n";
}
} finally { ftp_close($ftp); }

stock.csv

Ожидается учебная папка с единственным CSV. Расширение в имени не доказывает ни файловый тип, ни содержимое; для типа dir/file используйте MLSD, для данных — последующую проверку. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$lines = ftp_rawlist($ftp, 'incoming');
if ($lines === false) throw new RuntimeException('LIST не выполнен');
foreach ($lines as $line) echo $line, "\n";
} finally { ftp_close($ftp); }

Вывод — строки LIST вашего сервера: Unix ls-подобный либо иной формат. Точные права/дата/владелец меняются, поэтому здесь не заявляется универсальный stdout. В HTML выводите строки через htmlspecialchars. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$lines = ftp_rawlist($ftp, 'incoming', false);
if ($lines === false) throw new RuntimeException('Нет листинга');
if (file_put_contents('lesson-listing.txt', implode("\n", $lines) . "\n") === false) throw new RuntimeException('Нет локального журнала');
echo "Листинг сохранён для диагностики\n";
} finally { ftp_close($ftp); }

Листинг сохранён для диагностики

Не используйте explode(" ")[8] как переносимый парсер: повторные пробелы, имена с пробелами, symlink и Windows LIST нарушают предположение. Журнал храните вне публичной папки. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$entries = ftp_mlsd($ftp, 'incoming');
if ($entries === false) throw new RuntimeException('Сервер не вернул MLSD');
foreach ($entries as $entry) {
    if (($entry['type'] ?? null) === 'file') echo $entry['name'], "\n";
}
} finally { ftp_close($ftp); }

stock.csv

На учебном стенде incoming содержит один файл. type может также обозначать dir, cdir, pdir либо расширение; не считайте всё не-dir обычным файлом. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$entries = ftp_mlsd($ftp, 'incoming');
if ($entries === false) throw new RuntimeException('Нет MLSD');
foreach ($entries as $entry) {
    if (($entry['type'] ?? '') !== 'file' || !str_ends_with($entry['name'] ?? '', '.csv')) continue;
    $size = $entry['size'] ?? null;
    if (!is_string($size) || !ctype_digit($size)) throw new RuntimeException('Нет корректного SIZE fact');
    // This import accepts at most six decimal digits and then a smaller limit.
    if (strlen($size) > 6 || (int)$size > 100_000) throw new RuntimeException('Выгрузка слишком велика');
    echo $entry['name'], ': ', (int)$size, " байт\n";
}
} finally { ftp_close($ftp); }

stock.csv: 14 байт

Facts приходят строками и не обязаны присутствовать все. Ограничение до int-приведения не даёт огромной десятичной строке переполнить прикладной диапазон. Этот фильтр не заменяет ограничение реально скачанного размера и проверку CSV. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$system = ftp_systype($ftp);
if ($system === false) throw new RuntimeException('SYST не поддержан');
echo $system, "\n";
} finally { ftp_close($ftp); }

Типичный ответ UNIX, но значение задаёт сервер. Точный stdout зависит от стенда. Это не надёжный способ определить ОС физического хоста: сервер может эмулировать иной формат. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$system = ftp_systype($ftp);
if ($system === false) throw new RuntimeException('Нет системного идентификатора');
if (str_starts_with(strtoupper($system), 'UNIX')) {
    echo "Включён известный UNIX LIST адаптер\n";
} else {
    echo "Нужен другой адаптер или MLSD\n";
}
} finally { ftp_close($ftp); }

Ожидается одна из двух подписанных ветвей по ответу стенда. SYST — только один признак: формат LIST отдельно фиксируют примерами и проверяют, иначе ложное предположение испортит имена файлов. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$bytes = ftp_size($ftp, 'incoming/stock.csv');
if ($bytes === -1) throw new RuntimeException('SIZE не получен');
echo $bytes, " байт\n";
} finally { ftp_close($ftp); }

14 байт

Нужен учебный файл из 14 ASCII/LF байтов. Ноль — допустимый размер пустого файла, отказ — именно -1; проверка if(!$bytes) смешала бы эти ситуации. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$bytes = ftp_size($ftp, 'incoming/stock.csv');
if ($bytes < 0) throw new RuntimeException('Размер неизвестен: выберите явную политику');
if ($bytes > 100_000) throw new RuntimeException('Превышен лимит импорта');
echo "Предварительный лимит размера пройден\n";
} finally { ftp_close($ftp); }

Предварительный лимит размера пройден

SIZE может быть не поддержан. Файл способен измениться после проверки, поэтому во время/после загрузки также контролируйте фактический объём. Размер не подтверждает содержимое или контрольную сумму. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$timestamp = ftp_mdtm($ftp, 'incoming/stock.csv');
if ($timestamp === -1) throw new RuntimeException('MDTM не получен');
echo gmdate('Y-m-d H:i:s', $timestamp), " UTC\n";
} finally { ftp_close($ftp); }

Вывод зависит от даты файла на стенде. Unix timestamp — число секунд момента времени, собственной локальной зоны у него нет; gmdate форматирует UTC, date использует текущую зону PHP. Стандартный MDTM приходит в UTC. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$before = ftp_mdtm($ftp, 'incoming/stock.csv');
if ($before === -1) throw new RuntimeException('Нет исходной метки');
if (!ftp_get($ftp, 'lesson-mtime.csv', 'incoming/stock.csv')) throw new RuntimeException('Не скачано');
$after = ftp_mdtm($ftp, 'incoming/stock.csv');
echo $after === $before ? "Метка времени не изменилась\n" : "Нужно повторно проверить версию\n";
} finally { ftp_close($ftp); }

Метка времени не изменилась

Для неподвижного учебного файла ожидается первая строка. Равенство mtime не доказывает идентичность: точность времени ограничена, сервер может сохранить старую метку. Для строгой согласованности используйте финальный immutable файл и хеш/манифест от поставщика. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$lines = ftp_raw($ftp, 'FEAT');
if ($lines === null) throw new RuntimeException('Ответ не получен');
foreach ($lines as $line) echo $line, "\n";
} finally { ftp_close($ftp); }

Вывод зависит от FTP сервера: FEAT обычно многострочный. Наличие массива не означает успех команды; сервер может вернуть строку 500/502. Не записывайте пароли/секретные команды в общий журнал. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$lines = ftp_raw($ftp, 'NOOP');
if ($lines === null || $lines === []) throw new RuntimeException('Нет ответа');
$last = $lines[array_key_last($lines)];
echo str_starts_with($last, '200 ') ? "NOOP принят\n" : "Нужен разбор отказа сервера\n";
} finally { ftp_close($ftp); }

NOOP принят

Предусловие: сервер поддерживает стандартный NOOP. Для произвольных команд нужен разбор их допустимых кодов и многострочных ответов; этот тест не универсальный parser всего FTP. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$ok = ftp_site($ftp, 'HELP');
echo $ok ? "SITE HELP принят\n" : "SITE HELP не поддержан\n";
} finally { ftp_close($ftp); }

Это пример для сервера с SITE HELP; вывод зависит от реализации. Возвращается bool, а не текст справки. Если нужны сами строки, применяют ftp_raw($ftp, "SITE HELP"). Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
if (!ftp_site($ftp, 'CHMOD 600 outgoing/lesson-private.txt')) throw new RuntimeException('SITE CHMOD не принят');
echo "Команда прав принята\n";
} finally { ftp_close($ftp); }

Команда прав принята

Нужен свой заранее созданный файл и сервер с SITE CHMOD. Для этой задачи проще ftp_chmod с отдельными параметрами; строка здесь показывает протокол. Пробелы/спецсимволы в именах подчиняются именно серверному parser, не shell escaping PHP. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$ok = ftp_exec($ftp, 'lesson-status');
echo $ok ? "Сервер принял SITE EXEC\n" : "SITE EXEC не поддержан или запрещён\n";
} finally { ftp_close($ftp); }

lesson-status — условное имя, которое заранее реализовал администратор собственного стенда; это не встроенная FTP/PHP команда. На обычном сервере ожидается отказ. Ничего из HTTP ввода не конкатенируется в command. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/ftp-lab.php';
$ftp = openLessonFtp();
try {
$commands = ['status' => 'lesson-status'];
$action = 'status';
if (!array_key_exists($action, $commands)) throw new RuntimeException('Действие запрещено');
if (!ftp_exec($ftp, $commands[$action])) throw new RuntimeException('Сервер не выполнил договорённую команду');
echo "Оговорённое действие принято сервером\n";
} finally { ftp_close($ftp); }

Оговорённое действие принято сервером

Контекст: свой сервер явно предоставляет SITE EXEC lesson-status и возвращает 200. Allowlist не делает опасную команду безопасной сам по себе; команда должна иметь узкие полномочия. Для запуска Python/Node на PHP машине используется иной API exec/proc_open. Это пример для настроенного учебного FTP сервера: здесь проверен синтаксис, успешная серверная операция не заявляется. Условия и файлы перечислены в начале главы; не запускайте на чужом или рабочем каталоге.