Où se trouve php.ini ? 5 erreurs fatales et comment les éviter

« Mais où est ce fichier php.ini ? » — une question qui rend fou même les développeurs expérimentés

Avez-vous déjà eu l'impression de partir à la chasse au trésor, mais au lieu de l'or, vous cherchiez le fichier php.ini ? Si oui, vous n'êtes pas seul. La question « Where can I find php.ini? » sur Stack Overflow cumule des dizaines de milliers de vues. Et ce n'est pas un hasard.

Imaginez : vous avez installé PHP, écrit un code parfait, mais il refuse obstinément de fonctionner. Ou bien vous modifiez les paramètres dans php.ini, redémarrez le serveur, et les changements… ne s'appliquent pas. Ça vous parle ? Bienvenue au club.

Dans cet article, nous ne nous contenterons pas de vous montrer où se trouve php.ini. Nous allons décortiquer les 5 erreurs les plus fréquentes que commettent les développeurs et vous donner des instructions claires pour les éviter. C'est parti !

Qu'est-ce que php.ini et à quoi sert-il ?

php.ini est le fichier de configuration principal de PHP. C'est ici que vous gérez le comportement du langage : de la taille maximale des fichiers téléchargés au temps d'exécution des scripts. Sans lui, PHP fonctionne « au petit bonheur la chance » — avec les paramètres par défaut.

Voici quelques paramètres que vous pouvez modifier dans php.ini :

\n
• upload_max_filesize — taille maximale des fichiers téléchargés
\n
• max_execution_time — temps d'exécution maximal d'un script
\n
• memory_limit — limite de mémoire pour un script
\n
• display_errors — afficher ou non les erreurs à l'écran
\n
• error_reporting — niveau d'affichage des erreurs
\n

Le problème, c'est que selon les systèmes d'exploitation et les environnements, l'emplacement de php.ini diffère. Et c'est le premier piège pour les débutants.

Où chercher php.ini : aide-mémoire pour tous les OS

Linux (Ubuntu, Debian, CentOS)

Sous Linux, le fichier peut se trouver à plusieurs endroits. Les plus courants :

/etc/php/8.1/cli/php.ini   # pour la ligne de commande (CLI)\n/etc/php/8.1/apache2/php.ini # pour Apache\n/etc/php/8.1/fpm/php.ini     # pour PHP-FPM

Attention : la version de PHP (8.1) peut varier. Si vous avez PHP 8.0, le chemin sera /etc/php/8.0/....

Comment trouver rapidement ? Exécutez dans le terminal :

php --ini

Cette commande affiche le chemin vers le fichier de configuration chargé.

Windows

Sous Windows, php.ini se trouve généralement dans le dossier d'installation de PHP :

C:\\php\\php.ini\nC:\\Program Files\\PHP\\php.ini\nC:\\xampp\\php\\php.ini    # si vous utilisez XAMPP\nC:\\wamp64\\bin\\php\\php8.1.0\\php.ini  # pour WAMP

macOS

Sous macOS (si PHP est installé via Homebrew) :

/usr/local/etc/php/8.1/php.ini\n/opt/homebrew/etc/php/8.1/php.ini  # pour Apple Silicon

Si vous utilisez le PHP intégré d'Apple (déconseillé), le chemin peut être différent.

Docker

Dans un conteneur Docker, le chemin est standard pour Linux :

/usr/local/etc/php/php.ini

Mais il est préférable de monter votre propre php.ini via les volumes :

docker run -v /chemin/vers/votre/php.ini:/usr/local/etc/php/php.ini mon-app-php

Top 5 des erreurs avec php.ini (et comment les éviter)

Erreur n°1 : Je modifie le mauvais php.ini

C'est le problème le plus courant. Vous ouvrez le fichier, modifiez les paramètres, redémarrez le serveur, mais PHP continue de fonctionner comme avant. Pourquoi ? Parce que vous avez modifié le mauvais fichier !

PHP peut utiliser différents php.ini pour la CLI (ligne de commande) et le serveur web (Apache/Nginx).

Comment l'éviter :

\n
1. Créez un fichier PHP avec le contenu suivant :
\n

<?php\nphpinfo();\n?>

\n
2. Exécutez-le dans votre navigateur (si vous vérifiez la version web) ou dans le terminal (php votrefichier.php).
\n
3. Recherchez la ligne Loaded Configuration File — c'est le chemin vers le fichier actif.
\n