Instalar PHP, Composer y Node.js con Homebrew (macOS)

Guía paso a paso para instalar PHP, Composer y Node.js con Homebrew en macOS y preparar un entorno de desarrollo para Laravel.

​

Introducción

El equipo de Laravel ofrece Herd y php.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.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Tras la instalación, en Apple Silicon se añade automáticamente la siguiente línea al archivo de configuración del shell (~/.zprofile, etc.). Si la añades manualmente, recarga la configuración.

eval "$(/opt/homebrew/bin/brew shellenv)"

Verifica la instalación.

brew --version

---

​

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.

   brew install php
   
2. Verifica la versión

   php --version
   

   Si se muestra 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.

   brew install php@8.3
   

   Para cambiar de versión se utiliza brew link.

   brew unlink php
   brew link php@8.3 --force --overwrite
   

   Comprueba la versión actualmente enlazada.

   php --version
   

---

​

Instalación de Composer

1. Instala Composer

   Puedes instalarlo directamente desde Homebrew.

   brew install composer
   
2. Verifica la versión

   composer --version
   
3. Configura la ruta de la instalación global

   Añade ~/.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).

   export PATH="$HOME/.composer/vendor/bin:$PATH"
   

   Aplica la configuración.

   source ~/.zshrc
   

---

​

Instalación de nvm

Node.js se instala por usuario mediante nvm (Node Version Manager). Como se puede gestionar sin permisos de root, 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.

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   
2. Añade líneas al archivo de configuración del shell

   El script de instalación añade automáticamente lo siguiente a ~/.zshrc (o ~/.bashrc). Si no se añade, hazlo manualmente.

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
   [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
   

   Aplica la configuración.

   source ~/.zshrc
   
3. Verifica la instalación

   nvm --version
   

---

​

Instalación de Node.js

1. Instala la versión LTS

   nvm install --lts
   
2. Establece como predeterminada

   Para que se use automáticamente también en sesiones de terminal nuevas, establece la versión por defecto.

   nvm alias default node
   
3. Verifica las versiones

   node --version
   npm --version
   

---

​

Verificar la instalación de Laravel

1. Instala el instalador de Laravel

   composer global require laravel/installer
   
2. Crea un nuevo proyecto

   laravel new my-app
   

   Se inicia una configuración interactiva. Podrás elegir starter kit, autenticación, etc.

3. Arranca el servidor de desarrollo

   cd my-app
   php artisan serve
   

   Accede en el navegador a http://localhost:8000; si aparece la página de bienvenida de Laravel, ya está listo.

---

​

Cómo elegir entre Homebrew y Herd

	Configuración manual con Homebrew	Herd
Público objetivo	Desarrolladores que quieren controlar al detalle versiones y configuración	Principiantes o desarrolladores individuales que quieren empezar rápido
Cambio de versión de PHP	Manual con brew link	Cambio sencillo mediante GUI
Dominio local	Edición manual de /etc/hosts	Configura automáticamente el dominio .test
Gestión de servicios	brew services	Arranque y parada desde la GUI
Personalización	Alta	Limitada

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.