Utiliser un fichier PHP.ini personnalisé

Qu'est-ce que php.ini ?

Le fichier php.ini est l'endroit où vous déclarez les modifications de vos paramètres PHP. Vous pouvez utiliser les paramètres par défaut du serveur, modifier des paramètres spécifiques en modifiant le fichier php.ini existant ou créer un nouveau fichier texte et le nommer php.ini.

Il existe plusieurs cas qui peuvent vous obliger à modifier un paramètre dans le fichier php.ini de votre site Web, comme l'augmentation de la limite de téléchargement PHP. Nous autorisons définitivement l'utilisation d'un fichier php.ini personnalisé, mais il y a certaines exigences impliquées juste pour s'assurer que les fichiers fonctionnent comme prévu.

Paramètres par défaut

Le serveur est déjà configuré avec des paramètres standard pour PHP qui ont été sélectionnés par nos administrateurs comme étant les paramètres les plus optimaux pour la majorité de nos clients. Sauf si vous avez spécifiquement besoin de modifier un ou plusieurs paramètres, il n'est pas nécessaire de créer ou de modifier un fichier php.ini. Si le fichier php.ini n'existe pas dans votre compte, alors votre site utilisera les paramètres PHP par défaut définis sur le serveur.

Pourquoi créer un fichier php.ini personnalisé ?

Voici quelques exemples de ce qui peut être modifié en utilisant un fichier php.ini personnalisé :

Modification de la taille maximale d'un fichier pouvant être téléchargé dans un script PHP (upload_max_filesize =10M)
Modification de la taille de publication PHP maximale qui doit au moins correspondre à upload_max_filesize (post_max_size =10M)
Modification du temps d'exécution maximal du fichier en secondes (max_execution_time =30)

Découvrez le gestionnaire

Avant qu'une directive PHP personnalisée puisse être définie, le gestionnaire PHP doit être déterminé, afin que la méthode correcte puisse être utilisée. Pour connaître votre gestionnaire PHP :

Connectez-vous au shell en tant que root
Vérifiez le fichier '/etc/httpd/conf/php.conf'

Si vous voyez la ligne 'LoadModule suphp_module modules/mod_suphp.so ' alors vous utilisez suPHP.
Si vous voyez la ligne 'LoadModule php5_module modules/libphp5.so ' alors vous n'utilisez pas suPHP et pouvez utiliser les instructions DSO.

Veuillez consulter chaque ensemble d'instructions ci-dessous.

Créer un PHP.ini dans cPanel

Ce fichier doit être créé dans votre répertoire cPanel Home (/home/username/). Assurez-vous de remplacer « nom d'utilisateur » par votre nom d'utilisateur cPanel actuel et « $DOMAIN » par votre domaine actuel.

Connectez-vous à cPanel
Dans la section Fichiers, cliquez sur Gestionnaire de fichiers
Sélectionnez Répertoire personnel parmi les options disponibles et cliquez sur Aller
Cliquez sur Nouveau fichier, en haut de la page
Dans le champ Nouveau nom de fichier, entrez 'php.ini' et cliquez sur Créer un nouveau fichier
Cliquez sur le fichier nommé php.ini
Cliquez sur Modifier en haut de la page, puis cliquez sur Modifier dans la fenêtre contextuelle

Vous pouvez maintenant saisir le contenu de votre fichier php.ini et cliquer sur Enregistrer.

Créer un fichier PHP.ini personnalisé avec suPHP

Pour commencer à créer votre propre fichier php.ini personnalisé :

Copiez votre fichier php.ini dans le répertoire d'accueil de votre utilisateur cPanel, 'cp /usr/local/lib/php.ini /home/user/' (où 'user' est votre nom d'utilisateur cPanel)
Créez un fichier .htaccess dans le répertoire 'public_html' de votre site OU modifiez le fichier .htaccess existant, s'il existe, en ajoutant la ligne suivante :

suPHP_ConfigPath /home/utilisateur

Remarque : vous n'avez pas besoin d'ajouter 'php.ini' à la fin.

Une fois que vous avez terminé les étapes ci-dessus, votre fichier php.ini sera actif. Vous pourrez désormais apporter des modifications au fichier php.ini personnalisé. Vos modifications n'affecteront que les répertoires sous le fichier .htaccess dans lequel vous avez référencé le fichier.

Créer un fichier PHP.ini personnalisé avec DSO

Sur le serveur DSO, les directives doivent être placées dans le fichier .htaccess du répertoire auquel elles doivent s'appliquer. Dans la plupart des cas, ce sera '/home/user/public_html/ où 'user' est votre nom d'utilisateur cPanel.

Pour modifier une valeur booléenne (on/off), vous pouvez utiliser php_flag comme ceci :

php_flag magic_quotes_gpc off

Pour modifier une valeur numérique, vous pouvez utiliser php_value comme ceci :

php_value memory_limit 256M

Si vous avez besoin d'aide supplémentaire pour créer un fichier php.ini personnalisé, contactez l'un de nos fantastiques collaborateurs de l'assistance.

Voir aussi Remplacer les paramètres PHP, Utiliser d'autres installations PHP