Simply : un framework WordPress s’alliant avec Symfony

En bref. Simply Framework (clementdecou/simply-framework) est un framework open source qui apporte à WordPress des outils de Symfony : le container d’injection de dépendances, le moteur de templates Twig, des hooks déclarés avec les attributs PHP 8, des modèles et repositories, et en option le pattern MVC (contrôleurs et routes). La version actuelle est la 0.3. Elle demande PHP 8.2 à 8.4, Composer 2 et WordPress 6.1 ou plus récent, et s’appuie sur Symfony 7.4 et Twig 3.

Après une (très) longue absence je reviens pour vous parler de mon projet développé pendant un an : mon framework WordPress appelé Simply Framework.

Mon amour envers WordPress et Symfony

Ce framework est issu de mon expérience de développement avec le CMS WordPress d’une part et le framework Symfony d’autre part. Il allie certaines « magies » qu’offre le framework directement dans un CMS (non non je ne parle pas de Drupal…).

Vous allez pouvoir utiliser le (puissant) container d’injection de dépendance de Symfony ainsi que le moteur de template PHP Twig. Mais aussi utiliser l’argument resolver dans des contrôleurs (oui oui vous pouvez utiliser le pattern MVC avec le framework 🙂).

Renforcer la programmation orientée objet dans WordPress

Le plus important d’après mon expérience sur WordPress c’est de renforcer la POO. Car oui en 2022 WordPress utilise encore et toujours beaucoup de fonctions. C’est donc comme ça que j’ai imaginé le framework de base en se posant cette question : comment « simplement » pouvons-nous renforcer la solidité du code ?

Ma réponse fut tout aussi simple : ajouter l’injection de dépendance. Et plus précisément celui de Symfony. Cela va permettre de renforcer la POO ainsi que d’avoir une infinité de possibilité pour augmenter la productivité de développement grâce à la compilation du container.

Car oui le container de Symfony permet la compilation et possède tout un système de tags qui va permettre de pouvoir « classer » des classes en fonction de leurs spécificités. Un hook pourra alors être décrit comme tel dans le container grâce à un tag « hook ». C’est comme cela que j’ai imaginé et développé ce framework WordPress.

Je me suis fixé plusieurs règles :

Ne pas modifier la structure de WordPress
Permettre à des développeurs Symfony de développer sur WordPress sans crise cardiaque (bon à vous de me dire si j’ai réussi ou pas)
Permettre à des développeurs WordPress de continuer à s’y retrouver même avec le framework
Rester simple et donner la possibilité facilement d’étendre les fonctionnalités du framework

Que pouvez-vous faire avec Simply ?

Je vais simplifier toutes les possibilités seulement avec une liste :

Avoir des modèles (et repository) et non plus seulement utiliser les objets de base de WordPress (WP_Post, WP_Term…)
Avoir l’injection de dépendance avec Symfony
Pouvoir utiliser le moteur de template Twig
Pouvoir ajouter des Hook WordPress directement via les attributs de php 8
Pouvoir utiliser le pattern MVC
Gagner en rapidité de développement grâce à la CLI
Gérer toutes ses dépendances de projets (dont WordPress) avec Composer

En bref : se concentrer sur son code métier plutôt que celui de WordPress.

Comment installer Simply ?

Le plus simple est de partir du boilerplate, qui installe WordPress, le framework et les commandes bin/console avec Composer, et fournit un environnement Docker :

composer create-project clementdecou/simply mon-projet

Il reste ensuite à renseigner le .env (URL du site, base de données, clés de sécurité) et à faire pointer le serveur web sur le dossier web/. Le framework s’installe aussi dans un WordPress existant : tout est expliqué dans la documentation.

Le code est sur GitHub : une étoile aide le projet à se faire connaître, et les contributions sont bienvenues. Pour suivre les nouveautés du framework, suivez-moi sur Twitter.