Base de connaissances · Environnement PHP
La variable PHP upload_max_filesize présente une valeur locale et une valeur principale différentes
Dernière mise à jour : 2025-06-07
La différence entre la valeur locale et la valeur principale (master value) de upload_max_filesize dans votre configuration PHP s'explique généralement par les raisons suivantes :
- Valeur locale: il s'agit du paramètre qui s'applique au script ou au contexte en cours (par exemple, un hôte virtuel, un répertoire ou un fichier .htaccess particulier).
- Valeur principale (Master Value): il s'agit du paramètre global par défaut du serveur, défini dans le fichier principal
php.inifichier géré par cPanel > Sélectionner une version de PHP.
Pourquoi ces valeurs sont différentes
Les Valeur locale d'une variable PHP est contrôlée par le développeur au moyen de commandes dans le script, tandis que la Valeur globale est gérée via cPanel > Sélectionner une version de PHP. Les valeurs locales peuvent être définies par le développeur dans le code ou dans des fichiers de configuration. Les emplacements les plus couramment utilisés pour définir des variables PHP dans le code sont :
- Les valeurs de remplacement peuvent être indiquées dans .htaccess, httpd.conf, .user.ini ou php.ini:
- Si un
.htaccessfichier,httpd.conf, ou la configuration d'un hôte virtuel spécifique définit une valeur pour la variable et remplace la valeur globale, la valeur locale sera différente.
- Si un
- Définition à l'exécution dans le code PHP:
- Un script peut utiliser
ini_set()pour modifier laupload_max_filesizeà l'exécution pour le script en cours.
- Un script peut utiliser
- Paramètres par répertoire ou par utilisateur:
- Les configurations PHP peuvent varier selon les répertoires ou les utilisateurs, en particulier dans les environnements d'hébergement mutualisé.
- Elles sont définies dans des fichiers .htaccess, .user.ini ou php.ini propres à un répertoire ou à un utilisateur.
-
Fichier de configuration du script :
- Des scripts tels que WordPress permettent de définir
ini_set() basedles valeurs des variables PHP dans des fichiers de configuration comme wp-config.php
- Des scripts tels que WordPress permettent de définir
Corriger l'écart
Pour aligner la valeur locale et la valeur principale, vous devez identifier l'endroit où la surcharge est effectuée et apporter les ajustements nécessaires.
Étapes de correction :
-
Vérifiez la configuration principale dans
php.ini:- Localisez votre
php.inifichier. Vous pouvez trouver son chemin à l'aide de : - Recherchez la
upload_max_filesizedirective et définissez-la sur la valeur souhaitée. Par exemple :
- Localisez votre
-
Assurez-vous qu'aucune surcharge n'existe dans .htaccess :
- Si vous utilisez Apache, recherchez les
.htaccessfichiers dans le répertoire courant ou dans les répertoires parents. - Recherchez des directives telles que :
php_value upload_max_filesize 10M
- Supprimez-les ou modifiez-les afin qu'elles correspondent à votre
php.inivaleur.
- Si vous utilisez Apache, recherchez les
-
Recherchez les surcharges à l'exécution :
- Examinez vos scripts PHP à la recherche de tout
ini_set()appel susceptible de modifier laupload_max_filesizevaleur pendant l'exécution.
- Examinez vos scripts PHP à la recherche de tout
-
Vérifiez les modifications :
- Exécutez à nouveau
phpinfo()et vérifiez que la valeur locale et la valeur principale (master) sont désormais identiques.
- Exécutez à nouveau
Remarques :
- Assurez-vous que la valeur de
post_max_sizedansphp.iniest également suffisante pour gérer les téléversements. Elle doit généralement être supérieure àupload_max_filesize. - Assurez-vous que la valeur de memory_limit est également suffisante pour gérer les téléversements.
Tell us what you need
Compare available plans or describe your workload so we can discuss a suitable starting point.