php
use ApiPlatform\Doctrine\Orm\Filter\OrderFilter;
use ApiPlatform\Doctrine\Orm\State\Options;
use ApiPlatform\Metadata\ApiFilter;
use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Tests\Fixtures\TestBundle\Entity\SeparatedEntity;

#[ApiResource(shortName: 'SeparatedEntity', stateOptions: new Options(entityClass: SeparatedEntity::class))]
class ResourceWithSeparatedEntity
{
	public string $id;
	#[ApiFilter(OrderFilter::class)]
	public string $value;
}

yaml
defaults:
    extra_properties:
        standard_put: true

Am&eacute;lioration de la personnalisation d'OpenAPI


php
use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Post;
use ApiPlatform\OpenApi\Model;
use App\Controller\RandomRabbit;

#[ApiResource]
#[Post(
	name: 'create_rabbit',
	uriTemplate: '/rabbit/create',
	controller: RandomRabbit::class,
	openapi: new Model\Operation(
    	summary: 'Create a rabbit picture',
    	description: '# Pop a great rabbit picture by color!\n\n![A great rabbit](https://rabbit.org/graphics/fun/netbunnies/jellybean1-brennan1.jpg)',
    	requestBody: new Model\RequestBody(
        	content: new \ArrayObject([
            	'application/json' => [
                	'schema' => [
                    	'type' => 'object',
                    	'properties' => [
                        	'name' => ['type' => 'string'],
                        	'description' => ['type' => 'string']
                    	]
                	],
                	'example' => [
                    	'name' => 'Mr. Rabbit',
                    	'description' => 'Pink Rabbit'
                	]
            	]
        	])
    	)
	)
)]
class Rabbit
{
	// ...
}


Collecte des erreurs de d&eacute;normalisation


php
use ApiPlatform\Metadata\ApiResource;
#[ApiResource(
	collectDenormalizationErrors: true
)]
class Book
{
}

<a href="https://soyuka.me/api-platform-3.1-whats-new/" target="_blank" rel="noreferrer noopener">Lire la version originale (en anglais) de cet article</a>.



Après les retours plus que positifs sur la sortie de <a href="https://www.youtube.com/watch?v=cWIu3tahbbs" target="_blank" rel="noreferrer noopener">sa dernière version majeure</a>, nous avons la joie de vous annoncer la disponibilité immédiate des versions 3.1, 3.0.11 et 2.7.7 d’API Platform !



Important : si vous n&#8217;avez pas encore effectué la mise à niveau vers la version 3.0, vous devez absolument la faire car la version 2.7 ne recevra plus que des mises à jour de sécurité. Si vous ne vous sentez pas à l&#8217;aise ou si vous pensez qu&#8217;il est trop difficile d&#8217;effectuer la mise à niveau, <a href="mailto:contact@les-tilleuls.coop" target="_blank" rel="noreferrer noopener">contactez-nous</a>, nous pouvons vous aider ! Voyons maintenant ce que vous devez retenir de cette mise à jour.



<h2>Configuration des stateOptions</h2>



Il est désormais possible de configurer des <code>stateOptions</code> sur une <code>Operation</code>. Cela permet d’aider à séparer la classe PHP que nous utilisons pour représenter la ressource API et la classe PHP utilisée pour la persistance dans un environnement Doctrine.&nbsp;



Cette <a href="https://github.com/api-platform/core/pull/5275" target="_blank" rel="noreferrer noopener">fonctionnalité</a> est le résultat de discussions menées avec notre coopérateur <a href="https://twitter.com/C0il" target="_blank" rel="noreferrer noopener">Loïc Vernet</a> lorsqu&#8217;il travaillait sur <a href="https://www.strangebuzz.com/en/blog/replacing-manual-api-endpoints-with-api-platform-3-in-a-symfony-application" target="_blank" rel="noreferrer noopener">le remplacement des endpoints avec API Platform 3</a> et avec <a href="https://twitter.com/Pierstoval/status/1581166242659856384" target="_blank" rel="noreferrer noopener">Alex Rock</a> lors du dernier Forum PHP.&nbsp;



Dans cette nouvelle version, la propriété <code>stateOptions</code> vous permet de spécifier une autre classe à utiliser en tant qu&#8217;entité Doctrine :





<a href="https://github.com/api-platform/core/blob/902b1354f84c75cf5cc9d7199998733f6157a998/src/Elasticsearch/State/Options.php">Le même mécanisme a été ajouté à Elasticsearch</a> pour personnaliser l’<code>index</code> utilisé.&nbsp;



<h2>Conformité de PUT</h2>



Notre implémentation actuelle de <a href="https://httpwg.org/specs/rfc9110.html#PUT" target="_blank" rel="noreferrer noopener">la méthode HTTP PUT</a>&nbsp; n’est pas conforme aux normes.&nbsp;



Selon la spécification, une requête PUT doit créer ou remplacer la ressource à l&#8217;URL demandée. À partir d&#8217;API Platform 3.1, vous pouvez activer la création d&#8217;une ressource via PUT en utilisant <code>allowCreate : true</code>



Attention : préparez le changement de compatibilité ascendante en prévision d&#8217;API Platform 4 ! Dans cette future version, <code>PUT</code> remplacera les données. Pour s&#8217;assurer que votre code fonctionne de cette façon, nous vous recommandons de définir :





Vous serez ainsi prêt·e pour la prochaine version majeure. Dans API Platform 3.1, la valeur par défaut est <code>false</code> afin que le comportement attendu ne change pas. Retrouvez tous les détails de l&#8217;implémentation sur <a href="https://github.com/api-platform/core/pull/4996" target="_blank" rel="noreferrer noopener">GitHub</a>, merci à <a href="https://twitter.com/dunglas" target="_blank" rel="noreferrer noopener">Kévin Dunglas</a> pour avoir rendu cela possible !



<h2>Support des Enums</h2>



Après <a href="https://github.com/api-platform/core/issues/2254" target="_blank" rel="noreferrer noopener">une longue attente</a>, les Enums sont désormais supportées dans OpenAPI, REST et GraphQL. Doctrine ORM et ODM ont tous deux un support pour les Enums à travers <code>enumType</code> qui est supporté par API Platform 3.0. Notre coopérateur <a href="https://twitter.com/_alanpoulain" target="_blank" rel="noreferrer noopener">Alan Poulain</a> a ajouté son support à <a href="https://github.com/api-platform/core/pull/5199" target="_blank" rel="noreferrer noopener">OpenAPI</a> et <a href="https://github.com/api-platform/core/pull/5120" target="_blank" rel="noreferrer noopener">GraphQL</a>.



<h2>Purge du cache HTTP revisité</h2>



Nous avons remanié notre <a href="https://github.com/api-platform/core/pull/5273" target="_blank" rel="noreferrer noopener">clé de substitution</a> pour le rendre agnostique en termes de fournisseur et nous avons ajouté un Purger pour <a href="https://github.com/darkweak/souin" target="_blank" rel="noreferrer noopener">Souin</a>, un fournisseur de cache HTTP en Go qui fonctionne comme un module Caddy !



<h2>Amélioration de la personnalisation d&#8217;OpenAPI</h2>



Dans les versions précédentes, personnaliser la documentation <a href="https://www.openapis.org/" target="_blank" rel="noreferrer noopener">OpenAPI</a> nécessitait souvent de décorer le service <code>OpenApiFactory</code>. Dans API Platform 3.1, vous pouvez utiliser l&#8217;option <code>openapi</code> avec un objet <code>ApiPlatform\OpenApi\Model\Operation</code> vous permettant ainsi d&#8217;utiliser exactement le même <code>ValueObject</code> que celui utilisé pour générer la documentation OpenAPI :





Cette option <code>openapi</code> prend également la valeur <code>false</code> pour supprimer votre opération de la documentation.



<h2>Collecte des erreurs de dénormalisation</h2>



Depuis Symfony 5.4 et <a href="https://github.com/symfony/symfony/pull/42502" target="_blank" rel="noreferrer noopener">grâce à Grégoire Pineau</a>, nous pouvons collecter les erreurs de type pendant la dénormalisation. Notre coopératrice Natacha a ajouté cette fonctionnalité en tant qu&#8217;option sur API Platform 3.1 :





Voici un aperçu de ce que vous pourrez découvrir dans cette nouvelle version, n&#8217;oubliez pas de consulter le <a href="https://github.com/api-platform/core/blob/main/CHANGELOG.md#v310" target="_blank" rel="noreferrer noopener">CHANGELOG</a> pour plus de détails ! Encore une fois, si vous avez besoin d’accompagnement ou d’une formation dans votre montée de version, n’hésitez pas à nous solliciter ! 



Nous profitons de ce billet pour vous annoncer qu’une nouvelle date a été annoncée pour un workshop API Platform 3 : j’aurais à nouveau le plaisir d’animer à Nantes le 9 février prochain <a href="https://les-tilleuls.coop/masterclass/workshops/workshop-api-platform-3-2/2023-02-09" target="_blank" rel="noreferrer noopener">une journée d’atelier consacrée à cette version</a>. Inscrivez-vous dès maintenant, le nombre de places est limité !&nbsp;

Sortie d’API Platform 3.1

Découvrez dans cet article les fonctionnalités disponibles dans la nouvelle version du framework API Platform.

Découvrez dans cet article d'Antoine Bluchet les fonctionnalités disponibles dans la nouvelle version du framework API Platform.

Sortie d'API Platform 3.1

Sortie d’API Platform 3.1 | Les-Tilleuls.coop

Accueil

Les-Tilleuls.coop

https://secure.gravatar.com/avatar/1a1f2874fd9ed1257d288578fcb1e2fb?s=96&d=mm&r=g

Antoine Bluchet

Toute notre équipe profite de ce billet pour vous souhaiter une excellente année 2023, puisse-t-elle être pleine de partages, de découvertes et d’apprentissages ! L’année écoulée a de nouveau été riche de projets :



<ul>
<li>La version 3 d’API Platform est sortie en septembre, lors de la keynote d’ouverture de <a href="https://api-platform.com/con/2022/review/" target="_blank" rel="noreferrer noopener">l’API Platform Conference</a>. <a href="https://www.youtube.com/watch?v=cWIu3tahbbs" target="_blank" rel="noreferrer noopener">Revivez ce moment</a> et prenez contact dès à présent avec nos consultantes et consultants pour effectuer votre montée de version (la v3.1 sort d’ailleurs d’ici quelques jours).</li>



<li>Dans la continuité de nos contributions aux logiciels qui fiabilisent les applications que nous utilisons au quotidien, notre <a href="https://les-tilleuls.coop/cloud-et-devops" target="_blank" rel="noreferrer noopener">offre Cloud</a> a été actualisée ! Disponibilité, monitoring, sécurité ou optimisation, <a href="mailto:contact@les-tilleuls.coop" target="_blank" rel="noreferrer noopener">regardons avec nos SRE</a> les différentes solutions pouvant correspondre à votre besoin.&nbsp;</li>



<li>Nous avons obtenu la certification Qualiopi, remportée suite à un audit attestant de la qualité de nos formations. Celles-ci sont conçues par des personnes maintenant, écrivant ou donnant des conférences sur les technologies que nous enseignons. Parcourez dès maintenant <a href="https://les-tilleuls.coop/masterclass/formations" target="_blank" rel="noreferrer noopener">notre catalogue</a>, sur lequel vous trouverez des formations consacrées à <a href="https://les-tilleuls.coop/masterclass/formations/introduction-a-api-platform" target="_blank" rel="noreferrer noopener">API Platform</a>, <a href="https://les-tilleuls.coop/masterclass/formations/maitriser-symfony" target="_blank" rel="noreferrer noopener">Symfony</a>, <a href="https://les-tilleuls.coop/masterclass/formations/introduction-a-react" target="_blank" rel="noreferrer noopener">React</a>, <a href="https://les-tilleuls.coop/masterclass/formations/introduction-a-vue-js" target="_blank" rel="noreferrer noopener">Vue</a> ou encore <a href="https://les-tilleuls.coop/masterclass/formations/docker" target="_blank" rel="noreferrer noopener">Docker</a> !</li>



<li>La deuxième édition de la API Platform Conference a battu son plein : 300 personnes à Lille et 400 en ligne ont suivi les retours d’expérience de nos conférencières et conférenciers, le tout dans une ambiance conviviale. <a href="https://api-platform.com/con/2023/" target="_blank" rel="noreferrer noopener">Notre prochaine édition aura lieu les 21 et 22 septembre prochains</a> et les billets au tarif Early Bird sont disponibles jusqu’en mai, mois où les premiers speakers seront annoncés. Vous hésitez à nous rejoindre ? <a href="https://www.youtube.com/playlist?list=PL3hoUDjLa7eQfYOEmuQNG8he3AeOeWaz8" target="_blank" rel="noreferrer noopener">Regardez le replay</a> de nos dernières conférences.&nbsp;</li>
</ul>



Enfin, vous savez qu&#8217;à l&#8217;occasion de nos vœux, nous prenons plaisir à présenter chaque année une application développée pour l’occasion. Cette année ne déroge pas à la règle et nous avons le plaisir de vous présenter : <a href="https://back-to-2022.les-tilleuls.coop/" target="_blank" rel="noreferrer noopener">https://back-to-2022.les-tilleuls.coop/</a>. Faites dès à présent un saut dans le passé et revivez 2022 en tentant de répondre à des choix cornéliens ayant un impact (ou non) sur le bilan de votre année. Tentez votre chance et dites-nous ce que vous en pensez !



<figure class="wp-block-image size-medium is-style-rounded"><a href="https://back-to-2022.les-tilleuls.coop/"><img decoding="async" loading="lazy" width="600" height="320" src="https://api.les-tilleuls.coop/wp-content/uploads/2023/01/back-to-2022-600x320.jpg" alt="" class="wp-image-6224" srcset="https://api.les-tilleuls.coop/wp-content/uploads/2023/01/back-to-2022-600x320.jpg 600w, https://api.les-tilleuls.coop/wp-content/uploads/2023/01/back-to-2022-1024x546.jpg 1024w, https://api.les-tilleuls.coop/wp-content/uploads/2023/01/back-to-2022-300x160.jpg 300w, https://api.les-tilleuls.coop/wp-content/uploads/2023/01/back-to-2022-768x410.jpg 768w, https://api.les-tilleuls.coop/wp-content/uploads/2023/01/back-to-2022.jpg 1500w" sizes="(max-width: 600px) 100vw, 600px" /></a><figcaption class="wp-element-caption"><a href="https://back-to-2022.les-tilleuls.coop/" target="_blank" rel="noreferrer noopener">https://back-to-2022.les-tilleuls.coop/</a></figcaption></figure>



En 2023, Les-Tilleuls.coop vous accompagne toujours dans la réalisation et le maintien de vos projets web. <a href="mailto:contact@les-tilleuls.coop?subject=Parlons%20projets%202023%20!" target="_blank" rel="noreferrer noopener">Échangeons dès maintenant</a>, en visio ou autour d&#8217;un café, sur les prochaines évolutions de vos applications ou sur vos besoins de formation. Nous nous ferons un plaisir de vous accompagner.

Une belle année qui se termine et les yeux rivés vers 2023

Découvrez avec Les-Tilleuls.coop le bilan de l'année 2022 et les projets de l'année qui se profile ! Un petit jeu se cache dans cet article.

Une belle année qui se termine et les yeux rivés vers 2023 | Les-Tilleuls.coop

https://secure.gravatar.com/avatar/54fb8ea2a1a36c3b9ef44f25bf976b48?s=96&d=mm&r=g

Cécile Hamerel

<a href="https://www.youtube.com/watch?v=cWIu3tahbbs" target="_blank" rel="noreferrer noopener">La version 3 d&#8217;API Platform est sortie en septembre dernier</a> avec son lot de fonctionnalités : nouvelle utilisation des attributs PHP 8 (simplifiant la création de sous-ressources), support de OpenAPI pour les composants Admin, Schema Generator et Create Client… Et si votre résolution de 2023 était de vous former aux nouveautés qu&#8217;offre cette nouvelle version ?&nbsp;



<figure class="wp-block-image size-large"><img decoding="async" loading="lazy" width="1024" height="512" src="https://api.les-tilleuls.coop/wp-content/uploads/2022/12/workshop-API-first-1024x512.png" alt="" class="wp-image-6102" srcset="https://api.les-tilleuls.coop/wp-content/uploads/2022/12/workshop-API-first-1024x512.png 1024w, https://api.les-tilleuls.coop/wp-content/uploads/2022/12/workshop-API-first-600x300.png 600w, https://api.les-tilleuls.coop/wp-content/uploads/2022/12/workshop-API-first-300x150.png 300w, https://api.les-tilleuls.coop/wp-content/uploads/2022/12/workshop-API-first-768x384.png 768w, https://api.les-tilleuls.coop/wp-content/uploads/2022/12/workshop-API-first-1536x768.png 1536w, https://api.les-tilleuls.coop/wp-content/uploads/2022/12/workshop-API-first-2048x1024.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



Le jeudi 19 janvier prochain à Nantes, <a href="https://www.youtube.com/watch?v=YGiCEy__vrs" target="_blank" rel="noreferrer noopener">Antoine Bluchet</a>, un des principaux mainteneurs du projet, proposera le temps d&#8217;une journée de se concentrer sur cette nouvelle version. Formez-vous dès à présent et restez à jour sur l&#8217;évolution de ce framework aux <a href="https://packagist.org/packages/api-platform/core" target="_blank" rel="noreferrer noopener">16 millions de paquets téléchargés</a> !



<a href="https://les-tilleuls.coop/masterclass/workshops/workshop-api-platform-3/2023-01-19">Cet atelier</a>, au tarif de 500€ HT, est éligible à de multiples financements et le nombre de places, pour garder une qualité de formation optimale, est très limité. <a href="mailto:contact@les-tilleuls.coop" target="_blank" rel="noreferrer noopener">Contactez Thomas</a> pour valider votre inscription (notre société est <a href="https://les-tilleuls.coop/blog/les-formations-de-les-tilleuls-coop-certifiees-qualiopi" target="_blank" rel="noreferrer noopener">reconnue comme organisme de formation Qualiopi</a> : nous pouvons vous accompagner dans la construction et le financement de votre dossier).



Des questions au sujet de ce workshop ou de <a href="https://les-tilleuls.coop/masterclass" target="_blank" rel="noreferrer noopener">nos autres offres d&#8217;apprentissage</a> ? N&#8217;hésitez pas à nous écrire !

Workshop : plongez dans les nouveautés d'API Platform 3 le 19 janvier à Nantes

Partez à la découverte des nouvelles fonctionnalités d'API Platform le jeudi 19 janvier en compagnie d'Antoine Bluchet.

Workshop : plongez dans les nouveautés d'API Platform 3 le 19 janvier à Nantes | Les-Tilleuls.coop

Workshop : plongez dans les nouveautés d&#8217;API Platform 3 le 19 janvier à Nantes

&Agrave; la d&eacute;couverte du Fediverse


Depuis quelques semaines, un séisme secoue le web après l’arrivée récente d’Elon Musk à la tête de Twitter&nbsp;: démissions, licenciements en cascade, rumeurs de fermeture&#8230; Ces bouleversements font migrer de nombreuses personnalités, utilisatrices et utilisateurs de Twitter vers Mastodon.&nbsp;



<h2>Qu’est-ce que Mastodon ?</h2>



Mastodon est à la fois un réseau social et un logiciel de microblogging auto-hébergé, libre, distribué et décentralisé. Le réseau est constitué d’un ensemble de serveurs qui peuvent communiquer entre eux grâce à <a href="https://fr.wikipedia.org/wiki/ActivityPub" target="_blank" rel="noreferrer noopener">ActivityPub</a>, un protocole ouvert édité par le W3C (le même organisme qui publie les spécifications HTML, CSS ou encore RDF, qui sont au cœur du web). On peut considérer Mastodon comme un réseau analogue de Twitter, mais fédéré.&nbsp;



Non seulement les comptes Mastodon peuvent suivre d&#8217;autres comptes Mastodon &#8211; même si ils sont hébergés sur d&#8217;autres serveurs appelées “instances”, mais ils peuvent aussi suivre des comptes utilisant d&#8217;autres applications communiquant également avec le protocole ActivityPub, comme Pixelfed ou PeerTube. L’ensemble de ces instances fédérées (qui peuvent donc utiliser des logiciels différents mais interopérables) forment ce que l’on appelle <a href="https://fr.wikipedia.org/wiki/Fediverse" target="_blank" rel="noreferrer noopener">le Fediverse</a>. Concrètement, c’est un peu comme si votre compte Twitter vous permettait de suivre et d&#8217;interagir avec les utilisateurs d’Instagram et de TikTok.



<h2>À la découverte du Fediverse</h2>



Le Fediverse, mot-valise formé à partir de &#8220;federation&#8221; et &#8220;universe&#8221;, est un réseau fédéré composé de nombreux serveurs indépendants, qui utilisent divers logiciels très différents mais capables de communiquer ensemble. Ces nombreux serveurs autonomes et indépendants sont ainsi interconnectés et permettent à leurs utilisateurs et utilisatrices d&#8217;interagir les uns et les unes avec les autres de façon totalement transparente. Il n&#8217;y a pas de site central unique : c’est à chaque utilisateur de choisir un serveur pour s’y inscrire.



<center><iframe loading="lazy" title="What is this Federation thing?" src="https://tilvids.com/videos/embed/d62847b6-b803-4985-8b7e-9f905799188c" allowfullscreen="" sandbox="allow-same-origin allow-scripts allow-popups" width="560" height="315" frameborder="0"></iframe></center>



Cette décentralisation garantit que chaque hébergeur d’un serveur est souverain sur ses données. Aucune autorité centrale ne peut censurer ou invisibiliser. De plus, les serveurs du Fediverse (également appelé Fedi) n&#8217;intègrent généralement pas de publicités, ni d&#8217;algorithmes malveillants qui vous fichent et vous surveillent. Comme le web sur lequel il s’appuie, le Fediverse n’appartient pas à une grande firme qui y dicte ses règles : tout le monde peut y brancher son serveur, sans devoir demander l’autorisation à qui que ce soit. 



Pour le moment, le Fediverse est principalement composé de petites communautés, mais n’importe quel site ou réseau social existant peut facilement rejoindre le Fediverse. Pour cela il lui suffit d’implémenter ActivityPub (ou l’un des autres protocoles supporté par le réseau). <a href="https://techreport.com/software/3485711/tumblr-signals-support-for-activitypub-the-mastodon-protocol/" target="_blank" rel="noreferrer noopener">Tumblr, la plateforme de microblogging qui fut un temps la coqueluche du web, vient par exemple d’annoncer son intention de rejoindre le Fediverse</a>.



<h2>Le protocole ActivityPub</h2>



Les communications entre tous ces serveurs se font généralement via un protocole appelé ActivityPub. Il est supporté par Mastodon, mais aussi par d&#8217;autres logiciels tels que PeerTube (alternative à YouTube) et Mobilizon (alternative à Meetup et aux évènements Facebook), tous deux développés par l’association française Framasoft, ou encore Pixelfed (alternative à Instagram) et WriteFreely (logiciel de blog). Il existe par ailleurs un plugin permettant de rendre n’importe quel site utilisant WordPress (y compris le nôtre) accessible sur le Fediverse. Tous ces logiciels peuvent donc interagir ensemble !



ActivityPub a été publié en 2018. C’est le successeur du standard OStatus. ActivityPub s’est très vite imposé du fait de sa simplicité d’implémentation. Les rédactrices et rédacteurs du standard ont d’ailleurs mis un point d’honneur à rendre la lecture de <a href="https://www.w3.org/TR/activitypub/" target="_blank" rel="noreferrer noopener">la spécification</a> aussi aisée que possible, ce que les habitués de ce type de littérature savent assez rare.



Le framework web que nous développons, API Platform, <a href="https://github.com/api-platform/activity-pub" target="_blank" rel="noreferrer noopener">propose également un module permettant à n’importe quel site qui l’utilise d’implémenter ActivityPub</a>. Il est aussi compatible avec l’ensemble des sites créés avec le populaire framework Symfony, auquel nous sommes fiers de contribuer et que nous sponsorisons. Ce module peut même être utilisé comme une bibliothèque PHP autonome.



ActivityPub fonctionne grâce à deux points d’entrée mises à disposition sur une API REST qui se comportent comme deux boîtes aux lettres : l’une permet de recevoir du contenu, l’autre permet d’en envoyer. Pour communiquer avec une autre instance, un serveur n’a donc qu’à consulter le contenu public de la&nbsp; “boîte d’envoi” de cette instance, et déposer du contenu qui lui est spécifique dans sa “boîte de réception”.



<figure class="wp-block-image size-large"><img decoding="async" loading="lazy" width="1024" height="476" src="https://api.les-tilleuls.coop/wp-content/uploads/2022/12/Capture-decran-2022-12-06-a-17.50.13-1024x476.png" alt="" class="wp-image-6069" srcset="https://api.les-tilleuls.coop/wp-content/uploads/2022/12/Capture-decran-2022-12-06-a-17.50.13-1024x476.png 1024w, https://api.les-tilleuls.coop/wp-content/uploads/2022/12/Capture-decran-2022-12-06-a-17.50.13-600x279.png 600w, https://api.les-tilleuls.coop/wp-content/uploads/2022/12/Capture-decran-2022-12-06-a-17.50.13-300x140.png 300w, https://api.les-tilleuls.coop/wp-content/uploads/2022/12/Capture-decran-2022-12-06-a-17.50.13-768x357.png 768w, https://api.les-tilleuls.coop/wp-content/uploads/2022/12/Capture-decran-2022-12-06-a-17.50.13.png 1380w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



Le seul prérequis est de connaître l’existence du serveur en question. Dans le cas d’un serveur exécutant Mastodon, la découverte des autres serveurs se fait au fur et à mesure que les membres du Fediverse se connectent entre eux.



Notez que la spécification d’ActivityPub précise qu’il est tout à fait possible de n’implémenter qu’une seule des deux boîtes.



<h2>Les-Tilleuls.coop et le Fediverse</h2>



Chez Les-Tilleuls.coop, cela fait plusieurs années désormais que <a href="https://les-tilleuls.coop/blog/api-platform-schema-generator-v3" target="_blank" rel="noreferrer noopener">nous alertons sur la manière dont le web est utilisé</a>. Nous sommes intervenu·e·s à plusieurs reprises sur les manières de&nbsp; bâtir un nouveau web décentralisé : 



<center><iframe loading="lazy" src="https://www.youtube.com/embed/x4rvTtfP4k8" title="YouTube video player" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen="" width="560" height="315" frameborder="0"></iframe></center>



Comme nous l’avons vu, nous avons également créé il y a quelques années <a href="https://github.com/api-platform/activity-pub" target="_blank" rel="noreferrer noopener">une bibliothèque PHP implémentant le protocole ActivityPub</a> et nous sommes logiquement présents sur <a href="https://mastodon.online/@cooptilleuls" target="_blank" rel="noreferrer noopener">Mastodon</a> et Peertube depuis plusieurs années.



Si vous souhaitez aussi rejoindre le Fediverse, <a href="https://les-tilleuls.coop/blog/rencontre-equipe-sre" target="_blank" rel="noreferrer noopener">notre pôle SRE</a> peut héberger vos instances Mastodon, PeerTube, Mobilizon, PixelFed, etc. Nos développeuses et développeurs <a href="https://les-tilleuls.coop/cloud-et-devops" target="_blank" rel="noreferrer noopener">peuvent également adapter vos sites, apps et réseaux sociaux pour les rendre compatibles</a> ! Contactez-nous pour plus de détails.







Crédit photo : <a href="https://commons.wikimedia.org/wiki/User:Eukombos">Eukombos</a>, <a href="https://en.wikipedia.org/wiki/en:Creative_Commons">Creative Commons</a> <a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en">Attribution-Share Alike 4.0 International</a>

Mastodon, le Fediverse, ActivityPub : comprendre et maîtriser les nouvelles étoiles du web

Comprenez le fonctionnement du Fediverse, du protocole ActivityPub et du réseau social Mastodon grâce à cet article.

Mastodon, le Fediverse, ActivityPub : comprendre et maîtriser les nouvelles étoiles du web | Les-Tilleuls.coop

Nous vous donnons rendez-vous les 14, 15 et 16 décembre prochains à la Cité des Sciences (Paris) à l&#8217;occasion des <a href="https://www.apidays.global" target="_blank" rel="noreferrer noopener nofollow">API Days</a>, l&#8217;événement de référence axé sur l&#8217;écosystème des APIs. Cette convention à laquelle nous assistons depuis plusieurs années fête ses 10 ans. L&#8217;équipe derrière l&#8217;organisation des API Days a coordonné depuis 2012 plus de soixante conférences réparties dans quatorze pays différents : USA, Chine, Australie, Indonésie, Pays Bas&#8230; De nombreux secteurs d&#8217;activités et sujets y sont couverts : banque et services financiers, conseil, énergie, santé, IT, automobile, médias, no code&#8230; 



Cette année, le thème de cette édition porte sur le futur des APIs dans les 10 prochaines années : logiciel, société, souveraineté, durabilité. Parmi la centaine de conférencières et conférenciers annoncés, nous avons la chance d&#8217;avoir le mercredi 14 décembre une après-midi entière axée sur le framework API Platform avec 5 speakers que vous connaissez déjà :



<ul>
<li><a href="https://twitter.com/s0yuka" target="_blank" rel="noreferrer noopener">Antoine Bluchet</a> initiera cette track avec une conférence revenant sur la sortie de la release d&#8217;API Platform 3.</li>



<li><a href="https://twitter.com/dunglas" target="_blank" rel="noreferrer noopener">Kévin Dunglas</a> parlera de l&#8217;étendue de toutes les possibilités d&#8217;utilisation du format JSON-LD.</li>



<li><a href="https://twitter.com/gknjockbot" target="_blank" rel="noreferrer noopener">Georges-King Njock-Bôt</a> fera un retour d&#8217;expérience de l&#8217;utilisation d&#8217;API Platform.</li>



<li><a href="https://twitter.com/matarld" target="_blank" rel="noreferrer noopener">Mathias Arlaud</a> échangera sur la sérialisation avec API Platform et Symfony.</li>



<li><a href="https://twitter.com/gheb_dev" target="_blank" rel="noreferrer noopener">Grégoire Hébert</a> montrera comment gérer les opérations séquentielles avec REST et API Platform.
<ul>
<li></li>
</ul>
</li>
</ul>



Le <a href="https://www.apidays.global/paris/" target="_blank" rel="noreferrer noopener">programme complet est disponible</a> et nous vous invitons à venir nous rencontrer gratuitement sur notre stand et suivre les conférences en utilisant le code promo suivant <a href="https://www.apidays.global/paris/#buy-ticket" target="_blank" rel="noreferrer noopener">sur cette page</a> : LESTILLEULSVIP



En complément de cette après-midi consacrée à Webby, plusieurs coopératrices et coopérateurs seront également sur la scène Technology &amp; Society de cet événement le jeudi 15 décembre : <a href="https://twitter.com/marion_age" target="_blank" rel="noreferrer noopener">Marion Agé</a> et <a href="https://fr.linkedin.com/in/camillegaquiere" target="_blank" rel="noreferrer noopener">Camille Gaquière</a> prendront la parole sur le modèle coopératif et la place des femmes dans le numérique. Kévin Dunglas, de son côté, animera la conférence &#8220;Ne vous lamentez pas, organisez-vous !&#8221;. 



À la semaine prochaine !

Une scène consacrée à API Platform aux API Days Paris 2022

Retrouvez-nous aux 10 ans des API Days Paris le 14 décembre 2022 sur une track entièrement dédiée à API Platform.

Une scène consacrée à API Platform aux API Days Paris 2022 | Les-Tilleuls.coop

Admission, rapport du conseil de surveillance et bilan de la co-g&eacute;rance


Le mois de juin 2022 a été l’occasion, comme chaque année pour l’ensemble d’entre-nous de participer à l’Assemblée Générale Ordinaire” (AGO). Cette AGO n’est en réalité pas si “ordinaire” puisqu’elle n’a lieu qu’une seule fois par an. Quelques explications s’imposent… Comme vous le savez peut-être déjà, <a href="https://les-tilleuls.coop/" target="_blank" rel="noreferrer noopener">Les-Tilleuls.coop</a> est une société coopérative détenue et dirigée à 100 % par ses salarié•es. C’est-à-dire que non seulement l’entreprise nous appartient financièrement, mais que toutes les décisions qui sont prises en son sein le sont par l’ensemble de nos effectifs. Afin de s’organiser efficacement, nous organisons tous les mois <a href="https://les-tilleuls.coop/blog/une-journee-chez-les-tilleuls-coop">une journée complète d’assemblée générale</a> où sont abordés tous les sujets relatifs à la vie de l’entreprise, que ce soit nos salaires, les clients, les embauches ou les événements, absolument tout est décidé collégialement et démocratiquement sur un modèle autogestionnaire intégral : 1 salarié•e  = 1 voix. Lors de ces réunions mensuelles, les personnes récemment embauché•e•s ont donc le même pouvoir de décision que les gérant•es, sur un principe qui nous est cher : “c’est nous qui travaillons, c’est nous qui décidons”.



<h2>Le fonctionnement des AGO </h2>



Ces AG permettent donc de gérer les affaires courantes de la société, et peuvent parfois faire l’objet de débats animés sur des sujets plus ou moins clivants. Ces journées, même si elles sont le cœur de notre démocratie interne, n’ont pas de réelle valeur juridique, et c’est au cours de l’Assemblée Générale Ordinaire, une fois l’an, qu’un certain nombre de points doivent être discutés. Cette AGO fait donc l’objet d’un procès verbal et permet notamment d’aborder des aspects administratifs précis tels que l’intégration de nouvelles personnes associé•es à l’entreprise, la validation des comptes de l’année écoulée, l’élection des gérant•es, etc. Lorsqu’une nouvelle personne est embauchée chez <a href="https://les-tilleuls.coop/" target="_blank" rel="noreferrer noopener">Les-Tilleuls.coop</a>, les statuts internes de l’entreprise prévoient qu’avant la fin de sa première année de présence dans les effectifs, il ou elle fasse sa demande d’accès au sociétariat. Concrètement, cela signifie que toute nouvelle recrue est amenée à devenir associé·e de l’entreprise et à détenir des parts de la société : cette personne devient donc définitivement une “coopératrice” ou un &#8220;coopérateur&#8221;. Et puisqu’on souhaite que chaque recrue soit également une associée, s’il ne fait pas sa demande, elle est considérée comme démissionnaire. Chaque année c’est donc l’occasion pour un certain nombre de nos collègues de faire leur demande d’accès au sociétariat et d’acheter une part sociale de l’entreprise pour devenir associé•e. C’est d’ailleurs même le premier point abordé lors des ces journées. Un vote des personnes déjà associées a ensuite lieu et permet de valider l’intégration des nouvelles recrue. Même si cet instant peut paraître symbolique, il s’agit pour chacun•e d’entre nous d’un moment fort qui acte définitivement l’entrée en tant qu’associé•e de la coopérative. 



<h2>Admission, rapport du conseil de surveillance et bilan de la co-gérance</h2>



 Ces explications techniques faites, cette année vit l’admission en tant que coopérateur de 16 nouvelles et nouveaux associés ! Bienvenue donc à <a href="https://twitter.com/MargauxFeslard" target="_blank" rel="noreferrer noopener">Margaux</a>, Jonas, <a href="https://twitter.com/MaximeUrbanski" target="_blank" rel="noreferrer noopener">Maxime</a>, <a href="https://twitter.com/matarld" target="_blank" rel="noreferrer noopener">Mathias</a>, <a href="https://twitter.com/stakovicz" target="_blank" rel="noreferrer noopener">Albin</a>, <a href="https://twitter.com/romainallanot" target="_blank" rel="noreferrer noopener">Romain</a>, <a href="https://les-tilleuls.coop/la-cooperative/equipe" target="_blank" rel="noreferrer noopener">Samuel</a>, <a href="https://twitter.com/DuverdierElise">Élise</a>, Julien, Jérémy, <a href="https://les-tilleuls.coop/la-cooperative/equipe">Emmanuel</a>, <a href="https://twitter.com/acauwd" target="_blank" rel="noreferrer noopener">Antoine</a> et Arnaud 😉 Après la présentation par <a href="https://twitter.com/Olenancker" target="_blank" rel="noreferrer noopener">Olivier Lenancker</a> des comptes de l’entreprise et de nos résultats pour l’année 2021, ces derniers ont également été validés par l’ensemble des coopérateur•rices.



Pour la deuxième fois cette année nous avons eu un compte rendu de notre conseil de surveillance <a href="https://les-tilleuls.coop/blog/election-marion-age">mise en place lors de l’AGO 2021 </a>et présidé par <a href="https://twitter.com/s0yuka" target="_blank" rel="noreferrer noopener">Antoine Bluchet</a> de notre antenne Nantaise. Ce conseil de surveillance nous a proposé un rapport complet sur son travail d’enquête et d’analyse établi tout au long de l’année écoulée.



Cette Assemblée Générale Ordinaire fut aussi l&#8217;occasion de faire le bilan de la première année de co-gérance de <a href="https://les-tilleuls.coop/blog/election-marion-age" target="_blank" rel="noreferrer noopener">Marion Agé</a>, élue l&#8217;année dernière et qui a présenté un résumé de l&#8217;année écoulé plus que satisfaisant. 



Cette assemblée fut l’occasion de se retrouver le soir lors d’un moment convivial. Nous étions plus de 60 collaboratrices et collaborateurs sur notre terrasse lilloise. Au programme : petits fours, convivialité, animations, rires, photocall, etc. Un beau moment de cohésion pour notre équipe !

Assemblée Générale Ordinaire 2022 : de nouveaux associés et une soirée conviviale

Découvrez le bilan de notre assemblée générale ordinaire, permettant l'admission de nouveaux associés.

Assemblée Générale Ordinaire 2022 : de nouveaux associés et une soirée conviviale | Les-Tilleuls.coop

https://secure.gravatar.com/avatar/5f74ccf442f27a3c41d1ab21d11e8900?s=96&d=mm&r=g

Climate change and IT, scaling sustainably 


Decoupling an application with Symfony Messenger 


Comment faire pour moderniser son application ?


Les-Tilleuls.coop &agrave; la SymfonyCon


7 Lessons You Can Learn From Disney Movies 


Le&ccedil;on n&deg; 1 : connais-toi toi-m&ecirc;me


Le&ccedil;on n&deg; 2 : tu n&rsquo;es pas seul&middot;e


Le&ccedil;on n&deg; 3 : quel est ton objectif ?


Le&ccedil;on n&deg; 4 : apprends, mets en pratique, pers&eacute;v&egrave;re


Le&ccedil;on n&deg; 5 : le travail d&rsquo;&eacute;quipe


Le&ccedil;on n&deg; 6 : parie sur toi&nbsp;&nbsp;


Le&ccedil;on n&deg; 7 : change de point de vue


Retour sur la SymfonyCon 2022

Notre coopérative était présente à la SymfonyCon 2022. Découvrez le retour de notre équipe présente sur place.

Découvrez le compte-rendu de notre équipe sur la SymfonyCon 2022 organisée cette année à Disneyland Paris.

Retour sur la SymfonyCon 2022 | Les-Tilleuls.coop

Formater et documenter vos &eacute;num&eacute;rations expos&eacute;es


&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

use ApiPlatform\Metadata\ApiProperty;
use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Get;
use ApiPlatform\Metadata\GetCollection;
use ApiPlatform\Metadata\Post;
use Symfony\Component\Uid\Uuid;
use Symfony\Component\Validator\Constraints\Length;

#[ApiResource(types: ['http://schema.org/Blogpost'], description: "A blog article")]
class BlogPost
{
    public function __construct(
        #[ApiProperty(types: ['http://schema.org/identifier'])]
        public Uuid $id,
        #[ApiProperty(types: ['http://schema.org/name'])]
        #[Length(min: 3)]
        public string $title,
        public Status $status
    )
    {
    }
}

&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Get;
use ApiPlatform\Metadata\GetCollection;

#[
    ApiResource(
        types: ['https://schema.org/Enumeration'],
        normalizationContext: ['groups' => ['read']],
        description: "Status used for a blog article"
    ),
    GetCollection(provider: Status::class.'::getCases'),
    Get(provider: Status::class.'::getCase')
]
enum Status: int
{
    case DRAFT = 0;
    case PUBLISHED = 1;
    case ARCHIVED = 2;

    use EnumApiResourceTrait;
}

&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

use ApiPlatform\Metadata\ApiProperty;
use ApiPlatform\Metadata\Operation;
use Symfony\Component\Serializer\Annotation\Groups;

trait EnumApiResourceTrait
{
    #[ApiProperty(types: ['https://schema.org/identifier'])]
    public function getId()
    {
        return $this->name;
    }

    #[Groups('read')]
    #[ApiProperty(types: ['https://schema.org/name'])]
    public function getValue()
    {
        return $this->value;
    }

    public static function getCases()
    {
        return self::cases();
    }

    public static function getCase(Operation $operation, array $uriVariables)
    {
        $name = $uriVariables['id'] ?? null;
        return self::tryFrom($name) ?? constant(self::class . "::$name");
    }
}

    "components": {
        "schemas": {
            "BlogPost.jsonld": {
                "type": "object",
                "description": "A blog article",
                "deprecated": false,
                "externalDocs": {
                    "url": "http://schema.org/Blogpost"
                },
                "properties": {
                    "id": {
                        "externalDocs": {
                            "url": "http://schema.org/identifier"
                        },
                        "type": "string",
                        "format": "uuid"
                    },
                    "title": {
                        "minLength": 3,
                        "externalDocs": {
                            "url": "http://schema.org/name"
                        },
                        "type": "string"
                    },
                    "status": {
                        "type": "string",
                        "format": "iri-reference"
                    }
                }
            },
            "Status.jsonld-read": {
                "type": "object",
                "description": "Status used for a blog article",
                "deprecated": false,
                "externalDocs": {
                    "url": "https://schema.org/Enumeration"
                },
                "properties": {
                    "@context": {
                        "readOnly": true,
                        "oneOf": [
                            {
                                "type": "string"
                            },
                            {
                                "type": "object",
                                "properties": {
                                    "@vocab": {
                                        "type": "string"
                                    },
                                    "hydra": {
                                        "type": "string",
                                        "enum": [
                                            "http://www.w3.org/ns/hydra/core#"
                                        ]
                                    }
                                },
                                "required": [
                                    "@vocab",
                                    "hydra"
                                ],
                                "additionalProperties": true
                            }
                        ]
                    },
                    "@id": {
                        "readOnly": true,
                        "type": "string"
                    },
                    "@type": {
                        "readOnly": true,
                        "type": "string"
                    },
                    "value": {
                        "readOnly": true,
                        "externalDocs": {
                            "url": "https://schema.org/name"
                        },
                        "type": "string"
                    }
                }
            }

    "hydra:supportedClass": [
        {
            "@id": "http://schema.org/Blogpost",
            "@type": "hydra:Class",
            "rdfs:label": "BlogPost",
            "hydra:title": "BlogPost",
            "hydra:supportedProperty": [
                {
                    "@type": "hydra:SupportedProperty",
                    "hydra:property": {
                        "@id": "#BlogPost/id",
                        "@type": "rdf:Property",
                        "rdfs:label": "id",
                        "domain": "http://schema.org/Blogpost"
                    },
                    "hydra:title": "id",
                    "hydra:required": false,
                    "hydra:readable": true,
                    "hydra:writeable": true
                },
                {
                    "@type": "hydra:SupportedProperty",
                    "hydra:property": {
                        "@id": "#BlogPost/title",
                        "@type": "rdf:Property",
                        "rdfs:label": "title",
                        "domain": "http://schema.org/Blogpost",
                        "range": "xmls:string"
                    },
                    "hydra:title": "title",
                    "hydra:required": false,
                    "hydra:readable": true,
                    "hydra:writeable": true
                },
                {
                    "@type": "hydra:SupportedProperty",
                    "hydra:property": {
                        "@id": "#BlogPost/status",
                        "@type": "hydra:Link",
                        "rdfs:label": "status",
                        "domain": "http://schema.org/Blogpost",
                        "owl:maxCardinality": 1,
                        "range": "https://schema.org/Enumeration"
                    },
                    "hydra:title": "status",
                    "hydra:required": false,
                    "hydra:readable": true,
                    "hydra:writeable": true
                }
            ],
            "hydra:description": "Blog article"
        },
        {
            "@id": "https://schema.org/Enumeration",
            "@type": "hydra:Class",
            "rdfs:label": "Status",
            "hydra:title": "Status",
            "hydra:supportedProperty": [
                {
                    "@type": "hydra:SupportedProperty",
                    "hydra:property": {
                        "@id": "#Status/value",
                        "@type": "rdf:Property",
                        "rdfs:label": "value",
                        "domain": "https://schema.org/Enumeration",
                        "range": "xmls:integer"
                    },
                    "hydra:title": "value",
                    "hydra:required": false,
                    "hydra:readable": true,
                    "hydra:writeable": false
                }
            ],
            "hydra:supportedOperation": [
                {
                    "@type": [
                        "hydra:Operation",
                        "schema:FindAction"
                    ],
                    "hydra:method": "GET",
                    "hydra:title": "Retrieves a Status resource.",
                    "rdfs:label": "Retrieves a Status resource.",
                    "returns": "https://schema.org/Enumeration"
                }
            ],
            "hydra:description": "Status used for a blog article"
        },


&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Get;
use ApiPlatform\Metadata\GetCollection;
use ApiPlatform\Metadata\Post;
use Symfony\Component\Uid\Uuid;

#[ApiResource, GetCollection, Get, Post]
class BlogPost
{
    public function __construct(
        public Uuid $id,
        public string $title,
        public Status $status
    )
    {
    }
}

&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

enum Status: int
{
    case DRAFT = 0;
    case PUBLISHED = 1;
    case ARCHIVED = 2;
}

curl -k -X 'POST' \
  'https://localhost/blog_posts' \
  -H 'Accept: application/ld+json' \
  -H 'Content-Type: application/ld+json' \
  -d '{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "string",
  "status": 0
}'

string

Donner la possibilit&eacute; de conna&icirc;tre la liste des valeurs possible


&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Get;
use ApiPlatform\Metadata\GetCollection;

#[
    ApiResource,
    GetCollection, 
    Get,
]
enum Status: int
{
    case DRAFT = 0;
    case PUBLISHED = 1;
    case ARCHIVED = 2;
}

&lt;?php

enum Suit
{
    case Hearts;
    case Diamonds;
    case Clubs;
    case Spades;
}

function doStuff(Suit $s)
{
    // ...
}

doStuff(Suit::Spades);
doStuff('Spades'); // ceci échouera

&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Get;
use ApiPlatform\Metadata\GetCollection;
use ApiPlatform\Metadata\Operation;

#[
    ApiResource,
    GetCollection(provider: Status::class.'::getCases'), 
    Get(provider: Status::class.'::getCase'),
]
enum Status: int
{
    case DRAFT = 0;
    case PUBLISHED = 1;
    case ARCHIVED = 2;

    public function getId()
    {
        return $this->name;
    }

    public static function getCases()
    {
        return self::cases();
    }

    public static function getCase(Operation $operation, array $uriVariables)
    {
        $name = $uriVariables['id'] ?? null;

        return constant(self::class . "::$name");
    }
}

curl -k --request GET 'https://localhost/statuses' --header 'Content-Type: application/ld+json'

curl -k --request GET 'https://localhost/statuses/DRAFT' --header 'Content-Type: application/ld+json'

    // ...

    public function getId()
    {
        return $this->value;
    }

    public static function getCases()
    {
        return array_map(static fn (UnitEnum $enumCase) => $enumCase->value, self::cases());
    }

    public static function getCase(Operation $operation, array $uriVariables)
    {
        return self::tryFrom($uriVariables['id'] ?? null);
    }

    // ...

S&eacute;rialiser les valeurs &eacute;num&eacute;r&eacute;es


&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Get;
use ApiPlatform\Metadata\GetCollection;
use ApiPlatform\Metadata\Operation;
use Symfony\Component\Serializer\Annotation\Groups;

#[
  ApiResource(normalizationContext: ['groups' => ['read']]),
  GetCollection(provider: Status::class.'::getCases'),
  Get(provider: Status::class.'::getCase')
]
enum Status: int
{
    case DRAFT = 0;
    case PUBLISHED = 1;
    case ARCHIVED = 2;

    public function getId()
    {
        return $this->name;
    }

    #[Groups('read')]
    public function getValue()
    {
        return $this->value;
    }

    public static function getCases()
    {
        return self::cases();
    }

    public static function getCase(Operation $operation, array $uriVariables)
    {
        return self::tryFrom($uriVariables['id']);
    }
}

curl -k -X 'GET' 'https://localhost/statuses' -H 'accept: application/ld+json'

curl -k -X 'GET' 'https://localhost:8000/statuses/DRAFT' -H 'accept: application/ld+json'

&lt;?php

enum Suit: string
{
    case Hearts = 'H';
    case Diamonds = 'D';
    case Clubs = 'C';
    case Spades = 'S';
}

curl -k -X 'POST' \
  'https://localhost/blog_posts' \
  -H 'Accept: application/ld+json' \
  -H 'Content-Type: application/ld+json' \
  -d '{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "string",
  "status": "/statuses/DRAFT"
}'

&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\Get;
use ApiPlatform\Metadata\GetCollection;

#[ApiResource(normalizationContext: ['groups' => ['read']]),
    GetCollection(provider: Status::class.'::getCases'),
    Get(provider: Status::class.'::getCase')
]
enum Status: int
{
    case DRAFT = 0;
    case PUBLISHED = 1;
    case ARCHIVED = 2;

    use EnumApiResourceTrait;
}

&lt;?php

declare(strict_types=1);

namespace App\ApiResource;

use ApiPlatform\Metadata\Operation;
use Symfony\Component\Serializer\Annotation\Groups;

trait EnumApiResourceTrait
{
    public function getId()
    {
        return $this->name;
    }

    #[Groups('read')]
    public function getValue()
    {
        return $this->value;
    }

    public static function getCases()
    {
        return self::cases();
    }

    public static function getCase(Operation $operation, array $uriVariables)
    {
        $name = $uriVariables['id'] ?? null;
        return self::tryFrom($name);
    }
}

Note d&#8217;avant lecture : si des termes vous sont inconnus, mettez votre lecture en pause et allez vérifier leur signification avant de reprendre !



Ils sont là depuis près d&#8217;un an, et ils ont longtemps été attendus ! Ce ne sont pas les derniers titres de Vianney mais les énumérations. Si vous les découvrez avec cet article, les <meta charset="utf-8">énumérations sont un moyen de définir un ensemble restreint de valeurs possibles pour un type. Cela peut être particulièrement utile lors de la définition d&#8217;un modèle de domaine puisqu&#8217;ils ne nécessitent pas de surcouche de code. 





 Il est également possible d&#8217;associer leurs constantes à des valeurs. 





Je vous invite à lire <a href="https://www.php.net/manual/fr/language.enumerations.php" target="_blank" rel="noreferrer noopener">la documentation</a> afin de prendre connaissance des autres mécanismes que proposent les <meta charset="utf-8">énumérations, leurs méthodes, leurs constantes&#8230; Lisez bien les douze sections en prenant le temps de les comprendre, quitte à tester vous-même chaque situation présentée ! Utiliser les <meta charset="utf-8">énumérations avec API Platform devient très vite attrayant, découvrez plus en détails pourquoi :



<h2>Les Enums avec API Platform</h2>



Voyons un cas classique d&#8217;un BlogPost possédant un statut : 







 Si nous effectuons une requête <code>POST</code> pour créer un BlogPost : 





Nous obtenons bien un BlogPost valide.





C&#8217;est déjà une très bonne chose, mais nous aimerions donner la possibilité de connaître les statuts disponibles, et de les exposer à l&#8217;aide de notre API.



<h2>Donner la possibilité de connaître la liste des valeurs possible</h2>



Nous allons transformer notre classe Status en ressource. 





<div class="wp-block-image"><figure class="aligncenter size-large"><img decoding="async" loading="lazy" width="1024" height="269" src="https://api.les-tilleuls.coop/wp-content/uploads/2022/11/Capture-décran-2022-11-08-à-07.52.33-1024x269.png" alt="Aperçu de SwaggerUI avec les nouveaux EndPoint pour les status." class="wp-image-5882" srcset="https://api.les-tilleuls.coop/wp-content/uploads/2022/11/Capture-décran-2022-11-08-à-07.52.33-1024x269.png 1024w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/Capture-décran-2022-11-08-à-07.52.33-600x157.png 600w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/Capture-décran-2022-11-08-à-07.52.33-300x79.png 300w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/Capture-décran-2022-11-08-à-07.52.33-768x201.png 768w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/Capture-décran-2022-11-08-à-07.52.33-1536x403.png 1536w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/Capture-décran-2022-11-08-à-07.52.33-2048x537.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure></div>



Pour servir de <code>provider</code>, nous allons utiliser l&#8217;<meta charset="utf-8">énumération Status lui-même. 





<blockquote class="wp-block-quote">La méthode statique <code>cases</code> n&#8217;appartient pas au <code>userland</code>. Il est sous-entendu ici qu&#8217;elle est définie par le langage, et n&#8217;est pas tout à fait régie par les mêmes règles. Nous devons la redéfinir nous-même afin qu&#8217;elle puisse être utilisée comme méthode de provider, sinon une incompatibilité des arguments attendus sera soulevée par PHP.</blockquote>



Nous pouvons à présent lister les statuts avec la requête HTTP suivante :







Et en obtenir une valeur spécifique à l&#8217;aide des constantes :







Vous pourriez aussi vouloir les récupérer avec leur valeur. 





<h2>Sérialiser les valeurs énumérées</h2>



Les <meta charset="utf-8">énumérations fonctionnent d&#8217;une manière assez particulière. Chaque <code>case</code>, lorsqu&#8217;il est obtenu est techniquement une instance de l&#8217;<meta charset="utf-8">énumérations. En passant par le Serializer, nous aurions alors une boucle infinie (si elle n&#8217;était pas limitée à trois sous-niveaux par défaut) où chaque <code>case</code> expose à son tour les autres <code>cases</code> disponibles. 



Nous devons restreindre cette récursion à l&#8217;aide des groupes de sérialisation (voir <a href="https://www.youtube.com/watch?v=mYwL8snWvTs" target="_blank" rel="noreferrer noopener">la conférence de notre coopérateur Mathias Arlaud</a> sur le sujet). 





Vous pouvez à présent obtenir la liste des statuts : 







Et récupérer un status seul : 







<h2>Résultat</h2>



Pour effectuer notre requête <code>POST</code> initiale, nous pouvons désormais faire référence à sa ressource à l&#8217;aide de son IRI ! 





Avec pour résultat : 





<h2>Factoriser le code</h2>



Les trois méthodes de notre <meta charset="utf-8">énumération sont très génériques alors nous pouvons utiliser les traits pour éviter de nous répéter au sein de nos autres <meta charset="utf-8">énumérations. 





Et 





C&#8217;est un bon moyen d&#8217;exposer vos listes !





<h2>Formater et documenter vos énumérations exposées</h2>



Depuis le début de cet article, je me suis appliqué à utiliser l&#8217;entête HTTP <code>Accept</code> pour la récupération de mes énumérations. En particulier avec le <a href="https://www.iana.org/assignments/media-types/media-types.xhtml" target="_blank" rel="noreferrer noopener">Media-Type</a> <code>application/ld+json</code> pour l&#8217;usage de <a href="https://json-ld.org/" target="_blank" rel="noreferrer noopener">Json Linked Data</a>. Cet entête permet la négociation de contenu. C&#8217;est important parce que REST propose une solution de restitution de la ressource demandée de sorte à ce qu&#8217;elle corresponde à ses capacités, sa nature, ainsi qu&#8217;au désir du client. Pour respecter ceci, nous voulons : 



<ul><li>Pouvoir représenter / rendre les données où elles se trouvent</li><li>Pouvoir encapsuler les données avec un moteur de rendu et envoyer les deux (la donnée brute et la donnée rendue)</li><li>Pouvoir envoyer les données brutes avec des métadonnées afin de laisser le choix du moteur de rendu au client</li></ul>



Ici nous nous proposons sur le dernier point.



<meta charset="utf-8">Le format <code>application/ld+json</code> est un format <a href="https://book.validatingrdf.com/" target="_blank" rel="noreferrer noopener">RDF</a>.



RDF est un élément clé des données liées (<a href="https://www.w3.org/standards/semanticweb/data" target="_blank" rel="noreferrer noopener">Linked-Data</a>). Les données liées ont été proposées comme un ensemble de bonnes pratiques pour publier des données sur le Web. Elles ont été introduites par <a href="https://fr.wikipedia.org/wiki/Tim_Berners-Lee" target="_blank" rel="noreferrer noopener">Tim Berners-Lee</a> et reposent sur quatre grands principes. RDF est mentionné dans le troisième principe comme l&#8217;une des normes qui fournit des informations utiles.



L&#8217;objectif est que l&#8217;information soit utile non seulement pour les humains qui utilisent des navigateurs (pour lesquels le HTML serait suffisant) mais aussi pour d&#8217;autres agents susceptibles de traiter automatiquement ces données (des clients avec des API HTTP).



<meta charset="utf-8">Nous ne savons pas encore, en tant que consommateur de l&#8217;API, ce que signifie ou représente le champs valeur de notre ressource <code>Status</code>. Mais puisque nous avons une API REST, offrant un format RDF, en particulier JSON-LD, nous souhaitons la nourrir pour qu&#8217;un outil partageant les mêmes standards puisse découvrir de façon automatisée comment exploiter nos données.



Pour faire ceci, et respecter RDF, il faut choisir un format respectant les règles établies ainsi qu&#8217;un &#8220;<a href="https://fr.wikipedia.org/wiki/Web_Ontology_Language" target="_blank" rel="noreferrer noopener">vocabulaire</a>&#8221; / une &#8220;<a href="https://www.w3.org/standards/semanticweb/ontology" target="_blank" rel="noreferrer noopener">ontologie</a>&#8220;, afin de s&#8217;assurer que la donnée offerte puisse être exploitée comme prévu. Les vocabulaires RDF sont couramment utilisés pour définir des concepts et des relations à l&#8217;échelle du web (<a href="https://schema.org/" target="_blank" rel="noreferrer noopener">Schema.org</a>), d’une branche d’industrie (la&nbsp;<a href="https://data.nasa.gov/ontologies/atmonto" target="_blank" rel="noreferrer noopener">NASA</a>,&nbsp;<a href="http://www.automotive-ontology.org/" target="_blank" rel="noreferrer noopener">The Automotive Ontology</a>,<a href="https://addictovocab.org/" target="_blank" rel="noreferrer noopener">&nbsp;AddictO Vocab</a>&#8230;) ou d’une organisation&nbsp; (<a href="https://op.europa.eu/en/web/eu-vocabularies/corevocs" target="_blank" rel="noreferrer noopener">l’Union Européenne,</a>&nbsp;<a href="https://www.w3.org/2001/sw/sweo/public/UseCases/Volkswagen/" target="_blank" rel="noreferrer noopener">Volkswagen</a>).





Au sein du vocabulaire Schema.org, il existe une définition des énumérations. <a href="https://schema.org/Enumeration" target="_blank" rel="noreferrer noopener">https://schema.org/Enumeration</a>. Afin de rendre nos ressources expressives, nous allons ajouter l&#8217;usage du vocabulaire dans nos métadonnées. Profitons-en pour ajouter une description à notre classe <code>BlogPost</code>.





Ensuite notre énumération <code>Status</code>





Sans oublier le trait :





Ce qui permet à API Platform de documenter notre ressource.



Voici ce qui sera ajouté à notre documentation OpenAPI (j&#8217;ai collé un extrait pour n&#8217;afficher ici que l&#8217;essentiel) :





API Platform pourra également fournir la documentation <a href="https://www.hydra-cg.com/" target="_blank" rel="noreferrer noopener">HYDRA</a> <meta charset="utf-8">(j&#8217;ai collé un extrait pour n&#8217;afficher ici que l&#8217;essentiel).





<h2>Synthétisons</h2>



Avec tout ce que nous avons fait, lorsque nous récupérons un statut en particulier, nous obtenons ce JSON-LD :





Nous ne savons pas encore, en tant que consommateur de l&#8217;API ce que signifie ou représente le champ valeur. Mais puisque nous avons une API REST, offrant un format RDF, en particulier JSON-LD, nous savons que nous pouvons en apprendre plus à l&#8217;aide de la clé <a href="https://www.w3.org/TR/json-ld/#the-context" target="_blank" rel="noreferrer noopener">context</a>. En effectuant une requête GET sur cet URL, nous allons donc obtenir des informations sur cette propriété et cette ressource.





Nous obtenons l&#8217;information que toutes les valeurs sont décrites par le vocabulaire défini à l&#8217;URL <code><meta charset="utf-8">https://localhost:8000/docs.jsonld#</code>. Cet URL, c&#8217;est la documentation Hydra vue précédemment.



Autrement dit, cela nous a permis d&#8217;obtenir une API Hypermédia.




Si API Platform est compatible, la documentation pourrait être un peu plus automatisée, et ce travail est en cours grâce à <a href="https://github.com/alanpoulain" target="_blank" rel="noreferrer noopener">Alan Poulain</a>, ici : <a href="https://github.com/api-platform/core/pull/5120" target="_blank" rel="noreferrer noopener">https://github.com/api-platform/core/pull/5120</a> et là <a href="https://github.com/api-platform/core/issues/2254" target="_blank" rel="noreferrer noopener">https://github.com/api-platform/core/issues/2254</a>. N&#8217;hésitez pas à aller tester et montrer votre enthousiasme sur son travail !




<h2>Aller plus loin </h2>



Si vous avez besoin d&#8217;intégrer encore plus loin vos <meta charset="utf-8">énumérations (readable, Doctrine, translate, bitwise operation, forms et Faker), je vous recommande également l&#8217;excellente bibliothèque PhpEnums <a href="https://github.com/Elao/PhpEnums" target="_blank" rel="noreferrer noopener">https://github.com/Elao/PhpEnums</a> réalisée par l&#8217;équipe d&#8217;Elao. 



Bon code à vous !

Exposez vos Enums avec API Platform

Découvrez dans cet article comment les Enums permettent de définir un ensemble restreint de valeurs possibles pour un type.

Exposez vos Enums avec API-Platform. Ils sont un moyen de définir un ensemble restreint de valeurs possibles pour un type.

Exposez vos Enums avec API-Platform

Exposez vos Enums avec API Platform | Les-Tilleuls.coop

https://secure.gravatar.com/avatar/b473bd9d058c922e08d57f39a4a861db?s=96&d=mm&r=g

Grégoire Hébert

Après <a href="https://twitter.com/dunglas/status/1463784075961978883" target="_blank" rel="noreferrer noopener">un premier volet effectué avec succès</a> l&#8217;année dernière et deux conférences sur le sujet données <a href="https://www.youtube.com/watch?v=coEdCX6sm_Q" target="_blank" rel="noreferrer noopener">en 2021</a> et <a href="https://www.youtube.com/watch?v=SSQal3Msi9g&amp;list=PL3hoUDjLa7eQfYOEmuQNG8he3AeOeWaz8&amp;index=20" target="_blank" rel="noreferrer noopener">cet automne</a>, nos coopérateurs <a href="https://twitter.com/chalas_r" target="_blank" rel="noreferrer noopener">Robin Chalas</a> et <a href="https://twitter.com/matarld" target="_blank" rel="noreferrer noopener">Mathias Arlaud</a> donnent à nouveau rendez-vous à notre communauté le premier décembre prochain à Lyon pour un workshop sur le Domain-Driven Design. <a href="https://les-tilleuls.coop/masterclass/workshops/domain-driven-design-avec-api-platform-3/2022-12-01" target="_blank" rel="noreferrer noopener">Nous sommes à 3 semaines de l&#8217;événement</a> et il nous reste encore quelques places disponibles.



<figure class="wp-block-image size-medium"><a href="https://les-tilleuls.coop/masterclass/workshops/domain-driven-design-avec-api-platform-3/2022-12-01"><img decoding="async" loading="lazy" width="600" height="300" src="https://api.les-tilleuls.coop/wp-content/uploads/2022/11/workshop-DDD-600x300.png" alt="" class="wp-image-5926" srcset="https://api.les-tilleuls.coop/wp-content/uploads/2022/11/workshop-DDD-600x300.png 600w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/workshop-DDD-1024x512.png 1024w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/workshop-DDD-300x150.png 300w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/workshop-DDD-768x384.png 768w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/workshop-DDD-1536x768.png 1536w, https://api.les-tilleuls.coop/wp-content/uploads/2022/11/workshop-DDD-2048x1024.png 2048w" sizes="(max-width: 600px) 100vw, 600px" /></a><figcaption><a href="https://les-tilleuls.coop/masterclass/workshops/domain-driven-design-avec-api-platform-3/2022-12-01">https://les-tilleuls.coop/masterclass/workshops/domain-driven-design-avec-api-platform-3/2022-12-01</a></figcaption></figure>



<a href="https://les-tilleuls.coop/masterclass/workshops/domain-driven-design-avec-api-platform-3/2022-12-01" target="_blank" rel="noreferrer noopener">Le temps d&#8217;une journée</a>, vous aurez l&#8217;opportunité d&#8217;être accompagné·e par nos formateurs dans la maîtrise de concepts d’architecture avancée, de comprendre les enjeux du découplage ou encore améliorer votre sensibilité à la programmation orientée objet. Vous également serez sensibilisé·e·s au Domain-Driven Design en adéquation avec <a href="https://les-tilleuls.coop/technologies/api-platform" target="_blank" rel="noreferrer noopener">le framework API Platform</a>, la référence pour le développement de solutions complexes, robustes et maintenables et laissant une liberté de gestion de la couche métier (notamment en DDD).



<a href="https://les-tilleuls.coop/masterclass/workshops/domain-driven-design-avec-api-platform-3/2022-12-01" target="_blank" rel="noreferrer noopener">Cette journée</a>, au tarif de 500€ HT, est éligible à de multiples financements et le nombre de places, pour garder une qualité de formation optimale, est très limité. <a href="mailto:contact@les-tilleuls.coop" target="_blank" rel="noreferrer noopener">Contactez-nous dès à présent</a> pour valider votre inscription. Notre coopérative est <a href="https://les-tilleuls.coop/blog/les-formations-de-les-tilleuls-coop-certifiees-qualiopi" target="_blank" rel="noreferrer noopener">référencée comme organisme de formation Qualiopi</a> : nous pouvons vous accompagner dans la construction et le financement de votre dossier.



L&#8217;année 2022 se termine doucement mais restez à l&#8217;écoute, d&#8217;autres workshops (centrés sur le <a href="https://les-tilleuls.coop/masterclass/workshops/domain-driven-design-avec-api-platform-3/2022-12-01" target="_blank" rel="noreferrer noopener">DDD</a> ou sur d&#8217;autres technologies que nous maintenons ou maîtrisons) seront très prochainement annoncés sur nos réseaux sociaux. Profitez de ce billet pour vous abonner à <a href="https://mastodon.online/@cooptilleuls" target="_blank" rel="noreferrer noopener">notre Mastodon</a> que nous utilisons depuis 2 ans maintenant !

Workshop : formez-vous aux bonnes pratiques du DDD avec Robin Chalas et Mathias Arlaud

Rendez-vous le jeudi 1er décembre pour un workshop axé sur le Domain-driven Design, animé par Robin Chalas et Mathias Arlaud.

Workshop : formez-vous aux bonnes pratiques du DDD avec Robin Chalas et Mathias Arlaud | Les-Tilleuls.coop %

Une premi&egrave;re &eacute;dition prometteuse


Des retours d&rsquo;exp&eacute;riences et de la mont&eacute;e en comp&eacute;tences


Il y a quelques jours, une partie de notre équipe a traversé l’Europe pour se rendre à Łódź, en Pologne, afin d’assister à la première édition de la <a href="https://sylius.com/conference/" target="_blank" rel="noreferrer noopener nofollow">SyliusCon</a>, l’événement dédié au framework e-commerce <a href="https://les-tilleuls.coop/technologies/sylius" target="_blank" rel="noreferrer noopener nofollow">Sylius</a>. Plus de 250 personnes venant de toute l’Europe et aux métiers variés liés au e-commerce (développeuses et développeurs, product ou marketing managers, représentant·e·s d’agences…) étaient présentes. Au programme de cette journée : de l’apprentissage, des cas d&#8217;usage variés et un regard tourné vers le futur.



<h2>Des retours d’expériences et de la montée en compétences</h2>



La conférence était divisée en deux tracks : une consacrée aux talks business et une axée sur le développement web autour de l’écosystème Sylius. Parmi les conférences que nous retiendrons, nous notons la keynote d’ouverture de <a href="https://twitter.com/lukaszchrusciel" target="_blank" rel="noreferrer noopener">Łukasz Chruściel</a> qui a partagé sa vision de Sylius 2.0 et présenté la roadmap du projet pour les deux prochaines années. 



<center><blockquote class="twitter-tweet">? <a href="https://twitter.com/hashtag/SyliusCon?src=hash&amp;ref_src=twsrc%5Etfw">#SyliusCon</a> has just started! More than 200 people are listening to <a href="https://twitter.com/lukaszchrusciel?ref_src=twsrc%5Etfw">@lukaszchrusciel</a>’s opening keynote <a href="https://twitter.com/hashtag/Sylius?src=hash&amp;ref_src=twsrc%5Etfw">#Sylius</a> <a href="https://t.co/gYLmIYRTvx">pic.twitter.com/gYLmIYRTvx</a>— Les-Tilleuls.coop (@coopTilleuls) <a href="https://twitter.com/coopTilleuls/status/1585549445126553601?ref_src=twsrc%5Etfw">October 27, 2022</a></blockquote> <script async="" src="https://platform.twitter.com/widgets.js" charset="utf-8"></script></center>



<a href="https://twitter.com/Sylius/status/1585624110524243968" target="_blank" rel="noreferrer noopener">Alfons Martin</a> a illustré dans sa conférence l’utilisation de Sylius dans le cadre d’une marketplace multi-vendeurs à grande échelle dans le domaine de l’agriculture. Il a notamment évoqué la gestion de multi-tarifs complexes avec l’utilisation des channels ou encore l’architecture nécessaire à ce projet à grande échelle : <a href="https://les-tilleuls.coop/technologies/symfony" target="_blank" rel="noreferrer noopener">Symfony</a>, API Platform, Kafka.



Nous avons aussi Kévin Dunglas qui nous a tout dévoilé sur la spécification <a href="https://json-ld.org/" target="_blank" rel="noreferrer noopener">JSON-LD</a> et son impact sur vos ventes e-commerce. Il nous rappelle que les fonctionnalités du standard sont implémentées nativement dans <a href="http://api-platform.com" target="_blank" rel="noreferrer noopener">API Platform</a>. Sylius utilise API Platform, et bénéficie aussi de ces fonctionnalités. Kévin nous a montré alors comment les utiliser et a présenté une intégration d’un <a href="https://schema.org/Product" target="_blank" rel="noreferrer noopener">schéma de produit</a> sur un site e-commerce propulsé avec Sylius.



<center><blockquote class="twitter-tweet">Full house for our cooperator <a href="https://twitter.com/dunglas?ref_src=twsrc%5Etfw">@dunglas</a> at the <a href="https://twitter.com/hashtag/SyliusCon?src=hash&amp;ref_src=twsrc%5Etfw">#SyliusCon</a> ? <a href="https://t.co/F4crTZhBhA">pic.twitter.com/F4crTZhBhA</a>— Les-Tilleuls.coop (@coopTilleuls) <a href="https://twitter.com/coopTilleuls/status/1585569979222691840?ref_src=twsrc%5Etfw">October 27, 2022</a></blockquote> <script async="" src="https://platform.twitter.com/widgets.js" charset="utf-8"></script></center>



L’intervention d’Andreas Braun, mainteneur de l’<a href="https://www.mongodb.com/docs/drivers/php/" target="_blank" rel="noreferrer noopener">extension PHP pour MongoDB</a>, appliquait les concepts de la base de données orientée Documents à un projet Sylius. Il nous a présenté une implémentation de taxonomies qu’il compare avec un design sur une base de données relationnelle. Nous comprenons ainsi l’apport de ce type de bases de données et en quoi cette approche est plus naturelle pour certains cas d’usages.&nbsp;



<a href="https://twitter.com/StephaneDecock" target="_blank" rel="noreferrer noopener">Stéphane Decock</a> et Luka Smolcic nous ont dévoilé Sylify, la nouvelle UI de l’espace d’administration de Sylius. Il nous ont présenté les raisons du choix de passer de SemanticUI à Bootstrap, le déroulement de la refonte du design des composants, l’amélioration globale de l’UX de Sylius.



<h2>Une première édition prometteuse</h2>



Chez Les-Tilleuls.coop, nous sommes ravi·e·s d’avoir assisté au lancement de cette conférence qui s’est merveilleusement déroulée. Timing parfait, échanges intéressants avec les exposants et visiteurs, buffet qui a régalé nos papilles, apéro communautaire convivial au cœur de la rue Piotrkowska… Cette convention avait tout d’une conférence organisée par des professionnels de l’événementiel.



<center><blockquote class="twitter-tweet">We’re glad to support <a href="https://twitter.com/hashtag/SyliusCon?src=hash&amp;ref_src=twsrc%5Etfw">#SyliusCon</a> and meet <a href="https://twitter.com/Sylius?ref_src=twsrc%5Etfw">@Sylius</a>’ friendly community in Łódź! See you tonight at the afterparty ?? <a href="https://t.co/JJ3Xn8e2Bu">pic.twitter.com/JJ3Xn8e2Bu</a>— Les-Tilleuls.coop (@coopTilleuls) <a href="https://twitter.com/coopTilleuls/status/1585639811221983232?ref_src=twsrc%5Etfw">October 27, 2022</a></blockquote> <script async="" src="https://platform.twitter.com/widgets.js" charset="utf-8"></script></center>



Nous sommes contentes et contents d’avoir enfin rencontré une partie de leur équipe avec laquelle nous échangeons depuis de nombreuses années et le moins qu’on puisse dire, c’est que nos amis polonais ont <a href="https://twitter.com/coopTilleuls/status/1585703651821162504/photo/1" target="_blank" rel="noreferrer noopener">le sens de l’accueil</a> 😉 Nous reviendrons avec plaisir l’année prochaine et espérons que notre collaboration avec Sylius prendra encore de nouvelles envergures dans les mois et années à venir.

SyliusCon 2022: on y était !

Retrouvez le compte rendu de notre participation à la SyliusCon, l'événement propulsé par la société et le framework e-commerce Sylius.

SyliusCon 2022: on y était ! | Les-Tilleuls.coop

&lt;?php

class LivingThing{}

class Animal extends LivingThing {}

class Cat extends Animal 
{
    public function __construct(
        public string $name,
        public bool $needToBeBrushed = true,
        public bool $needClawsCutting = true,
        public bool $needToBeFed = true
    ){}
}

interface AnimalShelter
{
    public function adopt(string $name): Animal;
}

class CatShelter implements AnimalShelter
{
    public function adopt(string $name): Cat
    {
        return new Cat($name);
    }
}

class BetterCatShelter implements AnimalShelter
{
    // On donne l'instance décorée
    public function __construct(private AnimalShelter $decorated)
    {}
     
    public function adopt(string $name): Cat
    {
        // On utilise le comportement initial de l'instance décorée
        $cat = $this->decorated->adopt($name);
        
        // Ainsi qu'un comportement supplémentaire
        $this->groom($cat);
        
        return $cat;
    }
     
    private function groom(Cat $cat)
    {
        $cat->needToBeBrushed = false;
        $cat->needClawsCutting = false;
        $cat->needToBeFed = false;
    }
}

class Me
{
    private Cat $cat;
     
    // Puis que le décorateur possède la même interface,
    // je n'ai rien à changer dans cette classe pour utiliser l'un ou l'autre
    public function getACatFromShelter(AnimalShelter $shelter, string $catName)
    {
        $this->cat = $shelter->adopt($catName);
    }
     
    public function checkCatStatus(): string
    {
        if (!$this->cat->needToBeBrushed &amp;&amp; !$this->cat->needClawsCutting &amp;&amp; !$this->cat->needToBeFed) {
            return "Tout va bien pour {$this->cat->name}.";
        }
        
        return "Oula... {$this->cat->name} a besoin d'attention !";
    }
}

$me = new Me;
$catShelter = new CatShelter;

$me->getACatFromShelter($catShelter, 'Cripper');
echo $me->checkCatStatus(). PHP_EOL;

$betterCatShelter = new BetterCatShelter($catShelter);
$me->getACatFromShelter($betterCatShelter, 'Jinjer');

echo $me->checkCatStatus(). PHP_EOL;


Application du pattern avec les services de Symfony


&lt;?php

// src/Mailer/LoggingMailer.php
namespace App\Mailer;

// ...
use Symfony\Component\DependencyInjection\Attribute\AsDecorator;

#[AsDecorator(decorates: Mailer::class)]
class LoggingMailer<meta charset="utf-8"> implements MailerInterface
{
	// ...
}

&lt;?php

// ...

#[AsDecorator(
	decorates: Mailer::class,
	priority: 10,
	onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE,
)]
class LoggingMailer implements MailerInterface
{
	// ...
}

&lt;?php
 
// ...
use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
use Symfony\Component\DependencyInjection\Attribute\MapDecorated;

#[AsDecorator(decorates: Mailer::class)]
class LoggingMailer implements MailerInterface
{
	public function __construct(#[MapDecorated] <meta charset="utf-8">MailerInterface $originalMailer)
	{
 	// ...
	}

	// ...
}

Inconv&eacute;nients de l'h&eacute;ritage


&lt;?php

class BoiteDeTucs 
{
    private array $authorizedFlavours = ['bacon', 'fromage', 'crème oignon', 'ail et fines herbes'];
    protected array $tucs = [];
    
    public function obtenirUnTuc()
    {
        if (empty($this->tucs)) {
            throw new RuntimeException('boite vide !');
        }
        
        return array_shift($this->tucs);
    }
    
    public function insererDesTucs(array $tucs) 
    {
        if (!empty($this->tucs)) {
            throw new RuntimeException('On fini la boite avant !');
        }
        
        $this->tucs = array_filter($tucs, fn ($tuc) => in_array($tuc, $this->authorizedFlavours));
    }
}


$boiteDeTucs = new BoiteDeTucs;
$boiteDeTucs->insererDesTucs(['bacon', 'barbecue', 'fromage', 'crème oignon']);

echo $boiteDeTucs->obtenirUnTuc().PHP_EOL; // bacon
echo $boiteDeTucs->obtenirUnTuc().PHP_EOL; // fromage, ouf pas de barbecue.


&lt;?php

class BoiteDeTucs 
{
    protected array $authorizedFlavours = ['bacon', 'fromage', 'crème oignon', 'ail et fines herbes'];
    protected array $tucs = [];
    
    public function obtenirUnTuc()
    {
        if (empty($this->tucs)) {
            throw new RuntimeException('boite vide !');
        }
        
        return array_shift($this->tucs);
    }
    
    public function insererdesTucs(array $tucs) 
    {
        if (!empty($this->tucs)) {
            throw new RuntimeException('On fini la boite avant !');
        }
        
        $this->tucs = array_filter($tucs, fn ($tuc) => in_array($tuc, $this->authorizedFlavours));
    }
}

class BoiteDeTucsTriFromage extends BoiteDeTucs
{
    public function obtenirUnTuc()
    {
        while ('fromage' === $tuc = parent::obtenirUnTuc()){
            $this->tucs[] = $tuc;
        }
        
        return $tuc;
    }
}


$boiteDeTucs = new BoiteDeTucsTriFromage;
$boiteDeTucs->insererdesTucs(['fromage', 'bacon', 'barbecue', 'crème oignon']);

echo $boiteDeTucs->obtenirUnTuc().PHP_EOL; // bacon
echo $boiteDeTucs->obtenirUnTuc().PHP_EOL; // crème oignon… Ouf, ni fromage ni barbecue


Pourquoi pr&eacute;f&eacute;rer la composition &agrave; l'h&eacute;ritage


Description du Liskov Substitution Principle


&lt;?php

interface LivingThingInterface {}
interface AnimalInterface extends LivingThingInterface {}

interface DogInterface extends AnimalInterface {}
interface PlantInterface extends LivingThingInterface {}


class Dog implements DogInterface {}

class Plant implements PlantInterface {}

class Pet
{
	public function __construct(AnimalInterface $animal) {}
}

class PetDog extends Pet
{
 	// Fonctionne
	public function __construct(DogInterface $dog)
	{
 		parent::__construct($dog);
	}
}

class PlantPet extends Pet
{
 	// Ne fonctionne pas
	public function __construct(PlantInterface $plant)
	{
 		parent::__construct($plant);
	}
}

&lt;?php

class LivingThing{}

class Plant extends LivingThing {}
class Animal extends LivingThing {}

class Cat extends Animal {}

interface AnimalShelter
{
	public function adopt(string $name): Animal;
}

class CatShelter implements AnimalShelter
{
 	// Fonctionne
	public function adopt(string $name): Cat
	{
 		return new Cat($name);
	}
}

class PlantShelter implements AnimalShelter
{
 	// Ne fonctionne pas
	public function adopt(string $name): Plant
	{
 		return new Plant($name);
	}
}


Note d&#8217;avant lecture : si des termes vous sont inconnus, mettez votre lecture en pause et allez vérifier leur signification avant de reprendre !



Dans <a href="https://api-platform.com/" target="_blank" rel="noreferrer noopener">API Platform</a>, mais aussi dans <a href="https://les-tilleuls.coop/technologies/symfony" target="_blank" rel="noreferrer noopener">Symfony</a> — et dans énormément de logiciels —, il est souvent recommandé de &#8220;décorer&#8221; pour étendre du code tiers. Dans API Platform, on nous propose de décorer les providers, les processors, les listeners, les resolvers, les factories… Pour un·e dev expérimenté·e, c&#8217;est trivial. Mais si vous découvrez le terme, ce n&#8217;est pas si évident.



Avant d&#8217;aborder le pattern, il faut comprendre la raison de son existence. Pour cela, il faut définir la différence (en POO) entre la composition et l&#8217;héritage.



<h2>Héritage</h2>



L&#8217;héritage est l&#8217;un des quatre concepts majeurs associés à la programmation orientée objet. Cela comprend l&#8217;abstraction, l&#8217;encapsulation, l&#8217;héritage et le polymorphisme. L&#8217;héritage nous permet d&#8217;acquérir des propriétés et des méthodes de la classe de base dans la classe dérivée (ou enfant). Les classes dérivées ont généralement une relation (logique) avec la classe de base.



<h3>Avantages de l&#8217;héritage&nbsp;</h3>



<ul><li>L&#8217;héritage permet la réutilisation du code, d&#8217;hériter facilement des fonctionnalités de la classe mère sans copier le code. </li><li>Elle fournit une structure hiérarchique claire qui nous permet de décomposer un modèle en une structure simple et facile à digérer.</li></ul>



<h3>Inconvénients de l&#8217;héritage</h3>



<ul><li>Les fonctions héritées sont plus lentes que les fonctions normales (sans parler de langage de programmation spécifiquement). </li><li>Toutes les variables ainsi que les méthodes de la classe de base sont héritées même si elles ne sont pas utilisées, cela provoque un surplus inutile. </li><li>De petits changements peuvent affecter toutes les classes dérivées de manière inattendue en raison du couplage étroit. </li><li>L&#8217;héritage a une structure définie au moment de la compilation : nous ne pouvons pas modifier quoi que ce soit dans les classes supérieures au moment de la &#8220;distribution&#8221; des méthodes et propriétés publiques ou protégées aux classes dérivées. Les détails de la classe mère sont exposés à la classe fille et cela brise le concept fondamental d&#8217;encapsulation (à savoir &#8220;cacher&#8221;, &#8220;garder privées&#8221; des propriétés et méthodes, pour maîtriser leurs contenus et leurs actions).</li></ul>



<meta charset="utf-8">Pour faire une analogie, si je pose des Tucs sur la table pour chacun·e avec 1 Tuc par personne. Sans surveillance, après le passage de 2 ou 3 gourmand·e·s, il n&#8217;y en a plus pour les autres. Alors je dépose les Tucs dans un distributeur (ce serait une classe) qui se charge de vérifier qu&#8217;un seul soit distribué à chacun. Personne ne peut en prendre directement. J&#8217;ajoute un accesseur `<code>obtenirUnTuc</code>`. Une fois vide cependant, je ne peux plus renouveler le stock. Alors je rajoute aussi un mutateur `<code><meta charset="utf-8">insererDesTucs</code>`.



Est-ce suffisant ? Non ! Je viens de laisser la possibilité d&#8217;ajouter des Tucs barbecue ! Tragédie, ils ne sont pas bons ! Alors mon mutateur sera aussi responsable de contrôler la qualité des Tucs insérés.





Nous avons correctement protégé l&#8217;accès et l&#8217;ajout des Tucs ! 



Si une implémentation d&#8217;une classe est parfaite d&#8217;un point de vue encapsulation, et si des changements sont appliqués sur cette classe, aucun changement ne sera nécessaire dans les classes qui en héritent. Seulement dans les faits, dès lors que je vais étendre la boite de Tucs, ma nouvelle classe aura connaissance de toutes les propriétés et méthodes publiques comme protégées.



Disons que je n&#8217;ai pas envie des Tucs au fromage aujourd&#8217;hui et que je souhaite faire le tri :





Imaginons que la marque distributrice de ces biscuits décide de remplacer la gamme fromage par 3 variations : beaufort, comté et chèvre. Lorsque je vais mettre à jour ma `<code>BoiteDeTucs</code>`, je vais être obligé de modifier ma `<meta charset="utf-8"><code>BoiteDeTucsTriFromage</code>` : l&#8217;héritage a rompu le contrat d&#8217;encapsulation.



<h2>Composition</h2>



Dans la composition, l&#8217;une des classes possède une ou plusieurs instances d&#8217;autres classes souvent obtenues en les passant au constructeur.



<h3>Avantages de la composition</h3>



<ul><li>Les dépendances sont moindres par rapport à l&#8217;héritage, l&#8217;idée étant de surtout s&#8217;appuyer sur des arguments typés à l&#8217;aides d&#8217;interfaces pour être le plus versatile et résilient possible dans le futur. </li><li>Les objets sont définis au moment de l&#8217;exécution, ils n&#8217;ont pas la possibilité d&#8217;accéder aux données protégées d&#8217;un autre objet : cela permet de maintenir l&#8217;encapsulation.</li></ul>



<h3>Inconvénients de la composition</h3>



<ul><li>Elle nécessite plus de temps et produit un code plus verbeux.</li><li>Le système est dépendant de l&#8217;interrelation entre les objets.</li><li>Un bon découpage pour conserver en souplesse tout en assurant l&#8217;évolutivité du code sans avoir à faire de profonde restructuration est difficile : il faut passer un peu de temps en amont à étudier les possibilités de structures, de design pattern, pour faire le choix optimal.</li></ul>



<h2>Pourquoi préférer la composition à l&#8217;héritage</h2>



La composition est un concept de programmation orientée objet qui stipule que les classes doivent avoir un comportement <a href="https://fr.wikipedia.org/wiki/Polymorphisme_(informatique)" target="_blank" rel="noreferrer noopener">polymorphe</a> (on parle surtout ici de surcharge de méthode, ce qui n&#8217;est pas possible en PHP par exemple). Cela rend le tout plus flexible, plus facile à maintenir malgré un code plus important au départ. C&#8217;est à cela que l&#8217;on doit le dicton “<a href="https://en.wikipedia.org/wiki/Composition_over_inheritance" target="_blank" rel="noreferrer noopener">Favoriser la composition d&#8217;objets plutôt que l&#8217;héritage de classes</a>”.



L&#8217;héritage est un outil puissant. S&#8217;il est bien utilisé, il peut rendre votre code compact, facile à lire et rapide à développer mais il existe de nombreux pièges dans lesquels une personne peut facilement tomber. Des changements minimes peuvent avoir des conséquences désastreuses comme vu plus haut. C&#8217;est pour cela qu&#8217;en règle générale, on opte plutôt pour la composition.



<h2>Quand hériter ou non ?</h2>



Voyons ensemble quelques règles de typage en POO et les limites qu&#8217;elles imposent. Avec celles-ci en tête, vous serez capable de déceler les situations dans lesquelles hériter n&#8217;est pas une bonne solution.



Connaissez-vous Barbara Liskov ? Elle a produit une publication nommée “A behavioral notion of subtyping” où elle formalise le Liskov Substitution Principle, un des principes <a href="https://fr.wikipedia.org/wiki/SOLID_(informatique)" target="_blank" rel="noreferrer noopener">SOLID</a>. Je vous encourage à étudier ces principes (ainsi que <a href="https://fr.wikipedia.org/wiki/Loi_de_D%C3%A9m%C3%A9ter" target="_blank" rel="noreferrer noopener">la loi de Déméter</a>).



<h3>Description du Liskov Substitution Principle</h3>



Si S est un sous-type de T, alors les objets de type T dans un programme peuvent être remplacés par des objets de type S sans altérer aucune des propriétés de ce programme.



Le principe de substitution de Liskov impose certaines exigences sur les signatures de méthodes dans les langages de POO. Parmi elles, deux notions que nous allons détailler :



<ul><li>Le respect de la contravariance des types de paramètres de méthode dans le sous-type.</li><li>Le respect de la covariance des types de retour des méthodes dans le sous-type.</li></ul>



<h3>Covariance et Contravariance</h3>



De nombreux langages de programmation prennent en charge le sous-typage. Par exemple, si le type Chat est un sous-type de Animal, un élément de type Chat devrait être accepté partout où un élément de type Animal est utilisé.



La variance fait référence à la manière dont le sous-typage entre des types plus complexes est lié au sous-typage entre leurs composants. Par exemple, comment une liste de chats doit-elle s&#8217;identifier comme une liste d&#8217;animaux ? Ou comment une fonction qui renvoie un chat doit-elle s&#8217;identifier à une fonction qui renvoie un animal ? Ces phrases sont complexes, et rien ne vaut un exemple par la pratique pour s&#8217;approprier la règle.



<h4>Exemple de contravariance en PHP</h4>





<code>DogInterface</code> hérite de <code>AnimalInterface</code>, l&#8217;héritage tolère ce changement de type, c&#8217;est la contravariance. S sous type de T -&gt; S étant DogInterface et T étant AnimalInterface.



<code>PlantInterface</code> hérite de <code>LivingThingInterface</code>, tout comme <code>Animal</code>. Cependant <code>PlantInterface</code> n&#8217;est pas un sous type de <code>AnimalInterface</code>, c&#8217;est un sous type de <code>LivingThingInterface</code>.



Considérons-le comme un cousin. L&#8217;héritage refusera ce changement de type.



<h3>Un exemple de covariance en PHP</h3>





<code>Cat</code> hérite de <code>Animal</code>, l&#8217;héritage tolère ce changement de type, c&#8217;est la contravariance. S sous type de T -&gt; S étant Cat et T étant Animal.



<code>Plant</code> hérite de <code>LivingThingInterface</code>, tout comme <code>Animal</code>. Cependant <code>Plant</code> n&#8217;est pas un sous type de <code>Animal</code>. C&#8217;est un sous type de <code>LivingThing</code>.



Considérons-le comme un cousin. L&#8217;héritage refusera ce changement de type. On remarquera que par l&#8217;évidence des noms utilisés, il semble étrange d&#8217;avoir classé <code>Plant</code> sous <code>Animal</code>, mais ce n&#8217;est pas toujours aussi flagrant. Une meilleure structure aurait été de tout faire découler de LivingThing.



Aussi, de nouvelles exceptions ne devraient pas être lancées par les méthodes du sous-type, sauf si elles sont des sous-types d&#8217;exceptions lancées par les méthodes du super-type. Vous commencez à voir les limites de l&#8217;héritage !



Il y a un moment où dans nos structures, ces relations entrent en conflit avec ce que l&#8217;on souhaite accomplir. Alors, plutôt que d&#8217;hériter pour ajouter des comportements, cela devient plus clair en créant des classes qui font juste ce qui est désiré et de les injecter aux classes qui ont besoin de ce comportement. En prime, ces classes pourront plus facilement être utilisées.



La composition prend beaucoup plus de sens, d&#8217;accord. Et la décoration dans tout ça ?



<h2>Le pattern</h2>



Admettons que nous ayons utilisé de la composition dans notre code. Parmi les principes SOLID se trouve aussi le O pour Open/Closed Principle. Ce principe dit ceci : les entités logicielles (classes, modules, fonctions, etc.) devraient être ouvertes à l&#8217;extension, mais fermées à la modification. C&#8217;est-à-dire qu&#8217;une telle entité peut permettre d&#8217;étendre son comportement sans modifier son code source.



Comment ajouter un comportement à une classe, mais sans toucher à son interface et ses signatures, sans lui ajouter de nouvelles méthodes ? C&#8217;est envisageable d&#8217;hériter et de surcharger, mais nous ne voulons pas retomber dans les limites que nous avons vues plus haut. Alors on compose. On compose en décorant !



Un décorateur est une classe. C&#8217;est une classe qui expose la ou les mêmes interfaces que la classe qu&#8217;il décore, qu&#8217;il veut étendre. Ce n&#8217;est pas suffisant bien entendu, pour compléter la décoration, il va falloir passer une instance de la classe décorée à la classe qui la décore, souvent via son constructeur. L&#8217;image la plus répandue pour visualiser l&#8217;opération est celle des poupées russes s&#8217;imbriquant les unes dans les autres. On parle aussi d&#8217;onion architecture.



<h3>Un exemple avec PHP</h3>





N&#8217;hésitez pas à jouer avec cet exemple, à le triturer pour bien appréhender la mécanique. Par exemple, amusez-vous à ajouter un <code>CollarOptionCatShelter</code> qui met un collier à son nom au chat lorsque vous payez plus cher.



Et tentez de décorer <code>CatShelter</code>, et/ou <code>BetterCatShelter</code>.



<h3>Application du pattern avec les services de Symfony</h3>



Dans Symfony toutes les classes enregistrées comme service sont décorables. Dans la version 6.1 du framework voici comment s&#8217;y prendre (traduit de la documentation : <a href="https://symfony.com/blog/new-in-symfony-6-1-service-decoration-attributes" target="_blank" rel="noreferrer noopener">https://symfony.com/blog/new-in-symfony-6-1-service-decoration-attributes</a>). Vous pouvez aussi vous référer au talk de notre coopérateur Robin : <a href="https://slides.com/chalasr/symfonybc-promise-demystifed/" target="_blank" rel="noreferrer noopener">https://slides.com/chalasr/symfonybc-promise-demystifed/</a>. 



Considérons le cas courant où vous voulez décorer un service (par exemple <code>Mailer</code>) avec un nouveau service qui lui ajoute des capacités de log (par exemple <code>LoggingMailer</code>). Voici comment vous pouvez configurer la décoration avec des attributs PHP :



Les deux classes devront implémenter une interface commune. Ici <code>MailerInterface.</code>





L&#8217;attribut `<code>#[AsDecorator]</code>` prend en charge toutes les options supplémentaires dont vous pourriez avoir besoin :





Si vous devez accéder au service décoré à l&#8217;intérieur du service décorateur, ajoutez l&#8217;attribut `<code>#[MapDecorated]</code>` à l&#8217;un des arguments du constructeur du service :





<blockquote class="wp-block-quote">Attention à ne pas décorer un service servant d&#8217;Alias dans Symfony, pour éviter de chercher pourquoi le code ne fonctionne pas. L&#8217;injection de dépendance de Symfony ne supporte pas encore la décoration d&#8217;Alias.<cite>De la part de Baptiste, Antoine, Vincent, Robin, Moi-même&#8230; (et tout ceux qui s&#8217;y sont frotté)</cite></blockquote>



J&#8217;espère que ce concept est un peu plus clair pour vous maintenant. Pour votre veille personnelle, n&#8217;hésitez pas également à consulter <a href="https://symfony.com/doc/current/service_container/service_decoration.html" target="_blank" rel="noreferrer noopener">ce billet de Symfony</a> sur les différentes façons de décorer un service. Bon code à vous !

Maîtrisez votre app avec le pattern decorator

Apprenez le pattern decorator, gagnez en maîtrise dans votre application développée avec API Platform.

Apprenez le pattern decorator et gagnez en maitrise dans votre application Symfony.

Maîtrisez votre app avec le pattern decorator | Les-Tilleuls.coop

Pourquoi nous pensons que cette mesure ne va pas stigmatiser les personnes menstru&eacute;es ?


Pourquoi mettre en place un cong&eacute; menstruel ?


Lors de notre dernière assemblée générale mensuelle, sur proposition d’une de nos coopératrices, nous avons voté la mise en place d’un congé menstruel. Ainsi, les personnes menstruées de notre coopérative peuvent maintenant bénéficier, en addition à leur quota de congés annuels, d’une journée d&#8217;absence par mois rémunérée sans avoir besoin de fournir de justificatif. Revenons dans cet article sur les tenants et aboutissants de cette initiative.



<h2>Pourquoi mettre en place un congé menstruel ?</h2>



Douleurs pelviennes, abdominales et dorsales, nausées, céphalées… Les règles peuvent provoquer chez les personnes concernées tout un panel de désagréments les empêchant de mener à bien leurs activités quotidiennes, que ces dernières soient liées à leurs loisirs comme à leur travail. Or lorsque ces désagréments surviennent, il est encore aujourd’hui très difficile d’obtenir suffisamment rapidement un rendez-vous médical en vue de bénéficier d’un arrêt de travail (sans même parler de la réticence de certains médecins).&nbsp;



Après en avoir discuté longuement en interne de manière plutôt informelle, nous nous sommes demandé chez Les-Tilleuls.coop pourquoi les personnes menstruées souffrant de <a href="https://fr.wikipedia.org/wiki/Dysm%C3%A9norrh%C3%A9e" target="_blank" rel="noreferrer noopener nofollow">dysménorrhées</a> devraient “prendre sur elles” lors de ces jours compliqués ? Avant d’aborder ce sujet en assemblée générale, nous avons contacté la Scop <a href="https://www.lacollective.coop/" rel="noreferrer noopener nofollow" target="_blank">La Collective</a> qui a mis en place un congé similaire au sein de leur entreprise depuis quelques mois, et dont le rapide retour d’expérience nous a conforté·e·s sur cette prise de décision.



Lors de l&#8217;AG suivante, une proposition a été formulée et soumise au vote : accorder chaque mois aux personnes menstruées un jour de congé (payé), librement utilisable en cas de besoin et sans devoir fournir de justificatif médical (seulement signaler notre absence aux RH et à notre client). La proposition ayant été adoptée à l’unanimité, ce nouveau “droit” devient effectif pour les personnes concernées.



<h2>Pourquoi nous pensons que cette mesure ne va pas stigmatiser les personnes menstruées ?</h2>



Depuis notre fondation, nous mettons régulièrement en place des dispositifs permettant une équité entre toutes et tous au sein de la coopérative : <a href="https://les-tilleuls.coop/blog/election-marion-age" target="_blank" rel="noreferrer noopener">co-gérance mixte</a>, <a href="https://les-tilleuls.coop/blog/grille-salariale-a-vote" target="_blank" rel="noreferrer noopener">grille de salaire et de compétences égales</a>, <a href="https://les-tilleuls.coop/la-cooperative/equipe" target="_blank" rel="noreferrer noopener">représentation mixte des postes à responsabilités</a>, mise à disposition gratuitement de protections périodiques, refus de collaborer sur des projets discriminants… Cette initiative rentre dans la continuité d’un sujet plus global : le bien-être des salariés et la féminisation des métiers du numérique.

Les-Tilleuls.coop met en place un congé menstruel

Lors de notre dernière assemblée générale, sur proposition d’une de nos coopératrices, nous avons voté la mise en place d’un congé menstruel.

Quoi de neuf chez Les-Tilleuls.coop ?