Configuración de macOS 11.0 Big Sur Apache: Múltiples versiones de PHP

Parte 1: Entorno de desarrollo Web Big Sur de macOS 11.0

Desarrollar aplicaciones web en macOS es una verdadera alegría. Hay muchas opciones para configurar sus entornos de desarrollo, incluido el siempre popular MAMP Pro que proporciona una interfaz de usuario agradable sobre Apache, PHP y MySQL. Sin embargo, hay momentos en que MAMP Pro tiene ralentizaciones, o versiones desactualizadas, o simplemente se comporta mal debido a su sistema restrictivo de plantillas de configuración y compilaciones no estándar.

En momentos como estos, las personas a menudo buscan un enfoque alternativo, y afortunadamente hay uno, y es relativamente sencillo de configurar.

En esta entrada de blog, lo guiaremos a través de la configuración y configuración de Apache 2.4 y múltiples versiones de PHP. En la segunda entrada de blog de esta serie de dos publicaciones, cubriremos MySQL, hosts virtuales Apache, almacenamiento en caché de APC e instalación de Xdebug.

Si aún no tiene XCode instalado, lo mejor es instalar primero las herramientas de línea de comandos, ya que serán utilizadas por Homebrew:

xcode-select --install

Instalación de Homebrew

Este proceso depende en gran medida del gestor de paquetes de macOS llamado Homebrew. Usando el comando brew puede agregar fácilmente una funcionalidad potente a su mac, pero primero tenemos que instalarla. Este es un proceso simple, pero debe iniciar su aplicación de Terminal (/Applications/Utilities/Terminal) y luego ingresar:

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

Simplemente siga las instrucciones de terminal e ingrese su contraseña cuando sea necesario. Esto puede tardar unos minutos, pero cuando se complete, una forma rápida de asegurarse de que ha instalado brew correctamente, simplemente escriba:

brew --version

Homebrew 2.5.10Homebrew/homebrew-core (git revision 542ff0; last commit 2020-11-13)

Probablemente también debería ejecutar el siguiente comando para asegurarse de que todo está configurado correctamente:

brew doctor

Él le indicará si necesita corregir nada.

Big Sur Requirió bibliotecas

Al instalar fresh en Big Sur, me encontré con algunas bibliotecas que faltaban al completar todos los pasos a continuación. Para hacer las cosas más fáciles, simplemente ejecute esto ahora:

brew install openssl

Instalación de Apache

Ael último macOS 11.0 Big Sur viene con Apache 2.4 preinstalado, sin embargo, ya no es una tarea sencilla usar esta versión con Homebrew porque Apple ha eliminado algunos scripts necesarios en esta versión. Sin embargo, la solución es instalar Apache 2.4 a través de Homebrew y luego configurarlo para que se ejecute en los puertos estándar (80/443).

Si ya tiene el Apache incorporado en ejecución, primero tendrá que apagarse y eliminar cualquier script de carga automática. Realmente no hace daño ejecutar todos estos comandos en orden, incluso si se trata de una instalación nueva:

sudo apachectl stopsudo launchctl unload -w /System/Library/LaunchDaemons/org.apache.httpd.plist 2>/dev/null

Ahora necesitamos instalar la nueva versión proporcionada por Brew:

brew install httpd

Sin opciones, httpd no tendrá que construirse desde fuente, por lo que se instala bastante rápido. Al finalizar, debería ver un mensaje como:

🍺 /usr/local/Cellar/httpd/2.4.46: 1,658 files, 27.9MB

Ahora solo necesitamos configurar las cosas para que nuestro nuevo servidor Apache se inicie automáticamente

brew services start httpd

Ahora ha instalado Apache de Homebrew y lo ha configurado para que se inicie automáticamente con una cuenta con privilegios. Ya debería estar en ejecución, por lo que puede intentar llegar a su servidor en un navegador apuntando a http://localhost:8080, debería ver un encabezado simple que dice » ¡Funciona!».

Consejos para solucionar problemas

Si recibe un mensaje de que el navegador no se puede conectar al servidor, compruebe primero que el servidor está activado.

ps -aef | grep httpd

Debería ver algunos procesos httpd si Apache está en funcionamiento.

Intente reiniciar Apache con:

brew services restart httpd

Puede ver el registro de error de Apache en una nueva pestaña/ventana de terminal durante un reinicio para ver si algo no es válido o causa un problema:

tail -f /usr/local/var/log/httpd/error_log

Apache se controla a través del comando brew services Por lo que algunos comandos útiles para usar son:

$ brew services stop httpd$ brew services start httpd$ brew services restart httpd

Visual Studio Code

En guías anteriores, siempre he proporcionado instrucciones para editar archivos utilizando el TextEdit aplicación que viene preinstalada. Sin embargo, esto no es lo que yo uso, ya que es un editor terrible y al probar mi guía para Big Sur, me encontré con problemas de codificación, búsqueda de números de línea, etc. La mejor solución es simplemente instalar un mejor editor. Así que, por favor, instale el código de Visual Studio increíblemente versátil pero 100% gratuito. Está disponible en Mac, Windows y Linux, pero en este momento solo nos importa la versión para Mac.

Vaya al sitio de código de Visual Studio y haga clic en Descargar para Mac

Una vez descargada, arrastre la aplicación a la ubicación de aplicaciones que prefiera. A continuación, desea instalar las herramientas de línea de comandos, así que siga las instrucciones paso a paso oficiales para poder usar el comando code desde el Terminal.

Configuración de Apache

Ahora que tenemos un servidor web en funcionamiento, lo que queremos hacer es hacer algunos cambios de configuración para que funcione mejor como servidor de desarrollo local.

En la última versión de Brew, debe configurar manualmente el puerto de escucha desde el valor predeterminado de 8080 a 80, por lo que tendremos que editar el archivo de configuración de Apache /usr/local/etc/httpd/httpd.conf.

Si ha seguido las instrucciones anteriores, debería poder usar el código de Visual Studio para editar sus archivos utilizando el comando de terminal code. Sin embargo, si desea utilizar la aplicación Editor de texto predeterminada para realizar ediciones, puede usar el comando open -e seguido de la ruta al archivo.

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

/p>

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

User & Group

Ahora tenemos la configuración de Apache apuntando a una carpeta Sites en nuestro directorio personal. Sin embargo, sigue existiendo un problema. De forma predeterminada, apache se ejecuta como el usuario daemon y el grupo daemon. Esto causará problemas de permisos al intentar acceder a archivos en nuestro directorio personal. Alrededor de un tercio del camino hacia abajo en el archivo httpd.conf hay dos configuraciones para configurar el User y Group en el que se ejecutará Apache. Cambiar estos para que coincida con su cuenta de usuario (reemplace your_user con su nombre real), con un grupo de staff:

User your_userGroup staff

Nombre de servidor

A Apache le gusta tener un nombre de servidor en la configuración, pero está deshabilitado de forma predeterminada, así que busque:

#ServerName www.example.com:8080

y reemplácelo por:

ServerName localhost

Carpeta de sitios

Ahora, necesita crear una carpeta Sites en la raíz de su directorio personal. Puede hacerlo en su terminal o en Finder. En esta nueva carpeta Sites, cree un simple index.htmly coloque contenido ficticio como: <h1>My User Web Root</h1>.

mkdir ~/Sitesecho "<h1>My User Web Root</h1>" > ~/Sites/index.html

Reinicie apache para asegurarse de que los cambios de configuración hayan tenido efecto:

brew services stop httpdbrew services start httpd

Apuntando su navegador a http://localhost debería mostrar su nuevo mensaje. ¡Si lo tienes funcionando, podemos seguir adelante!

Solución de problemas Inicio de servicios httpd no Sudo

Este año, con macOS Big Sur, he cambiado de usar sudo para lanzar httpd con root (aunque se ejecutó como el usuario/grupo definido en httpd.conf), y para las personas que han actualizado de esa versión a esta, ha habido problemas.

Me encontré con algunos problemas, pero pude hacerlo funcionar con bastante facilidad, pero otros han informado de problemas más amplios. Por favor, intente estos pasos si su Apache no se inicia cuando usa brew services start httpd.

Primero, intente iniciar apache directamente con:

/usr/local/bin/httpd -k start

Esto omite el comando brew services y a menudo imprime problemas específicos. Si tiene problemas para escribir en archivos de registro, intente eliminar todos los archivos de registro httpd actuales:

rm -Rf /usr/local/var/log/httpd/*

Y, a continuación, intente comenzar de nuevo.

Si usted ve un mensaje que dice algo como Address already in use: AH00072: make_sock: could not bind to address, pruebe a cambiar el Listen config httpd.conf para:

Listen 0.0.0.0:80

Instalación de PHP

Hasta finales de marzo de 2018, todas las cervezas relacionadas con PHP eran manejadas por la pestaña Homebrew/php, pero ha quedado obsoleta, por lo que ahora usamos lo que está disponible en el paquete Homebrew/core. Este debería ser un conjunto de paquetes mejor mantenido, pero mucho menos completo.

PHP 5.6, PHP 7.0 y PHP 7.1 han sido obsoletos y eliminados de Brew porque no son compatibles, y aunque no se recomienda para producción, hay razones legítimas para probar estas versiones no compatibles en un entorno de desarrollo. Estas versiones también necesitan «compilarse desde el código fuente»para usar las últimas versiones de icu4c y openssl.

Recuerde que solo los PHP 7.2 a 7.4 son soportados oficialmente por Brew, pero también tienen que ser construidos, lo que es bastante lento. Para la última versión de nuestra guía, usaremos el nuevo toque de @shivammahtur, ya que hay muchas versiones (incluidas las compilaciones de PHP 8.0) pre-construidas.

PHP 8.0 acaba de ser lanzado y puede instalarlo, pero puede tomar algún tiempo para que los módulos PHP compatibles estén completamente disponibles.

brew tap shivammathur/php

Procederemos instalando varias versiones de PHP y utilizando un script simple para cambiar entre ellas según lo necesitemos. No dude en excluir cualquier versión que no desee instalar.

brew install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected]

Además, es posible que tenga la necesidad de ajustar la configuración de PHP a sus necesidades. Una cosa común a cambiar es la configuración de memoria, o la configuración date.timezone. Los archivos php.ini para cada versión de PHP se encuentran en los siguientes directorios:

/usr/local/etc/php/5.6/php.ini/usr/local/etc/php/7.0/php.ini/usr/local/etc/php/7.1/php.ini/usr/local/etc/php/7.2/php.ini/usr/local/etc/php/7.3/php.ini/usr/local/etc/php/7.4/php.ini/usr/local/etc/php/8.0/php.ini

Hemos instalado pero no enlazado estas versiones de PHP. Para cambiar a PHP 5.6, por ejemplo, podemos escribir:

brew unlink php && brew link --overwrite --force [email protected]

prueba Rápida que estamos en la versión correcta:

php -v

PHP 5.6.40 (cli) (built: Jul 2 2020 04:41:54) Copyright (c) 1997-2016 The PHP GroupZend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies with Zend OPcache v7.0.6-dev, Copyright (c) 1999-2016, by Zend Technologies

y para cambiar a a 7.4:

brew unlink php && brew link --overwrite --force [email protected]

Y comprobar que se ha cambiado correctamente:

php -v

PHP 7.4.12 (cli) (built: Oct 30 2020 00:56:27) ( NTS )Copyright (c) The PHP GroupZend Engine v3.4.0, Copyright (c) Zend Technologies with Zend OPcache v7.4.12, Copyright (c), by Zend Technologies

Configuración de Apache PHP – Parte 1

Ha instalado correctamente sus versiones de PHP, pero necesitamos decirle a Apache que las use. Nuevamente tendrá que editar el archivo /usr/local/etc/httpd/httpd.conf desplácese hasta la parte inferior de las entradas LoadModule.

Si usted ha estado siguiendo esta guía correctamente, la última entrada debe ser su mod_rewrite módulo:

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

a Continuación añadir la siguiente libphp módulos:

LoadModule php5_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp5.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp.so

Solo podemos tener un módulo procesando PHP a la vez, así que por ahora, hemos dejado nuestra entrada [email protected] sin comentarios mientras que todos los demás están comentados. Esto le dirá a Apache que use PHP 5.6 para manejar peticiones PHP. (Añadiremos la posibilidad de cambiar versiones de PHP más adelante).

También debe establecer los Índices de directorio para PHP explícitamente, por lo que busque este bloque:

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

y reemplácelo con esto:

<IfModule dir_module> DirectoryIndex index.php index.html</IfModule><FilesMatch \.php$> SetHandler application/x-httpd-php</FilesMatch>

Guarde el archivo y detenga Apache y vuelva a iniciarlo, ahora que hemos instalado PHP:

brew services stop httpdbrew services start httpd

Validar la instalación de PHP

La mejor manera de probar si PHP está instalado y funcionando como se espera es hacer uso de phpinfo(). Esto no es algo que quiera dejar en una máquina de producción, pero es invaluable en un entorno de desarrollo.

Simplemente crea un archivo llamado info.phpen la carpeta Sites/ que creaste anteriormente con este forro único.

echo "<?php phpinfo();" > ~/Sites/info.php

apunte su navegador a http://localhost/info.php y usted debería ver una brillante página de información de PHP:

Si ve un resultado similar de phpinfo, ¡enhorabuena! Ahora tiene Apache y PHP funcionando correctamente. Puede probar las otras versiones de PHP comentando la entrada LoadModule ... [email protected] ... y descomentando una de las otras. A continuación, simplemente reinicie apache y vuelva a cargar la misma página.

Script conmutador PHP

Hemos codificado Apache para usar PHP 5.6, pero realmente queremos poder cambiar entre versiones. Afortunadamente, algunas personas laboriosas ya han hecho el trabajo duro por nosotros y han escrito un pequeño script de conmutador PHP muy útil.

Instalaremos el script sphp en el estándar de brew /usr/local/bin:

curl -L https://gist.githubusercontent.com/rhukster/f4c04f1bf59e0b74e335ee5d186a98e2/raw/0c36a5067fbd63e6a36700a6aaa119df0836bdfc/sphp.sh > /usr/local/bin/sphpchmod +x /usr/local/bin/sphp

Compruebe su ruta

Homebrew debería haber agregado su preferido /usr/local/bin y /usr/local/sbin a su ruta como parte de su proceso de instalación. Prueba esto rápidamente escribiendo:

echo $PATH/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

Si no ve esto, primero intente cerrar su terminal y reiniciarlo. Si eso no funciona, compruebe que dispone de /usr/local/bin antes de /usr/bin y /usr/local/sbin antes de /usr/sbin en la definición de la ruta de su ~/.zshrc archivo. Puede hacerlo temporalmente en el shell escribiendo:

export PATH=/usr/local/bin:/usr/local/sbin:$PATH

Probando el cambio de PHP

Después de haber completado estos pasos, debería poder cambiar su versión de PHP utilizando el comando sphp seguido de un valor de dos dígitos para la versión de PHP:

sphp 7.1

probablemente tendrá que ingresar su contraseña de administrador, y debería darle algunos comentarios:

Switching to [email protected]

Switching to [email protected] your shellUnlinking /usr/local/Cellar/[email protected]/5.6.40... 0 symlinks removedUnlinking /usr/local/Cellar/[email protected]/7.1.33... 0 symlinks removedUnlinking /usr/local/Cellar/[email protected]/7.2.34... 0 symlinks removedUnlinking /usr/local/Cellar/php/7.4.12... 24 symlinks removedLinking /usr/local/Cellar/php/7.4.12... 24 symlinks createdSwitching your apache confRestarting apachePHP 7.4.12 (cli) (built: Oct 30 2020 00:56:27) ( NTS )Copyright (c) The PHP GroupZend Engine v3.4.0, Copyright (c) Zend Technologies with Zend OPcache v7.4.12, Copyright (c), by Zend TechnologiesAll done!

Pruebe para ver si su Apache ahora está ejecutando PHP 7.4 apuntando nuevamente su navegador a http://localhost/info.php. Con un poco de suerte, debería ver algo como esto:

Solución de problemas de conmutación de PHP

Si ha actualizado desde una versión anterior de esta guía y ha instalado PHP8, puede ver un mensaje como: Unknown version of PHP. PHP Switcher can only handle arguments of: 5.6,7.0,7.1,7.2,7.3,7.4, entonces debe reinstalar el que ha sido actualizado.

Si recibe un mensaje sobre versiones de PHP en conflicto, entonces probablemente tenga un conflicto de toques. Necesitará desinstalar sus versiones anteriores de PHP, luego eliminar el toque antiguo, luego agregar el toque nuevo y luego reinstalar las versiones de PHP usando la sintaxis anterior. Por ejemplo:

brew untap exolnet/deprecatedbrew tap shivammathur/phpbrew install shivammathur/php/[email protected]

¡Pruebe su configuración con el CMS Grav!

Qué mejor manera de probar su nueva y potente configuración que instalar y probar Grav rápidamente. El mejor CMS de archivo plano del mundo!! Podemos hacer esto con solo un par de comandos de terminal rápidos:

cd ~/Sitescurl -OJL https://getgrav.org/download/core/grav-admin/latest

 % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0100 646 100 646 0 0 1664 0 --:--:-- --:--:-- --:--:-- 1664100 10.5M 100 10.5M 0 0 8198k 0 0:00:01 0:00:01 --:--:-- 21.6Mcurl: Saved to filename 'grav-admin-v1.6.28.zip'

Luego simplemente extraiga el archivo zip:

unzip grav-admin-v1.6.28.zip

Esto extraerá el zip en una carpeta ~/Sites/grav-admin. Luego, simplemente apunte su navegador a este directorio http://localhost/grav-admin:

Llene la información relevante para crear un nuevo usuario administrador, y simplemente haga clic en Crear Usuario para entrar en el admin. No se necesitan otros pasos.

Todo listo!!!!

Actualizar PHP y otros paquetes de Brew

Brew hace que sea súper fácil actualizar PHP y los otros paquetes que instale. El primer paso es actualizar Brew para que obtenga una lista de actualizaciones disponibles:

brew update

Esto escupirá una lista de actualizaciones disponibles y cualquier fórmula eliminada. Para actualizar los paquetes simplemente escriba:

brew upgrade

Activando Versiones específicas / Últimas de PHP

Debido a la forma en que se configura nuestro enlace de PHP, solo se vincula una versión de PHP a la vez, solo la versión activa actual de PHP se actualizará a la última versión. Puede ver la versión activa actual escribiendo:

php -v

Y puede ver las versiones específicas de un paquete PHP escribiendo:

brew info [email protected]

PHP 7.4.12 (cli) (built: Oct 30 2020 00:56:27) ( NTS )Copyright (c) The PHP GroupZend Engine v3.4.0, Copyright (c) Zend Technologies with Zend OPcache v7.4.12, Copyright (c), by Zend Technologiesrhuk@macos-big-sur ~ % brew info [email protected]: stable 7.4.12 (bottled), HEADGeneral-purpose scripting languagehttps://www.php.net//usr/local/Cellar/php/7.4.12 (497 files, 72.2MB) * Poured from bottle on 2020-11-13 at 11:57:43From: https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/php.rbLicense: PHP-3.01==> DependenciesBuild: httpd ✔, pkg-config ✔Required: apr ✔, apr-util ✔, argon2 ✔, aspell ✔, autoconf ✔, curl-openssl ✔, freetds ✔, gd ✔, gettext ✔, glib ✔, gmp ✔, icu4c ✔, krb5 ✔, libffi ✔, libpq ✔, libsodium ✔, libzip ✔, oniguruma ✔, openldap ✔, [email protected] ✔, pcre2 ✔, sqlite ✔, tidy-html5 ✔, unixodbc ✔...

OK, que concluye la Parte 1 de esta serie de 3 partes, Ahora tiene un Apache 2.4 completamente funcional instalación con una forma rápida y fácil de alternar entre PHP 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, y 8.0. Consulte la Parte 2 para averiguar cómo configurar su entorno con MySQL, Hosts Virtuales, almacenamiento en caché de APC, YAML y Xdebug. También eche un vistazo a la Parte 3 para averiguar cómo configurar SSL para sus Hosts virtuales Apache.