Solução de problemas¶

Comece com o sintoma e depois verifique a camada relevante sem expor as credenciais.

Página em branco ou erro de servidor¶

Verifique o servidor web e os logs de erros PHP.
Confirme se a versão PHP atende aos requisitos.
Verifique a sintaxe PHP:

php -l config.inc.php

Verifique as permissões do arquivo e o caminho de inclusão de PHP.
Confirme se as extensões necessárias estão carregadas.

A conexão com o banco de dados falha¶

Verifique $dbsys, host, porta, nome do banco de dados, nome de usuário, senha e prefixo da tabela. Confirme se o driver PDO correspondente está instalado e teste o acesso à rede ou ao soquete do host do aplicativo.

Não cole credenciais de produção em um problema.

Determine se a falha está no tratamento da sessão ou na verificação de credenciais. Então verifique:

os configurados $auth["session"] e $auth["type"];
disponibilidade do provedor de identidade e TLS;
filtros de usuário, funções, grupos ou atributos;
contas desativadas ou expiradas; e
extensões PHP exigidas pelo método de autenticação.

Mantenha um procedimento de recuperação separado para acesso de administrador.

Os tempos estão errados¶

Verifique o fuso horário da sala, o fuso horário da área, o fuso horário global $timezone, PHP e a transição para o horário de verão. Utilize o fuso horário das salas, não necessariamente o servidor ou administrador.

E-mail não chega¶

Verifique o evento e o tipo de destinatário habilitados e, depois, o endereço do remetente, o método de envio, a conexão SMTP, a autenticação, o TLS e os logs do servidor de e-mail. Teste separadamente a criação, alteração e exclusão.

Uma alteração na configuração não tem efeito¶

As causas comuns incluem:

editando um arquivo padrão em vez de config.inc.php;
alterar padrões de área quando a área existente possui configurações de banco de dados;
editar uma implantação ou site diferente no modo multisite;
cache opcode do PHP; e
uma atribuição de configuração posterior substituindo a anterior.

Colete diagnósticos úteis¶

Registre a versão MRBS, versão PHP, tipo de banco de dados, lista de extensões relevantes, erro exato, página afetada e reprodução mínima. Edite credenciais, identificadores de sessão, endereços de e-mail e dados de reservas privadas.