Instalación Laravel 6x

Author
By Darío Rivera
Posted on 2019-07-01 in Laravel

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 install

El 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!.


Si te ha gustado este artículo puedes invitarme a tomar una taza de café


Acerca de Darío Rivera

Author

Ingeniero de desarrollo en PlacetoPay , Medellín. Darío ha trabajado por más de 6 años en lenguajes de programación web especialmente en PHP. Creador del microframework DronePHP basado en Zend y Laravel.

Sólo aquellos que han alcanzado el éxito saben que siempre estuvo a un paso del momento en que pensaron renunciar.