Problemas frecuentes (instalación)

Esta es una pequeña lista de problemas frecuentes en la instalación de FacturaScripts 2021.

COMPOSER ERROR: You need to run: composer install

Usted no ha seguido el tutorial de instalación de FacturaScripts, sino que ha descargado el código fuente a lo loco y sin seguir ni siquiera las propias instrucciones del README.md

404: página no encontrada

Es necesario instalar y activar el mod rewrite en el Apache, así como permitir el uso de .htaccess en la carpeta de FacturaScripts. Generalmente en Ubuntu, o derivados, es necesario modificar el archivo /etc/apache2/apache2.conf y poner AllowOverride All en la carpeta /var/www/html

Página en blanco (no carga el estilo)

Es el mismo problema 404, con la misma solución descrita arriba.

Siempre me carga la página de Plugins o Wizard

Independientemente de la opción del menú que elija, siempre me aparece Admin -> Plugins.

Este comportamiento indica un problema con el mod rewrite del Apache. Es necesario permitir el uso de .htaccess en la carpeta de FacturaScripts. Generalmente en Ubuntu, o derivados, es necesario modificar el archivo /etc/apache2/apache2.conf y poner AllowOverride All en la carpeta /var/www/html

En otros servidores web es recomendable indicar que todo el tráfico lo dirija al archivo index.php, en lugar de a la carpeta. Así FacturaScripts se encarga del enrutado.

Error 500

En algunos hostings como 1and1 es necesario modificar el archivo .htaccess donde pone:

<IfModule mod_rewrite.c>
   RewriteEngine On
   RewriteRule . index.php [L]
</IfModule>

Debe cambiarlo por:

<IfModule mod_rewrite.c>
   RewriteEngine On
   RewriteBase /
   RewriteRule . index.php [L]
</IfModule>

Si el problema persiste vaya al panel de control del hosting o cPanel, busque una sección llamada logs o historial de errores, ahí le dará más información del problema. Si no encuentra una sección así, reflexione sobre los motivos por los que está usando un hosting que ni siquiera le da información sobre errores de ejecución.