Modificar os parâmetros php.ini em um VPS HestiaCP

Procédure

Para modificar os parâmetros php.ini no HestiaCP, ajuste a configuração da versão PHP-FPM associada ao seu site pela interface ou via SSH e, em seguida, reinicie o serviço. O HestiaCP é um painel de controle de hospedagem open source que permite gerenciar facilmente sites web, bancos de dados e serviços de servidor. Essa operação permite adaptar os recursos das suas aplicações web às suas necessidades reais.

As etapas

1. Identificar a versão PHP atribuída ao domínio

   Conecte-se ao seu painel HestiaCP, vá até a seção WEB e clique no domínio a configurar. Expanda a seção Opções avançadas para verificar a versão ativa definida no campo Modelo backend PHP-FPM (por exemplo PHP-8_3 ou o valor padrão).

   

2. Modificar as diretivas PHP pela interface HestiaCP

   Clique no ícone de configurações do servidor (a engrenagem no canto superior direito), role até o serviço PHP-FPM correspondente à sua versão e, em seguida, abra-o. Altere os campos desejados, como max_execution_time, memory_limit, post_max_size ou upload_max_filesize, e depois clique em Salvar.

   

3. Identificar o caminho do arquivo de configuração php.ini

   Se você precisar intervir pela linha de comando ou inspecionar o arquivo-fonte, visualize os caminhos indicados nas opções avançadas de configuração do serviço PHP. Os arquivos se encontram no seu servidor na estrutura padronizada (por exemplo /etc/php/8.3/fpm/php.ini).

   

4. Criar um backup do arquivo via SSH

   Conecte-se ao seu servidor pela linha de comando com a conta root (por exemplo ssh root@203.0.113.10). Antes de qualquer modificação manual, crie uma cópia de segurança da sua configuração com o comando cp /etc/php/8.3/fpm/php.ini /etc/php/8.3/fpm/php.ini.bak, ajustando o número da versão.

5. Editar o arquivo php.ini e testar a sintaxe

   Abra o arquivo de configuração com o editor de texto executando nano /etc/php/8.3/fpm/php.ini. Modifique seus parâmetros, saia salvando as alterações com o atalho Ctrl+X e depois confirme com O; em seguida, valide a integridade do arquivo usando o comando php-fpm8.3 -t.

6. Reiniciar o PHP-FPM e verificar os valores

   Aplique suas alterações reiniciando o serviço com systemctl restart php8.3-fpm. Para garantir que foram levadas em conta corretamente, crie um arquivo temporário contendo na raiz do seu site, consulte-o no navegador e depois apague-o imediatamente após a verificação.

Diretivas PHP comuns e exemplos de valores

Estes são os parâmetros php.ini mais frequentemente ajustados para atender às exigências de CMS e scripts web.

• memory_limit (ex. 256M ou 512M) — define a quantidade máxima de memória que um script PHP pode alocar para sua execução
• upload_max_filesize (ex. 64M ou 128M) — limita o tamanho máximo permitido para um arquivo individual enviado por meio de um formulário
• post_max_size (ex. 64M ou 128M) — determina o tamanho máximo total dos dados enviados por uma requisição HTTP POST (deve ser maior ou igual a upload_max_filesize)
• max_execution_time (ex. 120 ou 300) — define a duração máxima, em segundos, permitida para a execução de um script antes de sua interrupção

Personalização por pool de domínio e riscos de atualização

Compreender os níveis de personalização no HestiaCP evita conflitos e a perda involuntária de parâmetros.

• Personalização via pool PHP-FPM — permite restringir diretivas a um único site sem modificar o php.ini global do servidor
• Risco de sobrescrita das configurações — os arquivos de configuração gerais podem ser redefinidos ou modificados durante uma atualização maior do pacote PHP do sistema

Perguntas frequentes

Links úteis

• Documentação oficial do HestiaCP
• Documentação PHP sobre as diretivas do php.ini