# php_value ignorado no LiteSpeed: migre para .user.ini

Varredura com grep, tabela de conversão de sintaxe, prova de escopo comparando Local Value e Master Value no phpinfo, e o que só o MultiPHP INI Editor resolve.

> Sob LiteSpeed, `php_value` e `php_flag` no `.htaccess` são ignorados porque o PHP roda como processo externo (LSAPI), não como módulo do Apache. O ajuste por pasta vai para `.user.ini`, que leva até 300 segundos para valer por causa do cache `user_ini.cache_ttl`.

João Rizzon · 2026-11-05 · Painéis

---

## O que muda quando o PHP deixa de ser módulo do Apache

No LiteSpeed, o PHP roda como processo externo via LSAPI. A documentação oficial da LiteSpeed é direta sobre a consequência: diretivas `php_value` e `php_flag` dentro de `.htaccess` não são aplicadas, porque elas são sintaxe do `mod_php` (PHP como módulo do Apache) e o LSAPI não lê esse trecho do arquivo. O lugar documentado para ajuste por pasta passa a ser o `.user.ini` ([LiteSpeed, PHP user.ini com cPanel](https://docs.litespeedtech.com/lsws/cp/cpanel/php-user-ini/)).

O resto do `.htaccess` continua valendo. `RewriteRule`, `RewriteCond`, `Redirect`, `Header set`, `ExpiresByType`, `<FilesMatch>` com `deny`, `AddType`: tudo isso é interpretado normalmente. Por isso o sintoma confunde quem mantém carteira de sites: o site não quebra, as URLs amigáveis continuam funcionando, só o limite de upload (ou o `memory_limit`, ou o `max_execution_time`) volta silenciosamente ao valor global.

E há um terceiro grupo, o que não vai funcionar em lugar nenhum dentro da conta: as diretivas de nível `PHP_INI_SYSTEM`. Elas só mudam no `php.ini` daquela versão de PHP, via MultiPHP INI Editor no cPanel ou por pedido ao provedor.

## Um grep que acha todos os php_value da carteira em segundos

Se você tem acesso SSH na conta (ou em várias contas), a varredura leva segundos. Rode na raiz que contém os sites:

```bash
grep -rn --include='.htaccess' -E 'php_value|php_flag|php_admin_value|php_admin_flag' ~/public_html ~/*/public_html
```

O `-n` traz o número da linha, que você vai querer no momento de comentar a diretiva. Se forem contas separadas em revenda, o mesmo comando dentro de cada `/home/usuario/` resolve.

Sem SSH, o Gerenciador de Arquivos do cPanel tem busca por conteúdo, mas é lento para carteira grande. Para quem mantém dezenas de sites, vale rodar a varredura uma vez e guardar a saída em um arquivo: ela vira o checklist da migração.

### Separe cada ocorrência em migra, fica e escala

- **Migra** para `.user.ini`: tudo que for `PHP_INI_PERDIR` ou `PHP_INI_USER` (`upload_max_filesize`, `post_max_size`, `memory_limit`, `max_execution_time`, `max_input_vars`, `max_input_time`, `display_errors`, `error_log`). O `max_input_vars` é `PHP_INI_PERDIR` e funciona no `.user.ini`, apesar da confusão frequente com diretivas de sistema.
- **Fica** no `.htaccess`: rewrite, header, cache, bloqueio, tipo MIME, `php-handler` de versão gerado pelo MultiPHP Manager.
- **Escala** (não resolve dentro da conta): `disable_functions`, `extension`, qualquer coisa marcada como `PHP_INI_SYSTEM`. Vai para o MultiPHP INI Editor ou para um chamado. O `open_basedir` cai nesta pilha por outro motivo: ele é `PHP_INI_ALL`, mas no cPanel costuma estar travado pelo tweak de proteção do servidor, então na prática também depende do provedor.

## De php_value para .user.ini, linha por linha

A tradução é mecânica: tira o prefixo, tira as aspas, usa `=`. Em `php_flag`, `on`/`off` vira `1`/`0`.

| No `.htaccess` (não aplicado sob LSAPI) | No `.user.ini` |
|---|---||
| `php_value upload_max_filesize 64M` | `upload_max_filesize = 64M` |
| `php_value post_max_size 64M` | `post_max_size = 64M` |
| `php_value memory_limit 512M` | `memory_limit = 512M` |
| `php_value max_execution_time 300` | `max_execution_time = 300` |
| `php_value max_input_vars 5000` | `max_input_vars = 5000` |
| `php_flag display_errors on` | `display_errors = 1` |
| `php_value error_log /home/usuario/logs/php.log` | `error_log = /home/usuario/logs/php.log` |

Os valores acima são exemplos de sintaxe, não recomendação de configuração. Use os números que o site já usava.

### Em que pasta o .user.ini precisa estar

Na pasta que precisa do ajuste, e não na raiz por reflexo. O `.user.ini` vale para a pasta onde está e para as subpastas abaixo dela. Se o `php_value` original estava em `/public_html/loja/.htaccess`, o `.user.ini` vai em `/public_html/loja/`. Se estava na raiz, vai na raiz.

Permissão 644, dono o usuário do cPanel. E comente a linha antiga no `.htaccess` em vez de apagar: `# php_value upload_max_filesize 64M -> migrado para .user.ini em AAAA-MM-DD`. Em auditoria futura, você vai agradecer por saber que aquilo foi decisão e não esquecimento.

## Por que o valor novo demora até 300 segundos para aparecer

O PHP não relê o `.user.ini` a cada requisição. Ele mantém um cache controlado por `user_ini.cache_ttl`, cujo padrão do PHP é **300 segundos**. O mecanismo do `.user.ini` em cPanel com LiteSpeed está descrito na [documentação da LiteSpeed](https://docs.litespeedtech.com/lsws/cp/cpanel/php-user-ini/). Nos primeiros cinco minutos depois de criar ou editar o arquivo, o `phpinfo()` pode continuar mostrando o valor antigo. Isso é comportamento esperado, não falha do servidor.

Três coisas encurtam a espera, em ordem de preferência:

- Esperar os 300 segundos e recarregar com cache do navegador desligado.
- Reiniciar o PHP da conta (em cPanel com LiteSpeed, a opção de reiniciar o processo PHP do usuário, quando disponível no painel).
- Em plano gerenciado, pedir o reinício do LSPHP ao provedor. Peça só depois de confirmar a sintaxe, porque na maioria das vezes o problema é um ponto e vírgula ou um `php_value` que sobrou dentro do próprio `.user.ini`.

Outra causa comum de "não pegou": o valor pedido excede o teto global da conta. `memory_limit = 2048M` em um ambiente com teto menor não sobe; o PHP aplica o limite do sistema. Conferir isso é o papel do passo seguinte.

## Provar o escopo com dois phpinfo temporários

Esse é o passo que fecha o chamado antes de ele existir, porque transforma "acho que aplicou" em evidência com data e URL.

### Crie um phpinfo na pasta ajustada e outro na pasta de referência

```bash
echo '<?php phpinfo();' > ~/public_html/zz-info-raiz.php
echo '<?php phpinfo();' > ~/public_html/loja/zz-info-loja.php
```

Nome com prefixo `zz-` para ficar junto no listador e lembrar de remover. Nunca `info.php` ou `phpinfo.php`: esses são varridos por bot o dia inteiro.

### O que Local Value e Master Value dizem sobre o que pegou

Abra os dois no navegador e procure a diretiva com Ctrl+F. A tabela do `phpinfo()` tem duas colunas que resolvem a dúvida:

| Coluna | O que significa na prática |
|---|---||
| Master Value | O valor do `php.ini` da versão de PHP em uso, antes de qualquer ajuste por pasta |
| Local Value | O valor efetivo naquele diretório, já com o `.user.ini` aplicado |

A pasta de referência é qualquer uma sem `.user.ini`: se o `php_value` original estava na raiz, troque `/public_html/` por uma subpasta sem ajuste nenhum. Nessa pasta de referência, Local tem que ser igual a Master; na pasta ajustada (`/public_html/loja/`), Local traz o novo valor e Master segue inalterado. Se Local e Master aparecem iguais nas duas, há três motivos possíveis: o TTL ainda não venceu, o arquivo está na pasta errada, ou a diretiva é `PHP_INI_SYSTEM`.

### Apague os dois phpinfo no mesmo dia

```bash
rm ~/public_html/zz-info-raiz.php ~/public_html/loja/zz-info-loja.php
```

Faça isso no mesmo dia. `phpinfo()` exposto entrega caminho absoluto, extensões carregadas e versão exata: é reconhecimento gratuito para quem procura alvo.

## As diretivas PHP_INI_SYSTEM que o .user.ini não altera

O PHP classifica cada diretiva por onde ela pode ser alterada. `.user.ini` só aceita `PHP_INI_PERDIR` e `PHP_INI_USER`. O que é `PHP_INI_SYSTEM` precisa de mudança no `php.ini` da versão.

| Necessidade | Onde resolver em cPanel + LiteSpeed |
|---|---||
| `upload_max_filesize`, `post_max_size`, `memory_limit`, `max_execution_time` | `.user.ini` na pasta |
| Mesmos valores para a conta inteira | MultiPHP INI Editor, modo básico |
| `disable_functions`, carregar extensão, `open_basedir` (travado pelo tweak do servidor, não pela classificação) | MultiPHP INI Editor, modo editor, ou pedido ao provedor |
| Trocar a versão de PHP de uma pasta | MultiPHP Manager (ele grava o handler no `.htaccess`, e isso continua válido) |

Se o MultiPHP INI Editor não expõe a diretiva, é sinal de que ela está travada no nível do servidor. Aí o chamado é legítimo: descreva a diretiva, o valor desejado, o domínio e o motivo técnico. Com essas quatro informações, o atendimento não precisa pedir dados de volta antes de agir.

## Checklist para padronizar a migração em toda a carteira

- Rodar o `grep` de varredura por conta e salvar a saída datada.
- Classificar cada ocorrência nas três pilhas (migra, fica, escala).
- Criar o `.user.ini` na pasta exata, com os mesmos valores que já estavam em uso.
- Comentar a linha antiga no `.htaccess` com data e motivo.
- Esperar o TTL de 300 segundos antes de concluir qualquer coisa.
- Validar com `phpinfo()` em duas pastas, comparando Local e Master.
- Remover os `phpinfo()` no mesmo dia.
- Registrar no seu padrão interno de setup: todo site novo já nasce com `.user.ini` em vez de `php_value`.

Para quem entrega site novo toda semana, vale incluir um `.user.ini` modelo no boilerplate, com os valores que você usa por padrão e um comentário no topo explicando por que o arquivo existe. Custa um minuto na criação e economiza a investigação inteira seis meses depois, quando outra pessoa da equipe abrir o `.htaccess` e não achar nada.

## A explicação pronta para mandar ao cliente

Quando o cliente pergunta por que "o servidor ignorou a configuração", a explicação longa não ajuda. Mande esta:

> **** O servidor não ignorou nada. Ele mudou o lugar onde essa configuração é lida: o PHP agora roda como processo próprio, então os limites saíram do `.htaccess` e passaram para um arquivo `.user.ini` na pasta do site. Já reescrevi a configuração no formato novo, com os mesmos valores de antes, e validei que o limite está ativo nessa pasta. O restante do `.htaccess`, redirecionamentos e regras de URL, continua funcionando normalmente.

Funciona porque responde à pergunta implícita ("perdi alguma coisa?") antes que ela seja feita, e porque deixa claro que houve verificação e não apenas tentativa.

