`upload`

Передаёт файлы между браузером и хостингом: upload загружает, download скачивает, а каталоги выдаются как временный TAR.

ФайлыВерсия 1.2.4СтабильнаяАлиасы: download

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/uploadpicker opens immediately destination current directoryupload tmp -fpicker opens immediately destination sandbox/tmp replace same-named filesdownload imagesarchive images-20260809-a1b2.tar source sandbox/images temporary archive removed after streaming

Обзор

upload и download дают прямой обмен файлами через браузер без FTP и SSH. Можно загрузить несколько файлов в выбранный каталог, явно разрешить замену через -f, а каталог при скачивании автоматически получить одним временным TAR-архивом.

Передача файлов через браузер

Для пары файлов достаточно прямого upload/download. При развёртывании большого набора выгоднее передать один архив, а уже на хостинге распаковать или заменить нужное дерево командами архива.

Синтаксис

lil-terminal

upload [dst] [-f]

Справочник

upload

выбрать и загрузить файлы в текущий каталог

upload <dir>

загрузить файлы в <dir>

<dir> -f

загрузить файлы в <dir> с заменой одноимённых файлов

<file> -f

загрузить один файл по точному пути с заменой существующего

download

заархивировать и скачать текущий каталог

download <file>

скачать доступный для чтения файл

download <dir>

автоматически упаковать каталог и скачать временный TAR-архив

-n <name>

использовать другое имя скачивания (без переименования исходника)

Назначение загрузки

Без аргумента выбранные файлы записываются в текущий каталог. upload <dir> автоматически создаёт отсутствующий каталог; -f разрешает заменить там одноимённые файлы. upload <file> -f — явная форма для замены одного файла по точному пути.

Скачивание каталогов

Обычный download архивирует текущий каталог, а download <dir> — указанный. lil-terminal создаёт временный TAR, передаёт его браузеру и удаляет после отправки. Исходное дерево при этом не переименовывается и не меняется.

Ограничения хостинга

За один выбор принимается не более 20 файлов. Реальный предел размера зависит также от upload_max_filesize, post_max_size, max_file_uploads, временного места, веб-сервера, прокси и панели хостинга. Слишком большой запрос может быть отклонён ещё до запуска PHP.

Безопасность

Имена файлов нормализуются, а назначения проходят общий механизм разрешения путей lil-terminal. Существующие файлы сохраняются, пока -f не указан явно. Токены передачи быстро истекают и не создают повторно используемую публичную ссылку.

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Загрузить файлы в <dir>

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install upload

Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install upload -m

Точная публичная версия

Установить именно эту опубликованную версию.

install upload -v 1.2.4

Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade upload

Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install upload -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Загрузить файлы в <dir>

cd \sandbox | pwd | upload images

sandbox

picker       opens immediately
destination  sandbox/images

Выбрать и загрузить файлы в текущий каталог

upload

picker       opens immediately
destination  current directory

Upload · folder

upload tmp -f

picker       opens immediately
destination  sandbox/tmp
replace      same-named files

Upload · exact

upload tmp/replacement.txt -f

tmp/
  replacement.txt

Автоматически упаковать каталог и скачать временный TAR-архив

download images

archive  images-20260809-a1b2.tar
source   sandbox/images
temporary archive removed after streaming

download предоставляет модуль upload; загрузка в обе стороны использует общий набор проверок путей и передачи файлов.

Upload · directory

download README.txt -n readme-copy.txt

Download started  readme-copy.txt
Source            sandbox/README.txt

Обработать отсутствующий файл для скачивания

download \sandbox\missing.txt

Файл или каталог не найден

Файл из примера: `sandbox/tmp/README.txt`

Пример использует файл или каталог из защищённой учебной папки /sandbox/.

lil-terminal sandbox temporary workspace

Commands in the public documentation use this directory for disposable copies,
archives, uploads and files created during examples. Review destructive commands
before running them and restore the sandbox from the release package when needed.

Связанная документация

Как защищены файловые операции? →Почему ограничены большие файлы и объём вывода? →

Текущая публичная версия

v1.2.42026-08-09

Синхронизация языков

Завершена синхронизация локальной и серверной справки и усилена безопасность локализации upload.

# История версий

upload