d88d346bbdad8551af368f0de48cac8adbf3d13d
3 /***************************************************************************\
4 * SPIP, Systeme de publication pour l'internet *
6 * Copyright (c) 2001-2017 *
7 * Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James *
9 * Ce programme est un logiciel libre distribue sous licence GNU/GPL. *
10 * Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne. *
11 \***************************************************************************/
14 * Gestion de l'activation des plugins
16 * @package SPIP\Core\Plugins
19 if (!defined('_ECRIRE_INC_VERSION')) {
23 /** l'adresse du repertoire de telechargement et de decompactage des plugins */
24 define('_DIR_PLUGINS_AUTO', _DIR_PLUGINS
. 'auto/');
26 #include_spip('inc/texte'); // ????? Appelle public/parametrer trop tot avant la reconstruction du chemin des plugins.
27 include_spip('plugins/installer');
30 * Retourne la description de chaque plugin présent dans un répertoire
32 * Lecture des sous repertoire plugin existants
35 * - `liste_plugin_files()`
36 * - `liste_plugin_files(_DIR_PLUGINS_DIST)`
37 * - `liste_plugin_files(_DIR_PLUGINS_SUPPL)`
39 * @uses fast_find_plugin_dirs()
40 * @uses plugins_get_infos_dist()
42 * @param string|null $dir_plugins
43 * - string : Chemin (relatif à la racine du site) du répertoire à analyser.
44 * - null : utilise le chemin `_DIR_PLUGINS`.
47 function liste_plugin_files($dir_plugins = null) {
48 static $plugin_files = array();
49 if (is_null($dir_plugins)) {
50 $dir_plugins = _DIR_PLUGINS
;
52 if (!isset($plugin_files[$dir_plugins])
53 or count($plugin_files[$dir_plugins]) == 0
55 $plugin_files[$dir_plugins] = array();
56 foreach (fast_find_plugin_dirs($dir_plugins) as $plugin) {
57 $plugin_files[$dir_plugins][] = substr($plugin, strlen($dir_plugins));
60 sort($plugin_files[$dir_plugins]);
61 // et on lit le XML de tous les plugins pour le mettre en cache
62 // et en profiter pour nettoyer ceux qui n'existent plus du cache
63 $get_infos = charger_fonction('get_infos', 'plugins');
64 $get_infos($plugin_files[$dir_plugins], false, $dir_plugins, true);
67 return $plugin_files[$dir_plugins];
71 * Recherche rapide des répertoires de plugins contenus dans un répertoire
73 * @uses is_plugin_dir()
76 * Chemin du répertoire dont on souhaite retourner les sous répertoires
77 * @param int $max_prof
78 * Profondeur maximale des sous répertoires
80 * Liste complète des répeertoires
82 function fast_find_plugin_dirs($dir, $max_prof = 100) {
84 // revenir au repertoire racine si on a recu dossier/truc
85 // pour regarder dossier/truc/ ne pas oublier le / final
86 $dir = preg_replace(',/[^/]*$,', '', $dir);
94 if (is_plugin_dir($dir, '')) {
104 if (@is_dir
($dir) and is_readable($dir) and $d = opendir($dir)) {
105 while (($f = readdir($d)) !== false) {
106 if ($f[0] != '.' # ignorer . .. .svn etc
108 and is_dir($f = "$dir/$f")
116 foreach ($subdirs as $d) {
117 $fichiers = array_merge($fichiers, fast_find_plugin_dirs("$d/", $max_prof - 1));
124 * Indique si un répertoire (ou plusieurs) est la racine d'un plugin SPIP
126 * Vérifie le ou les chemins relatifs transmis pour vérifier qu'ils contiennent
127 * un `plugin.xml` ou un `paquet.xml`. Les chemins valides sont retournés.
129 * @param string|string[] $dir
130 * Chemin (relatif à `$dir_plugins`), ou liste de chemins à tester
131 * @param string|null $dir_plugins
132 * - string : Chemin de répertoire (relatif à la `_DIR_RACINE`), départ des chemin(s) à tester
133 * - null (par défaut) : utilise le chemin `_DIR_PLUGINS`
134 * @return string|string[]
135 * - string : Le chemin accepté (c'était un plugin)
136 * - '' : ce n'était pas un chemin valide
137 * - array : Ensemble des chemins acceptés (si `$dir` était array)
139 function is_plugin_dir($dir, $dir_plugins = null) {
141 if (is_array($dir)) {
142 foreach ($dir as $k => $d) {
143 if (!is_plugin_dir($d, $dir_plugins)) {
150 if (is_null($dir_plugins)) {
151 $dir_plugins = _DIR_PLUGINS
;
153 $search = array("$dir_plugins$dir/plugin.xml", "$dir_plugins$dir/paquet.xml");
155 foreach ($search as $s) {
156 if (file_exists($s)) {
164 /** Regexp d'extraction des informations d'un intervalle de compatibilité */
165 define('_EXTRAIRE_INTERVALLE', ',^[\[\(\]]([0-9.a-zRC\s\-]*)[;]([0-9.a-zRC\s\-\*]*)[\]\)\[]$,');
168 * Teste si le numéro de version d'un plugin est dans un intervalle donné.
170 * Cette fonction peut être volontairement trompée (phase de développement) :
171 * voir commentaire infra sur l'utilisation de la constante _DEV_VERSION_SPIP_COMPAT
173 * @uses spip_version_compare()
175 * @param string $intervalle
176 * Un intervalle entre 2 versions. ex: [2.0.0-dev;2.1.*]
177 * @param string $version
178 * Un numéro de version. ex: 3.1.99]
179 * @param string $avec_quoi
180 * Ce avec quoi est testée la compatibilité. par défaut ('')
181 * avec un plugin (cas des 'necessite'), parfois ('spip')
184 * True si dans l'intervalle, false sinon.
186 function plugin_version_compatible($intervalle, $version, $avec_quoi = '') {
188 if (!strlen($intervalle)) {
191 if (!preg_match(_EXTRAIRE_INTERVALLE
, $intervalle, $regs)) {
194 // Extraction des bornes et traitement de * pour la borne sup :
195 // -- on autorise uniquement les ecritures 3.0.*, 3.*
199 // si une version SPIP de compatibilité a été définie (dans
200 // mes_options.php, sous la forme : define('_DEV_VERSION_SPIP_COMPAT', '3.1.0');
201 // on l'utilise (phase de dev, de test...) mais *que* en cas de comparaison
202 // avec la version de SPIP (ne nuit donc pas aux tests de necessite
204 if (defined('_DEV_VERSION_SPIP_COMPAT') and $avec_quoi == 'spip' and $version !== _DEV_VERSION_SPIP_COMPAT
) {
205 if (plugin_version_compatible($intervalle, _DEV_VERSION_SPIP_COMPAT
, $avec_quoi)) {
208 // si pas de compatibilite avec _DEV_VERSION_SPIP_COMPAT, on essaye quand meme avec la vrai version
209 // cas du plugin qui n'est compatible qu'avec cette nouvelle version
212 $minimum_inc = $intervalle{0} == "[";
213 $maximum_inc = substr($intervalle, -1) == "]";
215 if (strlen($minimum)) {
216 if ($minimum_inc and spip_version_compare($version, $minimum, '<')) {
219 if (!$minimum_inc and spip_version_compare($version, $minimum, '<=')) {
223 if (strlen($maximum)) {
224 if ($maximum_inc and spip_version_compare($version, $maximum, '>')) {
227 if (!$maximum_inc and spip_version_compare($version, $maximum, '>=')) {
236 * Construire la liste des infos strictement necessaires aux plugins à activer
237 * afin de les mémoriser dans une meta pas trop grosse
239 * @uses liste_plugin_files()
240 * @uses plugins_get_infos_dist()
241 * @uses plugin_valide_resume()
242 * @uses plugin_fixer_procure()
244 * @param array $liste_plug
248 function liste_plugin_valides($liste_plug, $force = false) {
249 $liste_ext = liste_plugin_files(_DIR_PLUGINS_DIST
);
250 $get_infos = charger_fonction('get_infos', 'plugins');
252 // lister les extensions qui sont automatiquement actives
253 '_DIR_PLUGINS_DIST' => $get_infos($liste_ext, $force, _DIR_PLUGINS_DIST
),
254 '_DIR_PLUGINS' => $get_infos($liste_plug, $force, _DIR_PLUGINS
)
257 // creer une premiere liste non ordonnee mais qui ne retient
258 // que les plugins valides, et dans leur derniere version en cas de doublon
259 $infos['_DIR_RESTREINT'][''] = $get_infos('./', $force, _DIR_RESTREINT
);
260 $infos['_DIR_RESTREINT']['SPIP']['version'] = $GLOBALS['spip_version_branche'];
261 $infos['_DIR_RESTREINT']['SPIP']['chemin'] = array();
262 $liste_non_classee = array(
266 'version' => $GLOBALS['spip_version_branche'],
267 'dir_type' => '_DIR_RESTREINT',
272 foreach ($liste_ext as $plug) {
273 if (isset($infos['_DIR_PLUGINS_DIST'][$plug])) {
274 plugin_valide_resume($liste_non_classee, $plug, $infos, '_DIR_PLUGINS_DIST');
277 foreach ($liste_plug as $plug) {
278 if (isset($infos['_DIR_PLUGINS'][$plug])) {
279 plugin_valide_resume($liste_non_classee, $plug, $infos, '_DIR_PLUGINS');
283 if (defined('_DIR_PLUGINS_SUPPL') and _DIR_PLUGINS_SUPPL
) {
284 $infos['_DIR_PLUGINS_SUPPL'] = $get_infos($liste_plug, false, _DIR_PLUGINS_SUPPL
);
285 foreach ($liste_plug as $plug) {
286 if (isset($infos['_DIR_PLUGINS_SUPPL'][$plug])) {
287 plugin_valide_resume($liste_non_classee, $plug, $infos, '_DIR_PLUGINS_SUPPL');
292 plugin_fixer_procure($liste_non_classee, $infos);
294 return array($infos, $liste_non_classee);
298 * Ne retenir un plugin que s'il est valide
299 * et dans leur plus recente version compatible
300 * avec la version presente de SPIP
302 * @uses plugin_version_compatible()
303 * @uses spip_version_compare()
305 * @param array $liste
306 * @param string $plug
307 * @param array $infos
308 * @param string $dir_type
310 function plugin_valide_resume(&$liste, $plug, $infos, $dir_type) {
311 $i = $infos[$dir_type][$plug];
312 if (isset($i['erreur']) and $i['erreur']) {
315 if (!plugin_version_compatible($i['compatibilite'], $GLOBALS['spip_version_branche'], 'spip')) {
318 $p = strtoupper($i['prefix']);
319 if (!isset($liste[$p])
320 or spip_version_compare($i['version'], $liste[$p]['version'], '>')
324 'etat' => $i['etat'],
325 'version' => $i['version'],
327 'dir_type' => $dir_type
333 * Compléter la liste des plugins avec les éventuels procure
335 * les balises `<procure>` sont considerées comme des plugins proposés,
336 * mais surchargeables (on peut activer un plugin qui procure ça pour l'améliorer,
337 * donc avec le même prefixe, qui sera pris en compte si il a une version plus grande)
339 * @uses spip_version_compare()
341 * @param array $liste
342 * @param array $infos
344 function plugin_fixer_procure(&$liste, &$infos) {
345 foreach ($liste as $p => $resume) {
346 $i = $infos[$resume['dir_type']][$resume['dir']];
347 if (isset($i['procure']) and $i['procure']) {
348 foreach ($i['procure'] as $procure) {
349 $p = strtoupper($procure['nom']);
350 $dir = $resume['dir'];
354 $dir .= "procure:" . $procure['nom'];
356 $procure['etat'] = '?';
357 $procure['dir_type'] = $resume['dir_type'];
358 $procure['dir'] = $dir;
360 // si ce plugin n'est pas deja procure, ou dans une version plus ancienne
361 // on ajoute cette version a la liste
362 if (!isset($liste[$p])
363 or spip_version_compare($procure['version'], $liste[$p]['version'], '>')
365 $liste[$p] = $procure;
367 // on fournit une information minimale pour ne pas perturber la compilation
368 $infos[$resume['dir_type']][$dir] = array(
369 'prefix' => $procure['nom'],
370 'nom' => $procure['nom'],
371 'etat' => $procure['etat'],
372 'version' => $procure['version'],
374 'necessite' => array(),
375 'utilise' => array(),
379 'procure' => array(),
388 * Extrait les chemins d'une liste de plugin
390 * Sélectionne au passage ceux qui sont dans `$dir_plugins` uniquement
393 * @param array $liste
394 * @param string $dir_plugins
397 function liste_chemin_plugin($liste, $dir_plugins = _DIR_PLUGINS
) {
398 foreach ($liste as $prefix => $infos) {
401 defined($infos['dir_type'])
402 and constant($infos['dir_type']) == $dir_plugins)
404 $liste[$prefix] = $infos['dir'];
406 unset($liste[$prefix]);
414 * Liste les chemins vers les plugins actifs du dossier fourni en argument
415 * a partir d'une liste d'elelements construits par plugin_valide_resume
417 * @uses liste_plugin_actifs()
418 * @uses liste_chemin_plugin()
420 * @param string $dir_plugins
421 * Chemin du répertoire de plugins
424 function liste_chemin_plugin_actifs($dir_plugins = _DIR_PLUGINS
) {
425 include_spip('plugins/installer');
427 return liste_chemin_plugin(liste_plugin_actifs(), $dir_plugins);
431 * Trier les plugins en vériant leur dépendances (qui doivent être présentes)
433 * Pour tester "utilise", il faut connaître tous les plugins
434 * qui seront forcément absents à la fin,
435 * car absent de la liste des plugins actifs.
437 * Il faut donc construire une liste ordonnée.
439 * Cette fonction détecte des dépendances circulaires,
440 * avec un doute sur un "utilise" qu'on peut ignorer.
441 * Mais ne pas insérer silencieusement et risquer un bug sournois latent
443 * @uses plugin_version_compatible()
445 * @param array $infos
446 * Répertoire (plugins, plugins-dist, ...) => Couples (prefixes => infos completes) des plugins qu'ils contiennent
447 * @param array $liste_non_classee
448 * Couples (prefixe => description) des plugins qu'on souhaite utiliser
450 * Tableau de 3 éléments :
451 * - $liste : couples (prefixes => description) des plugins valides
452 * - $ordre : couples (prefixes => infos completes) des plugins triés
453 * (les plugins nécessités avant les plugins qui les utilisent)
454 * - $liste_non_classee : couples (prefixes => description) des plugins
455 * qui n'ont pas satisfait leurs dépendances
457 function plugin_trier($infos, $liste_non_classee) {
458 $toute_la_liste = $liste_non_classee;
459 $liste = $ordre = array();
462 while ($c = count($liste_non_classee) and $c != $count) { // tant qu'il reste des plugins a classer, et qu'on ne stagne pas
463 #echo "tour::";var_dump($liste_non_classee);
465 foreach ($liste_non_classee as $p => $resume) {
466 $plug = $resume['dir'];
467 $dir_type = $resume['dir_type'];
468 $info1 = $infos[$dir_type][$plug];
469 // si des plugins sont necessaires,
470 // on ne peut inserer qu'apres eux
471 foreach ($info1['necessite'] as $need) {
472 $nom = strtoupper($need['nom']);
473 $compat = isset($need['compatibilite']) ?
$need['compatibilite'] : '';
474 if (!isset($liste[$nom]) or !plugin_version_compatible($compat, $liste[$nom]['version'])) {
482 // idem si des plugins sont utiles,
483 // sauf si ils sont de toute facon absents de la liste
484 foreach ($info1['utilise'] as $need) {
485 $nom = strtoupper($need['nom']);
486 $compat = isset($need['compatibilite']) ?
$need['compatibilite'] : '';
487 if (isset($toute_la_liste[$nom])) {
488 if (!isset($liste[$nom]) or
489 !plugin_version_compatible($compat, $liste[$nom]['version'])
498 $liste[$p] = $liste_non_classee[$p];
499 unset($liste_non_classee[$p]);
504 return array($liste, $ordre, $liste_non_classee);
508 * Collecte les erreurs de dépendances des plugins dans la meta `plugin_erreur_activation`
510 * @uses plugin_necessite()
511 * @uses plugin_controler_lib()
513 * @param array $liste_non_classee
514 * Couples (prefixe => description) des plugins en erreur
515 * @param array $liste
516 * Couples (prefixe => description) des plugins qu'on souhaite utiliser
517 * @param array $infos
518 * Répertoire (plugins, plugins-dist, ...) => Couples (prefixes => infos completes) des plugins qu'ils contiennent
520 function plugins_erreurs($liste_non_classee, $liste, $infos, $msg = array()) {
521 static $erreurs = array();
523 if (!is_array($liste)) {
527 // les plugins en erreur ne sont pas actifs ; ils ne doivent pas être dans la liste
528 $liste = array_diff_key($liste, $liste_non_classee);
530 foreach ($liste_non_classee as $p => $resume) {
531 $dir_type = $resume['dir_type'];
532 $plug = $resume['dir'];
533 $k = $infos[$dir_type][$plug];
535 $plug = constant($dir_type) . $plug;
536 if (!isset($msg[$p])) {
537 if (!$msg[$p] = plugin_necessite($k['necessite'], $liste, 'necessite')) {
538 $msg[$p] = plugin_necessite($k['utilise'], $liste, 'utilise');
541 foreach ($msg[$p] as $c => $l) {
542 $msg[$p][$c] = plugin_controler_lib($l['nom'], $l['lien']);
545 $erreurs[$plug] = $msg[$p];
548 ecrire_meta('plugin_erreur_activation', serialize($erreurs));
552 * Retourne les erreurs d'activation des plugins, au format html ou brut
555 * - true : pour obtenir le tableau brut des erreurs
556 * - false : Code HTML
558 * - true pour effacer la meta qui stocke les erreurs.
559 * @return string|array
560 * - Liste des erreurs ou code HTML des erreurs
562 function plugin_donne_erreurs($raw = false, $raz = true) {
563 if (!isset($GLOBALS['meta']['plugin_erreur_activation'])) {
564 return $raw ?
array() : '';
566 $list = @unserialize
($GLOBALS['meta']['plugin_erreur_activation']);
567 // Compat ancienne version
569 $list = $raw ?
array() : $GLOBALS['meta']['plugin_erreur_activation'];
571 foreach ($list as $plug => $msg) {
572 $list[$plug] = "<li>" . _T('plugin_impossible_activer', array('plugin' => $plug))
573 . "<ul><li>" . implode("</li><li>", $msg) . "</li></ul></li>";
575 $list = "<ul>" . join("\n", $list) . "</ul>";
578 effacer_meta('plugin_erreur_activation');
585 * Teste des dépendances
587 * Et vérifie que chaque dépendance est présente
588 * dans la liste de plugins donnée
590 * @uses plugin_controler_necessite()
593 * Tableau de dépendances dont on souhaite vérifier leur présence
594 * @param array $liste
595 * Tableau des plugins présents
597 * Tableau des messages d'erreurs reçus. Il sera vide si tout va bien.
600 function plugin_necessite($n, $liste, $balise = 'necessite') {
602 foreach ($n as $need) {
603 $id = strtoupper($need['nom']);
604 $r = plugin_controler_necessite(
607 isset($need['compatibilite']) ?
$need['compatibilite'] : '',
619 * Vérifie qu'une dépendance (plugin) est bien présente.
621 * @uses plugin_version_compatible()
622 * @uses plugin_message_incompatibilite()
625 * Liste de description des plugins
627 * Le plugin donc on cherche la presence
629 * L'éventuelle intervalle de compatibilité de la dépendance. ex: [1.1.0;]
631 * Permet de définir si on teste un utilise ou un nécessite
634 * Message d'erreur lorsque la dépendance est absente.
636 function plugin_controler_necessite($liste, $nom, $intervalle, $balise) {
637 if (isset($liste[$nom]) and plugin_version_compatible($intervalle, $liste[$nom]['version'])) {
641 return plugin_message_incompatibilite(
643 (isset($liste[$nom]) ?
$liste[$nom]['version'] : ""),
650 * @param string $intervalle
651 * L'éventuelle intervalle de compatibilité de la dépendance. ex: [1.1.0;]
652 * @param string $version
653 * La version en cours active pour le plugin demandé (ou php ou extension php demandée)
655 * Le plugin (ou php ou extension php) qui est absent
656 * @param string $balise
657 * Le type de balise utilisé (necessite ou utilise)
659 * Le message d'erreur.
661 function plugin_message_incompatibilite($intervalle, $version, $nom, $balise) {
663 // prendre en compte les erreurs de dépendances à PHP
664 // ou à une extension PHP avec des messages d'erreurs dédiés.
666 if ($nom === 'PHP') {
668 } elseif (strncmp($nom, 'PHP:', 4) === 0) {
669 $type = 'extension_php';
670 list(,$nom) = explode(':', $nom, 2);
673 if (preg_match(_EXTRAIRE_INTERVALLE
, $intervalle, $regs)) {
677 $minimum_inclus = $intervalle{0} == "[";
678 $maximum_inclus = substr($intervalle, -1) == "]";
680 if (strlen($minimum)) {
681 if ($minimum_inclus and spip_version_compare($version, $minimum, '<')) {
682 return _T("plugin_${balise}_${type}", array(
684 'version' => ' ≥ ' . $minimum
687 if (!$minimum_inclus and spip_version_compare($version, $minimum, '<=')) {
688 return _T("plugin_${balise}_${type}", array(
690 'version' => ' > ' . $minimum
695 if (strlen($maximum)) {
696 if ($maximum_inclus and spip_version_compare($version, $maximum, '>')) {
697 return _T("plugin_${balise}_${type}", array(
699 'version' => ' ≤ ' . $maximum
702 if (!$maximum_inclus and spip_version_compare($version, $maximum, '>=')) {
703 return _T("plugin_${balise}_plugin", array(
705 'version' => ' < ' . $maximum
711 // note : il ne peut pas y avoir d'erreur sur
712 // - un 'utilise' sans version.
713 // - un 'php' sans version.
714 return _T("plugin_necessite_${type}_sans_version", array('plugin' => $nom));
718 function plugin_controler_lib($lib, $url) {
719 /* Feature sortie du core, voir STP
721 include_spip('inc/charger_plugin');
722 $url = '<br />' . bouton_telechargement_plugin($url, 'lib');
724 return _T('plugin_necessite_lib', array('lib' => $lib)) . " <a href='$url'>$url</a>";
729 * Calcule la liste des plugins actifs et recompile les fichiers caches
730 * qui leurs sont relatifs
732 * @uses ecrire_plugin_actifs()
734 * @param bool $pipe_recherche ?
736 * true si il y a eu des modifications sur la liste des plugins actifs, false sinon
738 function actualise_plugins_actifs($pipe_recherche = false) {
739 return ecrire_plugin_actifs('', $pipe_recherche, 'force');
744 * Calcule ou modifie la liste des plugins actifs et recompile les fichiers caches
745 * qui leurs sont relatifs
748 * Les ecrire_meta() doivent en principe aussi initialiser la valeur a vide
749 * si elle n'existe pas risque de pb en php5 a cause du typage ou de null
750 * (verifier dans la doc php)
752 * @param string|string[] $plugin
753 * Plugin ou plugins concernés (leur chemin depuis le répertoire plugins)
754 * @param bool $pipe_recherche
756 * @param string $operation
757 * - raz : recalcule tout
758 * - ajoute : ajoute le plugin indiqué à la liste des plugins actifs
759 * - enleve : enleve le plugin indiqué de la liste des plugins actifs
762 * true si il y a eu des modifications sur la liste des plugins actifs, false sinon
764 function ecrire_plugin_actifs($plugin, $pipe_recherche = false, $operation = 'raz') {
766 // creer le repertoire cache/ si necessaire ! (installation notamment)
767 $cache = sous_repertoire(_DIR_CACHE
, '', false, true);
769 // Si on n'a ni cache accessible, ni connexion SQL, on ne peut pas faire grand chose encore.
770 if (!$cache and !spip_connect()) {
774 if ($operation != 'raz') {
775 $plugin_valides = liste_chemin_plugin_actifs();
776 $plugin_valides = is_plugin_dir($plugin_valides);
777 if (defined('_DIR_PLUGINS_SUPPL') && _DIR_PLUGINS_SUPPL
) {
778 $plugin_valides_supp = liste_chemin_plugin_actifs(_DIR_PLUGINS_SUPPL
);
779 $plugin_valides_supp = is_plugin_dir($plugin_valides_supp, _DIR_PLUGINS_SUPPL
);
780 $plugin_valides = array_merge($plugin_valides, $plugin_valides_supp);
782 // si des plugins sont en attentes (coches mais impossible a activer)
783 // on les reinjecte ici
784 if (isset($GLOBALS['meta']['plugin_attente'])
785 and $a = unserialize($GLOBALS['meta']['plugin_attente'])
787 $plugin_valides = $plugin_valides +
liste_chemin_plugin($a);
790 if ($operation == 'ajoute') {
791 $plugin = array_merge($plugin_valides, $plugin);
792 } elseif ($operation == 'enleve') {
793 $plugin = array_diff($plugin_valides, $plugin);
795 $plugin = $plugin_valides;
798 $actifs_avant = isset($GLOBALS['meta']['plugin']) ?
$GLOBALS['meta']['plugin'] : '';
800 // si une fonction de gestion de dependances existe, l'appeler ici
801 if ($ajouter_dependances = charger_fonction("ajouter_dependances", "plugins", true)) {
802 $plugin = $ajouter_dependances($plugin);
805 // recharger le xml des plugins a activer
806 // on force le reload ici, meme si le fichier xml n'a pas change
807 // pour ne pas rater l'ajout ou la suppression d'un fichier fonctions/options/administrations
808 // pourra etre evite quand on ne supportera plus les plugin.xml
809 // en deplacant la detection de ces fichiers dans la compilation ci dessous
810 list($infos, $liste) = liste_plugin_valides($plugin, true);
811 // trouver l'ordre d'activation
812 list($plugin_valides, $ordre, $reste) = plugin_trier($infos, $liste);
814 plugins_erreurs($reste, $liste, $infos);
817 // Ignorer les plugins necessitant une lib absente
818 // et preparer la meta d'entete Http
819 $err = $msg = $header = array();
820 foreach ($plugin_valides as $p => $resume) {
821 // Les headers ne doivent pas indiquer les versions des extensions PHP, ni la version PHP
822 if (0 !== strpos($p, 'PHP:') and $p !== 'PHP') {
823 $header[] = $p . ($resume['version'] ?
"(" . $resume['version'] . ")" : "");
825 if ($resume['dir']) {
826 foreach ($infos[$resume['dir_type']][$resume['dir']]['lib'] as $l) {
827 if (!find_in_path($l['nom'], 'lib/')) {
830 unset($plugin_valides[$p]);
836 plugins_erreurs($err, '', $infos, $msg);
839 if (isset($GLOBALS['meta']['message_crash_plugins'])) {
840 effacer_meta('message_crash_plugins');
842 ecrire_meta('plugin', serialize($plugin_valides));
843 $liste = array_diff_key($liste, $plugin_valides);
844 ecrire_meta('plugin_attente', serialize($liste));
845 $header = strtolower(implode(",", $header));
846 if (!isset($GLOBALS['spip_header_silencieux']) or !$GLOBALS['spip_header_silencieux']) {
847 ecrire_fichier(_DIR_VAR
. "config.txt",
848 (defined('_HEADER_COMPOSED_BY') ? _HEADER_COMPOSED_BY
: "Composed-By: SPIP") . ' ' . $GLOBALS['spip_version_affichee'] . " @ www.spip.net + " . $header);
850 @unlink
(_DIR_VAR
. "config.txt");
852 // generer charger_plugins_chemin.php
853 plugins_precompile_chemin($plugin_valides, $ordre);
854 // generer les fichiers
855 // - charger_plugins_options.php
856 // - charger_plugins_fonctions.php
857 plugins_precompile_xxxtions($plugin_valides, $ordre);
858 // charger les chemins des plugins et les fichiers d'options
859 // (qui peuvent déclarer / utiliser des pipelines, ajouter d'autres chemins)
860 plugins_amorcer_plugins_actifs();
861 // mise a jour de la matrice des pipelines
862 $prepend_code = pipeline_matrice_precompile($plugin_valides, $ordre, $pipe_recherche);
863 // generer le fichier _CACHE_PIPELINE
864 pipeline_precompile($prepend_code);
866 // attendre eventuellement l'invalidation du cache opcode
867 spip_attend_invalidation_opcode_cache();
869 if (spip_connect()) {
870 // lancer et initialiser les nouveaux crons !
871 include_spip('inc/genie');
872 genie_queue_watch_dist();
875 return ($GLOBALS['meta']['plugin'] != $actifs_avant);
879 * Écrit le fichier de déclaration des chemins (path) des plugins actifs
881 * Le fichier créé, une fois exécuté permet à SPIP de rechercher
882 * des fichiers dans les répertoires des plugins concernés.
884 * @see _chemin() Utilisé pour déclarer les chemins.
885 * @uses plugin_version_compatible()
886 * @uses ecrire_fichier_php()
888 * @param array $plugin_valides
889 * Couples (prefixe => description) des plugins qui seront actifs
890 * @param array $ordre
891 * Couples (prefixe => infos complètes) des plugins qui seront actifs, dans l'ordre de leurs dépendances
893 function plugins_precompile_chemin($plugin_valides, $ordre) {
896 foreach ($ordre as $p => $info) {
897 // $ordre peur contenir des plugins en attente et non valides pour ce hit
898 if (isset($plugin_valides[$p])) {
899 $dir_type = $plugin_valides[$p]['dir_type'];
900 $plug = $plugin_valides[$p]['dir'];
901 // definir le plugin, donc le path avant l'include du fichier options
902 // permet de faire des include_spip pour attraper un inc_ du plugin
904 $dir = $dir_type . ".'" . $plug . "/'";
906 $prefix = strtoupper(preg_replace(',\W,', '_', $info['prefix']));
907 if ($prefix !== "SPIP") {
908 $contenu .= "define('_DIR_PLUGIN_$prefix',$dir);\n";
909 foreach ($info['chemin'] as $chemin) {
910 if (!isset($chemin['version']) or plugin_version_compatible($chemin['version'],
911 $GLOBALS['spip_version_branche'], 'spip')
913 $dir = $chemin['path'];
914 if (strlen($dir) and $dir{0} == "/") {
915 $dir = substr($dir, 1);
917 if (strlen($dir) and $dir == "./") {
921 $dir = rtrim($dir, '/') . '/';
923 if (!isset($chemin['type']) or $chemin['type'] == 'public') {
924 $chemins['public'][] = "_DIR_PLUGIN_$prefix" . (strlen($dir) ?
".'$dir'" : "");
926 if (!isset($chemin['type']) or $chemin['type'] == 'prive') {
927 $chemins['prive'][] = "_DIR_PLUGIN_$prefix" . (strlen($dir) ?
".'$dir'" : "");
934 if (count($chemins)) {
935 $contenu .= "if (_DIR_RESTREINT) _chemin(implode(':',array(" . implode(',',
936 array_reverse($chemins['public'])) . ")));\n"
937 . "else _chemin(implode(':',array(" . implode(',', array_reverse($chemins['prive'])) . ")));\n";
940 ecrire_fichier_php(_CACHE_PLUGINS_PATH
, $contenu);
944 * Écrit les fichiers de chargement des fichiers d'options et de fonctions des plugins
946 * Les onglets et menus déclarés dans le fichier paquet.xml des plugins sont également
947 * ajoutés au fichier de fonctions créé.
949 * @uses plugin_ongletbouton()
950 * @uses ecrire_fichier_php()
952 * @param array $plugin_valides
953 * Couples (prefixe => description) des plugins qui seront actifs
954 * @param array $ordre
955 * Couples (prefixe => infos complètes) des plugins qui seront actifs, dans l'ordre de leurs dépendances
957 function plugins_precompile_xxxtions($plugin_valides, $ordre) {
958 $contenu = array('options' => '', 'fonctions' => '');
963 foreach ($ordre as $p => $info) {
964 // $ordre peur contenir des plugins en attente et non valides pour ce hit
965 if (isset($plugin_valides[$p])) {
966 $dir_type = $plugin_valides[$p]['dir_type'];
967 $plug = $plugin_valides[$p]['dir'];
968 $dir = constant($dir_type);
969 $root_dir_type = str_replace('_DIR_', '_ROOT_', $dir_type);
971 $boutons = array_merge($boutons, $info['menu']);
973 if ($info['onglet']) {
974 $onglets = array_merge($onglets, $info['onglet']);
976 foreach ($contenu as $charge => $v) {
977 // si pas declare/detecte a la lecture du paquet.xml,
978 // detecer a nouveau ici puisque son ajout ne provoque pas une modif du paquet.xml
979 // donc ni sa relecture, ni sa detection
980 if (!isset($info[$charge])
981 and $dir // exclure le cas du plugin "SPIP"
982 and strpos($dir, ":") === false // exclure le cas des procure:
983 and file_exists("$dir$plug/paquet.xml") // uniquement pour les paquet.xml
985 if (is_readable("$dir$plug/" . ($file = $info['prefix'] . "_" . $charge . ".php"))) {
986 $info[$charge] = array($file);
989 if (isset($info[$charge])) {
990 $files = $info[$charge];
991 foreach ($files as $k => $file) {
992 // on genere un if file_exists devant chaque include
993 // pour pouvoir garder le meme niveau d'erreur general
995 if (!is_readable("$dir$plug/$file")
996 // uniquement pour les paquet.xml
997 and file_exists("$dir$plug/paquet.xml")
999 unset($info[$charge][$k]);
1001 $_file = $root_dir_type . ".'$plug/$file'";
1002 $contenu[$charge] .= "include_once_check($_file);\n";
1007 $sign .= md5(serialize($info));
1011 $contenu['options'] = "define('_PLUGINS_HASH','" . md5($sign) . "');\n" . $contenu['options'];
1012 $contenu['fonctions'] .= plugin_ongletbouton("boutons_plugins", $boutons)
1013 . plugin_ongletbouton("onglets_plugins", $onglets);
1015 ecrire_fichier_php(_CACHE_PLUGINS_OPT
, $contenu['options']);
1016 ecrire_fichier_php(_CACHE_PLUGINS_FCT
, $contenu['fonctions']);
1020 * Compile les entrées d'un menu et retourne le code php d'exécution
1022 * Génère et retourne un code php (pour enregistrement dans un fichier de cache)
1023 * permettant d'obtenir la liste des entrées de menus, ou des onglets
1024 * de l'espace privé.
1026 * Définit également une constante (_UPDATED_$nom et _UPDATED_md5_$nom),
1027 * signalant une modification de ces menus
1029 * @param string $nom Nom du type de menu
1030 * Exemple: boutons_plugins, onglets_plugins
1031 * @param array $val Liste des entrées de ce menu
1032 * @return string Code php
1034 function plugin_ongletbouton($nom, $val) {
1039 $val = serialize($val);
1042 if (!defined("_UPDATED_$nom")) {
1043 define("_UPDATED_$nom", $val);
1044 define("_UPDATED_md5_$nom", $md5);
1046 $val = "unserialize('" . str_replace("'", "\'", $val) . "')";
1049 "if (!function_exists('$nom')) {\n"
1050 . "function $nom(){return defined('_UPDATED_$nom')?unserialize(_UPDATED_$nom):$val;}\n"
1051 . "function md5_$nom(){return defined('_UPDATED_md5_$nom')?_UPDATED_md5_$nom:'" . $md5 . "';}\n"
1056 * Chargement des plugins actifs dans le path de SPIP
1057 * et exécution de fichiers d'options des plugins
1059 * Les fichiers d'options peuvent déclarer des pipelines ou de
1062 * La connaissance chemins peut être nécessaire pour la construction
1063 * du fichier d'exécution des pipelines.
1065 function plugins_amorcer_plugins_actifs() {
1067 if (@is_readable
(_CACHE_PLUGINS_PATH
)) {
1068 include_once(_CACHE_PLUGINS_PATH
);
1071 if (@is_readable
(_CACHE_PLUGINS_OPT
)) {
1072 include_once(_CACHE_PLUGINS_OPT
);
1074 spip_log("pipelines desactives: impossible de produire " . _CACHE_PLUGINS_OPT
);
1079 * Crée la liste des filtres à traverser pour chaque pipeline
1081 * Complète la globale `spip_pipeline` des fonctions que doit traverser un pipeline,
1082 * et la globale `spip_matrice` des fichiers à charger qui contiennent ces fonctions.
1084 * Retourne aussi pour certaines balises présentes dans les paquet.xml (script, style, genie),
1085 * un code PHP à insérer au début de la chaîne du ou des pipelines associés à cette balise
1086 * (insert_head, insert_head_css, taches_generales_cron, ...). Ce sont des écritures
1087 * raccourcies pour des usages fréquents de ces pipelines.
1089 * @param array $plugin_valides
1090 * Couples (prefixe => description) des plugins qui seront actifs
1091 * @param array $ordre
1092 * Couples (prefixe => infos complètes) des plugins qui seront actifs, dans l'ordre de leurs dépendances
1093 * @param string $pipe_recherche
1095 * Couples (nom du pipeline => Code PHP à insérer au début du pipeline)
1097 function pipeline_matrice_precompile($plugin_valides, $ordre, $pipe_recherche) {
1098 static $liste_pipe_manquants = array();
1099 if (($pipe_recherche) && (!in_array($pipe_recherche, $liste_pipe_manquants))) {
1100 $liste_pipe_manquants[] = $pipe_recherche;
1103 $prepend_code = array();
1105 foreach ($ordre as $p => $info) {
1106 // $ordre peur contenir des plugins en attente et non valides pour ce hit
1107 if (isset($plugin_valides[$p])) {
1108 $dir_type = $plugin_valides[$p]['dir_type'];
1109 $root_dir_type = str_replace('_DIR_', '_ROOT_', $dir_type);
1110 $plug = $plugin_valides[$p]['dir'];
1111 $prefix = (($info['prefix'] == "spip") ?
"" : $info['prefix'] . "_");
1112 if (isset($info['pipeline']) and is_array($info['pipeline'])) {
1113 foreach ($info['pipeline'] as $pipe) {
1114 $nom = $pipe['nom'];
1115 if (isset($pipe['action'])) {
1116 $action = $pipe['action'];
1120 $nomlower = strtolower($nom);
1121 if ($nomlower != $nom
1122 and isset($GLOBALS['spip_pipeline'][$nom])
1123 and !isset($GLOBALS['spip_pipeline'][$nomlower])
1125 $GLOBALS['spip_pipeline'][$nomlower] = $GLOBALS['spip_pipeline'][$nom];
1126 unset($GLOBALS['spip_pipeline'][$nom]);
1129 // une action vide est une declaration qui ne doit pas etre compilee !
1130 if (!isset($GLOBALS['spip_pipeline'][$nom])) // creer le pipeline eventuel
1132 $GLOBALS['spip_pipeline'][$nom] = "";
1135 if (strpos($GLOBALS['spip_pipeline'][$nom], "|$prefix$action") === false) {
1136 $GLOBALS['spip_pipeline'][$nom] = preg_replace(",(\|\||$),", "|$prefix$action\\1",
1137 $GLOBALS['spip_pipeline'][$nom], 1);
1139 if (isset($pipe['inclure'])) {
1140 $GLOBALS['spip_matrice']["$prefix$action"] =
1141 "$root_dir_type:$plug/" . $pipe['inclure'];
1146 if (isset($info['genie']) and count($info['genie'])) {
1147 if (!isset($prepend_code['taches_generales_cron'])) {
1148 $prepend_code['taches_generales_cron'] = "";
1150 foreach ($info['genie'] as $genie) {
1151 $nom = $prefix . $genie['nom'];
1152 $periode = max(60, intval($genie['periode']));
1153 if (charger_fonction($nom, "genie", true)) {
1154 $prepend_code['taches_generales_cron'] .= "\$val['$nom'] = $periode;\n";
1156 spip_log("Fonction genie_$nom introuvable", _LOG_ERREUR
);
1160 if (isset($info['style']) and count($info['style'])) {
1161 if (!isset($prepend_code['insert_head_css'])) {
1162 $prepend_code['insert_head_css'] = "";
1164 if (!isset($prepend_code['header_prive_css'])) {
1165 $prepend_code['header_prive_css'] = "";
1167 foreach ($info['style'] as $style) {
1168 if (isset($style['path']) and $style['path']) {
1169 $code = "if (\$f=timestamp(direction_css(find_in_path('" . addslashes($style['path']) . "')))) ";
1171 $code = "if (\$f='" . addslashes($style['url']) . "') ";
1173 $code .= "\$val .= '<link rel=\"stylesheet\" href=\"'.\$f.'\" type=\"text/css\"";
1174 if (isset($style['media']) and strlen($style['media'])) {
1175 $code .= " media=\"" . addslashes($style['media']) . "\"";
1178 if ($style['type'] != 'prive') {
1179 $prepend_code['insert_head_css'] .= $code;
1181 if ($style['type'] != 'public') {
1182 $prepend_code['header_prive_css'] .= $code;
1186 if (!isset($prepend_code['insert_head'])) {
1187 $prepend_code['insert_head'] = "";
1189 if (!isset($prepend_code['header_prive'])) {
1190 $prepend_code['header_prive'] = "";
1192 if (isset($info['script']) and count($info['script'])) {
1193 foreach ($info['script'] as $script) {
1194 if (isset($script['path']) and $script['path']) {
1195 $code = "if (\$f=timestamp(find_in_path('" . addslashes($script['path']) . "'))) ";
1197 $code = "if (\$f='" . addslashes($script['url']) . "') ";
1199 $code .= "\$val .= '<script src=\"'.\$f.'\" type=\"text/javascript\"></script>';\n";
1200 if ($script['type'] != 'prive') {
1201 $prepend_code['insert_head'] .= $code;
1203 if ($script['type'] != 'public') {
1204 $prepend_code['header_prive'] .= $code;
1211 $prepend_code['insert_head'] =
1212 "include_once_check(_DIR_RESTREINT . 'inc/pipelines.php');\n"
1213 . "\$val = minipipe('f_jQuery', \$val);\n"
1214 . $prepend_code['insert_head'];
1215 $prepend_code['header_prive'] =
1216 "include_once_check(_DIR_RESTREINT . 'inc/pipelines_ecrire.php');\n"
1217 . "\$val = minipipe('f_jQuery_prive', \$val);\n"
1218 . $prepend_code['header_prive'];
1220 // on ajoute les pipe qui ont ete recenses manquants
1221 foreach ($liste_pipe_manquants as $add_pipe) {
1222 if (!isset($GLOBALS['spip_pipeline'][$add_pipe])) {
1223 $GLOBALS['spip_pipeline'][$add_pipe] = '';
1227 return $prepend_code;
1231 * Précompilation des pipelines
1233 * Crée le fichier d'exécution des pipelines
1234 * dont le chemin est défini par `_CACHE_PIPELINES`
1236 * La liste des pipelines est définie par la globale `spip_pipeline`
1237 * qui a été remplie soit avec les fichiers d'options, soit avec
1238 * des descriptions de plugins (plugin.xml ou paquet.xml) dont celui de SPIP lui-même.
1240 * Les fichiers à charger pour accéder aux fonctions qui doivent traverser
1241 * un pipeline se trouve dans la globale `spip_matrice`.
1243 * @see pipeline_matrice_precompile()
1245 * @uses ecrire_fichier_php()
1246 * @uses clear_path_cache()
1248 * @param array $prepend_code
1249 * Code PHP à insérer avant le passage dans la chaîne des fonctions d'un pipeline
1250 * Couples 'Nom du pipeline' => Code PHP à insérer
1252 function pipeline_precompile($prepend_code = array()) {
1255 foreach ($GLOBALS['spip_pipeline'] as $action => $pipeline) {
1258 $pipe = array_filter(explode('|', $pipeline));
1259 // Eclater le pipeline en filtres et appliquer chaque filtre
1260 foreach ($pipe as $fonc) {
1261 $fonc = trim($fonc);
1262 $s_call .= '$val = minipipe(\'' . $fonc . '\', $val);' . "\n";
1263 if (isset($GLOBALS['spip_matrice'][$fonc])) {
1264 $file = $GLOBALS['spip_matrice'][$fonc];
1266 // si un _DIR_XXX: est dans la chaine, on extrait la constante
1267 if (preg_match(",(_(DIR|ROOT)_[A-Z_]+):,Ums", $file, $regs)) {
1269 $root_dir = str_replace('_DIR_', '_ROOT_', $dir);
1270 if (defined($root_dir)) {
1273 $file = str_replace($regs[0], "'." . $dir . ".'", $file);
1274 $file = str_replace("''.", "", $file);
1275 $file = str_replace(constant($dir), '', $file);
1277 $s_inc .= "include_once_check($file);\n";
1280 if (strlen($s_inc)) {
1281 $s_inc = "static \$inc=null;\nif (!\$inc){\n$s_inc\$inc=true;\n}\n";
1283 $content .= "// Pipeline $action \n"
1284 . "function execute_pipeline_$action(&\$val){\n"
1286 . ((isset($prepend_code[$action]) and strlen($prepend_code[$action])) ?
trim($prepend_code[$action]) . "\n" : '')
1288 . "return \$val;\n}\n";
1290 ecrire_fichier_php(_CACHE_PIPELINES
, $content);
1296 * Indique si un chemin de plugin fait parti des plugins activés sur le site
1298 * @param string $plug_path
1301 * true si le plugin est actif, false sinon
1303 function plugin_est_installe($plug_path) {
1304 $plugin_installes = isset($GLOBALS['meta']['plugin_installes']) ?
unserialize($GLOBALS['meta']['plugin_installes']) : array();
1305 if (!$plugin_installes) {
1309 return in_array($plug_path, $plugin_installes);
1314 * Parcours les plugins activés et appelle leurs fonctions d'installation si elles existent.
1316 * Elle ajoute ensuite les plugins qui ont été installés dans la valeur "plugin_installes"
1317 * de la table meta. Cette meta ne contient que les noms des plugins qui ont une version_base.
1319 * @uses plugins_installer_dist()
1321 function plugin_installes_meta() {
1322 $installer_plugins = charger_fonction('installer', 'plugins');
1323 $meta_plug_installes = array();
1324 foreach (unserialize($GLOBALS['meta']['plugin']) as $prefix => $resume) {
1325 if ($plug = $resume['dir']) {
1326 $infos = $installer_plugins($plug, 'install', $resume['dir_type']);
1328 if (!is_array($infos) or $infos['install_test'][0]) {
1329 $meta_plug_installes[] = $plug;
1331 if (is_array($infos)) {
1332 list($ok, $trace) = $infos['install_test'];
1333 include_spip('inc/filtres_boites');
1334 echo "<div class='install-plugins svp_retour'>"
1335 . boite_ouvrir(_T('plugin_titre_installation', array('plugin' => typo($infos['nom']))),
1336 ($ok ?
'success' : 'error'))
1338 . "<div class='result'>"
1339 . ($ok ?
((isset($infos['upgrade']) && $infos['upgrade']) ?
_T("plugin_info_upgrade_ok") : _T("plugin_info_install_ok")) : _T("avis_operation_echec"))
1347 ecrire_meta('plugin_installes', serialize($meta_plug_installes), 'non');
1351 * Écrit un fichier PHP
1353 * @param string $nom
1355 * @param string $contenu
1356 * Contenu du fichier (sans les balises ouvrantes et fermantes de PHP)
1357 * @param string $comment
1358 * Commentaire : code écrit en tout début de fichier, après la balise PHP ouvrante
1360 function ecrire_fichier_php($nom, $contenu, $comment = '') {
1361 ecrire_fichier($nom,
1362 '<' . '?php' . "\n" . $comment . "\nif (defined('_ECRIRE_INC_VERSION')) {\n" . $contenu . "}\n?" . '>');