Instalar o Actualizar PHP en MacOS con Homebrew

▶

En este artículo vamos a aprender cómo instalar y actualizar PHP en macOS usando Homebrew, la forma más sencilla y recomendada actualmente. Aunque macOS incluye por defecto Apache y una versión de PHP, esta suele estar desactualizada, lo que impide trabajar con frameworks modernos como Laravel, que exige versiones recientes de PHP.

Ya por defecto, Mac trae tanto Apache como el módulo de PHP instalado; pero la versión que nos trae generalmente es un poco vieja y por ende la tenemos que actualizar para emplear tecnologías como Laravel que cada vez piden mas y mas.

Comprobar la versión de PHP instalada en macOS

Antes de instalar o actualizar PHP, lo primero es verificar qué versión tienes actualmente:

$ php -v

Este comando mostrará la versión de PHP que está usando tu sistema operativo en ese momento.

¿Por qué usar Homebrew para instalar PHP en Mac?

Existen varias formas de instalar PHP en macOS (paquetes oficiales, compilación manual, etc.), pero Homebrew ofrece grandes ventajas:

• Instalación rápida y automatizada
• Posibilidad de tener múltiples versiones de PHP
• Cambio sencillo entre versiones
• Fácil actualización

Por eso, Homebrew es la opción más utilizada por desarrolladores profesionales.

Instalar PHP en Mac usando Homebrew

Si ya tienes Homebrew instalado, puedes instalar PHP con el siguiente comando:

$ brew install php

Este comando instalará la versión estable más reciente de PHP disponible en Homebrew.

Instalar una versión específica de PHP

Si necesitas una versión concreta (por ejemplo PHP 8.5), puedes hacerlo así:

$ brew install php@8.5

En la actualidad, Homebrew suele ofrecer versiones más recientes como PHP 8.1, 8.5 o superiores.

Enlazar PHP al sistema (brew link)

Después de instalar PHP, necesitas enlazarlo para que macOS lo use como versión principal:

$ brew link php

O si instalaste una versión específica:

$ brew link php@8.5

Si ya existe otra versión enlazada, puedes forzar el enlace con:

$ brew link --overwrite --force php@8.0

Actualizar tu versión de PHP

Ahora, para actualizar nuestro PHP de nuestro sistemas tenemos algunas variantes que van desde instalaciones manuales, pero vamos a usar Homebrew ya que con esto tenemos todo automatizado y sencillo de usar: vamos a instalar el tab o la fórmula.

Como puedes ver en la documentación oficial puedes instalar varias versiones de PHP, yo me voy por la ultima, así que coloco simplemente:

brew install php

O al momento que se grabó este video, la última viene siendo:

brew install php@8.5

Ambos comandos son equivalentes: Ya que el comando anterior de brew link php, te va a instalar la última versión.

Y con esto ya tenemos PHP instalado, ahora tenemos que linkearlo al sistema:

Cambiar entre diferentes versiones de PHP en macOS

Para eso usamos la opción de link:

$ brew link php@8.0
$ brew link php

Una de las mayores ventajas de Homebrew es poder cambiar fácilmente entre versiones de PHP.

Ejemplo:

$ brew unlink php
$ brew link php@8.1

Esto es especialmente útil si trabajas con varios proyectos que requieren distintas versiones.

Ver qué versiones de PHP tienes instaladas

Puedes instalar varias versiones de PHP en tu sistemas e ir cambiando de una a otra fácilmente con el comodín de link; pero, para eso tienes que ver que versiones tienes; para eso tenemos la opción de search que colocas parte del nombre del paquete del que quieres buscar:

$ brew search php

También puedes ver qué versiones tienes instaladas con:

$ brew list | grep php

Y esto es todo, ya que con esto puedes trabajar perfectamente con tu PHP en MacOS.

Ya NO podemos regresar desde la opción de brew a la versión anterior o la del sistema operativo.

Consideraciones importantes

• Una vez que instalas PHP con Homebrew, no puedes volver fácilmente a la versión de PHP incluida en macOS.
• Homebrew administra completamente tu instalación de PHP a partir de ese momento.
• Es la forma recomendada para desarrollo local moderno.
• Recuerda que si en algún momento de ejecutar el comando de brew vez un error como command not found: brew te falta configurar el comando de brew en el PATH del Sistema Operativo.

Error común: command not found: brew

Si al ejecutar un comando de Homebrew ves el error:

command not found: brew

Significa que Homebrew no está configurado en el PATH de tu sistema.

Solución rápida (para macOS con Apple Silicon):

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"

En Macs con Intel:

echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zshrc
eval “$(/usr/local/bin/brew shellenv)”

Conclusión

Ahora ya sabes cómo instalar, actualizar y cambiar versiones de PHP en Mac usando Homebrew. Con esta configuración podrás trabajar sin problemas con Laravel, Symfony, WordPress u cualquier otro framework moderno.

Si quieres aprender Laravel de forma profesional, no olvides revisar mi curso completo.