Instalar Laravel
Guía completa para la instalación y configuración del framework Laravel en alojamiento web y VPS.
Laravel es un framework PHP de código abierto, maduro y diseñado para el desarrollo web moderno. Siguiendo el patrón arquitectónico MVC (Model-View-Controller), ofrece a los desarrolladores una sintaxis elegante, un sólido conjunto de herramientas y un ecosistema muy completo.
Antes de empezar, asegúrate de que Composer — el gestor de dependencias esencial para PHP — esté instalado en tu sistema.
Método 1: Mediante el instalador de Laravel (recomendado)
Es la forma más eficiente de gestionar varios proyectos Laravel.
-
Instala el instalador de Laravel de forma global:
composer global require laravel/installer -
Configura la variable de entorno PATH (para que el comando
laravelsea reconocido):
En Ubuntu/Debian, añade lo siguiente a tu perfil:export PATH="$PATH:$HOME/.config/composer/vendor/bin" source ~/.bashrc -
Crea un nuevo proyecto:
laravel new project_name
Método 2: Instalación mediante Composer create-project
Si prefieres una instalación puntual sin el instalador global, ejecuta este comando en el directorio que desees:
composer create-project laravel/laravel project_name
Configurar el document root
Por defecto, el punto de entrada de Laravel es el directorio /public. Para que tu sitio cargue correctamente, debes apuntar tu servidor web a esta carpeta.
-
Opción A: Actualizar la configuración de hosting (recomendado).
En tu panel de control, cambia el «Document Root» o el «Home Directory» del sitio a/path/to/your/project/public. -
Opción B: Mediante .htaccess (solución alternativa).
Si no puedes modificar el document root, crea un archivo.htaccessen la raíz de tu proyecto:
# .htaccess en la raíz del proyecto
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^$ public/ [L]
RewriteRule ^((?s).*) public/$1 [L]
</IfModule>
A continuación, asegúrate de que el archivo .htaccess predeterminado esté presente dentro de la carpeta /public:
# public/.htaccess
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
</IfModule>
Consejos tras la instalación
- Establecer permisos: para que Laravel funcione sin problemas, el servidor web necesita acceso de escritura a ciertas carpetas:
chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache # para Ubuntu/Debian
- Preparación para producción: para tareas como colas y planificación, considera configurar Supervisor o un Cron job del sistema.
- Documentación oficial: para las últimas novedades y tutoriales en profundidad, visita el sitio oficial: laravel.com
Ayuda
¿Tienes dudas o necesitas ayuda? Escríbenos a través del sistema de tickets — siempre estamos aquí para ayudarte!