SPIP-Cli

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 : Composer doit être 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.

Récupérer Spip-Cli et l’installer :

sudo git clone https://git.spip.net/spip-contrib-outils/spip-cli.git /opt/spip-cli
cd /opt/spip-cli
sudo composer install

Lier les commandes spip pour un accès facile :

cd /opt/spip-cli/bin
# Commande 'spip' 
sudo ln -s $(pwd)/spip /usr/local/bin/
# Commande 'spipmu' pour site mutualisé
sudo ln -s $(pwd)/spipmu /usr/local/bin/
# Autocompletion (Linux)
sudo ln -s $(pwd)/spip_console_autocomplete /etc/bash_completion.d/spip
# Autocompletion (MacOs)
sudo ln -s $(pwd)/spip_console_autocomplete /usr/local/etc/bash_completion.d/spip

Spécificité d’installation MacOs/Mamp Mysql

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

# Disposer de /var/mysql/mysql.sock
sudo mkdir /var/mysql
sudo chmod 755 /var/mysql
sudo ln -s /Applications/MAMP/tmp/mysql/mysql.sock /var/mysql/mysql.sock
# Disposer de /tmp/mysql.sock
sudo ln -s /Applications/MAMP/tmp/mysql/mysql.sock /tmp/mysql.sock

Source : StackOverFlow : mysql connect

Spécificités d’installation sous Windows:

  • la machine doit disposer d’un serveur web complet avec PHP et MySQL/MariaDB. Pour une installation fonctionnelle de AMP (Apache / PHP / MySQL|MariaDB) vous pouvez utiliser par exemple Laragon ou XAMPP
  • il faut que les executables de PHP et MySQL/Mariadb soient dans le PATH de la machine (local ou global peu importe). Pour cela éditer les variables d’environnement de la machine:
    Panneau de configuration > Système > Paramètres systèmes avancés > Variables d’environnement... : dans la variable Path de votre utilisateur (= install locale, pour vous seul) ou dans celle du système (install globale, tous les utilisateurs), ajouter les chemins de php.exe et mysql.exe (précédés d’un ;), par exemple C:\laragon\bin\php\php-7.1.25-Win32-VC14-x64 et C:\laragon\bin\mysql\mariadb-10.3.10-winx64\bin
  • de la même manière il faut mettre dans le PATH le sous-dossier bin de spip-cli: par exemple C:\laragon\bin\spip-cli\bin (si on suppose que vous avez installé spip-cli dans le dossier bin/ de votre Laragon pour cet exemple)
  • pour éviter un blocage bizarre au lancement des commandes de spip-cli, (fonction PHP date_default_timezone_set() qui bloque et nécessite de re-valider par Entrée le lancement ???), il est indispensable que le paramètre date.timezone soit défini dans le php.ini de votre serveur web. Par ex date.timezone = Europe/Paris : à vérifier en ouvrant la page de l’espace privé ...ecrire/?exec=info et en recherchant dans le phpinfo qui s’affiche que dans le bloc date vous avez bien une directive date.timezone configurée. Sinon, éditez votre php.ini pour ajouter la directive.
  • il est vivement conseillé de ne pas utiliser l’invite de commande de Windows (cmd.exe) pour travailler avec spip-cli mais plutôt un terminal “Unix-like” qui permet d’utiliser toutes les commandes bash/sh standard, par exemple Gitbash fourni par l’installation de Git de https://gitforwindows.org/

Mise à jour

cd /opt/spip-cli
sudo git pull
composer update

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.

Commandes de base

Voici une liste rapide des commandes principales fournies :

auteurs
auteurs:superadmin Ajoute / supprime un webmestre temporaire.
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:maj:bdd Mettre à jour la base de données et configurations de SPIP.
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.
plugins:maj:bdd Mettre à jour la base de données et configurations des plugins.
test
test:spip Vérifie notre connexion au site SPIP.
test:style Affiche les différents styles d’écriture (charte typo des commandes en CLI !).
texte
texte:propre Convertit du texte au format SPIP vers du HTML via la fonction “propre”
texte:typo Pareil vers typo

Technique

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

Une application spip 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 d’éventuels plugins actifs sur le site).

É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 src/Command/ 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 !

Historique et Migration

Version 0.4

  • Les exécutables ont été déplacés dans le répertoire bin/ . Vous devez adapter vos liens symboliques en conséquence.
  • Les commandes sont déplacées src/Command
  • Les commandes core:maj:bdd et plugins:maj:bdd sont ajoutées
  • Les commandes plugins:lister, plugins:activer et plugins:desactiver sont revues et complétés par des options intéressantes
  • Tolère les sites SPIP mutualisés
  • L’exécutable spipmu permet d’appliquer une commande à plusieurs sites SPIP mutualisés.

updated on 6 September 2020

Discussion

10 discussions

  • 2

    Salut,

    suite à une installation via core:installer (donc en git par défaut ?)

    spip core:installer --db-server "mysql" --db-login "root" --db-pass "" --db-database "spipcli"

    si j’essaye de à mettre à jour via core:mettreajour (avec ou sans branche)

    spip core:mettreajour --branche "trunk"

    mais j’ai le message d’erreur suivant :

    ’svn’ n’est pas reconnu en tant que commande interne
    ou externe, un programme exécutable ou un fichier de commandes.

    Dans https://git.spip.net/spip-contrib-outils/spip-cli/src/branch/master/src/Command/CoreMettreajour.php#L46, les dépôt sont bien en SVN.

    Comment faire pour mettre à jour en git ?

    • core:installer c’est l’installation de la base, pas le télécharger

      la commande mettreajour… n’est plus à jour

      mais pour mettre à jour le code, c’est pareil que pour le premier téléchargement : toujours “dl” ou “core:telecharger”, et si c’était pas sur un tag précis, ça mettra à jour

      il faudrait mettre à jour la commande mettreajour pour appeler “dl” derrière, et ensuite lancer les fonctions de mise à jour de base et des plugins (mais je ne sais plus si c’est possible en cli, à voir enfin c’était l’idée de cette commande en tout cas, qui devait pas juste faire du téléchargement, ce qui permettait de pas avoir à repasser dans l’admin et dans admin_plugin en web)

    • Oui, bien vu, je mélange core:telecharger et core:installer :)

      C’est bon avec dl et core:telecharger.

      Merci pour le retour rapide.

    Reply to this message

  • 5

    Bonjour,
    Je suis en train de tester Spip-cli en mutualisation et j’ai le soucis suivant :
    Quand je fais un spipmu “*” test:spip , j’obtiens systématiquement ceci pour tous les sites :

    <!DOCTYPE html>
    <html class='ltr fr no-js' xmlns='http://www.w3.org/1999/xhtml' lang='fr' dir='ltr'>
    <head>
    <title>Site en travaux</title>
    <meta name='viewport' content='width=device-width' />
    <link rel='stylesheet' href='prive/themes/spip/reset.css' type='text/css' />
    <link rel='stylesheet' href='prive/themes/spip/clear.css' type='text/css' />
    <link rel='stylesheet' href='prive/themes/spip/minipres.css' type='text/css' />
    </head>
    <body class='minipres'>
            <div id='minipres'>
            <h1>Site en travaux</h1>
            <div>
    Attention&#160;: un probl&#232;me technique (serveur SQL) emp&#234;che l&#8217;acc&#232;s &#224; cette partie du site. de votre compr&#233;hension.
            </div>
            </div>
    </body>
    </html>

    Quelqu’un aurait-il une idée d’où vient l’erreur ?
    Merci.

    • Je me réponds à moi-même.
      Je suis sur un Spip 3.0.24... Sur un Spip 3.2, ça fonctionne !

    • Bonjour,
      Bon, en fait, ça ne marche que sur mon serveur de test sous windows (wamp) en php > 5.6.
      Sur mon autre serveur, il y la conf suivante : php 5.6.5 apache 2.4.18 mysql 5.5.40
      L’erreur est toujours présente.
      Quelle est la conf mini au niveau php et mysql pour que spip-cli fonctionne ?
      Cordialement.

    • Je ne connais pas la mutualisation donc je ne sais pas répondre, mais à priori faut vraiment passer à PHP7. PHP5 y compris 5.6 n’est plus supporté depuis des années (pas même pour des bugs de sécu), donc c’est dangereux, et il faut le virer dès qu’on le peut.

    • Merci pour cette réponse rapide !

    • Bonjour,
      Toujours la même erreur malgré le passage à php 7 !
      Comme spip-cli n’est pas très bavard, je ne trouve pas la source du problème...
      Si quelqu’un a une idée, je suis preneur !
      Merci.

    Reply to this message

  • 1
    Emmanuel Courcelle

    Bonjour

    J’utilisais l’ancienne version de spip-cli dans une installation mutualisée. J’avais dû la patcher pour qu’elle soit utilisable. Je viens de tester la version 0.4: un grand cru !!!

    Tous mes patches sont à mettre à la poubelle, spip-cli fait tout très bien maintenant (en tous cas tout ce dont j’ai besoin, c-à-d essentiellement exporter/importer les plugins activés).

    J’ai quand-même appliqué un tout petit patch: dans notre mutu (https://le-pic.org), nous acceptons que le même site ait deux url différents: exemple.fr et www.exemple.fr par exemple. Cela est implémenté en mettant le site dans le répertoire sites/exemple.fr et en faisant un lien symbolique: site/www.exemple.fr pointe sur sites/exemple.fr
    Avec cette configuration, spipmu voit deux sites: exemple.fr et www.exemple.fr, et fait donc l’action demandée une fois de trop. Ce n’est pas très élégant, et j’imagine que dans certains cas cela peut être dangereux. J’ai modifié une ligne afin de détecter et ignorer les liens symboliques:
    fichier spip-cli/src/Mutualisation/Command/Batch.php
    Ligne: 127
    remplacer if ($dir->isDir())
    par if ($dir->isDir() && !$dir->isLink())

    Merci pour ce super-outil et amitiés à tous les spipeurs !
    Emmanuel

    Reply to this message

  • 5

    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 ?

    • 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.

    • 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.

    • Salut,

      j’ai le même message pour une installation en mySQL (pas de problème en sqlite) :

      [Symfony\Component\Console\Exception\RuntimeException]
      The "-d" option does not exist

      Sur une installation locale laragon / PHP7.3 (mais testé aussi en 5.6 au cas où) avec la commande $spip core:installer -ds "mysql" -dh "localhost" -dd "labase" -dl "root" -dp ""

      Je rate quoi ?

    • Parce que les raccourcis à plusieurs lettres ne sont pas forcément supportés : https://github.com/symfony/symfony/issues/8322

      Faut que j’arrête de faire ça…

    • Ah oui, ça marche sans les raccourcis.

      C’est bon avec $spip core:installer --db-server "mysql" --db-login "root" --db-pass "" --db-database "spipcli"

      Merci pour ce script !

    Reply to this message

  • 1

    QUestion : comment peut basculer d’une branche spip à l’autre? d’une 3.1 à une 3.2 par ex ? Je ne vois rien ici ni en tapant spip dans mon terminal

    • C’était possible dans l’ancienne version, si tu spécifiais une branche ou un tag différent, et ça faisait tout simplement un “svn switch”. Mais ce n’est plus possible dans la version actuelle copiée de checkout. Il faut recoder ça pour git, normalement c’est juste un “co” à faire sur une autre branche ou tag.

    Reply to this message

  • 5

    Pour info, sur OSX j’ai installé spip-cli dans /usr/local/opt/ plutôt que dans /opt/ pour ne pas avoir à le faire en sudo.

    Sinon, par rapport à la doc d’installation il faut remplacer

    ln -s /opt/spip-cli/spip.php /usr/local/bin/spip

    par

    ln -s /opt/spip-cli/bin/spip /usr/local/bin/spip

    pour ne pas avoir le message “[deprecated] Veuillez utiliser les executables SPIP-Cli du répertoire bin.

    • Corrigé dans la doc merci, c’est suite aux mises à jour de marcimat

    • Et en fait c’est pareil pour :

      sudo ln -s /opt/spip-cli/spip_completion.sh /etc/bash_completion.d/spip

      qui devient :

      sudo ln -s /opt/spip-cli/bin/spip_console_autocomplete /etc/bash_completion.d/spip

      J’ai corrigé directement l’article.

    • J’ai peut être écrasé quelque chose en intégrant la nouvelle doc à l’instant du coup…
      À vérifier

    • Je sais pas, tu as testé ta procédure d’installation ?

    • Je viens de le réinstaller chez moi, il faut en effet bien faire attention au bin/ et ça marche, MAIS il faut ensuite aller éditer
      protected function optimizeTable(string $table, bool $reorder = false) {

      en
      protected function optimizeTable(string $table, bool $reorder) {

      sinon on a
      Fatal error: Default value for parameters with a class type hint can only be NULL in /opt/spip-cli/src/Command/SqlOptimize.php on line 43

      (en tout cas sous PHP 5.6.40-0+deb8u1 (cli) (built: Feb 17 2019 03:57:32))

    Reply to this message

  • 5

    Hello,

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

    • 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 ?

      	if( is_dir('sites') ){
      		define('_NOM_PERMANENTS_ACCESSIBLES', $cwd."/IMG/");
      		define('_NOM_PERMANENTS_INACCESSIBLES', $cwd."/config/");
      		define('_NOM_TEMPORAIRES_ACCESSIBLES', $cwd."/local/");
      		define('_NOM_TEMPORAIRES_INACCESSIBLES', $cwd."/tmp/");
      	}
    • 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é :(

    • Merci RastaPopoulos,

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

    • Super, merci pour ces autres :)

    • Pour info, maintenant, c’est plus facile.
      Et avec une doc : Spip-Cli en Mutualisation

    Reply to this message

  • 1

    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 !

    • 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

    Reply to this message

  • 1

    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.

    Reply to this message

  • 1

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

    Reply to this message

Ajouter un commentaire

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom