Le fichier mes_options.php

Le fichier mes_options.php offre la possibilité de modifier la configuration par défaut de SPIP.

  • Apparu en : SPIP 1.7

Quelles options ?

Lorsqu’un visiteur du site demande à voir une page, qu’elle soit déjà en cache ou non, SPIP exécute un certain nombre d’actions, dont celle de charger le fichier mes_options.php.

Dans ce fichier, il est possible de :

Voir la liste complète des constantes et des variables de personnalisation dans le glossaire.

Créer le fichier mes_options.php

Par défaut, SPIP ne fournit pas ce fichier.

Ces options peuvent être créées

  • dans le fichier config/mes_options.php d’un site,
  • ou dans un plugin, dans le fichier prefixePlugin_options.php

Note [1].

mes_options.php étant un fichier PHP, il doit commencer par <?php (soyez extrêmement vigilant : il ne doit y avoir aucun caractère ni espace ni ligne vierge avant la balise ouvrante <?php).
SPIP adopte les conventions PHP récentes, il est donc recommandé de ne plus indiquer de balise fermante ?>.

<?php

// sécurité
if (!defined('_ECRIRE_INC_VERSION')) {
	return;
}

// Définir une constante
// interdire l'upload de documents de plus de 500 Ko
define('_DOC_MAX_SIZE', 500);


// Adapter une variable de personnalisation
// forcer l’affichage d’un menu déroulant à partir de 2010 pour
// le champ "Date de première publication"
$GLOBALS['debut_date_publication'] = '2010';

Usage avancé

Il est possible dans ce fichier personnel d’invoquer la fonction spip_initialisation() pour définir les répertoires de données et, par exemple, disposer ainsi de plusieurs sites sous SPIP utilisant une seule distribution (l’appel standard de cette fonction, plus loin dans inc_version.php, sera automatiquement neutralisé).
Voir à ce propos le Mécanismes de fabrication des pages publiques et privées

Avertissement sur la performance

Lorsqu’il existe, ce fichier est chargé à chaque affichage de page (espace privée comme espace public) ; il doit donc rester le plus léger et économe possible.

Voir aussi

Pour débugguer les erreurs PHP

Sur le site programmer.spip.net

Notes

[1Dans les versions de SPIP antérieures à 1.9.2, ce fichier était placé dans le répertoire ecrire/

Auteur denisb Publié le : Mis à jour : 04/03/24

Traductions : català, English, français, Nederlands