Instalación de PHP en macOS con M1 e Intel usando Homebrew

Curso Básico de PHP: Instalación, Fundamentos y Operadores

Contenido del curso

Introducción

Instalación

Ejecutando código y archivos PHP

Aprendiendo a caminar con PHP

Tipos de datos

Operadores en PHP

Programando con PHP

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0025:42

Instalación de PHP en macOS con M1 e Intel usando Homebrew

Curso Básico de PHP: Instalación, Fundamentos y Operadores

Clase 6 de 23

Clase 6 / 23

Recursos

Debido a que Apple ahora fabrica ordenadores basados en el chip M1 (anteriormente basadas solo en Intel), la forma de instalar y configurar PHP en macOS puede variar un poco.

Previo a la instalación de PHP asegúrate de tener instalado Homebrew, si no lo tienes puedes revisar esta clase del curso de prework para entornos macOS. Este es un manejador de paquetes para macOS y que nos será de gran utilidad para esta ocasión.

Instalación de PHP mediante HomeBrew

Será necesario tener el paquete curl instalado, pues nos va a permitir hacer descargas de internet.

brew install curl

Un servidor Apache para macOS

Lo siguiente es instalar un servidor con el cual ejecutar PHP. El más conocido es Apache; sin embargo, existe otro igual de funcional llamado httpd. Junto a este también instalaremos las versiones de PHP específicas que deseemos, las cuales serán la 8.1 y 7.4.

brew install httpd php@8.1 php@7.4

Como observaste podemos instalar una o más versiones del lenguaje. Para comprobar si tenemos instalado podemos ejecutar el siguiente comando:

php --version

Desvinculando la versión PHP por defecto

Algunas computadoras macOS ya traen PHP por defecto, en especial las que usan un procesador Intel. No obstante, esta versión instalada no es la recomendable, por ello es mejor desvincularla para cambiarla por la versión que deseemos y tengamos instalado:

brew unlink php

Ahora vinculemos la versión que queremos usar:

brew link --force php@8.1

Configuraciones básicas

La versión de PHP que hemos instalado está en la terminal, más no aún en el servidor web que alojara PHP (httpd en este caso el cual es similar a Apache). Para ello debemos realizar algunas modificaciones en un archivo llamado httpd.config cuya ruta varía según el tipo de procesador:

Ubicación en Intel: /usr/local/etc/httpd/httpd.conf
Ubicación en M1: /opt/homebrew/etc/httpd/httpd.conf

Para hacer los cambios puedes utilizar cualquier editor. El elegido en esta ocasión será Visual Studio Code.

sudo code /opt/homebrew/etc/httpd/httpd.conf

Una vez ejecutado el comando anterior, se abrirá el editor con el archivo httpd.config lleno de configuraciones. Para buscar específicamente una palabra podemos realizar la combinación de teclas Command + f para que nos abra un pequeño buscador. Ahora editamos el archivo httpd.config:

Indiquemos que el puerto por el cual debe funcionar nuestro servidor web sea el 80:
```
Listen 80
```
Para indicar el lugar donde guardaremos y ejecutaremos nuestros proyectos PHP, editemos la ruta que se encuentren en DocumentRoot y Directory para colocar la ubicación de la carpeta que deseemos:
```
DocumentRoot ""/Users/retaxmaster/Documents/projects""

<Directory ""/Users/retaxmaster/Documents/projects"">
```
Cambiamos la configuración AllowOverride de None a All
```
AllowOverride All
```
Para habilitar el módulo de PHP tenemos que insertar una línea de configuración que cambia según el tipo de procesador:
- Si es basada en Intel: LoadModule php_module /usr/local/opt/php/lib/httpd/modules/libphp.so
- Si es basada en M1: LoadModule php_module /opt/homebrew/opt/php/lib/httpd/modules/libphp.so
El servidor web (httpd) necesita saber la ubicación del archivo libphp.so para poder interpretar correctamente PHP. Cabe decir que puedes indicar una versión en específica de PHP, por ejemplo (para M1) indiquemos que la configuración sea para la versión 8.1:
```
LoadModule php_module /opt/homebrew/opt/php@8.1/lib/httpd/modules/libphp.so 
```
Debemos descomentar la opción rewrite_module, en caso de ya estarlo, déjalo como estaba

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

Para que nuestro servidor httpd pueda reconocer los archivos índice debemos especificarle mediante la opción DirectoryIndex. Indiquemos que esos archivos serán el index.php e index.html:

<IfModule dir_module>
    DirectoryIndex index.php index.html
</IfModule>

Ejecutando PHP

Reiniciemos los servicios de PHP:

brew services restart php

Iniciemos nuestro servidor web:

sudo apachectl -k start

¡Listo! Ya puedes ejecutar tus archivos PHP. Para verificarlo podemos ir al navegador y visitar la ruta localhost:

Si tienes alguna alerta u error en la terminal o navegador cuando intentas correr el servidor httpd es probable que no se haya establecido el ServerName como localhost dentro de la configuración de httpd.conf:

ServerName localhost

Debería estar configurado con el nombre de localhost y así cuando visitemos esa ruta en el navegador se ejecute el archivo índice que se encuentre en el DirectoryIndex.

Contribución creada por: Martín Álvarez

Ubicación del archivo httpd.conf:

Ubicación en Intel: sudo nano /usr/local/etc/httpd/httpd.conf
Ubicación en M1: sudo nano /opt/homebrew/etc/httpd/httpd.conf

Módulo de libphp.so:

Para Intel: LoadModule php_module /usr/local/opt/php/lib/httpd/modules/libphp.so
Para M1: LoadModule php_module /opt/homebrew/opt/php/lib/httpd/modules/libphp.so

Miguel Osorio

Hace 4 años

Instalación de PHP en macOS - Resumen

Para este proceso debemos tener instalado previamente el sistema de gestión de paquetes Homebrew. Siempre es bueno mantenerlo actualizado, para ello ejecutamos en la terminal:

// Primero
brew update

// Después
brew upgrade

Después procedemos a instalar CURL:

brew install curl

Luego instalamos HTTPD y PHP:

brew install httpd php@8.1 php@7.4

Atención: aquí estamos instalando dos versiones de PHP, aunque podemos instalar solamente una versión.

Una vez instalado PHP procedemos a desvincular la versión que nuestra Mac trae por defecto:

brew unlink php

Ahora vinculamos la versión más reciente que tenemos o bien la versión que necesitemos:

brew link --force php@8.1

Comprobamos la versión de PHP que tenemos instalada:

php --version

Ahora vamos a editar algunos archivos de Apache. Se debe tener en cuenta si nuestra Mac es Intel o M1 pues las rutas de los archivos cambian en cada caso. Las rutas son las siguientes:

Ubicación del archivo httpd.conf:

Ubicación en Intel: /usr/local/etc/httpd/httpd.conf
Ubicación en M1: /opt/homebrew/etc/httpd/httpd.conf

Módulo de libphp.so:

Para Intel: LoadModule php_module /usr/local/opt/php/lib/httpd/modules/libphp.so
Para M1: LoadModule php_module /opt/homebrew/opt/php/lib/httpd/modules/libphp.so

Nota: en php debemos agregar la versión que instalamos, en mi caso la ruta quedó así: LoadModule php_module /usr/local/opt/php@8.1/lib/httpd/modules/libphp.so porque instalé la versión 8.1.

Procedemos a editar el archivo httpd.conf:

sudo nano /usr/local/etc/httpd/httpd.conf

// Para editarlo con VSCode

sudo code /usr/local/etc/httpd/httpd.conf

La terminal nos pedirá la contraseña, la ingresamos para poder continuar.

Una vez abierto el archivo presionamos command + f y en el buscador que se abre escribimos listen, y buscamos estas líneas:

#Listen 12.34.56.78:80
Listen 8080

Y modificamos el 8080 por un 80, nos queda así:

#Listen 12.34.56.78:80
Listen 80

Luego en el buscador escribimos DocumentRoot y buscamos estas líneas:

# DocumentRoot "/usr/local/var/www"
# <Directory "/usr/local/var/www">

Y modificamos las direcciones por las carpetas donde tenemos nuestros proyectos (debemos borrar las almohadillas que están al principio de cada línea):

DocumentRoot "/Users/miusuario/Documents/proyectos/miproyecto"
<Directory "/Users/miusuario/Documents/proyectos/miproyecto">

Procedemos a escribir AllowOverride y buscamos estas línea:

# AllowOverride controls what directives may be placed in .htaccess files.
    # It can be "All", "None", or any combination of the keywords:
    #   AllowOverride FileInfo AuthConfig Limit
    #
    AllowOverride None

Y cambiamos la palabra None por All:

# AllowOverride controls what directives may be placed in .htaccess files.
    # It can be "All", "None", or any combination of the keywords:
    #   AllowOverride FileInfo AuthConfig Limit
    #
    AllowOverride All

Luego buscamos las líneas que digan LoadModule, vamos a encontrar muchas de estas así que nos ubicamos al principio de ellas, donde tenemos que ver algo como esto:

# Example:
# LoadModule foo_module modules/mod_foo.so
#
#LoadModule mpm_event_module lib/httpd/modules/mod_mpm_event.so
LoadModule mpm_prefork_module lib/httpd/modules/mod_mpm_prefork.so
#LoadModule mpm_worker_module lib/httpd/modules/mod_mpm_worker.so
LoadModule authn_file_module lib/httpd/modules/mod_authn_file.so

Como referencia: estas líneas están por debajo de donde modificamos el puerto de 8080 a 80.

Agregamos LoadModule php_module /usr/local/opt/php@8.1/lib/httpd/modules/libphp.so y nos queda así:

# Example:
# LoadModule foo_module modules/mod_foo.so
#
#LoadModule mpm_event_module lib/httpd/modules/mod_mpm_event.so
LoadModule php_module /usr/local/opt/php@8.1/lib/httpd/modules/libphp.so
LoadModule mpm_prefork_module lib/httpd/modules/mod_mpm_prefork.so
#LoadModule mpm_worker_module lib/httpd/modules/mod_mpm_worker.so
LoadModule authn_file_module lib/httpd/modules/mod_authn_file.so

En el buscador escribimos rewrite_module y buscamos esta línea:

#LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

Y simplemente quitamos la almohadilla que está al principio:

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

Continuamos con la búsqueda y ahora escribimos DirectoryIndex, debemos encontrar esto:

# DirectoryIndex: sets the file that Apache will serve if a directory
# is requested.
#
<IfModule dir_module>
    DirectoryIndex index.html
</IfModule>

Y agregamos index.php antes de index.html, nos queda así:

# DirectoryIndex: sets the file that Apache will serve if a directory
# is requested.
#
<IfModule dir_module>
    DirectoryIndex index.php index.html
</IfModule>

Ahora ya podríamos ejecutarlo, pero antes vamos a modificar otra cosa en este mismo archivo (porque a mi me dio el aviso “AH00558: httpd: Could not reliably determine the server's fully qualified domain name” cuando lo ejecuté), para ello escribimos ServerName y buscamos esta línea:

#ServerName www.example.com:8080

Y la modificamos para que quede así:

ServerName localhost

Bien, ahora vamos a la terminal para reiniciar PHP ejecutando:

brew services restart php

// O bien

brew services restart php@8.1

Continuamos iniciado el servidor Apache:

sudo apachectl -k start

Nos pedirá la contraseña así que la ingresamos. Si se inició correctamente no debería mostrar ningún mensaje y si ya estaba corriendo entonces mostrará un mensaje como esté: “httpd (pid 7743) already running”, pero no debemos preocuparnos. En todo caso podemos reiniciar el servidor con el siguiente comando:

sudo apachectl restart

Ahora vamos al navegador y en la barra de direcciones escribimos “localhost”. Si todo está bien deberíamos ver un mensaje en la pantalla que dice “It Works!”.

Javier Damiani

Hace 2 años

Excelente aporte! Tuve el mismo error que mencionaste y logré solucionarlo gracias a tu comentario :D

Comentarios (83)83 comentarios

Uriel Barranco Robles

Hace 5 años

Mario Alejandro Crespo Reyes

Javier Paulo Perdomo Tamani

Daniel Méndez Amutari

Ezequiel Rodriguez Esparza

Fernando Torres

Mario René García Péres

Diana Cañón

Carlos Enrique Membreño Barrientos

Guillermo Díaz

Francisco Miralles Niño

Rosa Rojas

Carlos Rubén Díaz Gutiérrez

Mauricio Andrés Baiz Buelvas

jaime cuesta rojas

Ivan Farid Espadas Escalante

Nestor Alejandro Melo Sánchez

Bulmaro Arellano Navarrete

Carlos Eduardo Gomez García

Maria del Sol Cisneros Castro

Enzo Gonzã¡Lez

Aldo Burgos Rodriguez

Ramiro Godoy

Vanessa Pineda Bernal

Diego Fernando Henao Ospina

Marina Mayo

Hace 3 años

Inés Lorenzo

Luis Martinez

Jhony Robles

Marco Antonio Alducin Garcia

Jorge A. Torres

Introducción

Programación Básica en PHP: Introducción y Conceptos Clave

Fundamentos y Aplicaciones Prácticas de PHP

Modelo Cliente-Servidor y Funciones de PHP en Web

Instalación

Instalación de XAMPP en Windows para desarrollo web

Instalación de PHP y Apache en Ubuntu paso a paso

Instalación de PHP en macOS con M1 e Intel usando Homebrew

Ejecutando código y archivos PHP

Uso básico de la terminal y comandos esenciales en UNIX

Ejecución de Archivos PHP en Windows y Linux

Aprendiendo a caminar con PHP

Sintaxis básica y concatenación en PHP

Debugging y Comentarios en PHP: var_dump, print_r y Buenas Prácticas

Variables y Constantes en PHP: Uso y Diferencias Básicas

Tipos de datos

Tipos de Datos en PHP: Integer, Float, String y Booleanos

Casting de Tipos de Datos en PHP: Convertir y Manipular Variables

Tipos de Datos y Operaciones en PHP

Operadores en PHP

Operadores Lógicos en PHP: AND, OR y NOT

Operadores Lógicos en PHP: Uso de AND, OR y NOT

Operadores Aritméticos en PHP: Suma, Resta, Multiplicación y Más

Operadores Relacionales en PHP: Igualdad, Diferencia y Más

Operadores de Asignación e Incremento en PHP

Precedencia y Asociatividad de Operadores en PHP

Programando con PHP

Conversión de segundos a horas, minutos y segundos en PHP

Conversión de Horas, Minutos y Segundos a Segundos en PHP

Fundamentos de PHP: Sintaxis, Variables y Operadores

Instalación de PHP en macOS con M1 e Intel usando Homebrew