
Utilitário Bash que audita configurações INI do PHP, pools FPM e configurações de sites para session.upload_progress.enabled e aplica a mitigação da CVE-2026-115560 com backups e rollback.
Um utilitário Bash autónomo para localizar configurações PHP e aplicar a mitigação temporária recomendada pelo projeto PHP:
session.upload_progress.enabled = 0
Status (2026-10-24): mitigação temporária, não um patch de segurança do PHP. Em 2026-10-23, o projeto PHP recomendou desativar o progresso de upload de sessão do PHP até a próxima versão regular de correção de bugs para tratar um cenário improvável de RCE. A configuração de aplicação afetada envolve session.serialize_handler definido como php_binary / php_serialize na configuração, e depois alterado para php em tempo de execução antes de session_start(), enquanto o progresso de upload permanece ativado. Aplicações que não alteram o serializador de sessão em tempo de execução não estão expostas a este cenário específico, de acordo com o aviso do PHP. Este utilitário aplica uma solução alternativa conservadora no nível da configuração; ele não tenta exploração nem varredura de vulnerabilidades.
Revise o script antes de executá-lo como root:
git clone https://github.com/ivst/CVE-2026-115560.git
cd CVE-2026-115560
bash -n php-upload-progress-mitigate.sh
sudo bash php-upload-progress-mitigate.sh --check
sudo bash php-upload-progress-mitigate.sh --apply
# Read the changes; reload validated managed PHP-FPM / Apache services:
sudo bash php-upload-progress-mitigate.sh --apply --reload
sudo bash php-upload-progress-mitigate.sh --check
# Optional: inspect running Docker PHP-FPM configurations as well (read-only):
sudo bash php-upload-progress-mitigate.sh --check --check-docker
Para validar e recarregar de forma controlada os serviços systemd do PHP-FPM e do Apache descobertos, como parte da aplicação da mitigação:
sudo bash php-upload-progress-mitigate.sh --apply --reload
O script identifica mestres PHP-FPM gerenciados por meio de seus PIDs em execução e do systemd MainPID, lê o caminho da configuração a partir do processo mestre, executa o binário FPM correspondente com -t -y <config> e, em seguida, usa systemctl reload apenas se CanReload=yes. O Apache recebe um teste de configuração antes de seu recarregamento gracioso. O helper não sinalizará automaticamente mestres FPM desconhecidos, configurações não verificadas ou serviços que não oferecem suporte a recarregamento; ele imprime avisos e encerra com status 2 quando uma revisão manual é necessária.
Uma reinicialização forçada explícita continua possível com --apply --restart, mas isso não é recomendado para sites em produção, a menos que seja necessário:
sudo bash php-upload-progress-mitigate.sh --apply --restart
Aviso: Mesmo recarregamentos graciosos podem causar erros de curta duração ou encerrar algumas requisições de longa duração. As alterações nos arquivos não são aplicadas automaticamente aos workers em execução, a menos que eles recarreguem ou reiniciem. Este utilitário não pode garantir cobertura completa de containers ou processos gerenciados pelo painel fora dos layouts PHP descobertos. Prefira uma janela de manutenção e confirme as configurações ativas do web-SAPI.
php-upload-progress-mitigate.sh [--check|--apply] [--reload|--restart] [--check-docker] [--root=/offline/root] [--site-root=/path]
php-upload-progress-mitigate.sh --rollback=/absolute/backup/directory [--apply] [--root=/offline/root]
| Flag | Finalidade |
|---|---|
--check | Padrão. Apenas inspeção estática; não modifica arquivos. |
--check-docker | Opcional com --check em host ativo: usa a CLI do Docker para inspecionar PHP-FPM e servidores web embutidos do PHP em contêineres Docker em execução. Sem alterações ou reinicializações. |
--apply | Grava mitigações com backups. Requer root. |
--reload | Com --apply, valida e recarrega de forma graciosa os serviços systemd gerenciados de PHP-FPM/Apache; serviços não suportados/não verificados são ignorados com avisos. |
--restart | Com --apply, valida e reinicia de forma forçada os serviços gerenciados elegíveis. Use apenas quando um reinício forçado for intencional. |
--root=/path | Inspeciona/aplica sobre uma árvore de sistema de arquivos offline; nunca reinicia serviços neste modo. Destinado a testes/manutenção offline. |
--site-root=/path | Adiciona um diretório de site à varredura de substituição somente leitura; repita para vários diretórios. Com --root, este é um caminho dentro da árvore offline (por exemplo, /srv/apps). |
--rollback=/path | Pré-visualiza a restauração de um diretório de backup. Adicione --apply para restaurar os arquivos com backup e remover os arquivos criados por essa execução. Não pode ser combinado com ações de serviço, Docker ou varreduras de sites. |
Códigos de saída: 0 para nenhum aviso detectado, 1 para um erro fatal/de uso, e 2 quando é necessária revisão manual. Uma execução com --apply pode gravar arquivos de mitigação e retornar 2 se encontrar avisos adicionais não tratados.
O script varre layouts comuns usados por Debian/Ubuntu, sistemas da família RHEL, Remi, caminhos padrão de instalação do PHP e painéis de hospedagem comuns, incluindo o runtime interno de aplicações do FASTPANEL (/opt/fphp/php.ini, /opt/fphp/conf.d, /opt/fphp/etc/php-fpm.d). Para árvores INI detectadas, ele grava uma substituição zzzzzz-cve-2026-115560.ini de carregamento tardio, ou edita php.ini quando não existe diretório de varredura. Ele também detecta substituições específicas de SAPI, como php-cli.ini (que o PHP pode carregar em vez de php.ini), e verifica diretórios de varredura irmãos, como /opt/php85/conf.d, usados por instalações gerenciadas por painel. Ele também insere php_admin_value[session.upload_progress.enabled] = 0 nas seções de pool do PHP-FPM detectadas para impedir substituições posteriores por diretório dessa configuração nesses pools.
Backups dos arquivos modificados e um manifesto de alterações são armazenados em:
/var/backups/php-upload-progress/<UTC timestamp>-<PID>/
Apenas arquivos existentes que foram alterados são incluídos no backup. Os backups podem conter segredos da configuração do PHP-FPM e são criados sob um diretório pai restritivo; mantenha-os privados. Cada arquivo original é incluído no backup uma vez por execução, mesmo que seja atualizado mais de uma vez. Novos snapshots usam registros versionados v2 em state.tsv com hashes SHA-256 dos conteúdos original e aplicado, além do dispositivo/inode de destino aplicado, UID/GID, modo, tamanho, hora de modificação e hora de alteração. A hora de acesso é excluída para que a leitura de um destino não a invalide.
Para reverter, use o diretório de backup exato impresso por --apply:
sudo bash php-upload-progress-mitigate.sh --rollback=/var/backups/php-upload-progress/TIMESTAMP-PID
sudo bash php-upload-progress-mitigate.sh --rollback=/var/backups/php-upload-progress/TIMESTAMP-PID --apply