Requisitos del Servidor
Antes de instalar FeedbackPulse SaaS, asegúrate de que tu servidor cumpla todos los siguientes requisitos.
Software Requerido
| Software | Versión Mínima | Recomendado | Notas |
|---|---|---|---|
| PHP | 8.4 | 8.4+ | Con las extensiones requeridas (ver abajo) |
| MySQL | 8.0 | 8.0+ | O MariaDB 10.6+ |
| Servidor Web | Apache 2.4+ o Nginx 1.18+ | Nginx | Apache requiere mod_rewrite |
| Composer | 2.0+ | Última versión | Gestor de dependencias PHP (o sube el vendor/ precompilado) |
| Node.js | No requerido | — | Los recursos están precompilados |
¿Alojamiento compartido? Si no puedes ejecutar
composer install, sube la carpetavendor/completa del paquete descargado. El instalador web comprueba la existencia devendor/autoload.phpy bloqueará la instalación si no está presente.
Extensiones PHP Requeridas
Las siguientes extensiones PHP deben estar instaladas y habilitadas:
| Extensión | Propósito | Comando de Verificación |
|---|---|---|
pdo_mysql | Conexión a la base de datos MySQL | php -m | grep pdo_mysql |
mbstring | Manejo de cadenas multibyte | php -m | grep mbstring |
openssl | Cifrado y HTTPS | php -m | grep openssl |
tokenizer | Tokenización de código PHP | php -m | grep tokenizer |
xml | Análisis de XML | php -m | grep xml |
ctype | Verificación de tipos de caracteres | php -m | grep ctype |
json | Codificación/decodificación JSON | php -m | grep json |
bcmath | Matemáticas de precisión arbitraria | php -m | grep bcmath |
fileinfo | Detección del tipo de archivo | php -m | grep fileinfo |
curl | Solicitudes HTTP (pagos, IA, webhooks) | php -m | grep curl |
gd o imagick | Procesamiento de imágenes | php -m | grep gd |
zip | Compresión de copias de seguridad | php -m | grep zip |
Instalar Extensiones PHP en 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 Extensiones PHP en CentOS/RHEL
sudo dnf install php-mysqlnd php-mbstring php-xml php-bcmath \
php-curl php-gd php-zip php-fileinfo
En Windows (XAMPP/Laragon)
La mayoría de las extensiones están preinstaladas. Edita php.ini y descomenta las líneas:
extension=pdo_mysql
extension=mbstring
extension=openssl
extension=curl
extension=gd
extension=zip
extension=fileinfo
extension=bcmath
Consejo: En Laragon, todas las extensiones están habilitadas por defecto. Solo asegúrate de usar PHP 8.4+.
Permisos de Directorios
El usuario del servidor web (Apache/Nginx) debe tener acceso de escritura en estos directorios:
| Directorio | Permiso | Propósito |
|---|---|---|
storage/ | 775 | Registros, caché, sesiones, archivos subidos |
storage/app/public/ | 775 | Subidas de archivos públicos (logos, fotos) |
storage/framework/cache/ | 775 | Caché de la aplicación |
storage/framework/sessions/ | 775 | Archivos de sesión |
storage/framework/views/ | 775 | Plantillas Blade compiladas |
storage/logs/ | 775 | Registros de la aplicación |
bootstrap/cache/ | 775 | Caché de arranque del framework |
.env | 644 | Configuración de entorno (creado por el instalador) |
Establecer Permisos (Linux)
cd /var/www/feedbackpulse-saas
# Establecer propietario como usuario del servidor web
sudo chown -R www-data:www-data storage bootstrap/cache
# Establecer permisos de directorio
sudo chmod -R 775 storage bootstrap/cache
Seguridad: Nunca establezcas los permisos en
777. Usa775con la propiedad correcta de usuario/grupo.
Requisitos de Red
| Requisito | Propósito | ¿Requerido? |
|---|---|---|
| Nombre de dominio | URL de tu plataforma | Sí |
| Certificado SSL | Cifrado HTTPS | Muy recomendado |
| DNS con comodín (opcional) | Subdominios de inquilino (*.yourdomain.com) | Opcional |
| HTTPS saliente (puerto 443) | APIs de Stripe, PayPal, OpenAI, OAuth | Sí (para integraciones) |
| SMTP saliente (puerto 587/465) | Envío de correos electrónicos | Sí |
Especificaciones de Servidor Recomendadas
| Inquilinos | CPU | RAM | Disco | Notas |
|---|---|---|---|---|
| 1-10 | 1 vCPU | 1 GB | 20 GB | El alojamiento compartido puede funcionar |
| 10-100 | 2 vCPU | 2 GB | 40 GB | Se recomienda VPS |
| 100-1.000 | 4 vCPU | 4 GB | 80 GB | Considera Redis para caché/cola |
| 1.000+ | 8+ vCPU | 8+ GB | 160+ GB | Redis requerido, se recomiendan trabajadores de cola |
Entornos de Alojamiento Compatibles
Totalmente Compatible
- Proveedores de VPS: DigitalOcean, Linode, Vultr, AWS EC2, Hetzner
- Servidores administrados: Laravel Forge, Ploi, RunCloud, ServerPilot
- Alojamiento compartido: cPanel, Plesk, DirectAdmin, CyberPanel, HestiaCP, CloudPanel, AAPanel
- Desarrollo local: Laragon (Windows), Valet (macOS), Sail (Docker)
¿Alojamiento compartido? FeedbackPulse SaaS es 100% compatible con alojamiento compartido — incluso cuando
exec()está deshabilitado y los enlaces simbólicos no son compatibles. Consulta la Guía de Alojamiento Compartido dedicada para instrucciones paso a paso.
Parcialmente Compatible (con limitaciones)
- Alojamiento WordPress administrado: Generalmente no funcionará (sin acceso a PHP CLI, cron restringido)
No Compatible
- Alojamiento estático: Netlify, Vercel, GitHub Pages (FeedbackPulse es una aplicación PHP, no estática)
- Sin servidor: AWS Lambda, Cloudflare Workers (requiere sistema de archivos persistente)
Verificar Tu Servidor
Ejecuta este comando para comprobar todos los requisitos de una vez:
php -v # Debe ser 8.4+
php -m # Comprobar todas las extensiones
mysql --version # Debe ser 8.0+ (o MariaDB 10.6+)
composer --version # Debe ser 2.0+
ls -la storage/ # Comprobar permisos
O simplemente navega a https://yourdomain.com/install — el instalador web incluye un verificador automático de requisitos que te indicará exactamente qué falta.
Próximos Pasos
¿Todos los requisitos cumplidos? Continúa con:
- Guía de Instalación — configuración completa paso a paso