SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

290 Plugins, 198 contribs sur SPIP-Zone, 93 visiteurs en ce moment

Accueil > Documentation > SPIP en ligne de commande > SPIP-Cli

SPIP-Cli

20 décembre 2015 – par RastaPopoulos – 14 commentaires

21 votes

SPIP-Cli est une interface en ligne de commande pour SPIP.

SPIP-Cli sert à interagir avec SPIP depuis la ligne de commande, à la fois avant d’avoir un SPIP sous la main (installation, configuration…), puis ensuite pour administrer ou modifier un SPIP existant depuis un terminal.

L’outil fournit une liste de commandes utiles et génériques en rapport avec la distribution officielle de SPIP. Elles seront complétées au fur et à mesure. Les plugins peuvent ensuite fournir de nouvelles commandes supplémentaires propres à leurs besoins.

Installation

Pré-requis : il faut avoir Composer installé sur la machine.

Les explications suivantes sont orientées autour d’une installation sous Linux, mais fonctionnent aussi sur Mac OS. Nous conseillons d’installer SPIP-Cli de manière globale sur tout le système. Pour cela, nous utilisons la commande sudo, qui lance les programmes avec les droits d’administration du système.

On récupère l’outil spip-cli dans un répertoire partagé :
sudo svn checkout svn://zone.spip.org/spip-zone/_outils_/spip-cli/trunk /opt/spip-cli

On installe les dépendances nécessaires dans un terminal :

cd /opt/spip-cli
composer install

Sur Linux, pour pouvoir utiliser la commande spip dans un shell :
sudo ln -s /opt/spip-cli/spip.php /usr/local/bin/spip

Toujours sur Linux, il est possible d’avoir l’autocomplétion de toutes les options. Pour cela il faut copier le fichier `spip_completion.sh` dans le dossier dédié du système :
sudo ln -s /opt/spip-cli/spip_completion.sh /etc/bash_completion.d/spip

Spip-Cli fonctionne aussi en local avec un Mac + MAMP. Un réglage spécifique peut cependant s’avérer nécessaire. [1]

Utilisation

Vous avez maintenant accès à la commande spip dans votre terminal. En lançant cette commande sans rien d’autre, cela affichera une liste des commandes disponibles ainsi que des options génériques.

Vous pouvez demander une aide plus précise sur une commande spécifique. Cela vous listera alors les arguments et options possibles :
spip help {commande}

Certaines commandes courantes ont des noms raccourcis supplémentaires assignés, afin de les appeler plus rapidement. Par exemple la commande spip core:telecharger peut s’appeler avec spip dl.

Voici une liste rapide des commandes fournies actuellement :

  • cache
    • cache:desactiver Désactive le cache de spip pendant 24h.
    • cache:reactiver Réactive le cache de spip.
    • cache:vider Vider le cache.
  • core
    • core:installer Installer la base de données et le premier utilisateur.
    • core:mettreajour Mettre à jour la branche de SPIP qui est installée.
    • core:preparer Préparer les fichiers pour installer SPIP correctement.
    • core:telecharger Télécharger SPIP dans un dossier (par défaut, la dernière version stable)
  • plugins
    • plugins:activer Active un ou plusieurs plugins.
    • plugins:desactiver Désactive des plugins.
    • plugins:lister Lister les plugins activés.
  • texte
    • texte:propre Convertit du texte au format SPIP vers du HTML via la fonction « propre »
    • texte:typo

Technique

SPIP-Cli est développé en utilisant le composant Console de Symfony, dans sa version 2.5 pour l’instant. Nous recommandons donc la lecture de sa documentation afin de comprendre le fonctionnement.

Une application spip.php s’occupe déjà de découvrir si l’on se trouve ou non dans une installation de SPIP, de charger SPIP le cas échéant (inc_version.php), puis de charger toutes les commandes disponibles (fournies par spip-cli ou par les plugins).

Étendre les fonctionnalités

Il y a donc deux moyens d’ajouter une commande :
-  soit c’est une commande sympa qui ne concerne que le noyau (ou des choses en shell, genre appel de mysql, svn ou autre). Dans ce cas, cette commande peut aller dans le dossier spip-cli/ du projet ;
-  soit on a une commande qui concerne un plugin précis (de la zone ou d’un projet perso) et il faut ajouter le fichier PHP dans un dossier spip-cli/ du plugin activé (il faut que ce soit un plugin activé pour que la commande apparaisse).

La règle est d’avoir :
-  une commande par classe, la plus circonscrite possible
-  une seule classe de commande par fichier PHP
-  au maximum possible un verbe à l’infinitif pour le dernier élément du nom, celui qui concerne l’action à faire

En revanche, on peut regrouper les commandes ensemble selon une hiérarchie, en séparant les noms avec les deux points «  : ». Par exemple plugins:activer et plugins:desactiver. La hiérarchie n’est pas limitée, mais il est conseillé de s’en tenir à deux éléments dans la majorité des cas. Parfois trois, mais il serait bien de ne pas dépasser ce nombre. On pourra par exemple imaginer regrouper toutes les fonctionnalités plus évoluées proposées par SVP sur les plugins avec plugins:svp:{commande}.

Quelques exemples de plugins qui l’utilisent

Des idées de commandes possibles

  • Gestion des auteurs
  • Gestion des médias
  • Gestion de la configuration
  • Gestion de synchronisation entre deux sites par SSH (IMG, données, etc)
  • et sûrement des millions d’autres idées que vous aurez !

Notes

[1Avec MAC OSX + MAMP, vous devrez peut-être effectuer les commandes suivantes en cas d’erreur de connexion à la base de donnée avec mysqli.

cd /var
sudo mkdir mysql
sudo chmod 755 mysql
cd mysql
sudo ln -s /Applications/MAMP/tmp/mysql/mysql.sock mysql.sock

Puis

cd /tmp
sudo ln -s /Applications/MAMP/tmp/mysql/mysql.sock mysql.sock

Voir : http://stackoverflow.com/questions/4219970/warning-mysql-connect-2002-no-such-file-or-directory-trying-to-connect-vi

Dernière modification de cette page le 24 mars 2018

Retour en haut de la page

Vos commentaires

  • Le 21 janvier à 18:55, par Emmanuel En réponse à : SPIP-Cli

    Bonjour
    Je viens d’installer un site d’essai pour essayer spip-cli (juste un article publié)
    Si je fais la suite de commandes suivantes ça ne marche pas :

    1/ spip cache:vider
    2/ spip plugins:activer —all —yes
    3/ spip cache:vider

    1/ vide effectivement le cache (plus aucun fichier dans tmp/cache)

    2/ Il n’y a qu’un seul plugin à activer (Escal) , cette commande a pour conséquence la perte de la base de données : j’ai le message (en html) : Attention : un problème technique (serveur SQL) etc...
    Lorsque je recharge le site par le navigateur j’ai le même message, donc le site est dès lors inutilisable

    3/ vide le cache et arrange tous les problèmes d’accès à la base de données !!! Mais Escal n’est toujours pas activé...

    Je précise que je suis sous php 5.6 (Debian jessie), spip 3.1.7, j’ai installé spip-cli en utilisant subversion comme expliqué ici.

    Merci de vos précieux conseils !

    • Le 25 janvier à 08:46, par Emmanuel En réponse à : SPIP-Cli

      Bonjour
      Je me réponds à moi-même : il manquait un paquet sur mon installation, maintenant tout est rentré dans l’ordre. Pardon pour le bruit j’aurais dû vérifier un peu mieux avant d’écrire ce message : la honte !
      Emmanuel

    Répondre à ce message

  • Le 25 octobre 2017 à 12:21, par Yohooo En réponse à : SPIP-Cli

    Hello,

    Existe-t-il une version de spip-cli pour spip mutualisés

    • Le 25 octobre 2017 à 13:48, par Yohooo En réponse à : SPIP-Cli

      Pour pouvoir faire fonctionner Spip-CLI sur un serveur accueillant des Spip en mutualisé, j’ai ajouter le code suivant dans la fonction « spip_charger.php ». Pouvez-vous me confirmer que c’est la bonne solution ?

      1.         if( is_dir('sites') ){
      2.                 define('_NOM_PERMANENTS_ACCESSIBLES', $cwd."/IMG/");
      3.                 define('_NOM_PERMANENTS_INACCESSIBLES', $cwd."/config/");
      4.                 define('_NOM_TEMPORAIRES_ACCESSIBLES', $cwd."/local/");
      5.                 define('_NOM_TEMPORAIRES_INACCESSIBLES', $cwd."/tmp/");
      6.         }

      Télécharger

    • Le 25 octobre 2017 à 13:52, par RastaPopoulos En réponse à : SPIP-Cli

      Vraiment aucune idée, je n’ai jamais utilisé la mutualisation de toute ma vie, donc je ne sais pas ce qui est propre ou pas pour cette fonctionnalité, désolé :(

    • Le 25 octobre 2017 à 14:46, par Yohooo En réponse à : SPIP-Cli

      Merci RastaPopoulos,

      L’ajout de ces 6 lignes ligne 162 de spip.php fonctionne chez moi. ça peut donc servir à d’autres ...

    • Le 25 octobre 2017 à 14:47, par RastaPopoulos En réponse à : SPIP-Cli

      Super, merci pour ces autres :)

    Répondre à ce message

  • Le 17 novembre 2016 à 11:39, par ManuC En réponse à : SPIP-Cli

    Bonjour,

    Tout d’abord, merci pour ce plugin vraiment très pratique.

    Un petit message rapide pour indiquer que si vous utilisez recuperer_fond dans un script spip-cli et que vous avez défini la variable de personnalisation $puce, il faut ajouter $puce à la liste des global de la fonction spip_charger()
    Sans cela, vos superbes puces perso ne seront pas prises en compte.

    Répondre à ce message

  • Le 9 septembre 2016 à 22:20, par Laurent Vergerolle En réponse à : SPIP-Cli

    Bonjour,
    Je trouve cette initiative super surtout quand, comme moi, on aime énormément la ligne de commande.

    J’ai toutefois un soucis, je suis en PHP7.0 et dès que je lance la commande

    $ spip install -ds « mysql » -dh « localhost » -db « test » -dp « test » -dd « spip_cli » -ap « password »

    j’ai le message d’erreur suivant que je ne comprend pas

                   
     [RuntimeException]              
     The "-d" option does not exist.

    J’ai regardé vite fait le fichier CoreInstaller.php mais je ne vois rien de louche. Quelqu’un aurait une idée ?

    • Le 10 septembre 2016 à 08:16, par RastaPopoulos En réponse à : SPIP-Cli

      SPIP-Cli embarque une vieille version du module Console de Symfony, donc c’est possible que ça ne soit pas compatible PHP7, oui.

      Il faudrait mettre à jour la librairie car elle marche sur la branche 5 (>= 5.5) et 7 à la fois, normalement. Mais il faut vérifier que tout fonctionne et il y a sûrement du code à revoir.

    • Le 11 septembre 2016 à 15:15, par Laurent Vergerolle En réponse à : SPIP-Cli

      Merci pour cette réponse rapide. Je m’en doutais un peu mais je préférais avoir une confirmation avant de passer en PHP5 pour utiliser les commandes. Dans mon cas ça ne me dérange pas.
      Merci beaucoup.

    Répondre à ce message

  • Le 24 mars 2016 à 15:12, par joz En réponse à : SPIP-Cli

    Bonjour,
    est-ce qu’il y a moyen de télécharger le paquet sans SVN ?
    Merci d’avance

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • PHANTOM (HTML5UP)

    18 juillet – commentaires

    Squelette SPIP pour intégrer le modèle Phantom de HTML5UP. https://html5up.net/phantom Installation A l’activation, le plugin installe aussi les plugins suivants : crayons, favicon, metasplus+, Couleur d’objet, champs extras, SPIP reset centre (...)

  • Galleria (fr)

    16 novembre 2011 – 192 commentaires

    Une galerie d’image qui utilise la librairie javascript Galleria. Description Ce plugin vous permet d’ajouter des galeries d’images à vos articles. La galerie créée utilise la librairie javascript Galleria. Le plugin propose un modèle nommé (...)

  • ScolaSPIP 4

    19 janvier 2016 – 371 commentaires

    ScolaSPIP est plugin-squelette responsive personnalisable pour sites Web d’établissements scolaires basé sur SPIPr Présentation de ScolaSPIP Ce plugin pour SPIP 3 est développé par la Dane de l’académie de Versailles pour les webmestres de cette (...)

  • Newsletters

    16 janvier 2013 – 474 commentaires

    Ce plugin permet de composer des Info-lettres. Par info-lettre, on désigne ici le contenu éditorial qui va être composé et envoyé par courriel à une liste d’inscrits. Le plugin permet de composer une info-lettre à partir d’un modèle pré-composé, (...)

  • SPIP 3.2, Agenda et FullCalendar

    6 juin – 16 commentaires

    Nous avions publié un article sur la manière d’utiliser FullCalendar avec SPIP 3.0 afin d’afficher des évènements sous forme d’Agenda. La version de FullCalendar a changé avec SPIP 3.2. Le présent article est donc un tutoriel adapté à SPIP 3.2. Pour (...)