Ao configurar um servidor com o MagnusBilling, é essencial garantir que tanto o ambiente PHP quanto o sistema Linux estejam utilizando o fuso horário correto. Este guia explica como fazer essa configuração passo a passo pela linha de comando.
Objetivo
Atualizar e sincronizar as configurações de fuso horário no PHP e no sistema Linux para garantir consistência na data e hora da aplicação e dos registros de log.
Instruções passo a passo
- Localize o arquivo php.ini ativo:
PHP_INI=$(php -i | grep /.+/php.ini -oE)
- Verifique a configuração atual de fuso horário do PHP:
egrep date.timezone $PHP_INI
- Defina o fuso horário desejado (exemplo: Asia/Almaty):
country=Asia city=Almaty
Define o fuso horário para
Asia/Almaty
. Você pode visualizar a lista completa de fusos horários disponíveis executando:
timedatectl list-timezones
no terminal do servidor ou consultando a lista oficial em: Wikipedia – Lista de fusos horários (TZ database). - Atualize o php.ini com o novo fuso horário:
sed -i 's/;date.timezone.*/date.timezone = "$country\/$city"/' $PHP_INI sed -i 's/date.timezone.*/date.timezone = "$country\/$city"/' $PHP_INI
Nota: Pode ser necessário usar sudo para modificar o arquivo.
- Recarregue o Apache para aplicar as mudanças no PHP:
systemctl reload httpd
Verificação: Para confirmar que as alterações foram aplicadas, crie um arquivo PHP com
<?php phpinfo(); ?>
e verifique a seção "date". - Atualize o fuso horário do sistema:
rm -f /etc/localtime ln -s /usr/share/zoneinfo/${country}/${city} /etc/localtime
Atenção: Esta operação pode afetar outros serviços. Recomenda-se executá-la durante uma janela de manutenção.
Solução de Problemas Comuns
- Erro de permissão: Use sudo para comandos que exigem privilégios administrativos
- Fuso horário não atualizado: Verifique se o arquivo php.ini modificado é o que está sendo usado pelo PHP
- Inconsistência entre PHP e sistema: Verifique se não há configurações específicas no código da aplicação
A configuração correta do fuso horário garante que todos os registros de data e hora no MagnusBilling sejam precisos, resultando em relatórios confiáveis e operação consistente do sistema.