Correção de problemas de conexão com banco de dados – iPDV On-premise (XAMPP)
2 min
Criado por Karine Taiza Mendes em 03/11/2026 13:53
Atualizado por Karine Taiza Mendes em 03/11/2026 16:22

1. Objetivo

Documentar o procedimento para identificação e correção de problemas de conexão com o banco de dados em ambientes iPDV On-premise que utilizam XAMPP.

2. Cenário

Em ambientes iPDV On-premise que utilizam XAMPP, foram identificados problemas de conexão com o banco de dados, tanto em conexões realizadas via VPN quanto em conexões locais.

Até o momento, os seguintes clientes apresentaram essa ocorrência:

  • VILLETTE
  • GOLDMEN

3. Como identificar o problema

Quando houver relatos de falha na conexão com o banco de dados, observe o log de eventos do Windows. Se aparecer o log da imagem a seguir, altere o interpretador PHP do XAMPP:

  1. Acesse o Visualizador de Eventos do Windows.
  2. Consulte os logs de eventos do sistema.
  3. Caso seja identificado o log da imagem acima, prossiga com o ajuste de configuração do PHP no XAMPP.

4. Procedimento para correção

A correção consiste em alterar o interpretador PHP utilizado pelo XAMPP, substituindo o handler mod_php pelo handler CGI.

4.1. Para desabilitar o handler mod_php

Localize a configuração abaixo e comente as linhas:

#<FilesMatch "\.php$">
#SetHandler application/x-httpd-php
#</FilesMatch>

4.2. Habilitar o handler CGI

Localize a configuração do handler CGI e habilite-a, deixando o conteúdo da seguinte forma:

<FilesMatch "\.php$">
    SetHandler application/x-httpd-php-cgi
</FilesMatch>
<IfModule actions_module>
    Action application/x-httpd-php-cgi "/php-cgi/php-cgi.exe"
</IfModule>

4.3. Adicionar variável de ambiente

Dentro do bloco <IfModule env_module>, adicione a seguinte configuração:

SetEnv PGSSLMODE "disable"

Essa configuração desabilita o uso de SSL nas conexões realizadas pelo cliente PostgreSQL.

5. Arquivos necessários para o procedimento

Este artigo foi útil para você?
Últimos artigos visitados