Files
doc-fr/install/macos/bundled.xml
T
2021-09-24 04:13:47 +01:00

221 lines
8.7 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 12081e88fbd683e58a029153afd57f043df9721b Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<sect1 xml:id="install.macosx.bundled" xmlns="http://docbook.org/ns/docbook">
<title>Utilisation de PHP embarqué antérieur à macOS Monterey</title>
<simpara>
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
<filename>httpd.conf</filename> tandis que le mode
<acronym>CGI</acronym> et/ou <acronym>CLI</acronym> sont activés par défaut
(accès simple via le terminal).
</simpara>
<simpara>
L'activation de PHP en suivant ces instructions permet de configurer
rapidement un environnement local de développement. Il est
<emphasis>vivement recommandé</emphasis> 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.
</simpara>
<simpara>
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 :
</simpara>
<para>
<orderedlist>
<listitem>
<simpara>
Trouvez et ouvrez le fichier de configuration d'Apache. Par défaut, ce sera :
<filename>/private/etc/apache2/httpd.conf</filename>
</simpara>
<simpara>
Utiliser le programme <literal>Finder</literal> ou <literal>Spotlight</literal>
pour trouver ce fichier peut s'avérer difficile, sachant que, par défaut, il
appartient à l'utilisateur <literal>root</literal>.
</simpara>
<note>
<simpara>
Une façon de l'ouvrir est d'utiliser un éditeur de texte Unix dans
un terminal, par exemple, <literal>nano</literal>, et sachant que le
fichier est la propriété de l'utilisateur <literal>root</literal>,
vous devrez utiliser la commande <literal>sudo</literal> pour l'ouvrir
(en tant que <literal>root</literal>) ; aussi, vous devrez entrer
la commande suivante dans votre <literal>Terminal</literal> (votre mot
de passe vous sera demandé) :
<literal>sudo nano /private/etc/apache2/httpd.conf</literal>
</simpara>
<simpara>
Quelques commandes nano : <literal>^w</literal> (recherche),
<literal>^o</literal> (sauvegarde), et <literal>^x</literal> (sortie) où
<literal>^</literal> représente la touche Ctrl.
</simpara>
</note>
<note>
<simpara>
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
<filename>/etc/httpd/httpd.conf</filename>.
</simpara>
</note>
</listitem>
<listitem>
<para>
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) :
<screen>
<![CDATA[
# LoadModule php5_module libexec/httpd/libphp5.so
# AddModule mod_php5.c
]]>
</screen>
Notez le chemin. Dans le futur, lorsque vous compilerez PHP, les fichiers
ci-dessus doivent être remplacés ou commentés.
</para>
</listitem>
<listitem>
<para>
Assurez-vous que les extensions désirées soient analysées par PHP
(exemples : .php .html et .inc)
</para>
<para>
Sachant que ce comportement a déjà été activé dans votre fichier
<filename>httpd.conf</filename> (depuis Mac Panther), une fois PHP activé,
les fichiers <filename>.php</filename> seront automatiquement analysés par PHP.
<screen>
<![CDATA[
<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>
]]>
</screen>
</para>
<note>
<para>
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.
</para>
</note>
</listitem>
<listitem>
<simpara>
Assurez-vous que DirectoryIndex charge le fichier index par défaut.
</simpara>
<simpara>
Ceci est également définit dans le fichier <filename>httpd.conf</filename>.
Normalement, les fichiers <filename>index.php</filename> et
<filename>index.html</filename> sont utilisés. Par défaut,
<filename>index.php</filename> est activé car il est également
dans la vérification de PHP ci-dessus. Ajustez-le suivant votre besoin.
</simpara>
</listitem>
<listitem>
<simpara>
Définissez le chemin vers le fichier
&php.ini; ou utilisez le chemin par défaut.
</simpara>
<simpara>
Le chemin par défaut sur macOS is
<filename>/usr/local/php/php.ini</filename> et un appel à la fonction
<function>phpinfo</function> révèlera cette information.
Si aucun fichier &php.ini; n'est utilisé, PHP utilisera toutes les valeurs
par défaut. Reportez-vous à la FAQ sur
"<link linkend="faq.installation.phpini">trouver le fichier php.ini</link>".
</simpara>
</listitem>
<listitem>
<simpara>
Trouvez et définissez le <literal>DocumentRoot</literal>
</simpara>
<simpara>
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 <filename>/Library/WebServer/Documents</filename> mais peut
être défini à n'importe quelle valeur dans le fichier
<filename>httpd.conf</filename>. De plus, le dossier <filename>DocumentRoot</filename> pour
les différentes utilisateurs est
<filename>/Users/yourusername/Sites</filename>
</simpara>
</listitem>
<listitem>
<simpara>
Créez un fichier <function>phpinfo</function>.
</simpara>
<para>
La fonction <function>phpinfo</function> affiche les informations sur PHP.
Créez un fichier dans le DocumentRoot avec le code PHP suivant :
<programlisting role="php">
<![CDATA[
<?php phpinfo(); ?>
]]>
</programlisting>
</para>
</listitem>
<listitem>
<simpara>
Redémarrez Apache et chargez le fichier PHP que nous venons de créer.
</simpara>
<para>
Pour redémarrez, exécutez la commande <literal>sudo apachectl graceful</literal>
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 <acronym>URL</acronym> comme ceci :
<filename>http://localhost/info.php</filename> ou, si vous utilisez le DocumentRoot
d'un dossier utilisateur, l'URL ressemblera à :
<filename>http://localhost/~yourusername/info.php</filename>
</para>
</listitem>
</orderedlist>
</para>
<simpara>
<acronym>CLI</acronym> (ou <acronym>CGI</acronym> dans les anciennes versions) est nommé
<filename>php</filename> et réside normalement dans
<filename>/usr/bin/php</filename>. Ouvrez un terminal, lisez la section sur
<link linkend="features.commandline">la ligne de commande</link> du manuel PHP, et
exécutez la commande <literal>php -v</literal> pour vérifier la version PHP de ce binaire.
Un appel à la fonction <function>phpinfo</function> pourra également vous révéler cette
information.
</simpara>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->