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.

Resposta curta: 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`.
Neste artigo
- O que muda quando o PHP deixa de ser módulo do Apache
- Um grep que acha todos os php_value da carteira em segundos
- De php_value para .user.ini, linha por linha
- Por que o valor novo demora até 300 segundos para aparecer
- Provar o escopo com dois phpinfo temporários
- As diretivas PHP_INI_SYSTEM que o .user.ini não altera
- Checklist para padronizar a migração em toda a carteira
- A explicação pronta para mandar ao cliente
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).
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:
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 forPHP_INI_PERDIRouPHP_INI_USER(upload_max_filesize,post_max_size,memory_limit,max_execution_time,max_input_vars,max_input_time,display_errors,error_log). Omax_input_varséPHP_INI_PERDIRe funciona no.user.ini, apesar da confusão frequente com diretivas de sistema. - Fica no
.htaccess: rewrite, header, cache, bloqueio, tipo MIME,php-handlerde versão gerado pelo MultiPHP Manager. - Escala (não resolve dentro da conta):
disable_functions,extension, qualquer coisa marcada comoPHP_INI_SYSTEM. Vai para o MultiPHP INI Editor ou para um chamado. Oopen_basedircai 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. 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_valueque 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
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
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
grepde varredura por conta e salvar a saída datada. - Classificar cada ocorrência nas três pilhas (migra, fica, escala).
- Criar o
.user.inina pasta exata, com os mesmos valores que já estavam em uso. - Comentar a linha antiga no
.htaccesscom 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.iniem vez dephp_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:
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.
Referências
- Documentação oficial (litespeed) — PHP user.ini (LiteSpeed com cPanel). Consultado em 2026-09-28.