Saltar al contenido principal

​
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 [email protected]
Para cambiar de versión se utiliza brew link.
brew unlink php
brew link [email protected] --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 HomebrewHerd
Público objetivoDesarrolladores que quieren controlar al detalle versiones y configuraciónPrincipiantes o desarrolladores individuales que quieren empezar rápido
Cambio de versión de PHPManual con brew linkCambio sencillo mediante GUI
Dominio localEdición manual de /etc/hostsConfigura automáticamente el dominio .test
Gestión de serviciosbrew servicesArranque y parada desde la GUI
PersonalizaciónAltaLimitada
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.
Última modificación el 13 de julio de 2026

Temas relacionados

Instalar PHP, Composer y Node.js con WSL (Windows)InstalaciónLaravel SailEmpaquetar Copilot CLILaravel Reverb