Requisitos do Servidor
Antes de instalar o FeedbackPulse SaaS, certifique-se de que seu servidor atende a todos os requisitos a seguir.
Software Necessário
| Software | Versão Mínima | Recomendado | Observações |
|---|---|---|---|
| PHP | 8.4 | 8.4+ | Com as extensões necessárias (veja abaixo) |
| MySQL | 8.0 | 8.0+ | Ou MariaDB 10.6+ |
| Servidor Web | Apache 2.4+ ou Nginx 1.18+ | Nginx | Apache requer mod_rewrite |
| Composer | 2.0+ | Mais recente | Gerenciador de dependências PHP (ou faça upload do vendor/ pré-compilado) |
| Node.js | Não necessário | — | Os assets são pré-compilados |
Hospedagem compartilhada? Se você não puder executar
composer install, faça upload de toda a pastavendor/do pacote baixado. O instalador web verificavendor/autoload.phpe bloqueará a instalação se estiver faltando.
Extensões PHP Necessárias
As seguintes extensões PHP devem estar instaladas e habilitadas:
| Extensão | Finalidade | Comando de Verificação |
|---|---|---|
pdo_mysql | Conexão com banco de dados MySQL | php -m | grep pdo_mysql |
mbstring | Manipulação de strings multibyte | php -m | grep mbstring |
openssl | Criptografia e HTTPS | php -m | grep openssl |
tokenizer | Tokenização de código PHP | php -m | grep tokenizer |
xml | Análise XML | php -m | grep xml |
ctype | Verificação de tipo de caractere | php -m | grep ctype |
json | Codificação/decodificação JSON | php -m | grep json |
bcmath | Matemática de precisão arbitrária | php -m | grep bcmath |
fileinfo | Detecção de tipo de arquivo | php -m | grep fileinfo |
curl | Requisições HTTP (pagamentos, IA, webhooks) | php -m | grep curl |
gd ou imagick | Processamento de imagens | php -m | grep gd |
zip | Compressão de backups | php -m | grep zip |
Instalar Extensões PHP no Ubuntu/Debian
sudo apt update
sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-bcmath \
php8.4-curl php8.4-gd php8.4-zip php8.4-fileinfo php8.4-tokenizer
Instalar Extensões PHP no CentOS/RHEL
sudo dnf install php-mysqlnd php-mbstring php-xml php-bcmath \
php-curl php-gd php-zip php-fileinfo
No Windows (XAMPP/Laragon)
A maioria das extensões vem pré-instalada. Edite o php.ini e descomente as linhas:
extension=pdo_mysql
extension=mbstring
extension=openssl
extension=curl
extension=gd
extension=zip
extension=fileinfo
extension=bcmath
Dica: No Laragon, todas as extensões estão habilitadas por padrão. Certifique-se apenas de estar usando PHP 8.4+.
Permissões de Diretório
O usuário do servidor web (Apache/Nginx) deve ter acesso de escrita nestes diretórios:
| Diretório | Permissão | Finalidade |
|---|---|---|
storage/ | 775 | Logs, cache, sessões, arquivos enviados |
storage/app/public/ | 775 | Uploads públicos de arquivos (logos, fotos) |
storage/framework/cache/ | 775 | Cache da aplicação |
storage/framework/sessions/ | 775 | Arquivos de sessão |
storage/framework/views/ | 775 | Templates Blade compilados |
storage/logs/ | 775 | Logs da aplicação |
bootstrap/cache/ | 775 | Cache de bootstrap do framework |
.env | 644 | Configuração de ambiente (criado pelo instalador) |
Definir Permissões (Linux)
cd /var/www/feedbackpulse-saas
# Definir proprietário para o usuário do servidor web
sudo chown -R www-data:www-data storage bootstrap/cache
# Definir permissões de diretório
sudo chmod -R 775 storage bootstrap/cache
Segurança: Nunca defina permissões para
777. Use775com o proprietário/grupo de usuário correto.
Requisitos de Rede
| Requisito | Finalidade | Necessário? |
|---|---|---|
| Nome de domínio | URL da sua plataforma | Sim |
| Certificado SSL | Criptografia HTTPS | Fortemente recomendado |
| DNS Wildcard (opcional) | Subdomínios de tenant (*.yourdomain.com) | Opcional |
| HTTPS de saída (porta 443) | APIs Stripe, PayPal, OpenAI, OAuth | Sim (para integrações) |
| SMTP de saída (porta 587/465) | Envio de e-mails | Sim |
Especificações Recomendadas do Servidor
| Tenants | CPU | RAM | Disco | Observações |
|---|---|---|---|---|
| 1-10 | 1 vCPU | 1 GB | 20 GB | Hospedagem compartilhada pode funcionar |
| 10-100 | 2 vCPU | 2 GB | 40 GB | VPS recomendado |
| 100-1.000 | 4 vCPU | 4 GB | 80 GB | Considere Redis para cache/fila |
| 1.000+ | 8+ vCPU | 8+ GB | 160+ GB | Redis obrigatório, workers de fila recomendados |
Ambientes de Hospedagem Suportados
Totalmente Suportados
- Provedores VPS: DigitalOcean, Linode, Vultr, AWS EC2, Hetzner
- Servidores gerenciados: Laravel Forge, Ploi, RunCloud, ServerPilot
- Hospedagem compartilhada: cPanel, Plesk, DirectAdmin, CyberPanel, HestiaCP, CloudPanel, AAPanel
- Desenvolvimento local: Laragon (Windows), Valet (macOS), Sail (Docker)
Hospedagem compartilhada? O FeedbackPulse SaaS é 100% compatível com hospedagem compartilhada — mesmo quando
exec()está desabilitado e links simbólicos não são suportados. Consulte o Guia de Hospedagem Compartilhada para instruções passo a passo.
Parcialmente Suportados (com ressalvas)
- Hospedagem WordPress gerenciada: Geralmente não funciona (sem acesso ao PHP CLI, cron restrito)
Não Suportados
- Hospedagem estática: Netlify, Vercel, GitHub Pages (o FeedbackPulse é um app PHP, não estático)
- Serverless: AWS Lambda, Cloudflare Workers (requer sistema de arquivos persistente)
Verificar Seu Servidor
Execute este comando para verificar todos os requisitos de uma vez:
php -v # Deve ser 8.4+
php -m # Verificar todas as extensões
mysql --version # Deve ser 8.0+ (ou MariaDB 10.6+)
composer --version # Deve ser 2.0+
ls -la storage/ # Verificar permissões
Ou simplesmente acesse https://yourdomain.com/install — o instalador web inclui um verificador automático de requisitos que informará exatamente o que está faltando.
Próximos Passos
Todos os requisitos atendidos? Prossiga para:
- Guia de Instalação — configuração completa passo a passo