Teddy Payet

LET.archi.fr, millésime 2023

Teddy Payet — 2023-07-06T10:36:21Z

L'un de mes premiers clients en développement Web est le LET de l'ENSAPLV. Nous travaillons en collaboration depuis plusieurs années ensemble. Cette année 2023 a été le souhait et l'engagement pour le laboratoire de mettre à jour le design du site et le faire rentrer dans un monde plus actuel dans son utilisation. La refonte a été mise en ligne ce lundi 3 juillet 2023.
Cette refonte graphique garde l'essence initiale du site mais rafraichit sa lecture sur l'ensemble des supports avec du (…)

- Développement / SPIP, Traitement automatique des images, HTML, CSS, Graphic Design, Web Design, MySQL, École Nationale Supérieure d'Architecture de Paris Lavillette (ENSAPLV), PHP, Développeur Web, Freelance, jQuery, Bootstrap (CSS et JS), PHPStorm, Git

Je suis passé à SPIP 4.0

Teddy Payet — 2021-09-14T06:00:00Z

Ça y est ! Je suis passé à SPIP 4.0 ! Je ne sais pas si vous avez suivi, mais SPIP 4.0 est sorti cet été pour ses 20 ans. Il y a pas mal de petites nouveautés, je vous laisse lire l'article sur le Blog de SPIP qui en parle très très bien.

Introduction

Je me suis décidé à passer à SPIP 4.0 en cette rentrée 2021. Pour être honnête, j'avais un peu peur de ce passage car j'avais quitté un peu l'actualité de SPIP (ses développements, son évolution, etc.). Je ne savais pas où j'allais mettre les pieds même si j'ai toujours aimé ce CMS. Je vais vous parler de mon chemin vers son adoption.

Par beau temps

Mon site était sous SPIP 3.2.9. Et j'utilise Zcore avec un template maison basé sur Bootstrap. Jusque là, rien de bien méchant. J'ai décidé de profiter de cette montée de version de SPIP pour revoir mon template et avoir également la dernière version de bootstrap : 5.1.1

J'ai dû retravailler les différentes classes que j'avais. Pas trop méchant. J'ai fait les choses étape par étape. Avant de migrer pour SPIP 4.0, j'ai fait la mise à jour de SPIP en 3.2.11 qui permet d'avoir la compatibilité PHP 7.4 (la version minimum pour SPIP 4.0 est PHP 7.3).

Mon hébergeur, OVH pour ne pas le citer, prend en charge cette version de PHP. Ouf.

Début septembre, j'ai mis en ligne mon template avec bootstrap 5.1.1 et SPIP 3.2.11. Cela me laissait le temps de tester en "live" la compatibilité avec PHP 7.4. Une lettre à la poste par beau temps !

Puis vint la pluie…

SPIP 3.2.11, PHP 7.4, Boostrap 5.1.1, c'était trop beau pour être vrai ! J'ai testé en local le passage à SPIP 4.0. Depuis le back-office, belle page avec la nouvelle interface de l'espace privé. Responsive, prenant toute la largeur de la fenêtre, c'est beau ! Certains diront que l'espace privé n'a pas changé depuis sa création, mais en fait tout a changé ! Il est plus light, plus agréable avec ces nouveaux jeux d'icônes SVG.

Puis, j'ai cliqué sur le bouton "voir le site public"… Et patatra ! La page met du temps à se charger… Je me dis que ce n'est que le cache qui se recalcule… Et ben non, j'ai une belle erreur php me disant soit que je n'ai suffisamment de mémoire allouée (mouais… 128Mo puis 256Mo…), soit qu'il ne trouvait pas une variable dans les scripts php…

Panique à bord !

Je cherche… désespérément… Je regarde mes scripts PHP maison en pensant trouver la bonne piste… Et non, rien y fait. J'y passe des heures sur le sujet, je change même d'environnement : d'un raspberry Pi avec LAMP, je passe sous MAMP sur mon mac et même en preprod sur mon espace d'hébergement. Rien y fait. Toujours ces erreurs aléatoires. Pourtant, tout fonctionne sous SPIP 3.2.11 en PHP 7.4.

Je sais que la gestion des documents et des logos a changé sous SPIP 4.0. Et j'utilise avec grand plaisir les filtres sur mes templates. Je décide alors d'aller vers cette piste.

Mes images sur mon site sont en moyenne à 2500px de largeur. Ça me permet d'avoir des images de bonnes dimensions et de pouvoir les redimensionner selon mon design. Je décide de venir à une version plus allégée de mes filtres. Suppression des filtres image_passe_partout, image_recadre, image_aplatir et j'en passe. Rien y fait !

Je peste sur mon idée de passer à SPIP 4.0 avec la méthode R.A.C.H.E. Même en sachant que SPIP 4.0 avait changé son approche pour les logos, je ne pensais pas que cela allait être aussi compliqué.

J'utilise un modèle nommé "logo.html". Ce modèle me permet de ne pas dupliquer mes filtres pour les visuels de mes articles, rubriques et cie. Je décide de l'ouvrir dans PHPStorm par raccourcis clavier "Search everywhere". Je tape donc modeles/logo.html. Et OH ! Surprise ! le plugin medias utilise un modèle logo en SPIP 4.0.

Ah tiens… En fait, j'étais tellement subjugué par la nouvelle interface que je n'avais pas remarqué qu'aucun de mes logos d'articles ne s'affichait. J'ai regardé en base de données dans la table spip_documents comment SPIP indique les logos d'articles. Je pige le truc rapidement. J'adopte la méthode R.A.C.H.E… La migration des données par SPIP n'a pas bien insérée les "anciens" logos dans la table de documents. Que cela ne tienne ! Je crée un petite fonction PHP qui va insérer dans la bdd mes logos d'article (de rubriques et de sites) en respectant les bons chemins (exemple : logo/arton-XX.png). Ça se fait rapidement.

Je reviens au fichier modeles/logo.html du plugin medias. Je consulte ce fichier et constate son extrême simplicité et efficacité :

[][(#ENV{lien}|?{})]

Je n'ai pas trouvé exactement où était appelé ce fichier. Mais j'ai pour principe de ne jamais utiliser les même noms que dans un framework. Cela évite les effets de bord indésirables. Donc, je renomme mon modèle maison en modeles/visuel.html. Cela colle bien à son utilisation première.

Une île paradisiaque au loin

Suite à ce renommage, je commence à avoir de nouveau un début de page sur mon espace public. Il y a encore quelques petits effets à régler. Des warnings plus compréhensibles. Je m'attèle à régler ça.

J'adopte de façon systématique (pas comme les antibiotiques) l'utilisation de modeles/visuel.html, je vide les répertoires local, tmp/cache et tmp/logs/ avant chaque grosse modification. Le site est à nouveau opérationnel et je retrouve le même template que j'utilisais en SPIP 3.2.21 en production en début de mois de septembre.

Je respire enfin. L'espoir en moi renait.

Un avenir radieux

Je teste toujours sur mon propre site la dernière version de SPIP avant de la proposer à mes clients. Ainsi, j'aurais déjà essuyé les plâtres. Il sera plus simple pour passer la peinture chez les clients.
L'erreur était toute bête, mon modèle logo gênait SPIP dans sa nouvelle monture. Ma surcharge changeait le comportement attendu. Je suis incapable de dire exactement pourquoi cela faisait planter PHP. Je n'ai pas cherché à le savoir non plus pour être franc.

Je constate surtout que SPIP est plus rapide. Merci PHP 7.4, merci à la core team d'avoir rendu SPIP plus léger et véloce. Je sais que si je passe à PHP 8.0, cela sera encore plus rapide. Mais j'ai plusieurs sites sur mon hébergement OVH qui ne sont pas compatibles PHP 8.0.

Vous pouvez consulter le résultat de cette migration en lisant cet article. En effet, en ce mardi 14 septembre, mon site est officiellement sous SPIP 4.0 sous vos yeux ébahis !

Et la suite ?

J'ai commencé à travailler sur mes plugins de la communauté pour une compatibilité avec SPIP 4.0 :

Info SPIP
Socicon
Lister les constantes PHP de SPIP
Lister les pages de configuration
Lister les pages ?exec=xxx
Lister les fonctions PHP de SPIP
Lister les objets principaux de SPIP
Lister les dossiers
Commits de projet
jQuery Vector Maps
Projets (je ne fais que la maintenance de ce plugin, je n'en suis pas le créateur, je tiens à le préciser)
Sites pour projets

Il m'en reste quelques uns à migrer dont le plus gros : InfoSites. Il est dans les bacs. Il est dépendant d'un plugin qui est en attente de mise en compatibilité avec SPIP 4.0. Plus qu'un pour pouvoir livrer la v2 de ce plugin qui me tient à cœur.

Fin de vie pour…

La liste précédente est plutôt longue. Mais il y aura des "laissés pour compte" dans la course à SPIP 4.0. En effet, selon ma vision, un plugin n'a plus lieu d'être :

Agrandir la largeur de page (SPIP_hop pour les intimes) : l'interface de l'espace privé a été revu pour prendre toute la largeur de la fenêtre et va même plus loin que ce qu'offrait spip_hop. Je ne vois pas l'utilité de le maintenir pour SPIP 4.0

Pour le moment, je n'ai plus le temps/besoin pour certains autres plugins. Donc leur mise à jour est repoussée à une date ultérieure :

Déréférencer les médias ;
Nettoyer la médiathèque.

Voilà le périple que j'ai connu avec SPIP 4.0. Je n'ai pas de regrets pour mon passage vers cette dernière version. Au contraire. :-)

Lister les pages de configuration

Teddy Payet — 2015-08-05T07:00:00Z

Ce plugin SPIP permet de lister sur une page tous les liens vers les pages de configuration des plugins.

La version 1.0.0 permet grâce à un pipeline de rajouter des éléments au menu. Les plugins suivants utilisent ce pipeline :

Lister les pages ?exec=xxx
Lister les constantes PHP de SPIP
Lister les extensions PHP chargées
Liste des objets principaux
Les plugins nécessaires au site
Lister les fonctions PHP de SPIP

Plus d'informations :

Plugin « Agrandir la largeur de page »

Teddy Payet — 2015-08-03T07:00:00Z

Ce plugin permet d'agrandir la largeur de la page dans l'espace privé de SPIP. Vous pourrez personnaliser cette largeur si besoin.

Pour informations, le préfixe du plugin est spip_hop. Il vient de l'onomatopée "Hop" qui, selon Wikipedia, signifie une « exclamation suggérant l'exécution d'un saut ou d'une manœuvre habile ». De par sa fonctionnalité principale "les écrans", j'aurais pu l'appeler spip_ecran mais ce terme est trop proche de l'idée "écran de sécurité" induisant ainsi l'utilisateur en erreur.
Mais "Hop" est aussi la réaction des beta-testeurs de ce plugin après son activation. "Et hop !"

Pour plus d'informations :

Plugin « Initialiser Zcore »

Teddy Payet — 2015-07-31T16:00:00Z

Suite à l'article Créer des squelettes avec Zcore, ce plugin voit le jour. Il permet de créer pour tous les objets éditoriaux le squelette nécessaire pour fonctionner avec l'architecture « Z » et plus précisément avec Zcore.

Présentation

Ce plugin reprend les principes dans l'article "Créer des squelettes avec Zcore" et vous aide à faire ces différentes opérations depuis l'espace privé. Après activation, un lien est ajouté dans le menu "Squelettes" : "Squelettes Zcore". Il vous amènera sur la page suivante :

Sur cette dernière, vous avez 3 tableaux :

Les contrôles ;
Les répertoires ;
Les objets éditoriaux.

Plus d'informations :

MAMP, PHP-cs-fixer, PHPDoc…

Teddy Payet — 2015-05-06T13:10:36Z

Pour faire suite au précédent article, je vais vous indiquer, très rapidement, l'installation de PHP-cs-fixer et de PHPDoc qui peuvent être à minima complémentaires voir très utiles dans nos développements.

PHP-CS-fixer

Source : https://github.com/FriendsOfPHP/PHP-CS-Fixer
L'outil "PHP Coding Standards Fixer" corrige la plupart des problèmes dans votre code lorsque vous souhaitez suivre les normes de codage PHP définies dans les documents PSR-1 et PSR-2.

Sous Mac, allez dans le Terminal et tapez la ligne suivante :

$ cd /Applications/MAMP/bin/php/php5.5.18/bin/

Puis, comme indiqué sur la page officielle, tapez le curl (le wget ne fonctionnera pas nativement sous MacOSX) :

$ curl http://get.sensiolabs.org/php-cs-fixer.phar -o php-cs-fixer

ET maintenant, on donne les bonnes autorisations d'exécution :

$ sudo chmod a+x php-cs-fixer

Grâce à ces lignes de commande, MAMP saura de quoi on parle quand un IDE en aura besoin… Mais pas encore MacOSX. Rien de plus simple, on fait comme d'habitude :

$ sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/php-cs-fixer /usr/bin/php-cs-fixer

On est ok normalement avec PHP-CS-Fixer

PHPDoc

Source : http://www.phpdoc.org/docs/latest/getting-started/installing.html
On ne le présente plus… PHPDocumentor devrait être connu de tous au moins de nom :-)
Pour l'installer en tant qu'extension de PHP, il faut passer par PEAR :

$ pear channel-discover pear.phpdoc.org Adding Channel "pear.phpdoc.org" succeeded
Discovery of channel "pear.phpdoc.org" succeeded

Maintenant, on peut installer phpDocumentor en utilisant la ligne de commande suivante :

$ pear install phpdoc/phpDocumentor downloading phpDocumentor-2.8.2.tgz ...
Starting to download phpDocumentor-2.8.2.tgz (16,246,834 bytes)
............................................................................................................................................................................................................................................................................done: 16,246,834 bytes
install ok: channel://pear.phpdoc.org/phpDocumentor-2.8.2

Et maintenant au tour de Mac OS X de comprendre ce qui se passe :

$ sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/phpdoc /usr/bin/phpdoc

Et voilà ! Vous voyez ? C'est rapide !

MAMP, PHP, Pear, PHP Code Sniffer sont dans un même bateau

Teddy Payet — 2015-01-27T17:06:32Z

Cela fait un moment que je n'avais pas écris de billet sur mon blog. Mais ça fait aussi longtemps que je me dis qu'il faut que j'écrive un tutoriel complet sur comment installer PHP Code Sniffer sur un MAMP.

En soit, vous pouvez retrouver toutes ces informations sur le net mais un peu éparpillées… Je dois "à chaque fois" jouer avec google pour retrouver ces différents articles.
De ce fait, je vais les regrouper sur une même page et, dans la mesure du possible, remettre les sources du code que je mettrai.

Besoins

En codant sous Mac OS X (Yosemite, là de suite), on utilise souvent MAMP pour développer nos différents sites en local. Et mine de rien, respecter les normes PHP, ça fait du bien. Et pour cela, on a besoin d'installer PHP Code Sniffer pour que nos IDEs puissent utiliser la norme PSR2 (dans mon cas).
Donc, ma configuration lors de ce pas à pas :

Mac OSX 10.10.1 (dit Yosemite) ;
MAMP 3.0.7.3 ;
PHP 5.5.18 (fournit dans MAMP, et PHP 5.5.14 dans Yosemite).

Configuration de l'installation

Pour que nos lignes de commandes php et pear soient reconnues, il faut dire au système où regarder.
Pour cela, je vous invite à ouvrir le Terminal car c'est quasiment que par lui que nous allons utiliser pour configurer notre Mac.

PHP

Source : http://stackoverflow.com/a/17240373
A partir de là, je vous invite à taper la commande suivante :

# which php

Ce qui devrait vous donner ceci :

/usr/bin/php

Vérifions la version :

# php -v

Cela devrait vous dire que vous avez une version PHP 5.5.14. Ce qui ne correspond pas à notre version fournit avec MAMP. Nous devons alors dire à notre Mac qu'on veut la version de MAMP.
Taper ceci pour faire une sauvegarde de notre version de php en renommant le fichier php en php.bak. :

# sudo mv /usr/bin/php /usr/bin/php.bak

Notre Mac ne reconnaitra plus temporairement les commandes PHP. On crée maintenant un lien symbolique de php vers notre version de MAMP :

# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/php /usr/bin/php

Regarder votre version de PHP maintenant :

# php -v

On est ok normalement avec PHP

PEAR

Cette fois-ci, on va régler PEAR qui va nous permettre d'installer PHP Code Sniffer sur notre installation MAMP. Pour faire simple, on reprend la même démarche que précédemment.

# which pear

Là, si vous n'avez jamais configuré votre Mac, rien ne s'affichera. Vous serez redirigé vers la ligne de saisie de commandes. La commande suivante normalement nous donne le numéro de version de PEAR (attention à la majuscule du "V").

# pear -V

Mais comme dit précédemment, la commande PEAR n'est pas reconnue. On va dire alors à notre Mac qu'il faut qu'il aille voir dans MAMP :

# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/pear /usr/bin/pear

Refaites la commande de version de PEAR. MAMP fournit la version 1.9.5 pour PEAR.
On est ok normalement avec PEAR

PHP Code Sniffer

Source : : https://github.com/Islandora/islandora/wiki/Installing-and-configuring-codesniffer
Pour installer PHP Code Sniffer, il faut passer par PEAR. Comme on l'a déjà installé, il nous suffit de renseigner la commande suivante :

# pear install PHP_CodeSniffer

Je n'ai pas rencontré de problème à ce stade. Si on va dans /Applications/MAMP/bin/php/php5.5.18/bin/ on peut voir un fichier phpcs. Mais dans /usr/bin/, on ne trouve pas de phpcs. Ce qui a pour effet, là de suite, que si on tape une commande phpcs, on aura une erreur. Pour régler ça, rien de miraculeux, une ligne de commande mettra notre Mac dans le droit chemin :

# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/phpcs /usr/bin/phpcs

On vérifie tout ça :

# phpcs --version

Soit pour moi : PHP_CodeSniffer version 2.2.0 (stable) by Squiz (http://www.squiz.net)

PHP Mess Detector

Source : http://pear.phpmd.org/
On installe souvent avec PHPcs la librairie PHP Mess Detector (PHPmd). Pour cela, il faut ajouter un channel spécifique à PEAR.

# pear channel-discover pear.phpmd.org

On regarde les packages disponibles :

# pear remote-list -c phpmd

Soit :

Channel phpmd Available packages:
=================================
Package Version
PHP_PMD 1.5.0

La ligne de commande suivante va poser problème :

# pear install phpmd/PHP_PMD
# Unknown remote channel: pear.pdepend.org
# phpmd/PHP_PMD requires package "channel://pear.pdepend.org/PHP_Depend" (version >= 1.1.1)
# No valid packages found
# install failed

Il faut rajouter le channel pear.pdepend.org :

# pear channel-discover pear.pdepend.org

Et maintenant, on fait ceci :

# pear install --alldeps phpmd/PHP_PMD

L'option --alldeps va installer toutes les dépendances nécessaires pour PHPmd avant d'installer PHPmd.
Ok, on crée les liens symboliques pour notre Mac :

# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/phpmd /usr/bin/phpmd
# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/pdepend /usr/bin/pdepend

Petit test :

# phpmd --version
# pdepend --version

Et voilà ! C'est fini ! Vous pouvez vous amuser maintenant !

Bonus : PHPUnit

Pour PHPcs, on n'a pas besoin de PHPUnit… Qu'on se le dise. Mais, je me dis que cela peut servir à certains. Alors voici la méthode.
Comme on peut le lire sur https://github.com/sebastianbergman..., on ne passe plus par PEAR pour installer PHPUnit mais par un fichier phar.
Sur la doc, on passe par des lignes de commandes aussi pour faire tout cela… Ok… Mais il y a un problème. Sur le Mac, la commande wget ne fonctionnera pas. On va passer par la commande curl pour récupérer le fichier.

D'abord, on va sur le bureau (par exemple)

# cd ~/Desktop/

Et là, on va pouvoir travailler ainsi :

# curl -o phpunit.phar https://phar.phpunit.de/phpunit.phar
# chmod +x phpunit.phar
# sudo mv phpunit.phar /usr/bin/phpunit

Ça vous dit de vérifier ? Simple, même astuce que tout à l'heure :

# phpunit --version
# PHPUnit 4.4.5 by Sebastian Bergmann.

Et voilà ! J'en ai fini avec ce pas à pas. ;-)

Plugin « Info SPIP »

Teddy Payet — 2014-07-21T16:00:00Z

Ce plugin permet d'avoir une page, dans la partie privée, donnant la fiche identitaire de votre site et de votre serveur. Il offre aussi la possiblité d'avoir une page au format xml (dans la partie publique) reprenant les même informations que la page du privé.

Ce plugin après activation fournira une page accessible par http://example.org/ecrire/?exec=info_config.

Les pages livrées par le plugin http://example.org/ecrire/?exec=configurer_info_config et http://example.org/ecrire/?exec=info_config ne sont accessibles qu'aux webmestres du site.
En effet, ces informations, plutôt techniques, n'intéressent pas les administrateurs mais les développeurs.

Plus d'informations :

Nettoyer la médiathèque

Teddy Payet — 2014-05-28T07:00:00Z

Ce plugin pour SPIP 2.1 et + a pour but de faire du rangement dans le répertoire IMG/ d'un site SPIP. Il est intéressant dans l'un des cas suivants :

Vous avez un site SPIP avec une version inférieure à la 1.9.2 et vous voulez le monter de version ;
Vous avez un site depuis une version inférieure à SPIP 1.9.2 ;
Vous voulez faire le ménage des logos et des documents orphelins dans votre répertoire IMG/.
Dans tous les cas, ce plugin déplacera les fichiers obsolètes dans un sous-répertoire IMG/orphelins. A vous de décider de leur sort par la suite.

Plus d'informations :

Titre de logo, v2

Teddy Payet — 2014-05-23T07:00:00Z

Ce plugin est une refonte pour SPIP 3.0 du plugin "Titre de logo", créé initialement par ARNO*.

La version 2 du plugin Titre de logo reprend les mêmes fonctions que la v1 mais étend le titre et le descriptif aux logos de tout objet éditorial de SPIP. Il ajoute un titre et un descriptif aux logos.

Plus d'informations :