macOS 11.0 Big Sur Apache Setup: Plusieurs Versions PHP

Partie 1 : macOS 11.0 Big Sur Environnement de développement Web

Développer des applications web sur macOS est une vraie joie. Il existe de nombreuses options pour configurer vos environnements de développement, y compris le très populaire MAMP Pro qui fournit une interface utilisateur agréable au-dessus d’Apache, PHP et MySQL. Cependant, il y a des moments où MAMP Pro a des ralentissements, ou des versions obsolètes, ou se comporte simplement mal en raison de son système restrictif de modèles de configuration et de versions non standard.

Ce sont des moments comme ceux-ci que les gens recherchent souvent une approche alternative, et heureusement, il y en a une, et c’est relativement simple à configurer.

Dans cet article de blog, nous vous expliquerons la configuration et la configuration d’Apache 2.4 et plusieurs versions de PHP. Dans le deuxième article de blog de cette série de deux articles, nous aborderons MySQL, les hôtes virtuels Apache, la mise en cache APC et l’installation de Xdebug.

Si vous n’avez pas déjà installé XCode, il est préférable d’installer d’abord les outils de ligne de commande car ceux-ci seront utilisés par homebrew:

xcode-select --install

Installation de Homebrew

Ce processus repose fortement sur le gestionnaire de paquets macOS appelé Homebrew. En utilisant la commande brew, vous pouvez facilement ajouter des fonctionnalités puissantes à votre mac, mais nous devons d’abord l’installer. C’est un processus simple, mais vous devez lancer votre application Terminal (/Applications/Utilities/Terminal), puis entrer:

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

Il suffit de suivre les invites du terminal et d’entrer votre mot de passe si nécessaire. Cela peut prendre quelques minutes, mais une fois terminé, un moyen rapide de vous assurer que vous avez installé correctement brew, tapez simplement:

brew --version

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

Vous devriez probablement également exécuter la commande suivante pour vous assurer que tout est configuré correctement:

brew doctor

Il vous indiquera si vous devez corriger quoi que ce soit.

Bibliothèques nécessaires à Big Sur

Lors de l’installation de fresh sur Big Sur, j’ai rencontré quelques bibliothèques manquantes lors de l’exécution de toutes les étapes ci-dessous. Pour faciliter les choses, exécutez simplement ceci maintenant:

brew install openssl

Installation d’Apache

Ala dernière version de macOS 11.0 Big Sur est livrée avec Apache 2.4 préinstallé, cependant, ce n’est plus une tâche simple d’utiliser cette version avec Homebrew car Apple a supprimé certains scripts requis dans cette version. Cependant, la solution consiste à installer Apache 2.4 via Homebrew, puis à le configurer pour qu’il s’exécute sur les ports standard (80/443).

Si vous avez déjà l’Apache intégré en cours d’exécution, il devra d’abord être arrêté et tous les scripts de chargement automatique supprimés. Cela ne fait vraiment pas de mal de simplement exécuter toutes ces commandes dans l’ordre – même s’il s’agit d’une nouvelle installation:

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

Maintenant, nous devons installer la nouvelle version fournie par Brew:

brew install httpd

Sans options, httpd n’aura pas besoin d’être construit à partir de la source , il s’installe donc assez rapidement. Une fois terminé, vous devriez voir un message comme:

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

Maintenant, nous avons juste besoin de configurer les choses pour que notre nouveau serveur Apache démarre automatiquement

brew services start httpd

Vous avez maintenant installé Apache de Homebrew et l’avez configuré pour démarrer automatiquement avec un compte privilégié. Il devrait déjà être en cours d’exécution, vous pouvez donc essayer d’atteindre votre serveur dans un navigateur en le pointant sur http://localhost:8080, vous devriez voir un simple en-tête qui dit « Ça marche! ».

Conseils de dépannage

Si vous recevez un message indiquant que le navigateur ne peut pas se connecter au serveur, vérifiez d’abord que le serveur est opérationnel.

ps -aef | grep httpd

Vous devriez voir quelques processus httpd si Apache est opérationnel.

Essayez de redémarrer Apache avec :

brew services restart httpd

Vous pouvez regarder le journal des erreurs Apache dans un nouvel onglet / fenêtre de terminal lors d’un redémarrage pour voir si quelque chose n’est pas valide ou cause un problème:

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

Apache est contrôlé via la commande brew services donc certaines commandes utiles à utiliser sont:

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

Visual Studio Code

Dans les guides précédents, j’ai toujours fourni des instructions pour éditer des fichiers en utilisant le TextEdit application préinstallée. Cependant, ce n’est pas ce que j’utilise moi-même car c’est un éditeur terrible et lors du test de mon guide pour Big Sur, j’ai continué à rencontrer des problèmes d’encodage, de recherche de numéros de ligne, etc. La meilleure solution consiste simplement à installer un meilleur éditeur. Veuillez donc installer le code Visual Studio incroyablement polyvalent mais 100% gratuit. Il est disponible sur Mac, Windows et Linux, mais pour le moment, nous ne nous soucions que de la version Mac.

Accédez au site Visual Studio Code et cliquez sur Télécharger pour Mac

Une fois téléchargée, faites glisser l’application vers l’emplacement de vos applications préférées. Ensuite, vous souhaitez installer les outils de ligne de commande, suivez donc les instructions étape par étape officielles afin de pouvoir utiliser la commande code à partir du Terminal.

Configuration d’Apache

Maintenant que nous avons un serveur Web qui fonctionne, nous voulons faire quelques modifications de configuration pour qu’il fonctionne mieux en tant que serveur de développement local.

Dans la dernière version de Brew, vous devez définir manuellement le port d’écoute par défaut de 8080 sur 80, nous devrons donc modifier le fichier de configuration d’Apache /usr/local/etc/httpd/httpd.conf.

Si vous avez suivi les instructions ci-dessus, vous devriez pouvoir utiliser Visual Studio Code pour éditer vos fichiers à l’aide de la commande de terminal code. Cependant, si vous souhaitez utiliser l’application TextEditor par défaut pour effectuer des modifications, vous pouvez utiliser la commande open -e suivie du chemin d’accès au fichier.

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

Trouvez la ligne qui dit

Listen 8080

et changez-la en 80:

Listen 80

Ensuite, nous allons le configurer pour utiliser le pour changer la racine du document pour Apache. C’est le dossier à partir duquel Apache cherche à servir le fichier. Par défaut, la racine du document est configurée en tant que /usr/local/var/www. Comme il s’agit d’une machine de développement, supposons que nous souhaitions modifier la racine du document pour pointer vers un dossier dans notre propre répertoire personnel.

Recherchez le terme DocumentRoot, et vous devriez voir la ligne suivante:

DocumentRoot "/usr/local/var/www"

Changez cela pour pointer vers votre répertoire utilisateur où your_user est le nom de votre compte utilisateur:

DocumentRoot /Users/your_user/Sites

Vous devez également modifier la référence de balise <Directory> juste en dessous de la ligne DocumentRoot. Cela devrait également être modifié pour pointer également vers la racine de votre nouveau document:

<Directory "/Users/your_user/Sites">

Dans ce même bloc <Directory>, vous trouverez un paramètre AllowOverride, cela doit être modifié comme suit:

## 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

Nous devrions également activer mod_rewrite qui est commenté par défaut. Recherchez mod_rewrite.so et décommentez la ligne en supprimant le # en appuyant sur ⌘/ sur la ligne (c’est un moyen rapide de décommenter et de commenter une ou plusieurs lignes :

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

Utilisateur &Groupe

Maintenant, nous avons la configuration Apache pointant vers un dossier Sites dans notre répertoire personnel. Un problème subsiste cependant. Par défaut, apache s’exécute en tant qu’utilisateur daemon et groupe daemon. Cela causera des problèmes d’autorisation lorsque vous tenterez d’accéder aux fichiers de notre répertoire personnel. Environ un tiers du chemin vers le bas du fichier httpd.conf il y a deux paramètres pour définir le User et Group Apache s’exécutera sous. Modifiez-les pour qu’elles correspondent à votre compte utilisateur (remplacez your_user par votre nom d’utilisateur réel), par un groupe de staff:

User your_userGroup staff

Nom du serveur

Apache aime avoir un nom de serveur dans la configuration, mais celui-ci est désactivé par défaut, alors recherchez :

#ServerName www.example.com:8080

et remplacez-le par :

ServerName localhost

Dossier Sites

Maintenant, vous devez créer un dossier Sites à la racine de votre répertoire personnel. Vous pouvez le faire dans votre terminal ou dans le Finder. Dans ce nouveau dossier Sites créez un simple index.html et mettez-y du contenu factice comme: <h1>My User Web Root</h1>.

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

Redémarrez Apache pour vous assurer que vos modifications de configuration ont pris effet :

brew services stop httpdbrew services start httpd

Pointer votre navigateur vers http://localhost devrait afficher votre nouveau message. Si cela fonctionne, nous pouvons passer à autre chose !

Dépannage du démarrage des services httpd non Sudo

Cette année, avec macOS Big Sur, je suis passé de l’utilisation de sudo pour lancer httpd avec root (même s’il fonctionnait en tant qu’utilisateur / groupe défini dans httpd.conf), et pour les personnes qui ont mis à niveau de cette version vers celle-ci, il y a eu des problèmes.

J’ai rencontré moi-même quelques problèmes mais j’ai pu le faire fonctionner assez facilement, mais d’autres ont signalé des problèmes plus répandus. Veuillez essayer ces étapes si votre Apache ne démarre pas lorsque vous utilisez brew services start httpd.

Tout d’abord, essayez de démarrer apache directement avec:

/usr/local/bin/httpd -k start

Cela contourne la commande brew services et imprime souvent des problèmes spécifiques. Si vous avez des problèmes signalés concernant l’impossibilité d’écrire dans des fichiers journaux, essayez de supprimer tous les fichiers journaux httpd actuels :

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

Puis essayez de recommencer.

Si vous voyez un message disant quelque chose comme Address already in use: AH00072: make_sock: could not bind to address, essayez de changer la configuration Listen dans httpd.conf pour:

Listen 0.0.0.0:80

Installation PHP

Jusqu’à fin mars 2018, toutes les brasseries liées à PHP étaient gérées par l’onglet Homebrew/php, mais cela a été obsolète, nous utilisons donc maintenant ce qui est disponible dans le package Homebrew/core. Cela devrait être un ensemble de paquets mieux entretenu, mais beaucoup moins complet.

PHP 5.6, PHP 7.0 et PHP 7.1 ont été dépréciés et supprimés de Brew car ils ne sont plus pris en charge, et bien qu’il ne soit pas recommandé pour la production, il existe des raisons légitimes de tester ces versions non prises en charge dans un environnement de développement. Ces versions doivent également être « construites à partir des sources » afin d’utiliser les dernières versions de icu4c et openssl.

Rappelez-vous que seuls PHP 7.2 à 7.4 sont officiellement pris en charge par Brew, mais ceux-ci doivent également être construits, ce qui est assez lent. Pour la dernière version de notre guide, nous utiliserons le nouveau robinet de @shivammahtur car il existe de nombreuses versions (y compris les versions PHP 8.0) pré-construites.

PHP 8.0 vient d’être publié et vous pouvez l’installer, mais cela peut prendre un certain temps pour que les modules PHP compatibles soient entièrement disponibles.

brew tap shivammathur/php

Nous allons procéder en installant différentes versions de PHP et en utilisant un script simple pour basculer entre elles selon nos besoins. N’hésitez pas à exclure les versions que vous ne souhaitez pas installer.

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]

De plus, vous devrez peut-être ajuster les paramètres de configuration de PHP à vos besoins. Une chose courante à modifier est le réglage de la mémoire, ou la configuration date.timezone. Les fichiers php.ini pour chaque version de PHP se trouvent dans les répertoires suivants:

/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

Nous avons installé mais pas lié ces versions de PHP. Pour passer à PHP 5.6par exemple, nous pouvons taper:

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

Test rapide que nous sommes dans la bonne version:

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

et pour passer à 7.4:

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

Et vérifiez qu’il a bien changé:

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

Configuration PHP d’Apache – Partie 1

Vous avez correctement installé vos versions PHP, mais nous devons dire à Apache de les utiliser. Vous devrez à nouveau modifier le fichier /usr/local/etc/httpd/httpd.conf défiler vers le bas des entrées LoadModule.

Si vous avez suivi ce guide correctement, la dernière entrée doit être votre module mod_rewrite:

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

Ci-dessous, ajoutez les modules libphp suivants:

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

Nous ne pouvons avoir qu’un seul module traitant PHP à la fois, donc pour l’instant, nous avons donc laissé notre entrée [email protected] non commentée alors que toutes les autres sont commentées. Cela indiquera à Apache d’utiliser PHP 5.6 pour gérer les requêtes PHP. (Nous ajouterons la possibilité de changer de version PHP plus tard).

Vous devez également définir explicitement les index de répertoire pour PHP, alors recherchez ce bloc:

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

et remplacez-le par ceci:

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

Enregistrez le fichier et arrêtez Apache puis recommencez, maintenant que nous avons installé PHP:

brew services stop httpdbrew services start httpd

Valider l’installation de PHP

La meilleure façon de tester si PHP est installé et fonctionne comme prévu est d’utiliser phpinfo(). Ce n’est pas quelque chose que vous voulez laisser sur une machine de production, mais c’est inestimable dans un environnement de développement.

Créez simplement un fichier appelé info.php dans votre dossier Sites/ que vous avez créé précédemment avec ce one-liner.

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

Pointez votre navigateur vers http://localhost/info.php et vous devriez voir une page d’information PHP brillante:

Si vous voyez un résultat phpinfo similaire, félicitations! Vous avez maintenant Apache et PHP qui fonctionnent avec succès. Vous pouvez tester les autres versions de PHP en commentant l’entrée LoadModule ... [email protected] ... et en décommentant l’une des autres. Ensuite, redémarrez simplement apache et rechargez la même page.

Script de commutation PHP

Nous avons codé Apache en dur pour utiliser PHP 5.6, mais nous voulons vraiment pouvoir basculer entre les versions. Heureusement, certaines personnes laborieuses ont déjà fait le travail acharné pour nous et ont écrit un petit script de commutation PHP très pratique.

Nous installerons le script sphp dans le script standard 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

Vérifiez votre chemin

Homebrew aurait dû ajouter son /usr/local/bin et /usr/local/sbin à votre chemin dans le cadre de son processus d’installation. Testez rapidement cela en tapant:

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

Si vous ne voyez pas cela, essayez d’abord de fermer votre terminal et de le redémarrer. Si cela ne fonctionne pas, vérifiez que vous avez /usr/local/bin avant /usr/bin et /usr/local/sbin avant /usr/sbin dans la définition du chemin de votre ~/.zshrc div> fichier. Vous pouvez le faire temporairement dans le shell en tapant:

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

Test de la commutation PHP

Après avoir terminé ces étapes, vous devriez pouvoir changer de version PHP en utilisant la commande sphp suivie d’une valeur à deux chiffres pour la version PHP :

sphp 7.1

Vous pouvez utiliser la commande sphp il faudra probablement entrer votre mot de passe administrateur, et cela devrait vous donner quelques commentaires:

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!

Testez pour voir si votre Apache exécute maintenant PHP 7.4 en pointant à nouveau votre navigateur sur http://localhost/info.php. Avec un peu de chance, vous devriez voir quelque chose comme ceci:

Dépannage de la commutation PHP

Si vous avez mis à niveau à partir d’une version précédente de ce guide et que vous avez installé PHP8, vous pouvez voir un message comme: Unknown version of PHP. PHP Switcher can only handle arguments of: 5.6,7.0,7.1,7.2,7.3,7.4, alors vous devez réinstaller le sphp script qui a été mis à jour.

Si vous recevez un message concernant des versions de PHP en conflit, vous avez probablement un conflit de taps. Vous devrez désinstaller vos versions PHP précédentes, puis supprimer l’ancien robinet, puis ajouter le nouveau robinet, puis réinstaller les versions PHP en utilisant la syntaxe ci-dessus. Par exemple :

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

Testez votre configuration avec Grav CMS!

Quelle meilleure façon de tester votre nouvelle configuration puissante que d’installer et de tester rapidement Grav. Le meilleur CMS de fichiers plats au monde 😆! Nous pouvons le faire avec juste quelques commandes de terminal rapides:

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'

Puis extrayez simplement le fichier zip:

unzip grav-admin-v1.6.28.zip

Cela extraira le zip dans un dossier ~/Sites/grav-admin. Ensuite, pointez simplement votre navigateur sur ce répertoire http://localhost/grav-admin:

Remplissez les informations pertinentes pour créer un nouvel utilisateur administrateur, et cliquez simplement sur Créer un utilisateur pour accéder à l’administrateur. Aucune autre étape n’est nécessaire.

Tout est fait!!!!

La mise à jour de PHP et d’autres paquets de brassage

Brew facilite grandement la mise à jour de PHP et des autres paquets que vous installez. La première étape consiste à mettre à jour Brew afin qu’il obtienne une liste des mises à jour disponibles :

brew update

Cela crachera une liste des mises à jour disponibles et des formules supprimées. Pour mettre à niveau les paquets, tapez simplement:

brew upgrade

Activation des versions spécifiques/les plus récentes de PHP

En raison de la configuration de notre liaison PHP, une seule version de PHP est liée à la fois, seule la version active actuelle de PHP sera mise à jour vers la dernière version. Vous pouvez voir la version active actuelle en tapant:

php -v

Et vous pouvez voir les versions spécifiques d’un paquet PHP en tapant:

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, cela clôt la partie 1 de cette série de 3 parties Vous avez maintenant un Apache 2.4 entièrement fonctionnel installation avec un moyen rapide et facile de basculer entre PHP 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, et 8.0. Consultez la partie 2 pour savoir comment configurer votre environnement avec MySQL, les hôtes virtuels, la mise en cache APC, YAML et Xdebug. Jetez également un coup d’œil à la partie 3 pour savoir comment configurer SSL pour vos hôtes virtuels Apache.