Laravel Homestead

• Introducción
• Instalación y Configuración
  • Primeros Pasos
  • Configurando Homestead
  • Configurando Sitios Nginx
  • Configurando Servicios
  • Lanzando la Vagrant Box
  • Instalación por Proyecto
  • Instalando Funciones Opcionales
  • Alias
• Actualizando Homestead
• Uso Diario
  • Conectando a través de SSH
  • Agregando Sitios Adicionales
  • Variables de Entorno
  • Puertos
  • Versiones de PHP
  • Conectando a Bases de Datos
  • Copias de Seguridad de Base de Datos
  • Configurando Cronogramas de Cron
  • Configurando Mailpit
  • Configurando Minio
  • Laravel Dusk
  • Compartiendo Tu Entorno
• Depuración y Profilado
  • Depurando Solicitudes Web Con Xdebug
  • Depurando Aplicaciones CLI
  • Profilando Aplicaciones Con Blackfire
• Interfaces de Red
• Extendiendo Homestead
• Configuraciones Específicas del Proveedor
  • VirtualBox

Introducción

Laravel se esfuerza por hacer que toda la experiencia de desarrollo en PHP sea deliciosa, incluyendo tu entorno de desarrollo local. Laravel Homestead es un box de Vagrant oficial y preconfigurado que te proporciona un maravilloso entorno de desarrollo sin requerir que instales PHP, un servidor web o cualquier otro software de servidor en tu máquina local. Vagrant proporciona una forma simple y elegante de gestionar y aprovisionar Máquinas Virtuales. ¡Las cajas de Vagrant son completamente desechables! Si algo sale mal, puedes destruir y recrear la caja en minutos. Homestead funciona en cualquier sistema Windows, macOS o Linux e incluye Nginx, PHP, MySQL, PostgreSQL, Redis, Memcached, Node y todo el software que necesitas para desarrollar increíbles aplicaciones Laravel.

[!WARNING] Si estás utilizando Windows, es posible que necesites habilitar la virtualización de hardware (VT-x). Por lo general, se puede habilitar a través de tu BIOS. Si estás utilizando Hyper-V en un sistema UEFI, es posible que también necesites desactivar Hyper-V para acceder a VT-x.

Software Incluido

Software Opcional

Instalación y Configuración

Primeros Pasos

Antes de lanzar tu entorno Homestead, debes instalar Vagrant así como uno de los siguientes proveedores compatibles:

• VirtualBox 6.1.x
• Parallels Todos estos paquetes de software ofrecen instaladores visuales fáciles de usar para todos los sistemas operativos populares. Para utilizar el proveedor Parallels, necesitarás instalar el plug-in Vagrant de Parallels. Es gratuito.

Instalando Homestead

Puedes instalar Homestead clonando el repositorio de Homestead en tu máquina host. Considera clonar el repositorio en una carpeta Homestead dentro de tu directorio "home", ya que la máquina virtual de Homestead servirá como el host para todas tus aplicaciones Laravel. A lo largo de esta documentación, nos referiremos a este directorio como tu "directorio Homestead":

git clone https://github.com/laravel/homestead.git ~/Homestead

Después de clonar el repositorio de Laravel Homestead, deberías cambiar a la rama release. Esta rama siempre contiene la última versión estable de Homestead:

cd ~/Homestead
 
git checkout release

A continuación, ejecuta el comando bash init.sh desde el directorio de Homestead para crear el archivo de configuración Homestead.yaml. El archivo Homestead.yaml es donde configurarás todas las configuraciones para tu instalación de Homestead. Este archivo se colocará en el directorio de Homestead:

Configurando Homestead

Configurando tu Proveedor

La clave provider en tu archivo Homestead.yaml indica qué proveedor de Vagrant se debe usar: virtualbox o parallels:

provider: virtualbox

[!WARNING] Si estás utilizando Apple Silicon, se requiere el proveedor Parallels.

Configurando Carpetas Compartidas

La propiedad folders del archivo Homestead.yaml lista todas las carpetas que deseas compartir con tu entorno Homestead. A medida que se cambien los archivos dentro de estas carpetas, se mantendrán en sincronía entre tu máquina local y el entorno virtual de Homestead. Puedes configurar tantas carpetas compartidas como sea necesario:

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1

[!WARNING] Los usuarios de Windows no deben utilizar la sintaxis de ruta ~/ y, en su lugar, deben usar la ruta completa a su proyecto, como C:\Users\user\Code\project1. Siempre debes mapear aplicaciones individuales a su propio mapeo de carpeta en lugar de mapear un solo directorio grande que contenga todas tus aplicaciones. Cuando mapeas una carpeta, la máquina virtual debe rastrear toda la entrada y salida de disco para cada archivo en la carpeta. Es posible que experimentes una reducción en el rendimiento si tienes un gran número de archivos en una carpeta:

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1
    - map: ~/code/project2
      to: /home/vagrant/project2

[!WARNING] Nunca debes montar . (el directorio actual) al usar Homestead. Esto provoca que Vagrant no mapee la carpeta actual a /vagrant y romperá funciones opcionales y causará resultados inesperados durante la provisión. Para habilitar NFS, puedes añadir una opción type a tu mapeo de carpetas:

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1
      type: "nfs"

[!WARNING] Al usar NFS en Windows, debes considerar instalar el plug-in vagrant-winnfsd. Este plug-in mantendrá los permisos de usuario / grupo correctos para los archivos y directorios dentro de la máquina virtual Homestead. También puedes pasar cualquier opción soportada por las Carpetas Sincronizadas de Vagrant listándolas bajo la clave options:

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1
      type: "rsync"
      options:
          rsync__args: ["--verbose", "--archive", "--delete", "-zz"]
          rsync__exclude: ["node_modules"]

Configurando Sitios Nginx

¿No estás familiarizado con Nginx? No hay problema. La propiedad sites del archivo Homestead.yaml te permite mapear fácilmente un "dominio" a una carpeta en tu entorno Homestead. Se incluye una configuración de sitio de muestra en el archivo Homestead.yaml. Nuevamente, puedes agregar tantos sitios a tu entorno Homestead como sea necesario. Homestead puede servir como un entorno virtualizado conveniente para cada aplicación Laravel en la que estés trabajando:

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public

Si cambias la propiedad sites después de aprovisionar la máquina virtual Homestead, debes ejecutar el comando vagrant reload --provision en tu terminal para actualizar la configuración de Nginx en la máquina virtual.

[!WARNING] Los scripts de Homestead están diseñados para ser lo más idempotentes posible. Sin embargo, si estás experimentando problemas durante el aprovisionamiento, deberías destruir y reconstruir la máquina ejecutando el comando vagrant destroy && vagrant up.

Resolución de Nombres de Host

Homestead publica nombres de host utilizando mDNS para la resolución automática de host. Si configuras hostname: homestead en tu archivo Homestead.yaml, el host estará disponible en homestead.local. macOS, iOS y distribuciones de escritorio de Linux incluyen soporte de mDNS por defecto. Si estás utilizando Windows, debes instalar Bonjour Print Services para Windows. Usar nombres de host automáticos funciona mejor para instalaciones por proyecto de Homestead. Si alojas múltiples sitios en una sola instancia de Homestead, puedes añadir los "dominios" para tus sitios web al archivo hosts en tu máquina. El archivo hosts redirigirá las solicitudes para tus sitios de Homestead a tu máquina virtual de Homestead. En macOS y Linux, este archivo se encuentra en /etc/hosts. En Windows, se encuentra en C:\Windows\System32\drivers\etc\hosts. Las líneas que agregues a este archivo se verán como las siguientes:

192.168.56.56  homestead.test

Asegúrate de que la dirección IP listada sea la que está configurada en tu archivo Homestead.yaml. Una vez que hayas añadido el dominio a tu archivo hosts y lanzado la caja de Vagrant, podrás acceder al sitio a través de tu navegador web:

http://homestead.test

Configurando Servicios

Homestead inicia varios servicios por defecto; sin embargo, puedes personalizar qué servicios están habilitados o deshabilitados durante el aprovisionamiento. Por ejemplo, puedes habilitar PostgreSQL y deshabilitar MySQL modificando la opción services dentro de tu archivo Homestead.yaml:

services:
    - enabled:
        - "postgresql"
    - disabled:
        - "mysql"

Los servicios especificados se iniciarán o detendrán según su orden en las directivas enabled y disabled.

Lanzando la Caja Vagrant

Una vez que hayas editado el Homestead.yaml a tu gusto, ejecuta el comando vagrant up desde tu directorio de Homestead. Vagrant iniciará la máquina virtual y configurará automáticamente tus carpetas compartidas y sitios de Nginx. Para destruir la máquina, puedes usar el comando vagrant destroy.

Instalación por Proyecto

En lugar de instalar Homestead de forma global y compartir la misma máquina virtual Homestead entre todos tus proyectos, puedes configurar una instancia de Homestead para cada proyecto que gestionas. Instalar Homestead por proyecto puede ser beneficioso si deseas incluir un Vagrantfile con tu proyecto, lo que permite a otros que trabajen en el proyecto ejecutar vagrant up inmediatamente después de clonar el repositorio del proyecto. Puedes instalar Homestead en tu proyecto utilizando el gestor de paquetes Composer:

composer require laravel/homestead --dev

Una vez que Homestead haya sido instalado, invoca el comando make de Homestead para generar el Vagrantfile y el archivo Homestead.yaml para tu proyecto. Estos archivos se colocarán en la raíz de tu proyecto. El comando make configurará automáticamente las directivas sites y folders en el archivo Homestead.yaml:

# macOS / Linux...
php vendor/bin/homestead make
 
# Windows...
vendor\\bin\\homestead make

A continuación, ejecuta el comando vagrant up en tu terminal y accede a tu proyecto en http://homestead.test en tu navegador. Recuerda, aún necesitarás agregar una entrada en el archivo /etc/hosts para homestead.test o el dominio de tu elección si no estás utilizando la resolución de hostname automática.

Instalando Características Opcionales

El software opcional se instala utilizando la opción features dentro de tu archivo Homestead.yaml. La mayoría de las características se pueden habilitar o deshabilitar con un valor booleano, mientras que algunas características permiten múltiples opciones de configuración:

features:
    - blackfire:
        server_id: "server_id"
        server_token: "server_value"
        client_id: "client_id"
        client_token: "client_value"
    - cassandra: true
    - chronograf: true
    - couchdb: true
    - crystal: true
    - dragonflydb: true
    - elasticsearch:
        version: 7.9.0
    - eventstore: true
        version: 21.2.0
    - flyway: true
    - gearman: true
    - golang: true
    - grafana: true
    - influxdb: true
    - logstash: true
    - mariadb: true
    - meilisearch: true
    - minio: true
    - mongodb: true
    - neo4j: true
    - ohmyzsh: true
    - openresty: true
    - pm2: true
    - python: true
    - r-base: true
    - rabbitmq: true
    - rustc: true
    - rvm: true
    - solr: true
    - timescaledb: true
    - trader: true
    - webdriver: true

Elasticsearch

Puedes especificar una versión soportada de Elasticsearch, que debe ser un número de versión exacto (mayor.menor.patch). La instalación predeterminada creará un clúster llamado 'homestead'. Nunca debes dar a Elasticsearch más de la mitad de la memoria del sistema operativo, así que asegúrate de que tu máquina virtual Homestead tenga al menos el doble de la asignación de Elasticsearch.

[!NOTA] Consulta la documentación de Elasticsearch para aprender a personalizar tu configuración.

MariaDB

Habilitar MariaDB eliminará MySQL e instalará MariaDB. MariaDB suele servir como un reemplazo directo de MySQL, por lo que aún deberías usar el driver de base de datos mysql en la configuración de base de datos de tu aplicación.

MongoDB

La instalación predeterminada de MongoDB configurará el nombre de usuario de la base de datos como homestead y la contraseña correspondiente como secret.

Neo4j

La instalación predeterminada de Neo4j configurará el nombre de usuario de la base de datos en homestead y la contraseña correspondiente en secret. Para acceder al navegador de Neo4j, visita http://homestead.test:7474 a través de tu navegador web. Los puertos 7687 (Bolt), 7474 (HTTP) y 7473 (HTTPS) están listos para atender solicitudes del cliente de Neo4j.

Alias

Puedes añadir alias de Bash a tu máquina virtual de Homestead modificando el archivo aliases dentro de tu directorio de Homestead:

alias c='clear'
alias ..='cd ..'

Después de haber actualizado el archivo aliases, deberías reprovisionar la máquina virtual de Homestead utilizando el comando vagrant reload --provision. Esto asegurará que tus nuevos alias estén disponibles en la máquina.

Actualizando Homestead

Antes de comenzar a actualizar Homestead, debes asegurarte de haber eliminado tu máquina virtual actual ejecutando el siguiente comando en tu directorio de Homestead:

vagrant destroy

A continuación, necesitas actualizar el código fuente de Homestead. Si clonaste el repositorio, puedes ejecutar los siguientes comandos en la ubicación donde clonaste originalmente el repositorio:

git fetch
 
git pull origin release

Estos comandos extraen el último código de Homestead del repositorio de GitHub, obtienen las últimas etiquetas y luego registran la última versión etiquetada. Puedes encontrar la última versión estable en la página de lanzamientos de GitHub de Homestead. Si has instalado Homestead a través del archivo composer.json de tu proyecto, debes asegurarte de que tu archivo composer.json contenga "laravel/homestead": "^12" y actualizar tus dependencias:

composer update

A continuación, deberías actualizar la caja de Vagrant utilizando el comando vagrant box update:

vagrant box update

Después de actualizar la caja Vagrant, debes ejecutar el comando bash init.sh desde el directorio de Homestead para actualizar los archivos de configuración adicionales de Homestead. Se te preguntará si deseas sobrescribir tus archivos Homestead.yaml, after.sh y aliases existentes:

# macOS / Linux...
bash init.sh
 
# Windows...
init.bat

Finalmente, necesitarás regenerar tu máquina virtual de Homestead para utilizar la última instalación de Vagrant:

vagrant up

Uso Diario

Conectando mediante SSH

Puedes acceder a tu máquina virtual a través de SSH ejecutando el comando vagrant ssh en la terminal desde tu directorio de Homestead.

Agregar Sitios Adicionales

Una vez que tu entorno de Homestead esté aprovisionado y en funcionamiento, es posible que desees agregar sitios Nginx adicionales para tus otros proyectos Laravel. Puedes ejecutar tantos proyectos Laravel como desees en un solo entorno Homestead. Para agregar un sitio adicional, añade el sitio a tu archivo Homestead.yaml.

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
    - map: another.test
      to: /home/vagrant/project2/public

[!WARNING] Debes asegurarte de que has configurado un mapeo de carpetas para el directorio del proyecto antes de añadir el sitio. Si Vagrant no está gestionando automáticamente tu archivo "hosts", es posible que necesites agregar el nuevo sitio a ese archivo también. En macOS y Linux, este archivo se encuentra en /etc/hosts. En Windows, se ubica en C:\Windows\System32\drivers\etc\hosts:

192.168.56.56  homestead.test
192.168.56.56  another.test

Una vez que se haya añadido el sitio, ejecuta el comando del terminal vagrant reload --provision desde tu directorio de Homestead.

Tipos de Sitio

Homestead admite varios "tipos" de sitios que te permiten ejecutar proyectos que no están basados en Laravel de manera sencilla. Por ejemplo, podemos añadir fácilmente una aplicación Statamic a Homestead utilizando el tipo de sitio statamic:

sites:
    - map: statamic.test
      to: /home/vagrant/my-symfony-project/web
      type: "statamic"

Los tipos de sitio disponibles son: apache, apache-proxy, apigility, expressive, laravel (el predeterminado), proxy (para nginx), silverstripe, statamic, symfony2, symfony4 y zf.

Parámetros del Sitio

Puedes añadir valores fastcgi_param adicionales de Nginx a tu sitio a través de la directiva params del sitio:

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
      params:
          - key: FOO
            value: BAR

Variables de Entorno

Puedes definir variables de entorno globales añadiéndolas a tu archivo Homestead.yaml:

variables:
    - key: APP_ENV
      value: local
    - key: FOO
      value: bar

Después de actualizar el archivo Homestead.yaml, asegúrate de reprovisionar la máquina ejecutando el comando vagrant reload --provision. Esto actualizará la configuración de PHP-FPM para todas las versiones de PHP instaladas y también actualizará el entorno para el usuario vagrant.

Puertos

Por defecto, los siguientes puertos están redirigidos a tu entorno Homestead:

Reenviando Puertos Adicionales

Si lo deseas, puedes redirigir puertos adicionales a la caja de Vagrant definiendo una entrada de configuración ports dentro de tu archivo Homestead.yaml. Después de actualizar el archivo Homestead.yaml, asegúrate de reprovisionar la máquina ejecutando el comando vagrant reload --provision:

ports:
    - send: 50000
      to: 5000
    - send: 7777
      to: 777
      protocol: udp

A continuación se muestra una lista de puertos de servicio adicionales de Homestead que es posible que desees mapear desde tu máquina host a tu caja Vagrant:

Versiones de PHP

Homestead admite la ejecución de múltiples versiones de PHP en la misma máquina virtual. Puedes especificar qué versión de PHP utilizar para un sitio dado dentro de tu archivo Homestead.yaml. Las versiones de PHP disponibles son: "5.6", "7.0", "7.1", "7.2", "7.3", "7.4", "8.0", "8.1", "8.2" y "8.3", (la predeterminada):

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
      php: "7.1"

Dentro de tu máquina virtual Homestead, puedes usar cualquiera de las versiones de PHP soportadas a través de la CLI:

php5.6 artisan list
php7.0 artisan list
php7.1 artisan list
php7.2 artisan list
php7.3 artisan list
php7.4 artisan list
php8.0 artisan list
php8.1 artisan list
php8.2 artisan list
php8.3 artisan list

Puedes cambiar la versión predeterminada de PHP utilizada por la CLI emitiendo los siguientes comandos desde dentro de tu máquina virtual de Homestead:

php56
php70
php71
php72
php73
php74
php80
php81
php82
php83

Conectándose a Bases de Datos

Una base de datos homestead está configurada para MySQL y PostgreSQL de manera predeterminada. Para conectarte a tu base de datos MySQL o PostgreSQL desde el cliente de base de datos de tu máquina host, debes conectarte a 127.0.0.1 en el puerto 33060 (MySQL) o 54320 (PostgreSQL). El nombre de usuario y la contraseña para ambas bases de datos son homestead / secret.

[!WARNING] Solo debes usar estos puertos no estándar al conectar a las bases de datos desde tu máquina host. Utilizarás los puertos 3306 y 5432 por defecto en el archivo de configuración database de tu aplicación Laravel, ya que Laravel se está ejecutando dentro de la máquina virtual.

Copias de Seguridad de Base de Datos

Homestead puede hacer una copia de seguridad de tu base de datos automáticamente cuando se destruye tu máquina virtual Homestead. Para utilizar esta función, debes estar usando Vagrant 2.1.0 o superior. O, si estás utilizando una versión más antigua de Vagrant, debes instalar el plugin vagrant-triggers. Para habilitar las copias de seguridad automáticas de la base de datos, añade la siguiente línea a tu archivo Homestead.yaml:

backup: true

Una vez configurado, Homestead exportará tus bases de datos a los directorios .backup/mysql_backup y .backup/postgres_backup cuando se ejecute el comando vagrant destroy. Estos directorios se pueden encontrar en la carpeta donde instalaste Homestead o en la raíz de tu proyecto si estás utilizando el método instalación por proyecto.

Configurando Programaciones Cron

Laravel ofrece una forma conveniente de programar trabajos cron programando un solo comando Artisan schedule:run para que se ejecute cada minuto. El comando schedule:run examinará el horario de trabajos definido en tu archivo routes/console.php para determinar qué tareas programadas ejecutar. Si deseas que el comando schedule:run se ejecute para un sitio de Homestead, puedes establecer la opción schedule en true al definir el sitio:

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
      schedule: true

El trabajo cron para el sitio se definirá en el directorio /etc/cron.d de la máquina virtual Homestead.

Configuración de Mailpit

Mailpit te permite interceptar tu correo electrónico saliente y examinarlo sin tener que enviar realmente el correo a sus destinatarios. Para comenzar, actualiza el archivo .env de tu aplicación para usar la siguiente configuración de correo:

MAIL_MAILER=smtp
MAIL_HOST=localhost
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

Una vez que Mailpit haya sido configurado, puedes acceder al dashboard de Mailpit en http://localhost:8025.

Configurando Minio

Minio es un servidor de almacenamiento de objetos de código abierto con una API compatible con Amazon S3. Para instalar Minio, actualiza tu archivo Homestead.yaml con la siguiente opción de configuración en la sección features:

minio: true

Por defecto, Minio está disponible en el puerto 9600. Puedes acceder al panel de control de Minio visitando http://localhost:9600. La clave de acceso predeterminada es homestead, mientras que la clave secreta predeterminada es secretkey. Al acceder a Minio, siempre debes usar la región us-east-1. Para usar Minio, asegúrate de que tu archivo .env tenga las siguientes opciones:

AWS_USE_PATH_STYLE_ENDPOINT=true
AWS_ENDPOINT=http://localhost:9600
AWS_ACCESS_KEY_ID=homestead
AWS_SECRET_ACCESS_KEY=secretkey
AWS_DEFAULT_REGION=us-east-1

Para aprovisionar depósitos "S3" impulsados por Minio, añade una directiva buckets a tu archivo Homestead.yaml. Después de definir tus depósitos, debes ejecutar el comando vagrant reload --provision en tu terminal:

buckets:
    - name: your-bucket
      policy: public
    - name: your-private-bucket
      policy: none

Los valores de policy soportados incluyen: none, download, upload y public.

Laravel Dusk

Para ejecutar pruebas de Laravel Dusk dentro de Homestead, debes habilitar la función webdriver en tu configuración de Homestead:

features:
    - webdriver: true

Después de habilitar la función webdriver, debes ejecutar el comando vagrant reload --provision en tu terminal.

Compartiendo tu entorno

A veces es posible que desees compartir en lo que estás trabajando actualmente con compañeros de trabajo o un cliente. Vagrant tiene soporte integrado para esto a través del comando vagrant share; sin embargo, esto no funcionará si tienes múltiples sitios configurados en tu archivo Homestead.yaml. Para resolver este problema, Homestead incluye su propio comando share. Para comenzar, conéctate a tu máquina virtual de Homestead a través de vagrant ssh y ejecuta el comando share homestead.test. Este comando compartirá el sitio homestead.test desde tu archivo de configuración Homestead.yaml. Puedes sustituir cualquiera de tus otros sitios configurados por homestead.test:

share homestead.test

Después de ejecutar el comando, verás aparecer una pantalla de Ngrok que contiene el registro de actividad y las URL de acceso público para el sitio compartido. Si deseas especificar una región personalizada, subdominio u otra opción de ejecución de Ngrok, puedes añadirlas a tu comando share:

share homestead.test -region=eu -subdomain=laravel

Si necesitas compartir contenido a través de HTTPS en lugar de HTTP, usar el comando sshare en lugar de share te permitirá hacerlo.

[!WARNING] Recuerda que Vagrant es inherentemente inseuro y estás exponiendo tu máquina virtual a Internet al ejecutar el comando share.

Depuración y Perfilado

Depurando Solicitudes Web con Xdebug

Homestead incluye soporte para depuración paso a paso utilizando Xdebug. Por ejemplo, puedes acceder a una página en tu navegador y PHP se conectará a tu IDE para permitir la inspección y modificación del código en ejecución. Por defecto, Xdebug ya está en funcionamiento y listo para aceptar conexiones. Si necesitas habilitar Xdebug en la línea de comandos (CLI), ejecuta el comando sudo phpenmod xdebug dentro de tu máquina virtual Homestead. A continuación, sigue las instrucciones de tu IDE para habilitar la depuración. Finalmente, configura tu navegador para activar Xdebug con una extensión o un bookmarklet.

[!WARNING] Xdebug hace que PHP se ejecute significativamente más lento. Para desactivar Xdebug, ejecuta sudo phpdismod xdebug dentro de tu máquina virtual Homestead y reinicia el servicio FPM.

Iniciando Xdebug automáticamente

Al depurar pruebas funcionales que realizan solicitudes al servidor web, es más fácil iniciar la depuración automáticamente en lugar de modificar las pruebas para que pasen a través de un encabezado personalizado o una cookie para activar la depuración. Para forzar a Xdebug a que comience automáticamente, modifica el archivo /etc/php/7.x/fpm/conf.d/20-xdebug.ini dentro de tu máquina virtual Homestead y añade la siguiente configuración:

; If Homestead.yaml contains a different subnet for the IP address, this address may be different...
xdebug.client_host = 192.168.10.1
xdebug.mode = debug
xdebug.start_with_request = yes

Depuración de Aplicaciones CLI

Para depurar una aplicación PHP CLI, utiliza el alias de shell xphp dentro de tu máquina virtual Homestead:

xphp /path/to/script

Perfilando Aplicaciones Con Blackfire

Blackfire es un servicio para perfilar solicitudes web y aplicaciones CLI. Ofrece una interfaz de usuario interactiva que muestra datos de perfil en gráficos de llamadas y líneas de tiempo. Está diseñado para su uso en desarrollo, staging y producción, sin sobrecarga para los usuarios finales. Además, Blackfire proporciona verificaciones de rendimiento, calidad y seguridad en el código y configuraciones php.ini. El Blackfire Player es una aplicación de código abierto para rastreo web, pruebas web y extracción de datos web que puede trabajar junto con Blackfire para crear escenarios de perfilado de scripts. Para habilitar Blackfire, utiliza la configuración "features" en tu archivo de configuración de Homestead:

features:
    - blackfire:
        server_id: "server_id"
        server_token: "server_value"
        client_id: "client_id"
        client_token: "client_value"

Las credenciales del servidor de Blackfire y las credenciales del cliente requieren una cuenta de Blackfire. Blackfire ofrece varias opciones para perfilar una aplicación, incluyendo una herramienta de línea de comandos y una extensión de navegador. Por favor, revisa la documentación de Blackfire para más detalles.

Interfaces de Red

La propiedad networks del archivo Homestead.yaml configura las interfaces de red para tu máquina virtual Homestead. Puedes configurar tantas interfaces como sea necesario:

networks:
    - type: "private_network"
      ip: "192.168.10.20"

Para habilitar una interfaz puenteada, configura una opción bridge para la red y cambia el tipo de red a public_network:

networks:
    - type: "public_network"
      ip: "192.168.10.20"
      bridge: "en1: Wi-Fi (AirPort)"

Para habilitar DHCP, simplemente elimina la opción ip de tu configuración:

networks:
    - type: "public_network"
      bridge: "en1: Wi-Fi (AirPort)"

Para actualizar qué dispositivo está utilizando la red, puedes añadir una opción dev a la configuración de la red. El valor dev predeterminado es eth0:

networks:
    - type: "public_network"
      ip: "192.168.10.20"
      bridge: "en1: Wi-Fi (AirPort)"
      dev: "enp2s0"

Extendiendo Homestead

Puedes extender Homestead utilizando el script after.sh en la raíz de tu directorio de Homestead. Dentro de este archivo, puedes agregar cualquier comando de shell que sea necesario para configurar y personalizar adecuadamente tu máquina virtual. Al personalizar Homestead, Ubuntu puede preguntarte si deseas mantener la configuración original de un paquete o sobrescribirla con un nuevo archivo de configuración. Para evitar esto, debes usar el siguiente comando al instalar paquetes para evitar sobrescribir cualquier configuración escrita previamente por Homestead:

sudo apt-get -y \
    -o Dpkg::Options::="--force-confdef" \
    -o Dpkg::Options::="--force-confold" \
    install package-name

Personalizaciones del Usuario

Al utilizar Homestead con tu equipo, es posible que desees ajustar Homestead para que se adapte mejor a tu estilo de desarrollo personal. Para lograr esto, puedes crear un archivo user-customizations.sh en la raíz de tu directorio de Homestead (el mismo directorio que contiene tu archivo Homestead.yaml). Dentro de este archivo, puedes hacer cualquier personalización que desees; sin embargo, el user-customizations.sh no debe estar bajo control de versiones.

Configuración Específica del Proveedor

VirtualBox

natdnshostresolver

Por defecto, Homestead configura la opción natdnshostresolver en on. Esto permite que Homestead use la configuración de DNS de tu sistema operativo host. Si deseas anular este comportamiento, añade las siguientes opciones de configuración a tu archivo Homestead.yaml:

provider: virtualbox
natdnshostresolver: 'off'