Como Criar e Testar o Seu Primeiro Formulário
Este guia vai te ajudar a configurar e testar o PHP Form Manager. Você encontrará instruções para rodar localmente na sua máquina e também diretamente no seu servidor DreamHost. Ambos os métodos utilizam o SQLite para que você não precise configurar um banco de dados MySQL.
---
Opção A: Testar Localmente (Na sua máquina)
Passo 1: Configuração Inicial
Por padrão, a aplicação já vem com o arquivo
config.php configurado para usar o SQLite. Mas para garantir que tudo está certo, verifique estas configurações principais no arquivo config.php:1. Abra o arquivo
config.php no seu editor de código.2. Procure a linha
define('DB_CONNECTION', ...) e garanta que está definida como 'sqlite': define('DB_CONNECTION', 'sqlite');
Passo 2: Iniciar o Servidor Local
O PHP possui um servidor web embutido que é perfeito para testes locais.
1. Abra o terminal (ou prompt de comando).
2. Navegue até a pasta `` do seu projeto:
cd
3. Inicie o servidor embutido do PHP apontando para o localhost na porta 8000:
php -S localhost:8000
4. O servidor agora está rodando! Mantenha esta janela do terminal aberta.
Passo 3: Acessar o Painel Administrativo
1. Abra o seu navegador e acesse: http://localhost:8000/admin/
2. Faça login usando a senha padrão configurada no seu
config.php (normalmente 'admin').3. Uma vez dentro do painel, procure a seção "Criar Novo Formulário" e clique no botão para criar.
4. O sistema irá gerar uma URL de Action (ex:
http://localhost:8000/process.php?id=...). Copie essa URL!---
Opção B: Testar no DreamHost (Servidor em Produção)
Passo 1: Fazer o Deploy para o Servidor
1. Se você já configurou as GitHub Actions (conforme o
DEPLOY_DREAMHOST.md), faça um git push das suas alterações (ou do projeto inicial) para o repositório. O código será enviado automaticamente para a pasta especificada no servidor.2. Importante sobre o
config.php: A rotina de deploy está configurada para preservar o config.php existente no servidor. Portanto, se você alterou a senha no arquivo local, precisará acessar seu servidor via FTP ou SSH e atualizar o arquivo config.php manualmente para refletir a nova senha.Passo 2: Acessar o Painel Administrativo
1. Acesse o seu domínio de produção onde o Form Manager está instalado. Por exemplo:
https://seudominio.com/admin/.2. Faça login usando a senha que está configurada no
config.php que está no servidor.3. Clique em "Criar Novo Formulário" no painel. (Pode deixar "Domínio Permitido" em branco por enquanto ou colocar o domínio do seu site estático).
4. O sistema irá gerar uma URL de Action que se parece com isso:
https://seudominio.com/process.php?id=.... Copie essa URL!---
Passo 4: Criar uma Página HTML de Teste (Válido para ambas as opções)
Agora vamos criar um site estático simples para enviar os dados para o nosso sistema.
1. Crie um arquivo chamado
meu_site.html (pode ser na sua Área de Trabalho).2. Abra o
meu_site.html no seu editor de código e cole o seguinte código HTML.3. MUITO IMPORTANTE: Substitua o valor do atributo
action="" pela URL que você copiou no Passo 3 da Opção A ou B.<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Meu Primeiro Formulário</title>
<style>
body { font-family: sans-serif; max-width: 500px; margin: 2rem auto; padding: 1rem; border: 1px solid #ccc; border-radius: 8px;}
.form-group { margin-bottom: 1rem; }
label { display: block; margin-bottom: 0.5rem; font-weight: bold; }
input[type="text"], input[type="email"], textarea { width: 100%; padding: 0.5rem; border: 1px solid #ccc; border-radius: 4px; box-sizing: border-box;}
button { background-color: #007bff; color: white; padding: 0.75rem 1.5rem; border: none; border-radius: 4px; cursor: pointer; }
button:hover { background-color: #0056b3; }
</style>
</head>
<body>
<h2>Entre em Contato</h2>
<!-- ATENÇÃO: Cole a URL do Form Action gerada no painel aqui no action="" -->
<form action="COLOQUE_A_URL_COPIADA_AQUI" method="POST" enctype="multipart/form-data">
<div class="form-group">
<label for="name">Nome:</label>
<input type="text" id="name" name="name" required>
</div>
<div class="form-group">
<label for="email">E-mail:</label>
<input type="email" id="email" name="email" required>
</div>
<div class="form-group">
<label for="message">Mensagem:</label>
<textarea id="message" name="message" rows="4" required></textarea>
</div>
<div class="form-group">
<label for="file">Anexo (opcional):</label>
<input type="file" id="file" name="attachment">
</div>
<!-- Campo opcional para redirecionar o usuário após o envio. -->
<!-- Se estiver testando no DreamHost, mude para: value="https://seudominio.com/sucesso.html" -->
<!-- <input type="hidden" name="_next" value="http://localhost:8000/admin/sucesso.html"> -->
<button type="submit">Enviar Mensagem</button>
</form>
</body>
</html>
4. Salve o arquivo.
Passo 5: Testar o Envio
1. Dê um clique duplo no arquivo
meu_site.html (ou abra ele no navegador file:///caminho/para/meu_site.html).2. Preencha os campos com dados de teste.
3. Clique em "Enviar Mensagem".
4. Você deverá ver uma mensagem de sucesso na tela (uma resposta JSON ou um redirecionamento, dependendo de como está configurado, o padrão exibirá um JSON
{"status":"success", ...}).Passo 6: Verificar os Dados Salvos
1. Volte para o Painel Administrativo (Local ou no DreamHost).
2. Atualize a página se necessário.
3. Você deverá ver que o número de "Submissions" (Envios) para o seu formulário aumentou.
4. Clique em "View Submissions" para aquele formulário.
5. Você verá os dados que acabou de enviar listados na tabela!
6. Se você enviou um arquivo, o caminho dele aparecerá ali, e você pode checar a pasta
uploads/ para garantir que o arquivo foi salvo corretamente.