User Documentation
Télécharger
Lancer

Configurer manuellement Apache, PHP et MySQL

Aperçu

Voici un bref aperçu des étapes pour configurer Apache, PHP et MySQL dans un environnement Windows, ainsi que diverses références à des outils connexes pour maintenir et travailler sur la plupart des tâches liées à Joomla!.

Afin de rendre les instructions claires et concises, nous supposerons que, partout où nous ne donnons pas d'instruction explicite, vous laisserez les chemins d'installation par défaut sans modification.

Avertissement

Si vous avez déjà installé l'une des piles AMP préconfigurées sur votre machine :

  • Revenir à votre pile AMP sera difficile. Les diverses installations que nous allons effectuer ci-dessous vont écraser des valeurs du registre et apporter des changements généraux à l'environnement. (Ceci s'applique au moins à l'environnement PC/Windows.)
  • Si vous devez conserver une configuration (Apache, MySQL ou PHP) ou des données (vos sites web existants et les bases de données associées), effectuez des sauvegardes appropriées avant de suivre ces instructions.

(à développer avec des conseils précis sur la façon de procéder...)

Configuration de MySQL

  1. Téléchargez l'installeur MySQL approprié pour votre plateforme.
  2. Démarrez l'installation et choisissez le chemin d'installation personnalisé.
  3. Parcourez tout le processus d'installation et cliquez sur Terminer.
  4. Vous verrez alors apparaître l'assistant de configuration de l'instance du serveur MySQL.
    1. Assurez-vous que la configuration standard est sélectionnée et passez à l'étape suivante.
    2. Si vous avez déjà installé MySQL, vous pourriez obtenir le message Un service Windows avec le nom MySQL existe déjà. Veuillez désinstaller correctement ce service ou choisir un autre nom pour le nouveau service. Si c'est le cas, choisissez un nom de service différent.
    3. Dans la fenêtre suivante, cochez Inclure le répertoire Bin dans le PATH de Windows. Cela vous permettra d'accéder aux différents utilitaires MySQL depuis la ligne de commande.
    4. Dans la fenêtre suivante, vous pourrez créer un mot de passe pour votre utilisateur root MySQL, l'utilisateur ayant le niveau d'accès le plus élevé sur votre serveur.
    5. Dans la dernière fenêtre, tous les changements que vous avez configurés jusqu'à présent seront enregistrés lorsque vous appuierez sur le bouton Exécuter, et le service Windows pour cette instance sera démarré.

Remarques

  1. Afin de rendre les instructions aussi accessibles que possible, nous avons omis un certain nombre de scénarios de configuration de votre instance MySQL, comme la possibilité de déplacer vos fichiers de base de données.
  2. MySQL s'installe par défaut avec un mode STRICT qui peut provoquer certaines erreurs lors de l'utilisation d'extensions ou d'applications qui n'en tiennent pas compte.

Ressources MySQL

  • HeidiSQL Un remplaçant complet de phpMyAdmin, facile à utiliser et extensible, en développement constant.
  • MySQL Workbench Divers outils parmi lesquels vous apprécierez l'Administration, qui vous aide à configurer votre instance MySQL. Nécessite le .Net framework.
  • phpMyAdmin Un puissant client MySQL basé sur le web pour administrer tout ce qui concerne MySQL.
  • Documentation MySQL

Configuration d'Apache

  1. Télécharger le programme d'installation de votre choix.
  2. Exécuter l'assistant d'installation et cliquer à chaque étape jusqu'à atteindre la fenêtre Server Information. Renseigner les options ci-dessous respectivement et dans l'ordre indiqué dans chacun des champs, sauf si vous avez des exigences spécifiques quant à la configuration de votre serveur web :
    1. localhost,
    2. localhost et
    3. admin@localhost
  3. Cliquer à travers l'assistant qui installera et démarrera le serveur web Apache en tant que service Windows.
  4. Dans la barre d'état Windows, vous verrez désormais une plume de couleur rose avec un bouton de lecture vert indiquant qu'Apache fonctionne. Pointez votre navigateur vers http://localhost/ et vous devriez obtenir une page indiquant que cela fonctionne.
  5. Rendons-nous maintenant à l'emplacement où Apache est installé, généralement C:\Program Files\Apache Software Foundation\Apache2.2, et parcourons les différents répertoires
    1. bin - contient les différents fichiers binaires, dont certains sont listés ci-dessous. Afin d'accéder à ces applications, dont la plupart sont en ligne de commande, nous devons ajouter le chemin du répertoire bin à notre variable PATH globale. Pour ce faire, faites un clic droit sur Poste de travail > Propriétés > Avancé > Variables d'environnement et, dans la liste des variables système, repérez et sélectionnez la variable PATH, cliquez sur Modifier et ajoutez un point-virgule final, s'il n'y est pas déjà, suivi du chemin absolu vers votre répertoire bin. Validez en quittant la boîte de dialogue des propriétés système.
      1. httpd.exe qui est le serveur web Apache lui-même, lequel engendre plusieurs processus enfants tout en servant autant de requêtes clientes simultanées que requis par la directive MaxClients ;
      2. ab.exe est un outil de benchmark fourni avec Apache vous permettant de voir les performances de votre application par unité de temps
    2. conf - dossier où se trouvent les différents fichiers de configuration, dont les suivants sont les plus intéressants dans notre cas
      1. httpd.conf - la plupart des directives du serveur se trouvent dans ce fichier et, pour un accès facile, vous devriez associer le type de fichier .conf à un éditeur convivial, c'est-à-dire tout sauf le Bloc-notes par défaut.
      2. extra\httpd-vhosts.conf - contient des directives qui vous permettraient d'utiliser votre serveur local comme hôte virtuel, c'est-à-dire d'exécuter plusieurs serveurs sur votre PC. Un scénario d'utilisation est que, pendant une phase de développement, si vous souhaitez faire correspondre le domaine réel sur lequel vous travaillez à votre copie locale, vous pourriez le faire en apportant de légères modifications à ce fichier. Nous en discuterons plus en détail ci-dessous.
    3. htdocs - la racine par défaut du serveur web, c'est ici que http://localhost/ est mappé, c'est-à-dire si vous ne le reconfigurez pas dans le fichier httpd.conf ci-dessus.
    4. logs - journaux d'accès et d'erreurs, utiles lors de la résolution de divers problèmes liés à votre serveur ou même à votre application

Ressources Apache

Configuration de PHP

  1. Télécharger PHP et choisir généralement VC6 x86 Thread Safe au format Zip. Les différentes options sont liées à la manière dont la base de code PHP a été compilée en binaire et ne sont probablement pas quelque chose dont vous devez vous soucier pour l'instant.
  2. Créer un dossier sous votre C:\Program Files\ (ou tout autre emplacement où se trouve votre répertoire de programmes) appelé PHP.
  3. Localiser votre fichier Zip téléchargé et le déplacer dans le dossier nouvellement créé, puis le décompresser directement dans ce dossier.
  4. Ajoutons maintenant le chemin de PHP à notre variable PATH globale en suivant les instructions ci-dessus.

Configuration de PHP

La configuration consiste à éditer le fichier php.ini. Un fichier d'exemple pour différents scénarios se trouve déjà dans votre dossier PHP. Renommons php.ini-development en php.ini et ouvrons-le dans votre éditeur de texte préféré. Les valeurs courantes à ajuster sont les suivantes et toutes ces variables sont bien documentées dans le fichier php.ini. (Notez qu'il s'agit d'un paramètre global au serveur s'appliquant à tous vos projets) :

  • max_execution_time - à utiliser chaque fois que vous avez des scripts qui s'exécutent trop longtemps et que le serveur renvoie divers résultats inattendus que vous pensez dus à l'impossibilité de terminer tout le processus

  • memory_limit

  • error_reporting

  • display_errors

  • log_errors - une variable dont vous devrez tenir compte dans les scénarios de production

  • upload_tmp_dir

  • upload_max_filesize

  • extension_dir' - afin d'éviter toute complication, nous allons indiquer le répertoire où se trouvent les extensions suivantes en décommentant cette variable et en assignant l'emplacement absolu du dossier. La ligne complète devrait se lire comme suit extension_dir = "C:\Program Files\PHP\ext"

  • La section des extensions dynamiques contient divers modules supplémentaires que vous souhaitez charger, et ceux qui sont commentés sont ceux fournis par défaut avec PHP et peuvent être trouvés dans le répertoire ext de votre dossier PHP. Si vous souhaitez en activer un, il suffit de supprimer le commentaire, comme vous devriez le faire pour les extensions suivantes :

    • php_curl.dll
    • php_gd2.dll
    • php_mbstring.dll
    • php_mysql.dll
    • php_mysqli.dll
    • php_pdo.dll
    • php_pdo_mysql.dll
    • php_xsl.dll

  • session.save_path

Configuration d'Apache pour fonctionner avec PHP

Maintenant que nous avons configuré PHP comme nous le souhaitons, allons dans Apache et faisons de même.

  • Ouvrir httpd.conf et dans la section "Dynamic Shared Object (DSO) Support" ajouter les directives suivantes. (Si vous avez placé votre dossier PHP ailleurs, apportez la modification correspondante pour php5apache2_2.dll ci-dessous) : LoadModule php5_module "C:/Program Files/PHP/php5apache2_2.dll" AddType application/x-httpd-php .php

  • Dans DirectoryIndex, ajouter index.php et index.htm comme fichiers possibles à servir lorsque le répertoire est demandé, comme suit : DirectoryIndex index.html index.htm index.php

  • À la fin du fichier, ajouter la ligne suivante qui indique où se trouve le fichier php.ini PHPIniDir "C:/Program Files/PHP"

Redémarrer et tester PHP

Dès que vous apportez une modification à php.ini, httpd.conf ou à tout autre fichier de configuration, vous devez redémarrer Apache pour voir l'effet des changements. Redémarrons donc maintenant Apache en utilisant l'outil Apache Monitor que vous pouvez trouver dans la barre d'état de Windows. Avec un peu de chance, vous ne serez pas sollicité par des boîtes de dialogue et Apache Monitor continuera de s'afficher en vert.

Nous allons maintenant tester que PHP fonctionne. Aller à la racine des documents de votre serveur web (par défaut C:\Program Files\Apache Software Foundation\Apache2.2\htdocs) et ajouter un fichier nommé phpinfo.php avec le contenu suivant :

Cela affichera une page contenant des informations sur votre configuration PHP et sur les différents modules/extensions actuellement chargés. Pointer votre navigateur vers <a href="http://localhost/phpinfo.php"

rel="nofollow noreferrer noopener">http://localhost/phpinfo.php.

Installation et configuration de xdebug

  1. Pointer votre navigateur vers l'assistant d'installation de Xdebug. Cette page vous aidera à trouver une version adaptée de Xdebug.
  2. Copier l'intégralité de la page phpinfo que nous avons exécutée ci-dessus et la coller dans la zone de texte, puis suivre les instructions fournies pour procéder à l'installation.

Ressources XDebug

  • Le Manuel PHP Une documentation excellente et à jour, avec de précieux commentaires complémentaires d'utilisateurs. Des versions téléchargeables sont disponibles.
  • La Documentation de Xdebug 3