upload

Transfere arquivos entre navegador e hospedagem: upload envia, download baixa e diretórios são entregues como TAR temporário.

ArquivosVersão 1.2.4EstávelAliases: download
lil-terminal

Visão geral

upload transforma o navegador em uma ponte prática de arquivos para hospedagens sem SSH: envia um ou vários arquivos ao diretório atual ou a um diretório escolhido, permite substituição explícita com -f e usa download no caminho inverso. Ao baixar um diretório, um TAR temporário é criado automaticamente; os limites do PHP continuam visíveis como restrições reais da hospedagem.

Transferir arquivos pelo navegador

upload e download transferem diretamente pelo navegador; em implantações, combine-os com arquivos compactados para mover muitos arquivos como um único pacote.

Sintaxe

lil-terminal
upload [dst] [-f]

Referência

upload

escolher e enviar arquivos ao diretório atual

upload <dir>

enviar arquivos para <dir>

<dir> -f

enviar arquivos para <dir> substituindo os de mesmo nome

<file> -f

enviar um arquivo para um caminho exato substituindo o existente

download

arquivar e baixar o diretório atual

download <file>

baixar um arquivo legível

download <dir>

arquivar automaticamente um diretório e baixar o TAR temporário

-n <name>

usar outro nome de download (sem renomear a origem)

Destinos de upload

Sem destino, os arquivos escolhidos são gravados no diretório atual. upload <dir> cria automaticamente um diretório ausente; -f permite substituir arquivos de mesmo nome. upload <file> -f é a forma explícita para substituir um único arquivo em um caminho exato.

Download de diretórios

Um download sem argumentos arquiva o diretório atual; download <dir> faz o mesmo com outro diretório. lil-terminal cria um TAR temporário, envia ao navegador e o remove depois. A árvore de origem não é renomeada nem alterada.

Limites da hospedagem

Um seletor aceita no máximo 20 arquivos. O tamanho efetivo também depende de upload_max_filesize, post_max_size, max_file_uploads, espaço temporário, servidor web, proxy e painel de hospedagem. Uma requisição grande demais pode ser recusada antes de chegar ao PHP.

Segurança

Os nomes são normalizados, os destinos usam o resolvedor normal de caminhos e arquivos existentes são preservados salvo -f explícito. Os tokens expiram rapidamente e não criam uma URL pública reutilizável.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Enviar arquivos para <dir>

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install upload
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install upload -m
Versão pública exata

Instalar exatamente esta versão publicada.

install upload -v 1.2.4
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade upload
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install upload -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Enviar arquivos para <dir>
cd \sandbox | pwd | upload images
sandbox

picker       opens immediately
destination  sandbox/images
Escolher e enviar arquivos ao diretório atual
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
Arquivar automaticamente um diretório e baixar o TAR temporário
download images
archive  images-20260809-a1b2.tar
source   sandbox/images
temporary archive removed after streaming

download é fornecido pelo módulo upload; os dois sentidos de transferência compartilham as mesmas verificações de caminho e segurança.

Upload · directory
download README.txt -n readme-copy.txt
Download started  readme-copy.txt
Source            sandbox/README.txt

download é fornecido pelo módulo upload; os dois sentidos de transferência compartilham as mesmas verificações de caminho e segurança.

Tratar um destino de download inexistente
download \sandbox\missing.txt
Arquivo ou diretório não encontrado

download é fornecido pelo módulo upload; os dois sentidos de transferência compartilham as mesmas verificações de caminho e segurança.

Arquivo usado neste exemplo: sandbox/tmp/README.txt

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /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.

Documentação relacionada

Como as operações no sistema de arquivos são protegidas? →Por que arquivos grandes e saídas extensas são limitados? →

Versão pública atual

v1.2.42026-08-09

Sincronização linguística

Conclui a sincronização da ajuda local e do servidor e reforça a segurança de localização de upload.

# Histórico de versões