Instalación Laravel 6x
Laravel ha demostrado ser uno de los frameworks con más acogida entre los desarrolladores experimentados en PHP. No solamente por su estilo elegante de código sino también por implementar una gran cantidad de patrones de diseño y herramientas avanzadas de programación. En este post abordaremos únicamente la instalación de Laravel dejando a tarea del lector investigar sobre las características más importantes del framework y su comparación con otros frameworks de PHP.
Uno de los aspectos más interesantes de Laravel a manera muy personal, es que no se da a conocer tan rápido como el desarrollador esperaría, en lugar de ello, poco a poco a medida que se aprende a utilizarlo se puede apreciar su gran valor y lo sofisticado de su uso. Aquellos desarrolladores que han utilizado otros frameworks como Zend, Symfony, Cake o incluso Codeigniter, encontrarán que Laravel tiene un estilo particular (lujoso) de programación. Veamos a continuación cómo podemos instalar Laravel 6x.
Requerimientos
Para instalar Laravel debes tener en cuenta los siguientes requerimientos.
- PHP >= 7.2.5
- Composer
Adicional debes tener las siguientes librerías de PHP habilitadas..
- BCMath
- Ctype
- Fileinfo
- JSON
- Mbstring
- OpenSSL
- PDO
- Tokenizer
- XML
Además de esto debes tener los siguientes módulos de apache habilitados
- mod_rewrite
Opcionalmente puedes requierer de los siguientes paquetes de software.
- Apache 2
- MySQL >=5.7
Puedes ver también los artículos relacionados con la instalación de Apache, PHP y MySQL según el sitema operativo que utilices.
- Instalar Apache, PHP y MySQL en Ubuntu 20.04 (Focal Fossa)
- Instalar Apache, PHP y MySQL en Debian 10 (Buster)
- Instalar Apache, PHP y MySQL en Arch Linux
Creación de un proyecto Laravel
Existen básicamente dos formas de crear un proyecto en Laravel. La primera consisten en utilizar un paquete llamado Laravel Installer. La segunda forma consiste en utilizar solamente composer.
Crear un nuevo proyecto con Laravel installer
Después de tener instalado composer debes asegurarte que esten debidamente configurados los binarios de composer para poder ejecutar estos comandos de manera global. Según el sistema operativo que tengas instalado debería agregarse la siguiente ruta a la variable PATH.
| Win | %USERPROFILE%\AppData\Roaming\Composer\vendor\bin |
| GNU/Linux | $HOME/.config/composer/vendor/bin |
| MacOS | $HOME/.composer/vendor/bin |
Una vez verificados los requerimientos en la máquina en donde instalaremos Laravel debes instalar globalmente Laravel Installer. Para esto basta con ejecutar el siguiente comando en consola:
composer global require laravel/installer
Una vez hecho esto tendrás a disposición el comando laravel. Para crear un nuevo proyecto en laravel puedes ejecutar el siguiente comando:
laravel new my_new_project
Debes tener en cuenta que este comando siempre creará un proyecto con la última versión de laravel, por lo que cuando salga la versión 7.x se creará un proyecto con esta versión. Si todo ha salido bien hasta aquí deberías ver un mensaje en la terminal similar al siguiente
Generating optimized autoload files
> @php -r "file_exists('.env') || copy('.env.example', '.env');"
> @php artisan key:generate --ansi
Application key set successfully.
> Illuminate\Foundation\ComposerScripts::postAutoloadDump
> @php artisan package:discover --ansi
Discovered Package: beyondcode/laravel-dump-server
Discovered Package: fideloper/proxy
Discovered Package: laravel/tinker
Discovered Package: nesbot/carbon
Discovered Package: nunomaduro/collision
Package manifest generated successfully.
Application ready! Build something amazing.
Lo cual indica que puedes saltar más abajo al apartado de configuración puesto que ya se ha instalado las dependencias. También puedes omitir la parte de creación de la key.
Crear un nuevo proyecto solo con composer
Si no deseas utilizar el laravel installer (poco recomendado) aún así puedes crear un nuevo proyecto de laravel con el siguiente comando de composer.
composer create-project --prefer-dist laravel/laravel my_new_project "6.*"
Cualquiera de las dos formas de crear un nuevo proyecto en laravel creará un scaffolding del proyecto con todo lo necesario para comenzar nuestro desarrollo.
Configuración
Debido a que laravel utiliza algunas carpetas para generar cache, vistas y otras utilidades, es necesario asignar los permisos necesarios.
chmod -R a+w storage
chmod a+w bootstrap/cache
Pasos para proyectos ya creados
Ten en cuenta que algunos pasos de la instalación de un proyecto en Laravel son automatizados cuando se crea un nuevo proyecto. Si ya tienes un proyecto en Laravel subido a GitHub, Bitbucket, GitLab u otros, y lo descargas para instalarlo deberás seguir estos pasos.
El primer paso consisten en instalar las dependencias.
composer installEl siguiente paso consiste en realizar una copia del archivo de configuración del entorno. A modo de ejemplo, en laravel viene incorporado el archivo .env.example que contiene las configuraciones necesarias para que la aplicación funcione de manera correcta.
cp .env.example .env
Finalmente, debemos generar una llave única para la aplicación que servirá también para cifrar ciertos datos manejados por el framework.
php artisan key:generate
Al ejecutar este comando, laravel configurará de manera automática un valor similar al siguiente en el archivo de configuración .env.
APP_KEY=base64:8veiqlPhUQlfvofFGfARw7M4tHvqumRT223tXoq5JDz0=
Ejecutar la aplicación
Para ver nuestra aplicación en ejecución basta con utilizar el siguiente comando en la raíz del proyecto.
php artisan serve
Después de esto accederemos por lo general a la aplicación en la dirección 127.0.0.1:8000 o en el puerto que el artisan encuentre libre.
Si deseas que laravel funcione en nuestro web server wamp, lamp o instalación personalizada de Apache y PHP necesitas una configuración adicional. Puedes revisar el siguiente post si deseas configurar un virtual host para Laravel en Apache.
- Configurar virtual host en Laravel con Apache
En este punto, sabremos que hemos realizado correctamente la instalación si vemos la pantalla principal de nuestra aplicación en la dirección de nuestro localhost. Hasta pronto!.