Instalação

O Conn2Flow é instalado por um instalador web: um pacote pequeno que você coloca na pasta pública do site e abre no navegador. Ele baixa o sistema (o Gestor), cria o banco, gera as chaves e o .env, cria o usuário administrador e, no fim, se transforma no ponto de entrada público do site e apaga a si mesmo.

1. Baixe a última versão do instalador

O instalador é publicado no GitHub como instalador.zip (com o instalador.zip.sha256 ao lado), em releases com tag instalador-vX.Y.Z.

Baixar a última versão do instalador

Pelo terminal, este comando sempre busca a versão mais recente e confere a integridade:

TAG=$(curl -fsSL "https://api.github.com/repos/otavioserra/conn2flow/releases?per_page=50" \
  | grep -o '"tag_name": *"instalador-v[^"]*"' | head -1 | sed 's/.*"\(instalador-v[^"]*\)"/\1/')
echo "Versão: $TAG"
curl -fsSLO "https://github.com/otavioserra/conn2flow/releases/download/$TAG/instalador.zip"
curl -fsSLO "https://github.com/otavioserra/conn2flow/releases/download/$TAG/instalador.zip.sha256"
echo "$(cat instalador.zip.sha256)  instalador.zip" | sha256sum -c -

2. Prepare o servidor

O instalador não confere a versão do PHP nem as extensões: se faltar algo, o erro aparece no meio de uma etapa. Garanta antes:

3. Envie e abra o instalador

1. Extraia o instalador.zip dentro da pasta pública do site (ou de uma subpasta, se o site vai morar em /subpasta/).

2. Abra o endereço no navegador (https://seu-dominio/).

3. Chave de segurança: na primeira visita, o instalador grava uma chave aleatória em install-key.txt, na própria pasta, e pede essa chave. Abra o arquivo por FTP, SSH ou pelo gerenciador de arquivos da hospedagem e cole o conteúdo. Isso impede que alguém instale o sistema no seu servidor antes de você.

4. Preencha o formulário

5. O que o instalador faz

1. Valida os campos, o caminho e a conexão com o banco.

2. Baixa o gestor.zip da release gestor-v* mais recente (pela API do GitHub) e confere o gestor.zip.sha256 antes de extrair. Se a API falhar (por exemplo, por limite de requisições), usa uma versão fixa conhecida (gestor-v2.10.1) e registra o aviso no log.

3. Extrai o Gestor na pasta de instalação e cria autenticacoes/<domínio>/ a partir de autenticacoes.exemplo/dominio/:

   • .env, com o banco, o domínio, o URL_RAIZ detectado, o idioma e senhas aleatórias para OPENSSL_PASSWORD e USUARIO_HASH_PASSWORD;

   • o par de chaves RSA em chaves/gestor/ (publica.key/privada.key), protegido por essa senha.

4. Cria o banco:

   • executa controladores/atualizacoes/atualizacoes-banco-de-dados.php (migrações e dados iniciais) e remove a pasta db/ do Gestor;

   • cria ou atualiza o administrador (senha em Argon2id, ou bcrypt se indisponível);

   • deixa o administrador já logado (cookie persistente).

5. Publica o site: troca o index.php do instalador pelo front-controller do Gestor, que aponta para a pasta de instalação.

   • No Apache, grava o .htaccess, com RewriteBase se estiver em subpasta.

   • No Nginx, grava nginx-conn2flow.conf.example na pasta de instalação e testa se o rewrite chega ao PHP.

6. Limpa: apaga src/, views/, assets/, lang/, temp/, o log, a trava e a chave. Por fim, abre a página de sucesso (/instalacao-sucesso/).

Se a pasta de instalação já tiver um Gestor (gestor.php e config.php), o instalador se recusa a continuar (HTTP 409).

Nginx

O .htaccess não vale no Nginx. O arquivo de exemplo gravado na pasta de instalação traz o bloco location que manda todas as requisições para o index.php, com o parâmetro _gestor-caminho. Aplique-o ao virtual host e recarregue o Nginx. O instalador avisa se a sonda de rewrite falhou.

6. Depois de instalar

A configuração do site fica em <pasta de instalação>/autenticacoes/<domínio>/.env. Pontos que o instalador deixa para você:

• E-mail: vem desligado (EMAIL_ACTIVE=false), com noreply@<domínio> e sem senha. Configure EMAIL_HOST, EMAIL_USER, EMAIL_PASS, EMAIL_PORT e EMAIL_SECURE e ligue EMAIL_ACTIVE, senão cadastro, recuperação de senha e formulários não enviam mensagens. Só TLS implícito funciona: use a porta 465 com EMAIL_SECURE=true (comunicacao.php).

• Captcha: vem desligado (CAPTCHA_PROVIDER vazio e USUARIO_RECAPTCHA_ACTIVE=false). Para Cloudflare Turnstile, defina CAPTCHA_PROVIDER=cloudflare-turnstile, TURNSTILE_SITE_KEY e TURNSTILE_SECRET_KEY; para Google reCAPTCHA, CAPTCHA_PROVIDER=google-recaptcha com chaves reais. Os valores USUARIO_RECAPTCHA_* gravados pelo instalador são aleatórios (preenchimento), e não chaves válidas do Google.

• HTTPS: se você respondeu "Não" e depois instalou um certificado, restaure o redirecionamento no .htaccess ou no servidor.

• Rotinas automáticas: o instalador não agenda nada. Registre no agendador do servidor um tick por frequência (php gestor/cron.php frequencia=diario etc.); veja biblioteca cron.php.

A maior parte do .env também pode ser editada pelo painel, em Ambiente.

Solução de problemas

Durante a instalação, os detalhes de cada etapa vão para installer.log, na pasta do instalador. Ele é apagado no final, junto com o resto do instalador.

Veja também

• Como escrever e publicar a documentação