blog
Painéis

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.

JR · · 7 min de leitura · 3 tabelas · 3 blocos de código

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
  1. O que muda quando o PHP deixa de ser módulo do Apache
  2. Um grep que acha todos os php_value da carteira em segundos
  3. De php_value para .user.ini, linha por linha
  4. Por que o valor novo demora até 300 segundos para aparecer
  5. Provar o escopo com dois phpinfo temporários
  6. As diretivas PHP_INI_SYSTEM que o .user.ini não altera
  7. Checklist para padronizar a migração em toda a carteira
  8. 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

  1. 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.
  2. Fica no .htaccess: rewrite, header, cache, bloqueio, tipo MIME, php-handler de versão gerado pelo MultiPHP Manager.
  3. 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.
Triagem de cada php_value encontradoVarreduragrep por php_value no .htaccessMigraPERDIR e USER vao ao .user.iniFicaRewrite, header, cache, handlerEscalaPHP_INI_SYSTEM vai ao provedor
Cada ocorrencia encontrada pelo grep cai em uma das tres pilhas.

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:

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.

Da migracao a prova de que o valor pegouCriar .user.iniNa pasta exata, permissao 644Comentar .htaccessLinha antiga com data e motivoEsperar TTLCache do user.ini vence depoisValidarLocal contra Master em duas pastasRemover phpinfoNo mesmo dia, sem excecao
Sequencia reutilizavel para cada site da carteira.

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

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

  1. Documentação oficial (litespeed) — PHP user.ini (LiteSpeed com cPanel). Consultado em 2026-09-28.
Leia também