📦 Guia de Instalação

✅ OPÇÃO 1: XAMPP (RECOMENDADO - Mais Fácil)

O que é? XAMPP é um pacote completo que instala tudo que você precisa de uma só vez.

🔽 Passo 1: Download

1. Clique no botão abaixo para ir ao site oficial:

📥 Download XAMPP (Site Oficial)

2. Baixe a versão mais recente para Windows
3. O arquivo terá cerca de 150 MB

⚙️ Passo 2: Instalação

1. Execute o arquivo baixado (xampp-windows-x64-X.X.X-installer.exe)
2. Se aparecer aviso do Windows Defender, clique em "Sim"
3. Na tela de componentes, marque apenas: Apache e PHP
4. Escolha a pasta de instalação (recomendado: C:\xampp)
5. Clique em "Next" até concluir
6. Aguarde a instalação (cerca de 2-3 minutos)

🚀 Passo 3: Configurar o Projeto

1. Abra o Windows Explorer
2. Navegue até: C:\xampp\htdocs
3. Crie uma nova pasta chamada: polimix
4. Copie TODOS os arquivos deste sistema para dentro dessa pasta
5. Resultado final: C:\xampp\htdocs\polimix\gerar-cobranca.php

▶️ Passo 4: Iniciar o Servidor

1. Abra o "XAMPP Control Panel"
2. Clique no botão "Start" na linha do Apache
3. O botão ficará verde quando iniciar
4. Se aparecer firewall do Windows, clique em "Permitir acesso"

🎯 Passo 5: Acessar o Sistema

1. Abra o navegador (Chrome, Firefox, Edge, etc.)
2. Digite na barra de endereço:

http://localhost/polimix/gerar-cobranca.php

💻 OPÇÃO 2: PHP Standalone (Para Usuários Avançados)

Quando usar? Se você já tem experiência com linha de comando ou não quer instalar o XAMPP.

🔽 Passo 1: Download

1. Acesse: https://windows.php.net/download/
2. Baixe a versão "Thread Safe" (arquivo ZIP)
3. Extraia o conteúdo para: C:\php

⚙️ Passo 2: Configurar PATH

1. Pressione Windows + R
2. Digite: sysdm.cpl e pressione Enter
3. Vá na aba "Avançado"
4. Clique em "Variáveis de Ambiente"
5. Em "Variáveis do Sistema", encontre "Path"
6. Clique em "Editar" → "Novo"
7. Adicione: C:\php
8. Clique em OK em todas as janelas

✅ Passo 3: Testar

1. Abra um novo PowerShell
2. Digite: php -v
3. Deve mostrar a versão do PHP

🚀 Passo 4: Iniciar o Servidor

1. Navegue até a pasta do projeto
2. Clique duas vezes no arquivo: INICIAR-SERVIDOR.bat
3. Ou abra o PowerShell na pasta e digite: php -S localhost:8000

🎯 Passo 5: Acessar

http://localhost:8000/gerar-cobranca.php

🔧 Problemas Comuns e Soluções

❌ "Porta 80 já está em uso" (XAMPP)

Solução: Outro programa (Skype, IIS) está usando a porta.

• No XAMPP Control Panel, clique em "Config" ao lado do Apache
• Mude a porta para 8080
• Acesse: http://localhost:8080/polimix/gerar-cobranca.php

❌ "php não é reconhecido"

Solução: O PHP não está no PATH ou você não reiniciou o terminal.

• Feche TODOS os terminais abertos
• Abra um novo PowerShell
• Teste: php -v
• Se ainda não funcionar, use a Opção 1 (XAMPP)

❌ "Página não carrega"

Solução: Servidor não está rodando.

• Verifique se o Apache está Start no XAMPP
• Ou se o PHP está rodando no terminal
• Teste: http://localhost - deve aparecer uma página

❌ "Erro ao gerar PIX"

Solução: Adicione &debug=1 na URL para ver detalhes.

• Exemplo: http://localhost/polimix/pagar.php?dados=XXX&debug=1
• Isso mostrará logs detalhados do que está acontecendo