Instalar y usar Laravel Valet para Mac OS X

Valet es un software perteneciente al ecosistema de Laravel que sirve para crear de manera cómoda un servidor capaz de ejecutar las aplicaciones PHP. Es excelente porque resulta muy ligero y sencillo de funcionar, pero sobre todo porque trabaja mediante la creación de Virtual Host.

Tener un host virtual para cada proyecto permite que cada uno se encuentre dentro de un dominio independiente. Gracias a tener ese dominio específico para la web, eres capaz de de servir un proyecto de manera similar a como se estaría sirviendo en su propio dominio, en lugar de tenerlos en una carpeta dentro de "localhost", como ocurriría con una instalación básica de Xampp.

Lo único malo de Valet es que está solamente disponible para Mac. Por eso los usuarios de Windows tendrán que usar Homestead o algún software como Laragon.

Instalar Valet

Para instalar Valet tienes que usar el gestor de paquetes de Mac "Homebrew". Comenzamos actualizando la lista de repositorios de estos paquetes con el comando:

brew update

Luego tendrás que instalar PHP, si es que no lo has instalado ya en tu sistema. También es muy sencillo gracias a Homebrew.

brew install php

Ahora, si no tienes Composer (el gestor de dependencias de PHP) instalado, tendrás que Instalar composer con el script de la propia página de Composer. https://getcomposer.org/download/

Para facilitarte la vida en el uso de Composer es una buena idea mover el ejecutable a tu carpeta bin del usuario, para que puedas tener el comando "composer" desde cualquier localización de tu terminal.

mv composer.phar /usr/local/bin/composer

Así quedará instalado de manera global. Si quieres más información sobre el gestor de dependencias de PHP la tienes en el Manual de Composer.

Instalar Valet vía composer

El siguiente paso consiste en instalar el propio Valet, lo que hacemos mediante Composer. Lo realizaremos de manera global a nuestro sistema, para que puedas usar Valet desde cualquier carpeta del disco. Estando en el terminal ejecutamos:

composer global require laravel/valet

Gestionar posibles problemas con el Path y los globales de Composer

En este punto deberías asegurarte que tienes en el path la ruta del binario de composer ~/.composer/vendor/bin porque la necesitarás, para que los ejecutables que hemos instalado de manera global los tengas disponibles en cualquier carpeta de tu terminal.

Podemos comprobar el estado del Path en nuestro sistema con el comando.

echo $PATH

Si no aparece el path que se vería a la carpeta :~/.composer/vendor/bin lo puedes introducir tú mismo. Para eso ejecutamos el siguiente comando:

export PATH=$PATH:~/.composer/vendor/bin

Correr el script de instalación de Valet

Después de tener el proyecto Valet instalado, aún tenemos que correr el script de instalación de Valet, mediante el comando.

valet install 

Instalar MariaDB

Valet no instala MariaDB o MySQL por nosotros. Solamente sirve como servidor web instalando Nginx y permitiendo trabajar al crear cómodamente los host virtuales. De modo que, si queremos usar estos SGBD los tendremos que instalar por nosotros mismos.

Vamos a ver cómo instalar MariaDB, que generalmente lo prefiero a MySQL por estar más alineado con las políticas de software libre. En Mac, lo conseguimos con un par de comandos de Homebrew.

brew install mariadb

Para gestionar el auto-arranque de MariaDB cada vez que el sistema se reinicia, tenemos que lanzar otro comando, que hace uso de una de las utilidades de Homebrew para la gestión de servicios que tienen que permanecer activos.

brew services start mariadb

Uso de Valet en Mac

Ahora se trata de aprender a usar Valet, lo que es bastante sencillo. Básicamente se trata de crear los dominios que sean necesarios, uno para cada proyecto generalmente.

Para ello tendrías dos opciones:

• Comando park: permite registrar un directorio de tu ordenador que contenga varias aplicaciones. Para cada uno de esos directorios se creará un nombre de aplicación a la que puedes acceder desde el navegador con el dominio "nombre_de_directorio.test". Esto se consigue con el comando "valet park" desde donde tengamos todas las aplicaciones que queremos servir.
• Comando link: este comando permite asociar a valet un único directorio como una aplicación. Para ello entramos en la aplicación que tengamos, y estando en la carpeta de esa aplicación concreta lanzamos el comando "valet link". Con ello tendremos el nombre de la aplicación (el directorio donde estábamos) enlazado en el dominio "nombre_de_aplicacion_o_directorio.test"

Es tan sencillo como meterse en la aplicación:

cd mi_aplicacion

Luego lanzar el comando:

valet link

Y acceder al dominio http://mi_aplicacion.test para ver lo que hay en esa carpeta concreta.

El comando "valet park" puede resultar de utilidad para servir muchas aplicaciones que tengas juntas en subdirectorios de una misma carpeta, pero generalmente no tengo todos los sitios web en la misma carpeta raíz, sino que me organizo por proyectos.

Operativas con Valet y gestión de proyectos

Para ver todos los sitios que tienes linkados a Valet puedes ejecutar:

valet links

Para eliminar un proyecto de Valet y dejar de servirlo en un dominio dado, te metes en la carpeta de ese proyecto y ejecutas el comando "valet unlink".

cd mi_proyecto
valet unlink

Exponer públicamente un desarrollo local

Si quieres compartir hacia fuera (por ejemplo para que un cliente pueda ver el estado de un proyecto que tienes en local) puedes lanzar el comando "valet share".

cd mi_proyecto
valet share

Este mismo comando te mostrará la ruta que tienes que comartir con tu cliente, el cual accederá usando un túnel ssh seguro y temporal. Tendrás que mantener el comando activo por el tiempo que desees que esté abierto ese túnel ssh.

Servir los proyectos con HTTPS

Aún te permite servir un dominio con su certificado de seguridad, para tener https en tu servidor de desarrollo local.

valet secure laravel

Conclusión

Con todo esto tienes suficiente para sacarle todo el partido a Valet, una herramienta excelente no solo para desarrollar con Laravel, sino con cualquier herramienta, como Symfony, WordPress, o cualquier sitio estático. Es muy ligera y fácil de usar.

Si tienes Mac, Valet es una buena opción. Si quieres algo mejor todavía, entonces Homestead es estupendo, ya que permite virtualizar un Linux y acercarse más aún al entorno que vas a tener en producción.