PHP est embarqué avec macOS depuis macOS X (10.0.0) et antérieur à macOS Monterey (12.0.0). Activer PHP avec le serveur Web par défaut nécessite de décommenter quelques lignes dans le fichier de configuration d'Apache httpd.conf tandis que le mode CGI et/ou CLI sont activés par défaut (accès simple via le terminal).
L'activation de PHP en suivant ces instructions permet de configurer rapidement un environnement local de développement. Il est vivement recommandé de toujours mettre à jour PHP à sa version la plus récente. Comme la plupart des programmes, les nouvelles versions sont créées pour corriger les bogues et ajouter des fonctionnalités et c'est le cas de PHP. Reportez-vous à la documentation de l'installation de macOS pour plus de détails. Les instructions suivantes sont destinées au débutant, en fournissant juste assez de détails pour mettre en place une configuration par défaut pour travailler. Tous les utilisateurs sont vivement encouragés à compiler et installer une version récente du paquet.
Le type d'installation standard utilise mod_php, et active le mod_php embarqué sur macOS pour le serveur Web Apache (le serveur Web par défaut qui est accessible via les préférences systèmes), en quelques étapes :
Finder
ou Spotlight
pour trouver ce fichier peut s'avérer difficile, sachant que, par défaut, il
appartient à l'utilisateur root
.
Note: Une façon de l'ouvrir est d'utiliser un éditeur de texte Unix dans un terminal, par exemple,
nano
, et sachant que le fichier est la propriété de l'utilisateurroot
, vous devrez utiliser la commandesudo
pour l'ouvrir (en tant queroot
) ; aussi, vous devrez entrer la commande suivante dans votreTerminal
(votre mot de passe vous sera demandé) :sudo nano /private/etc/apache2/httpd.conf
Quelques commandes nano :^w
(recherche),^o
(sauvegarde), et^x
(sortie) où^
représente la touche Ctrl.
Note: Les versions de Mac OS X antérieures à 10.5 fournissent d'anciennes versions de PHP et d'Apache. Aussi, le fichier de configuration d'Apache sur les machines originales peut être /etc/httpd/httpd.conf.
Avec un éditeur de texte, décommentez les lignes (en effaçant le caractère #) qui ressemblent aux lignes suivantes (ces 2 lignes ne se trouvent pas au même endroit) :
# LoadModule php5_module libexec/httpd/libphp5.so # AddModule mod_php5.c
Assurez-vous que les extensions désirées soient analysées par PHP (exemples : .php .html et .inc)
Sachant que ce comportement a déjà été activé dans votre fichier httpd.conf (depuis Mac Panther), une fois PHP activé, les fichiers .php seront automatiquement analysés par PHP.
<IfModule mod_php5.c> # If php is turned on, we respect .php and .phps files. AddType application/x-httpd-php .php AddType application/x-httpd-php-source .phps # Since most users will want index.php to work we # also automatically enable index.php <IfModule mod_dir.c> DirectoryIndex index.html index.php </IfModule> </IfModule>
Note:
Avant OS X 10.5 (Leopard), PHP 4 était livré par défaut plutôt que PHP 5. Ainsi, les instructions ci-dessus diffèreront juste en changeant 5 en 4. 5's to 4's.
DocumentRoot
C'est le dossier principal pour tous les fichiers Web. Les fichiers dans
ce dossier seront servis par le serveur Web, et donc, les fichiers PHP
seront analysés par PHP avant de les envoyer au navigateur. Le chemin
par défaut est /Library/WebServer/Documents mais peut
être défini à n'importe quelle valeur dans le fichier
httpd.conf. De plus, le dossier DocumentRoot pour
les différentes utilisateurs est
/Users/yourusername/Sites
La fonction phpinfo() affiche les informations sur PHP. Créez un fichier dans le DocumentRoot avec le code PHP suivant :
<?php phpinfo(); ?>
Pour redémarrez, exécutez la commande sudo apachectl graceful
dans un terminal ou arrêter/démarrer l'option "Personal Web Server" dans les
préférences systèmes de macOS. Par défaut, le chargement de fichiers locaux dans
le navigateur s'effectue via des URL comme ceci :
http://localhost/info.php ou, si vous utilisez le DocumentRoot
d'un dossier utilisateur, l'URL ressemblera à :
http://localhost/~yourusername/info.php
CLI (ou CGI dans les anciennes versions) est nommé
php et réside normalement dans
/usr/bin/php. Ouvrez un terminal, lisez la section sur
la ligne de commande du manuel PHP, et
exécutez la commande php -v
pour vérifier la version PHP de ce binaire.
Un appel à la fonction phpinfo() pourra également vous révéler cette
information.