Variáveis de Ambiente (.env)

O arquivo .env é o coração da configuração do FeedbackPulse. Ele é criado automaticamente durante a instalação, mas você pode editá-lo manualmente a qualquer momento.

📍 Localização do Arquivo

/var/www/feedbackpulse-saas/.env

⚠️ Segurança: O arquivo .env contém dados sensíveis (senhas do banco de dados, chaves de API). Nunca o comite no controle de versão ou o exponha publicamente. Ele deve ter permissões 640.

🔧 Após Editar o .env

Após fazer alterações, limpe o cache de configuração:

php artisan config:clear
php artisan config:cache  # Opcional: cache para desempenho em produção

📋 Referência Completa de Variáveis

🏠 Configurações da Aplicação

Variável	Padrão	Descrição
`APP_NAME`	`FeedbackPulse`	Nome da plataforma (exibido em e-mails, títulos)
`APP_ENV`	`production`	Ambiente: `production`, `local`, `staging`
`APP_KEY`	(gerado automaticamente)	Chave de criptografia. Nunca altere após a instalação!
`APP_DEBUG`	`false`	Exibir erros detalhados. Deve ser `false` em produção!
`APP_URL`	`https://yourdomain.com`	URL completa da sua plataforma (com https)
`APP_LOCALE`	`en`	Idioma padrão
`APP_FALLBACK_LOCALE`	`en`	Idioma de fallback
`BCRYPT_ROUNDS`	`12`	Força do hash de senha (maior = mais lento, mas mais seguro)

⚠️ APP_DEBUG=true vai expor informações sensíveis (credenciais do banco de dados, chaves de API) nas páginas de erro. Nunca habilite em produção, exceto para sessões breves de depuração.

🗄️ Banco de Dados

Variável	Padrão	Descrição
`DB_CONNECTION`	`mysql`	Driver do banco de dados: `mysql`, `mariadb`, `sqlite`, `pgsql`
`DB_HOST`	`127.0.0.1`	Endereço do servidor do banco de dados
`DB_PORT`	`3306`	Porta do banco de dados
`DB_DATABASE`	`feedbackpulse`	Nome do banco de dados
`DB_USERNAME`	`root`	Usuário do banco de dados
`DB_PASSWORD`	(vazio)	Senha do banco de dados

📧 E-mail / SMTP

Variável	Padrão	Descrição
`MAIL_MAILER`	`smtp`	Driver de e-mail: `smtp`, `ses`, `postmark`, `sendmail`, `log`
`MAIL_HOST`	`smtp.mailgun.org`	Host do servidor SMTP
`MAIL_PORT`	`587`	Porta SMTP (587 para TLS, 465 para SSL)
`MAIL_USERNAME`	(vazio)	Usuário SMTP
`MAIL_PASSWORD`	(vazio)	Senha SMTP
`MAIL_ENCRYPTION`	`tls`	Criptografia: `tls`, `ssl` ou `null`
`MAIL_FROM_ADDRESS`	`[email protected]`	Endereço de e-mail do remetente
`MAIL_FROM_NAME`	`FeedbackPulse`	Nome do remetente

💳 Stripe (Opcional)

Variável	Padrão	Descrição
`STRIPE_PUBLISHABLE_KEY`	(vazio)	Chave publicável do Stripe (começa com `pk_`)
`STRIPE_SECRET_KEY`	(vazio)	Chave secreta do Stripe (começa com `sk_`)
`STRIPE_WEBHOOK_SECRET`	(vazio)	Segredo de assinatura do webhook do Stripe (começa com `whsec_`)

💰 PayPal (Opcional)

Variável	Padrão	Descrição
`PAYPAL_CLIENT_ID`	(vazio)	Client ID da API REST do PayPal
`PAYPAL_CLIENT_SECRET`	(vazio)	Client secret da API REST do PayPal
`PAYPAL_WEBHOOK_ID`	(vazio)	ID do webhook do PayPal para verificação
`PAYPAL_MODE`	`sandbox`	Modo: `sandbox` (testes) ou `live` (produção)

Variável	Padrão	Descrição
`GOOGLE_CLIENT_ID`	(vazio)	Client ID do OAuth do Google
`GOOGLE_CLIENT_SECRET`	(vazio)	Client secret do OAuth do Google
`GITHUB_CLIENT_ID`	(vazio)	Client ID do OAuth do GitHub
`GITHUB_CLIENT_SECRET`	(vazio)	Client secret do OAuth do GitHub

🤖 IA / OpenAI (Opcional)

Variável	Padrão	Descrição
`OPENAI_API_KEY`	(vazio)	Chave de API da OpenAI para análise de sentimento, auto-tagging e respostas com IA

🤖 reCAPTCHA (Opcional)

Variável	Padrão	Descrição
`RECAPTCHA_SITE_KEY`	(vazio)	Chave de site do Google reCAPTCHA v2/v3
`RECAPTCHA_SECRET_KEY`	(vazio)	Chave secreta do Google reCAPTCHA

🍪 Sessão e Cache

Variável	Padrão	Descrição
`SESSION_DRIVER`	`file`	Armazenamento de sessão: `file`, `database`, `redis`, `cookie`
`SESSION_LIFETIME`	`120`	Timeout da sessão em minutos
`SESSION_DOMAIN`	(vazio)	Domínio do cookie (defina como `.yourdomain.com` para subdomínios)
`SESSION_SECURE_COOKIE`	`true`	Exigir HTTPS para cookies de sessão
`CACHE_STORE`	`file`	Driver de cache: `file`, `database`, `redis`, `memcached`

📦 Fila e Jobs

Variável	Padrão	Descrição
`QUEUE_CONNECTION`	`sync`	Driver de fila: `sync`, `database`, `redis`

⏰ Cron (Hospedagem Compartilhada)

Variável	Padrão	Descrição
`CRON_TOKEN`	(gerado automaticamente)	Token secreto para o endpoint cron via web `/cron/run?token=`. Gerado automaticamente durante a instalação. Obrigatório apenas se usar cron baseado em URL em vez de CLI.

📁 Armazenamento de Arquivos

Variável	Padrão	Descrição
`FILESYSTEM_DISK`	`local`	Disco de armazenamento padrão: `local`, `public`, `s3`

🪵 Logs

Variável	Padrão	Descrição
`LOG_CHANNEL`	`stack`	Canal de log: `stack`, `single`, `daily`, `syslog`
`LOG_LEVEL`	`error`	Nível mínimo de log: `debug`, `info`, `notice`, `warning`, `error`, `critical`

💡 Exemplo de .env para Produção

APP_NAME="FeedbackPulse"
APP_ENV=production
APP_KEY=base64:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
APP_DEBUG=false
APP_URL=https://feedback.mycompany.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=feedbackpulse
DB_USERNAME=fp_user
DB_PASSWORD=super_secure_password_here

SESSION_DRIVER=file
SESSION_LIFETIME=120
SESSION_DOMAIN=.feedback.mycompany.com
SESSION_SECURE_COOKIE=true
CACHE_STORE=file

QUEUE_CONNECTION=sync

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=mailgun_password_here
MAIL_ENCRYPTION=tls
[email protected]
MAIL_FROM_NAME="FeedbackPulse"

STRIPE_PUBLISHABLE_KEY=pk_live_xxxxx
STRIPE_SECRET_KEY=sk_live_xxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxx

OPENAI_API_KEY=sk-xxxxx

LOG_CHANNEL=daily
LOG_LEVEL=error

📍 Localização do Arquivo​

🔧 Após Editar o .env​

📋 Referência Completa de Variáveis​

🏠 Configurações da Aplicação​

🗄️ Banco de Dados​

📧 E-mail / SMTP​

💳 Stripe (Opcional)​

💰 PayPal (Opcional)​

🔑 Login Social (Opcional)​

🤖 IA / OpenAI (Opcional)​

🤖 reCAPTCHA (Opcional)​

🍪 Sessão e Cache​

📦 Fila e Jobs​

⏰ Cron (Hospedagem Compartilhada)​

📁 Armazenamento de Arquivos​

🪵 Logs​

💡 Exemplo de .env para Produção​

⏭️ Próximos Passos​