# Como bloquear PHP na pasta uploads do WordPress no LiteSpeed

Como recusar arquivos .php na pasta de mídia pelo contexto do host virtual e pelo .htaccess, testar com um arquivo inofensivo e evitar os erros que derrubam imagens e uploads.

> no LiteSpeed, crie um contexto estático para /wp-content/uploads/ no host virtual com uma regra que responde 403 a arquivos .php e variantes (sem diferenciar maiúsculas). No LiteSpeed Enterprise, use também um .htaccess na pasta como segunda camada.

João Rizzon · 2026-11-13 · WordPress

---

## Por que um arquivo .php em uploads vira execução de código no site

A pasta `wp-content/uploads` é a única do WordPress em que o próprio site precisa gravar arquivos o tempo todo. Toda imagem, PDF ou vídeo enviado pelo painel vai parar lá. Isso significa que o servidor web tem permissão de escrita nela.

O problema aparece quando alguém consegue colocar um arquivo `.php` ali dentro. Os caminhos mais comuns são um plugin de formulário com falha na validação de anexos, um tema desatualizado ou uma senha de FTP vazada. Se o servidor executa PHP nessa pasta, basta acessar o arquivo pelo navegador para rodar código no seu site.

A pasta uploads não precisa executar PHP para funcionar. Imagens e documentos são servidos como arquivos estáticos. Desligar a execução de scripts ali fecha esse caminho sem afetar o funcionamento normal da biblioteca de mídia.

Um detalhe que costuma gerar medo sem motivo: o envio de mídia no painel não passa por `wp-content/uploads`. Quem recebe o arquivo é o `wp-admin/async-upload.php` (ou a API REST), que roda fora da pasta e só grava o resultado nela. Bloquear PHP em uploads não impede o upload, desde que a regra fique restrita a essa pasta.

## Como o LiteSpeed decide executar um arquivo .php

Segundo a [documentação de Script Handling do LiteSpeed](https://docs.litespeedtech.com/lsws/script/), o servidor associa extensões de arquivo (como `php`) a um manipulador de script, que é o processo que interpreta o código. Quando chega uma requisição, o LiteSpeed olha a extensão e, se houver um manipulador associado, entrega o arquivo para ele em vez de servi-lo como conteúdo estático.

Essa associação pode ser definida no nível do servidor e no nível do host virtual. Na prática, é por isso que existem duas formas de bloquear a execução:

- **No host virtual**, criando um contexto para o caminho `/wp-content/uploads/` com uma regra que recusa arquivos de script. Fica fora do alcance do WordPress e de qualquer plugin.
- **No `.htaccess`** dentro da pasta uploads. Funciona em hospedagem compartilhada, mas é um arquivo que fica justamente na pasta gravável, e pode ser apagado ou sobrescrito.

O ideal é usar as duas camadas quando você tem acesso ao painel do LiteSpeed (WebAdmin), e ficar com o `.htaccess` quando não tem. A exceção é o OpenLiteSpeed: ele não aplica diretivas como `FilesMatch` e `Require` do `.htaccess` e só lê regras de reescrita desse arquivo depois de um reinício. No OpenLiteSpeed, a proteção que vale é o contexto no host virtual.

| Critério | Contexto no host virtual | `.htaccess` em uploads |
|---|---|---||
| Quem precisa ter acesso | Painel WebAdmin do LiteSpeed ou suporte da hospedagem | Gerenciador de arquivos ou FTP |
| Pode ser apagado por plugin ou invasor | Não, fica fora da pasta do site | Sim, está dentro da pasta gravável |
| Depende de o servidor ler `.htaccess` | Não | Sim |
| Exige reinício do servidor | Sim, reinício suave | Não no LiteSpeed Enterprise; no OpenLiteSpeed o bloco `FilesMatch` não é aplicado |
| Indicado para | VPS, servidor dedicado, OpenLiteSpeed | Hospedagem compartilhada com LiteSpeed Enterprise (não serve para OpenLiteSpeed) |

## Antes de mexer: backup e caminho de volta

Nenhuma das duas mudanças apaga dados, mas uma regra escrita no lugar errado pode tirar imagens do ar ou travar o painel. Faça isto antes:

- Baixe uma cópia do `.htaccess` da raiz do site e, se existir, do `.htaccess` dentro de `wp-content/uploads`.
- Se for mexer no WebAdmin, anote ou exporte a configuração atual do host virtual. Muitas instalações guardam um arquivo `vhconf.conf` por host virtual; copie esse arquivo.
- Deixe uma aba aberta com uma imagem antiga do site, para conferir depois se ela continua carregando.

Para desfazer, basta remover o contexto criado (e reiniciar o servidor) ou apagar o `.htaccess` novo de uploads. O site volta ao comportamento anterior.

## Como bloquear PHP pelo contexto do host virtual

Este caminho vale para quem administra o próprio LiteSpeed Web Server ou OpenLiteSpeed. A documentação de Script Handling citada acima cobre só a associação de extensões a manipuladores de script. A criação do contexto Static, a regra de reescrita com `[F]` e o Graceful Restart seguem a interface padrão do WebAdmin e não vêm dessa página: os nomes dos campos podem variar entre versões, então confira cada um na documentação da sua versão antes de salvar.

### Criar o contexto Static para a pasta uploads

No WebAdmin, entre em **Virtual Hosts**, clique no host virtual do site e abra a aba **Context**. Clique em **Add** e escolha o tipo **Static**.

Preencha:

- **URI**: `/wp-content/uploads/` (com barra no início e no fim).
- **Location**: o caminho real da pasta no disco. Exemplo fictício: `$VH_ROOT/html/wp-content/uploads/`. Confira a raiz de documentos do mesmo host virtual e acrescente `/wp-content/uploads/` ao final: o Location é a raiz mais esse trecho, nunca a raiz sozinha.
- **Accessible**: `Yes`. Se ficar `No`, todas as imagens passam a dar erro.

### Recusar arquivos de script com RewriteRule [F,NC]

Antes de escrever a regra, abra **Server Configuration > Script Handler** (ou a lista de manipuladores do host virtual) e anote todos os sufixos associados ao PHP, como `php`, `php5`, `php7`, `pht` ou `phtml`. No mesmo contexto, ative **Enable Rewrite** e coloque esta regra no campo de regras de reescrita, incluindo no padrão qualquer sufixo extra que você encontrou:

```
RewriteRule \.(php[0-9]?|phtml|pht|phar)$ - [F,NC]
```

Linha a linha: `\.(php[0-9]?|phtml|pht|phar)$` casa com arquivos que terminam em `.php`, `.php5`, `.php7`, `.phtml`, `.pht` ou `.phar`; o `-` significa que o endereço não é alterado; `[F]` responde com **403 Forbidden**, ou seja, o servidor recusa a requisição antes de chegar ao PHP; `NC` ignora maiúsculas, então `.PHP` também é recusado. Imagens, PDFs e vídeos não casam com a regra e seguem normais.

### Salvar e aplicar com Graceful Restart

Salve o contexto e use o **Graceful Restart** (reinício suave) no topo do WebAdmin. Sem o reinício, a mudança não entra em vigor e o teste da próxima seção vai parecer que falhou.

## Como bloquear PHP pelo .htaccess em hospedagem compartilhada

Se você não tem acesso ao WebAdmin, que é o caso da maioria das hospedagens compartilhadas, use o gerenciador de arquivos do painel (ou FTP).

- Navegue até `public_html/wp-content/uploads` (o nome da pasta raiz pode variar).
- Veja se já existe um `.htaccess` ali. Arquivos que começam com ponto ficam ocultos; no gerenciador de arquivos procure a opção **Mostrar arquivos ocultos**.
- Se não existir, crie um arquivo chamado `.htaccess` nessa pasta. Se existir, baixe uma cópia e acrescente ao final.
- Cole o bloco abaixo e salve.

```
<FilesMatch "(?i)\.(php[0-9]?|phtml|pht|phar)$">
  Require all denied
</FilesMatch>
```

O bloco diz: para arquivos que terminam em `.php` (ou `.php5`, `.php7`), `.phtml`, `.pht` ou `.phar`, com ou sem maiúsculas, negue o acesso. O `(?i)` é o que ignora maiúsculas. O resultado esperado é o mesmo da regra no host virtual, um **403**.

Esse bloco funciona no LiteSpeed Enterprise, que é o usado na maioria das hospedagens compartilhadas. No OpenLiteSpeed ele é ignorado: o servidor não aplica `FilesMatch` nem `Require` do `.htaccess`. Se o teste abaixo mostrar a frase impressa e o servidor for OpenLiteSpeed, a solução é o contexto no host virtual.

Nunca coloque esse bloco no `.htaccess` da raiz do site. Ali ele bloquearia o `index.php` e o `wp-admin`, e o site inteiro sairia do ar. Se isso acontecer, apague o bloco ou restaure a cópia que você baixou.

Se você não sabe se a sua hospedagem lê `.htaccess` em subpastas, o teste a seguir responde. E se a hospedagem for LiteSpeed com WebAdmin administrado por ela, vale abrir um chamado pedindo o contexto descrito na seção anterior: é uma alteração pequena para o suporte e protege mais do que o `.htaccess` sozinho.

## Como saber se o PHP ainda executa em uploads

O WordPress recusa `.php` pela biblioteca de mídia, então o teste é feito pelo gerenciador de arquivos ou FTP.

- Em `wp-content/uploads`, crie um arquivo chamado `teste-bloqueio.php`.
- Coloque nele só esta linha:

```
<?php echo 'PHP EXECUTOU NESTA PASTA'; ?>
```

- No navegador, abra `https://seusite.com.br/wp-content/uploads/teste-bloqueio.php` (troque pelo seu domínio). Use uma janela anônima para evitar cache.

O arquivo não faz nada além de imprimir uma frase, por isso é seguro. Interprete o resultado assim:

| O que aparece no navegador | O que significa | O que fazer |
|---|---|---||
| Página de erro 403 / Forbidden | Bloqueio funcionando | Nada, só apagar o arquivo de teste |
| O navegador baixa o arquivo ou mostra o código `<?php ...` | PHP não executa, mas o arquivo é entregue | Aceitável, porém prefira o 403; revise a regra |
| A frase PHP EXECUTOU NESTA PASTA | PHP ainda roda em uploads | A regra não está ativa; veja a lista de erros abaixo |
| Erro 404 | Arquivo em outra pasta ou caminho errado | Confira onde o arquivo foi criado |

O único resultado inaceitável é ver a frase impressa. Depois do teste, **apague o `teste-bloqueio.php`**. Arquivo PHP esquecido em uploads é exatamente o que você está tentando evitar.

Por fim, abra a imagem antiga que você deixou na outra aba e envie uma imagem nova pelo painel em **Mídia > Adicionar nova**. As duas precisam funcionar.

## Erros comuns que quebram o envio de mídia

- **Regra aplicada a `wp-content` inteiro.** Plugins e temas ficam em `wp-content/plugins` e `wp-content/themes` e precisam executar PHP. O contexto e o `.htaccess` devem cobrir só `uploads`.
- **Bloco colado no `.htaccess` da raiz.** Derruba o site e o painel. Restaure o backup.
- **Accessible em No no contexto.** Todas as imagens passam a dar erro. Volte para `Yes`.
- **Location apontando para pasta errada.** O contexto passa a servir outro diretório e as imagens retornam 404. O Location é a raiz de documentos do host virtual mais `/wp-content/uploads/`, como no exemplo fictício `$VH_ROOT/html/wp-content/uploads/`.
- **Regra sem a âncora de extensão.** Algo como bloquear tudo em uploads, em vez de só `.php`, impede imagens e PDFs. Mantenha o `\.(php[0-9]?|phtml|pht|phar)$`.
- **Esquecer o reinício suave.** No host virtual, a regra só vale depois do **Graceful Restart**.
- **Cache servindo o resultado antigo.** Se usa LiteSpeed Cache ou CDN, limpe o cache antes de concluir que a regra falhou ou que quebrou algo.
- **Plugin que grava PHP em uploads.** Alguns plugins de backup, formulário ou segurança criam arquivos `.php` dentro de uploads (às vezes um `index.php` vazio só para impedir listagem, o que pode ser bloqueado sem problema). Se um recurso de plugin parar depois da mudança, verifique no gerenciador de arquivos se ele depende de um `.php` em uploads e procure nas configurações do plugin uma opção para mudar a pasta.

Bloquear a execução reduz o estrago de um arquivo malicioso, mas não remove a falha que permitiu o envio. Mantenha plugins e temas atualizados e, se o teste mostrar algum `.php` que você não criou em uploads, trate como sinal de invasão: faça backup, troque senhas e investigue antes de só apagar o arquivo.

