Introducción
El equipo de Laravel ofrece Herd yphp.new para principiantes, pero los ingenieros senior prefieren gestionar cada herramienta por separado con un gestor de paquetes. Puedes controlar tú mismo las versiones y también es fácil alternar diferentes versiones de PHP entre proyectos.
En esta guía se explica cómo instalar PHP, Composer y Node.js (mediante nvm) usando Homebrew hasta llegar al punto en que laravel new funcione.
Entorno objetivo: macOS 13 Ventura o superior. Compatible tanto con Apple Silicon (M1/M2/M3) como con Intel.
Instalación de Homebrew
Homebrew es el gestor de paquetes para macOS. Si aún no lo tienes instalado, ejecuta lo siguiente en la terminal.~/.zprofile, etc.). Si la añades manualmente, recarga la configuración.
Instalación de PHP
1
Instala la última versión de PHP
La fórmula
php de Homebrew apunta siempre a la última versión estable. Laravel 13 requiere PHP 8.3 o superior.2
Verifica la versión
PHP 8.3.x o superior, la instalación es correcta.3
(Opcional) Usar una versión específica
Si quieres gestionar varias versiones de PHP, instala fórmulas con versión.Para cambiar de versión se utiliza Comprueba la versión actualmente enlazada.
brew link.Instalación de Composer
1
Instala Composer
Puedes instalarlo directamente desde Homebrew.
2
Verifica la versión
3
Configura la ruta de la instalación global
Añade Aplica la configuración.
~/.composer/vendor/bin al PATH para poder usar paquetes instalados con composer global require (como el instalador de Laravel).Añade la siguiente línea a ~/.zshrc (o ~/.bashrc).Instalación de nvm
Node.js se instala por usuario mediante nvm (Node Version Manager). Como se puede gestionar sin permisos deroot, encaja bien con herramientas de IA o CLIs que usan paquetes npm globales.
1
Instala nvm
El script de instalación más reciente se puede consultar en el repositorio de GitHub de nvm.
2
Añade líneas al archivo de configuración del shell
El script de instalación añade automáticamente lo siguiente a Aplica la configuración.
~/.zshrc (o ~/.bashrc). Si no se añade, hazlo manualmente.3
Verifica la instalación
Instalación de Node.js
1
Instala la versión LTS
2
Establece como predeterminada
Para que se use automáticamente también en sesiones de terminal nuevas, establece la versión por defecto.
3
Verifica las versiones
Verificar la instalación de Laravel
1
Instala el instalador de Laravel
2
Crea un nuevo proyecto
3
Arranca el servidor de desarrollo
http://localhost:8000; si aparece la página de bienvenida de Laravel, ya está listo.Cómo elegir entre Homebrew y Herd
Si quieres alinear la configuración con el desarrollo en equipo o con entornos CI, o si cambias frecuentemente entre múltiples versiones de PHP, la configuración manual con Homebrew es la más adecuada.