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

Accueil

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 %

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

Cécile Hamerel

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.

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

La semaine prochaine, une partie de notre équipe se rendra à Łódź, en Pologne, afin d&#8217;assister à la première édition de la <a href="https://sylius.com/conference/" target="_blank" rel="noreferrer noopener">SyliusCon</a>, le rendez-vous des passionné·e·s du framework e-commerce <a href="https://sylius.com" target="_blank" rel="noreferrer noopener">Sylius</a>. 



Cela fait maintenant une paire d&#8217;années que nous travaillons avec Sylius, que ce soit sur des projets clients <a href="https://les-tilleuls.coop/blog/etude-de-cas-rapid-flyer-com" target="_blank" rel="noreferrer noopener">comme Rapid-Flyer</a>, sur le développement de <a href="https://www.youtube.com/watch?v=88CKcwZJXmU" target="_blank" rel="noreferrer noopener">leur API</a> ou en organisant ponctuellement des rendez-vous avec nos communautés respectives (<a href="https://les-tilleuls.coop/blog/retour-sur-la-semaine-sylius-lille" target="_blank" rel="noreferrer noopener">notre premier événement avec Sylius date — déjà — de 2018 !)</a>. Un des membres de leur core-team, <a href="https://twitter.com/lukaszchrusciel" target="_blank" rel="noreferrer noopener">Łukasz Chruściel</a>, peut même se vanter de connaître notre ville de Lille comme sa poche vu le nombre de fois où nous l&#8217;avons accueilli à bras ouverts !



Cette fois-ci, nous traversons l&#8217;Europe pour découvrir la première édition de leur convention axée sur des retours d&#8217;expériences et bonnes pratiques variées autour de leur framework. Notre coopérateur <a href="https://twitter.com/dunglas" target="_blank" rel="noreferrer noopener">Kévin Dunglas</a> figure parmi les speakers de la track axée sur les talks techniques et donnera une conférence inédite sur les atouts de JSON-LD.



<center><blockquote class="twitter-tweet">The time has come to announce the second speaker at <a href="https://twitter.com/hashtag/SyliusCon?src=hash&amp;ref_src=twsrc%5Etfw">#SyliusCon</a>! ? We&#8217;re excited to introduce Kévin Dunglas, founder at <a href="https://twitter.com/coopTilleuls?ref_src=twsrc%5Etfw">@coopTilleuls</a> and creator of the <a href="https://twitter.com/ApiPlatform?ref_src=twsrc%5Etfw">@ApiPlatform</a>. ? Get your tickets now and don&#8217;t miss <a href="https://twitter.com/dunglas?ref_src=twsrc%5Etfw">@dunglas</a>&#8216; speech: <a href="https://t.co/CHWLwTTlbj">https://t.co/CHWLwTTlbj</a><a href="https://twitter.com/hashtag/Sylius?src=hash&amp;ref_src=twsrc%5Etfw">#Sylius</a> <a href="https://twitter.com/hashtag/ecommerce?src=hash&amp;ref_src=twsrc%5Etfw">#ecommerce</a> <a href="https://t.co/vy4ST04SK6">pic.twitter.com/vy4ST04SK6</a>— Sylius eCommerce (@Sylius) <a href="https://twitter.com/Sylius/status/1549013964050276353?ref_src=twsrc%5Etfw">July 18, 2022</a></blockquote> <script async="" src="https://platform.twitter.com/widgets.js" charset="utf-8"></script></center>



Enfin, nous sommes également sponsors de l&#8217;apéro communautaire prévu encore à l&#8217;heure actuelle dans un lieu tenu secret ? Si vous faites partie des personnes présentes sur place, n&#8217;hésitez pas également à passer nous dire bonjour sur notre stand ! Vous pourrez rencontrer <a href="https://twitter.com/s0yuka" target="_blank" rel="noreferrer noopener">Antoine Bluchet</a>, <a href="https://www.linkedin.com/in/camillegaquiere/" target="_blank" rel="noreferrer noopener">Camille Gaquière</a> ou <a href="https://twitter.com/cecilehamerel" target="_blank" rel="noreferrer noopener">Cécile Helary Hamerel</a> et échanger sur notre coopérative ou tout simplement sur la dernière version d&#8217;API Platform sortie il y a quelques semaines.



<center><blockquote class="twitter-tweet">Let off some of the conference steam and join us for the Afterparty powered by <a href="https://twitter.com/coopTilleuls?ref_src=twsrc%5Etfw">@coopTilleuls</a>! Put on your dancing shoes and take part in the largest Sylius community gathering. ? 20:00h, 27 October 2022, details TBC! ? <a href="https://t.co/CHWLwTTlbj">https://t.co/CHWLwTTlbj</a><a href="https://twitter.com/hashtag/Sylius?src=hash&amp;ref_src=twsrc%5Etfw">#Sylius</a> <a href="https://twitter.com/hashtag/SyliusCon?src=hash&amp;ref_src=twsrc%5Etfw">#SyliusCon</a> <a href="https://twitter.com/hashtag/ITconference?src=hash&amp;ref_src=twsrc%5Etfw">#ITconference</a> <a href="https://t.co/WjTnlEwVFV">pic.twitter.com/WjTnlEwVFV</a>— Sylius eCommerce (@Sylius) <a href="https://twitter.com/Sylius/status/1577603934042165251?ref_src=twsrc%5Etfw">October 5, 2022</a></blockquote> <script async="" src="https://platform.twitter.com/widgets.js" charset="utf-8"></script></center>



Nous sommes heureuses et heureux de soutenir le projet <a href="https://sylius.com" target="_blank" rel="noreferrer noopener">Sylius</a>, que ce soit en contribuant directement à leur projet ou en soutenant des initiatives telles que cet événement. Le framework est progressivement en train d&#8217;être l&#8217;une des solutions leader du e-commerce en Europe et quelque chose nous dit que nous n&#8217;avons pas fini d&#8217;entendre parler de cet outil open source.



Et vous, vous faîtes le déplacement jusque Łódź ?

Les-Tilleuls.coop speaker et sponsor de la SyliusCon

Nous sommes ravis de sponsoriser la première édition de la SyliusCon qui se tiendra à Łódź, en Pologne le 27 octobre prochain.

Les-Tilleuls.coop speaker et sponsor de la SyliusCon | Les-Tilleuls.coop

Après les avoir partagées en avant-première aux personnes qui étaient présentes à l&#8217;événement, nous avons la joie de vous annoncer la disponibilité des conférences données à l&#8217;API Platform Con 2022 sur <a href="https://www.youtube.com/playlist?list=PL3hoUDjLa7eQfYOEmuQNG8he3AeOeWaz8" target="_blank" rel="noreferrer noopener">notre chaîne YouTube</a> !



Release en direct d&#8217;<a href="https://github.com/api-platform/api-platform" target="_blank" rel="noreferrer noopener">API Platform 3</a>, cas d&#8217;usage du protocole <a href="https://mercure.rocks/" target="_blank" rel="noreferrer noopener">Mercure</a>, Domain-driven design appliqué notre framework préféré ou encore découverte des nouvelles fonctionnalités de Caddy&#8230; Partez à la découverte de 25 conférences variées avec des speakers de haute volée. 



<h2>Conférences anglophones</h2>



<ul><li><a href="https://youtu.be/cWIu3tahbbs" target="_blank" rel="noreferrer noopener">API Platform 3</a> par Kévin Dunglas </li><li><a href="https://youtu.be/SSQal3Msi9g" target="_blank" rel="noreferrer noopener">Domain-driven design with API Platform 3</a> par Robin Chalas et Mathias Arlaud </li><li><a href="https://youtu.be/88CKcwZJXmU" target="_blank" rel="noreferrer noopener">Dilemmas and decisions. What we’ve learned designing the new Sylius API </a>par Łukasz Chruściel </li><li><a href="https://youtu.be/HeokavFSB2A" target="_blank" rel="noreferrer noopener">Building schema-first event-driven architectures with AsyncAPI</a> par Fran Méndez </li><li><a href="https://youtu.be/7MMzkJQ2N_s" target="_blank" rel="noreferrer noopener">Decentralization, query APIs, and other myths</a> par Ruben Verborgh </li><li><a href="https://youtu.be/HrWl0zd0Ds8" target="_blank" rel="noreferrer noopener">4 years later: The &#8220;Components Web App&#8221; (CWA)</a> par Daniel West </li><li><a href="https://youtu.be/NDeiLevUteY" target="_blank" rel="noreferrer noopener">Fighting impostor syndrome: a practical handbook</a> par Marine Gandy </li><li><a href="https://youtu.be/8cSvLVZQJks" target="_blank" rel="noreferrer noopener">Q&amp;A Session with the API Platform Core Team</a></li><li><a href="https://les-tilleuls.us5.list-manage.com/track/click?u=b3b265cbc24961a53a749b3bd&amp;id=1cb394974f&amp;e=3f92d61c0c" rel="noreferrer noopener" target="_blank">A</a><a href="https://youtu.be/YGiCEy__vrs" target="_blank" rel="noreferrer noopener"> deeper look into API Platform 3</a> par Antoine Bluchet </li><li><a href="https://youtu.be/QSerOHpMjgY" target="_blank" rel="noreferrer noopener">What&#8217;s New in Caddy, the webserver of API Platform</a> par Francis Lavoie </li><li><a href="https://youtu.be/UCz0lZ_PJ2g" target="_blank" rel="noreferrer noopener">Realtime and beyond with Mercure </a>par Brian Mc Cluskey </li><li><a href="https://youtu.be/t6J9TbjSukc" target="_blank" rel="noreferrer noopener">PHP WebSockets, or how to communicate with clients in real-time</a> par Pauline Vos </li><li><a href="https://youtu.be/9Fvt3QzMI34" target="_blank" rel="noreferrer noopener">Finding the path to scaling API success</a> par Darrel Miller </li><li><a href="https://youtu.be/tDjR5l4QwTY" target="_blank" rel="noreferrer noopener">How do we decide to create a Symfony component?</a> par Nicolas Grekas</li></ul>



<h2>Conférences francophones</h2>



<ul><li><a href="https://youtu.be/3QdSR1V-7F4" target="_blank" rel="noreferrer noopener">Gérer les opérations séquentielles avec REST</a> par Grégoire Hébert&nbsp;</li><li><a href="https://youtu.be/TOn_3mSA9TI" target="_blank" rel="noreferrer noopener">Comment Alice&#8217;s Garden gère t-elle son code métier via les événements</a> par Nicolas Lemahieu</li><li><a href="https://youtu.be/jmpAa7ghELY" target="_blank" rel="noreferrer noopener">API Platform au quotidien dans une entreprise e-commerce et logistique</a> par Kévin Verschaeve et Clément Sanchez&nbsp;</li><li><a href="https://youtu.be/4hSOltkbMWE" target="_blank" rel="noreferrer noopener">Réutiliser et partager vos opérations personnalisées avec API Platform</a> par Hubert Lenoir et Jérémy Jarrié</li><li><a href="https://youtu.be/K0evmhvYf6w" target="_blank" rel="noreferrer noopener">La revue de code est un Art !</a> par Smaïne Milianni&nbsp;</li><li><a href="https://youtu.be/Ck0NXIM7QyI" target="_blank" rel="noreferrer noopener">Mon combat contre l&#8217;arachnophobie</a> par Jérôme Tanghe</li><li><a href="https://youtu.be/pYrpHFzdvAE" target="_blank" rel="noreferrer noopener">Pourquoi je n’utilise pas API Platform</a> par Frédéric Bouchery&nbsp;</li><li><a href="https://youtu.be/Y2_0omg1CFk" target="_blank" rel="noreferrer noopener">WebAuthn : se débarrasser des mots de passe. Définitivement</a> par Florent Morselli</li><li><a href="https://youtu.be/VC7VE5C5drQ" target="_blank" rel="noreferrer noopener">Tests avancés</a> par Olivier Doucet&nbsp;</li><li><a href="https://youtu.be/4kTQ9wQWszo" target="_blank" rel="noreferrer noopener">REX: France Télévisions, quand API Platform tombe à PIC</a> par Albin Kester et Georges-King Njock-Bôt</li><li><a href="https://youtu.be/4jcDmq--3N8" target="_blank" rel="noreferrer noopener">Comment (re)mettre la tech au service du bien commun</a> par Hélène Marchois, Paul Andrieux et Kévin Dunglas</li></ul>



<h2>En route pour 2023 !</h2>



Ces conférences vous inspirent ? Nous sommes en train de préparer l&#8217;API Platform Conference 2023 qui se tiendra de nouveau à Lille en septembre, l&#8217;année prochaine. <a href="mailto:events@les-tilleuls.coop" target="_blank" rel="noreferrer noopener">Contactez-nous</a> si vous voulez en être, que ce soit en tant que speaker ou sponsor. Vous souhaitez découvrir les moments clés de notre dernière édition ? Découvrez <a href="https://api-platform.com/con/2022/review/" target="_blank" rel="noreferrer noopener">notre bilan</a> ainsi que <a href="https://flickr.com/photos/194052559@N02/albums/72177720302238684" target="_blank" rel="noreferrer noopener">les photos prises</a> par Nicolas Detrez lors de l&#8217;événement.

Les vidéos de l'API Platform Conference 2022 sont disponibles

Les vidéos de l'API Platform Conference 2022 sont désormais disponibles sur la chaîne YouTube de Les-Tilleuls.coop !

Les vidéos de l'API Platform Conference 2022 sont disponibles | Les-Tilleuls.coop

Les vidéos de l&rsquo;API Platform Conference 2022 sont disponibles

Une &eacute;dition qui a tenu toutes ses promesses


Papa et Maman nettoient l&rsquo;internet


Revue de code : on n&rsquo;est pas venu pour souffrir !


FrankenPHP, dans les entrailles de l&rsquo;interpr&eacute;teur PHP, de machines virtuelles et des threads


Piochons dans les pratiques de DDD, programmation fonctionnelle and co pour notre bien &agrave; tous


Prot&eacute;gez votre application avec l&rsquo;en-t&ecirc;te HTTP de s&eacute;curit&eacute; &ldquo;Content Security Policy&rdquo;


Ce qu'il faut retenir du Forum PHP 2022 - partie 2

Voici la suite de notre compte-rendu du Forum PHP 2022 organisé par l'AFUP en octobre 2022 à Disneyland Paris.

Ce qu'il faut retenir du Forum PHP 2022 - partie 2 | Les-Tilleuls.coop

Ce qu&rsquo;il faut retenir du Forum PHP 2022 &#8211; partie 2

The PHP Foundation: the past, the present and the future


Comment &ecirc;tre bien onboard&eacute; en tant que d&eacute;veloppeuse junior reconvertie ?

De l&rsquo;humain &agrave; l&rsquo;ordinateur, ou d&eacute;couvrir le sens d&rsquo;un texte avec Elasticsearch


Sauve un&middot;e dev, &eacute;cris une doc !


OpenTelemetry : vers un standard pour surveiller vos applications


Ce qu'il faut retenir du Forum PHP 2022 - partie 1

Voici une première partie de notre compte-rendu des conférences du Forum PHP 2022 organisé par l'association AFUP.

Ce qu'il faut retenir du Forum PHP 2022 - partie 1 | Les-Tilleuls.coop

Ce qu&rsquo;il faut retenir du Forum PHP 2022 &#8211; partie 1

Le mardi 8 novembre prochain à Lille, Julien Francoz animera une journée de workshop axée sur les fondamentaux de <a href="https://prometheus.io/" target="_blank" rel="noreferrer noopener nofollow">Prometheus</a> et <a href="https://grafana.com/" target="_blank" rel="noreferrer noopener nofollow">Grafana</a>, les outils indispensables pour monitorer des infrastructures et des applications web.



<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/10/workshop-devops-1024x512.png" alt="" class="wp-image-5671" srcset="https://api.les-tilleuls.coop/wp-content/uploads/2022/10/workshop-devops-1024x512.png 1024w, https://api.les-tilleuls.coop/wp-content/uploads/2022/10/workshop-devops-600x300.png 600w, https://api.les-tilleuls.coop/wp-content/uploads/2022/10/workshop-devops-300x150.png 300w, https://api.les-tilleuls.coop/wp-content/uploads/2022/10/workshop-devops-768x384.png 768w, https://api.les-tilleuls.coop/wp-content/uploads/2022/10/workshop-devops-1536x768.png 1536w, https://api.les-tilleuls.coop/wp-content/uploads/2022/10/workshop-devops-2048x1024.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



Prometheus s’est imposé depuis quelques années comme l’outil de supervision par excellence des environnements Cloud Native. Il s’appuie sur un large écosystème, avec notamment Grafana pour la visualisation des données collectées ou encore Alertmanager pour notifier des incidents…C’est actuellement le seul projet de niveau Graduated de la Cloud Native Computing Foundation, dans la catégorie Observabilité et Analyse.



Julien Francoz, <a href="https://les-tilleuls.coop/blog/rencontre-equipe-sre" target="_blank" rel="noreferrer noopener nofollow">Principal SRE</a> et formateur expérimenté, vous accompagnera dans la prise en main des principaux composants de Prometheus et son écosystème. Au programme : installation sur Kubernetes, collecte de métriques, langage de requêtes, configuration des alertes, dashboards Grafana&#8230; Vous aurez aussi l&#8217;opportunité d&#8217;apprendre à exposer et exploiter les métriques de votre propre application. 



Cette journée de workshop lilloise, au coût de 500€ HT, est éligible à de multiples financements. <a href="mailto:contact@les-tilleuls.coop" target="_blank" rel="noreferrer noopener">Contactez dès à présent Thomas Thorez</a>, notre référent en formations pour en savoir plus. 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 de votre dossier.



Le lancement de cet atelier animé par Julien s&#8217;inscrit dans la continuité de l&#8217;annonce récente de <a href="https://les-tilleuls.coop/cloud-et-devops" target="_blank" rel="noreferrer noopener nofollow">notre offre Cloud</a>. En effet, reconnu·e·s en tant que contributrices et contributeurs à de multiples projets open source, notre équipe est également en mesure de monitorer, sécuriser et assurer la fiabilité de vos applications. Nous partons aussi depuis quelques temps à la rencontre de cette nouvelle communauté lors de conventions et expositions consacrées à ce secteur, comme le récent salon <a href="https://les-tilleuls.coop/blog/retour-sur-cloud-nord-2022-premiere-partie" target="_blank" rel="noreferrer noopener nofollow">Cloud Nord</a> où nous étions exposants. 



Développement, formation, expertise, Cloud management ou encore Cloud architecture&#8230; Les-Tilleuls.coop reste votre unique contact dans la construction de vos applications. <a href="mailto:contact@les-tilleuls.coop" target="_blank" rel="noreferrer noopener">Prenez contact avec notre équipe</a> pour échanger sur votre projet !

Workshop Cloud & DevOps : monitorez votre infra et vos apps avec Prometheus et Grafana

Le mardi 8 novembre 2022, Julien Francoz animera une journée d'atelier axé sur les fondamentaux de Prometheus et Grafana.

Quoi de neuf chez Les-Tilleuls.coop ?