<?xml version="1.0"?>
<rss version="2.0"><channel><title>Plan&#xE8;te PHP</title><description>Agr&#xE9;gateur de flux RSS sur le PHP francophone</description><link>http://www.planete-php.fr/rss.php</link><language>fr-fr</language><generator>AFUP</generator><managingEditor>planetephpfr@afup.org</managingEditor><item><title>Utiliser PHP avec Airflow</title><link>https://www.jdecool.fr/blog/2026/05/18/utiliser-php-avec-airflow.html</link><author/><date>Mon, 18 May 2026 00:00:00 +0200</date><description><![CDATA[<p>Je travaille actuellement sur un projet orienté BI pour lequel des scripts d’analyse et de visualisation de données sont écrits en Python et sont orchestrés par <a href="https://airflow.apache.org " target="_blank" rel="noopener noreferrer">Apache Airflow</a>. Airflow est un outil Python, initialement conçu et pensé pour l’écosystème Python. Mais travaillant essentiellement en PHP, je me suis demandé s’il était possible d’y faire tourner des scripts PHP.</p>

<!--more-->

<div style="background-color: #e3f2fd; color: #0d47a1; padding: 1rem; margin: 1rem 0; border: 1px solid #90caf9; border-radius: 0.25rem; text-align: center;">
    <a href="/en/blog/2026/05/18/using-php-with-airflow.html">🇻🇬 This blog post is also available in English</a>.
</div>

<p>En parcourant la documentation d’Airflow, on peut se rendre compte que l’outil permet bien plus que d’exécuter des scripts Python. Si Python y est fortement intégré, en réalité, Airflow est capable d’exécuter n’importe quelle commande d’un terminal. Il est donc possible d’orchestrer tout type de script, et donc du PHP.</p>

<p>Les tâches (appelées DAG pour <em>Directed Acyclic Graph</em>) Airflow sont lancées au travers d’opérateur. Parmi ceux disponibles, l’opérateur <code>BashOperator</code> permet d’exécuter une commande dans un <em>worker</em> Airflow sur lequel serait présent PHP et le script à lancer.</p>

<p>Prenons par exemple le script PHP suivant:</p>

<figure class="highlight"><pre><code class="language-php" data-lang="php">&lt;?php

echo &quot;Hello from PHP script!\n&quot;;
echo &quot;Execution time: &quot; . date(&#39;Y-m-d H:i:s&#39;) . &quot;\n&quot;;</code></pre></figure>

<p>La création d’un DAG passe par l’écriture du script Python (c’est le seul moment où ce denier est nécessaire). La mise en place de notre tâche PHP pourrait se faire ainsi:</p>

<figure class="highlight"><pre><code class="language-python" data-lang="python">from airflow import DAG
from airflow.providers.standard.operators.bash import BashOperator
from datetime import datetime

with DAG(
    dag_id=&quot;run_php_script&quot;,
    description=&quot;A DAG that runs a PHP script&quot;,
    schedule=None,
    start_date=datetime(2024, 1, 1),
    catchup=False,
    tags=[&quot;php&quot;],
) as dag:

    run_php_script = BashOperator(
        task_id=&quot;run_php_script&quot;,
        bash_command=&quot;php /path/to/scripts/hello.php&quot;,
    )</code></pre></figure>

<p>Avec ce simple code Python, Airflow déclenche notre script PHP (qui lui peut être bien plus complexe). Les sorties standard et d’erreur sont automatiquement capturées dans les logs Airflow. On peut également bénéficier de toute la mécanique de <em>retry</em>, de monitoring et d’alerting Airflow.</p>

<p>Si vous désirez tester par vous même, vous trouverez tout le nécessaire dans <a href="https://github.com/jdecool/airflow-php-demo " target="_blank" rel="noopener noreferrer">ce dépôt</a> pour démarrer un environnement Airflow avec tout le nécessaire.</p>
]]></description></item><item><title>Comment int&#xE9;grer l'IA dans son workflow UX/UI</title><link>https://jolicode.com/blog/comment-integrer-l-ia-dans-son-workflow-ux-ui</link><author>JoliCode Team</author><date>Tue, 12 May 2026 12:42:00 +0200</date><description><![CDATA[<p><em><strong>&quot;On a déjà deux agents IA qui tournent en interne.&quot;</strong></em></p>
<p>Ce n'est pas en réunion que j'ai entendu ça. C'est en mission chez un client, dans leurs bureaux. Ce genre de phrase, je l'entends de plus en plus souvent maintenant, entre deux écrans, dans les couloirs, pendant la pause déjeuner. L'IA fait désormais partie du quotidien.</p>
<p>Quelques semaines plus tard, un autre client nous présente deux pages de maquettes générées par Claude, structure de page et premières intentions de contenu, pour expliquer ce qu'il voulait avant même d’ouvrir Figma.</p>
<p>C'est ce constat qui nous a poussés à écrire cet article, pour poser ce que ça change dans notre façon de travailler, et ce qu'on peut en tirer concrètement pour nos projets et nos clients.</p>
<p>Ce que j'ai trouvé en explorant, c'est que l'IA ne remplace pas le designer, elle redistribue son temps et son attention. Certaines tâches s'accélèrent, d'autres disparaissent, et de nouvelles compétences deviennent importantes. La principale d'entre elles, j'y reviendrai, est la capacité à formuler des demandes précises. Savoir parler à une IA, ça s'apprend et ça change tout à la qualité des résultats.</p>
<h2>Le prompt : la compétence clé</h2>
<p>Avant de parler workflow et processus, un point essentiel, la qualité des résultats dépend de la qualité de la demande. C'est le cœur du sujet.</p>
<p>Un bon prompt, c'est un bon brief. Précis, contextualisé, avec une intention claire et des contraintes définies. L'erreur la plus fréquente, celle que j'ai faite moi-même au début, c'est de rester trop vague en espérant que l'IA devine l'intention derrière la demande.</p>
<p><strong>ex : Prompt trop vague</strong><br />
<em>&quot;Génère un UX flow pour un site e-commerce.&quot;</em></p>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/workflow-ia-ux-ui/article-ai-design-01.jpg" data-original-width="1920" data-original-height="1080"><source type="image/webp" srcset="/media/cache/content-webp/2026/workflow-ia-ux-ui/article-ai-design-01.58842894.webp" /><source type="image/jpeg" srcset="/media/cache/content/2026/workflow-ia-ux-ui/article-ai-design-01.jpg" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1920 / 1080)" src="https://jolicode.com//media/cache/content/2026/workflow-ia-ux-ui/article-ai-design-01.jpg" alt="Génère un UX flow pour un site e-commerce" /></picture></p>
<p><strong>ex : Prompt structuré</strong><br />
<em>&quot;Génère un UX flow pour la page produit d'un site e-commerce de mode féminine, destiné à des femmes de 25–40 ans sur mobile. Inclure : découverte produit, sélection de taille, ajout au panier, paiement, et edge cases (taille indisponible, rupture de stock, code promo invalide). Format en étapes claires avec états d'erreur et micro-interactions.&quot;.</em></p>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/workflow-ia-ux-ui/article-ai-design-02.jpg" data-original-width="1920" data-original-height="1080"><source type="image/webp" srcset="/media/cache/content-webp/2026/workflow-ia-ux-ui/article-ai-design-02.cf2c3f4f.webp" /><source type="image/jpeg" srcset="/media/cache/content/2026/workflow-ia-ux-ui/article-ai-design-02.jpg" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1920 / 1080)" src="https://jolicode.com//media/cache/content/2026/workflow-ia-ux-ui/article-ai-design-02.jpg" alt="Génère un UX flow pour la page produit d’un site e-commerce " /></picture></p>
<p>La différence se joue sur <strong>la précision de la demande</strong>. Un prompt efficace s'articule autour de cinq dimensions. Elles font la différence entre un résultat générique et une base vraiment exploitable :</p>
<ol>
<li><strong>La tâche</strong> : Ce que l’IA doit faire concrètement, générer un écran, proposer un flow, décliner un composant.</li>
<li><strong>Le contexte</strong> : Où s'intègre cet écran ou ce parcours dans l'expérience globale ? Quel est l'état précédent ?</li>
<li><strong>Les éléments clés du design</strong> : Les caractéristiques visuelles ou fonctionnelles importantes que l'IA doit intégrer dans sa proposition.</li>
<li><strong>Les comportements attendus</strong> : Comment réagissent ces éléments lors de l'interaction (hover, tap, scroll, états vides, erreurs…)</li>
<li><strong>Les contraintes :</strong> Le support, la mise en page, le style visuel, les guidelines de marque. Plus ces contraintes sont précises, plus le résultat est pertinent.</li>
</ol>
<p>J'aime les métaphores, alors en voici une : l'IA ressemble à un nouveau collaborateur. Il ne connaît pas encore le contexte, les clients, les process. Sans brief précis, il produit quelque chose de générique. Bien briefé, il va vite et produit une base exploitable.</p>
<p>Apprendre à prompter, c'est apprendre à collaborer avec l'IA, formuler ce qu'on veut, donner le bon niveau de contexte, et itérer ensemble.</p>
<h2>Intégrer l'IA à chaque étape</h2>
<p><strong>Maintenant qu'on a posé ce cadre, voyons comment ça se traduit dans le travail. J'ai organisé cette exploration en trois phases : explorer, concevoir et produire. L'IA n'y joue pas le même rôle à chaque étape.</strong></p>
<p>Une précision importante avant de commencer : &quot;plus vite&quot; ne veut pas dire &quot;sans effort&quot;. Une partie du temps gagné en génération est réinvestie en correction, ajustement et validation. L'IA produit une base et non un livrable.</p>
<p><strong>Explorer plus vite et plus largement</strong></p>
<p>Un brief flou est l'une des principales sources de perte de temps en début de projet. Avant, cela voulait dire plusieurs allers-retours avant même de commencer à concevoir. Aujourd'hui, on peut envoyer le brief tel quel à un agent conversationnel, demander une structure claire avec l'utilisateur cible, le problème, les objectifs attendus et les questions de clarification manquantes, et avoir une base de travail en quelques minutes.</p>
<p>Sur les UX flows, même constat. L'IA est capable de générer rapidement plusieurs scénarios, explorer des alternatives et identifier des états qu'on aurait pu oublier (erreurs, compte vide, connexion perdue..). La décision reste entièrement humaine : simplifier, prioriser, arbitrer.</p>
<p><strong>Concevoir et itérer sans blocage</strong></p>
<p>Pour cette phase de conception, j'ai testé spécifiquement deux outils : Figma Make et Claude Design.</p>
<p>Figma Make permet de générer plusieurs propositions d'écrans à partir d'une description ou de frames, de tester des patterns qu'on n'aurait pas spontanément tentés, et d'explorer des déclinaisons visuelles rapidement. C'est un véritable moteur d'expérimentation. Par défaut, il génère des écrans génériques, sans personnalité, sans cohérence graphique. Cette limite se réduit selon ce qu'on lui fournit un prompt détaillé ou en faisant plusieurs itérations.</p>
<p>Claude Design va plus loin dans l'aboutissement. La richesse de l'interface et la finesse des ajustements possibles sont intéressantes. C'est à ce jour la solution qui produit les prototypes les plus aboutis parmi celles que j'ai testées. Si le prompt semble insuffisant, Claude Design propose automatiquement un questionnaire pour affiner la demande avant de générer.</p>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/workflow-ia-ux-ui/article-ai-design-03.jpg" data-original-width="1920" data-original-height="1080"><source type="image/webp" srcset="/media/cache/content-webp/2026/workflow-ia-ux-ui/article-ai-design-03.424b3206.webp" /><source type="image/jpeg" srcset="/media/cache/content/2026/workflow-ia-ux-ui/article-ai-design-03.jpg" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1920 / 1080)" src="https://jolicode.com//media/cache/content/2026/workflow-ia-ux-ui/article-ai-design-03.jpg" alt="Exemple de Claude" /></picture></p>
<p>Autre détail qui a son importance, Claude Design propose deux modes d'itération complémentaires : le chat pour les changements globaux, et les commentaires inline pour les ajustements précis sur un élément spécifique. En pratique, ça permet de générer rapidement des visuels utiles pour aligner une équipe, transformer une idée produit en prototype testable.</p>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/workflow-ia-ux-ui/article-ai-design-04.jpg" data-original-width="1920" data-original-height="1080"><source type="image/webp" srcset="/media/cache/content-webp/2026/workflow-ia-ux-ui/article-ai-design-04.5660d1fd.webp" /><source type="image/jpeg" srcset="/media/cache/content/2026/workflow-ia-ux-ui/article-ai-design-04.jpg" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1920 / 1080)" src="https://jolicode.com//media/cache/content/2026/workflow-ia-ux-ui/article-ai-design-04.jpg" alt="Exemple de Claude" /></picture></p>
<p>Dans les deux cas, ce que ces outils produisent est une base de travail, pas un livrable finalisé. Le designer reste celui qui la transforme en proposition exploitable.</p>
<p>Au-delà des écrans, l'IA change aussi la façon de rédiger les interfaces. Sur le microcopy, ces petits textes qui guident l'utilisateur à chaque étape, c'est une aide précieuse. En définissant le ton et le style de communication de la marque dans le prompt, on peut générer rapidement des textes cohérents pour tous les états d'interface : succès, erreur, chargement, état vide.</p>
<p><strong>Produire et livrer plus efficacement</strong></p>
<p>Le handoff, ce moment où le designer passe le relais au développeur, est souvent un moment de friction. L'IA ne le supprime pas, mais elle le fluidifie. En connectant Figma à Claude via le protocole MCP (Model Context Protocol), Claude peut lire directement la structure du fichier (composants, calques, propriétés…) et produire une base de documentation de specs. C'est une piste que je n'ai pas encore testée personnellement, mais qui mérite d'être mentionnée. La qualité du résultat dépendrait directement de la structure du fichier Figma : un fichier bien nommé avec des composants propres donnerait un résultat exploitable.</p>
<p>C'est d'ailleurs une règle qui vaut pour tout l'article : l'IA amplifie que ce qui est déjà structuré. Un design system solide n'est plus seulement un outil de cohérence visuelle, c'est ce qui rend le travail exploitable par l'IA.</p>
<h2>Et côté client, qu’est-ce que ça change vraiment ?</h2>
<p>Les deux anecdotes d'introduction ne sont pas des cas isolés, elles disent quelque chose d'important : le niveau de préparation et d'attente des clients change. Quand un client arrive avec des maquettes générées par IA pour illustrer son idée, il ne cherche pas à faire le travail du designer. Il cherche à être compris plus vite, à aligner plus tôt, à éviter les allers-retours.</p>
<p>Pour le designer, ça change la nature de la conversation. On ne part plus d'une page blanche commune, on part d'idées déjà mises en forme, parfois précises, parfois approximatives mais toujours révélatrices de ce que le client a en tête. Le client montre une direction, une intention mais pas une solution. C'est au designer de définir ce qu'il y a derrière.</p>
<p>La prochaine étape naturelle, que j'imagine, c'est l'atelier client en live : générer des variantes d'écrans directement en réunion pour itérer en temps réel sur une direction. L'enjeu est simple : aligner plus vite.</p>
<h2>Pour conclure</h2>
<p>L'IA transforme réellement la pratique du design. Elle accélère certaines étapes, structure des réflexions qui prenaient du temps, et ouvre des possibilités d'exploration.</p>
<p>Elle ne connaît pas les utilisateurs, leurs habitudes, leurs frustrations, ce qui les fait décrocher. La créativité graphique, la sensibilité visuelle, la cohérence d'une marque, tout cela reste entièrement humain. Mais elle propose des directions qu'un designer seul n'aurait pas explorées, pas parce qu'elles sont meilleures, mais parce qu'elle n'a pas nos biais.</p>
<p>Sur un prochain sujet, nous pourrons approfondir un aspect particulier : comment configurer Claude avec des instructions personnalisées (system prompts, custom instructions) pour lui donner un contexte permanent et des compétences adaptées à la pratique du designer.</p>]]></description></item><item><title>Derni&#xE8;re semaine de billetterie pour l'AFUP Day 2026</title><link>https://afup.org/news/1255-derniere-semaine-billetterie-afupday2026</link><author/><date>Mon, 11 May 2026 06:43:00 +0200</date><description><![CDATA[<h3>Un événement qualitatif où que vous choisissiez d'aller</h3>
<p>Tech pure, arrivée fracassante de l'IA dans notre quotidien, bonnes pratiques, outils qui facilitent le quotidien, sujets plus sociaux ou managériaux... Une chose est sûre : quelle que soit la destination que vous choisirez, comptez sur une programmation de qualité, proposée par des expert·e·s trié·e·s sur le volet, qui vous permettront de voir vos projets sous un nouvel angle. <br>
Alors que notre secteur est en pleine mutation, échanger, partager et réfléchir collectivement n'a jamais été aussi précieux. C'est ensemble qu'on avance le mieux ! </p>
<h3>La place au tarif de soutien</h3>
<p>La billetterie propose actuellement les billets à 110€HT, quelle que soit l'édition à laquelle vous souhaitez participer. Une journée de conférences techniques et actuelles, qui soufflera un vent d'inspiration et de fraîcheur pour aborder vos projets avec un nouvel oeil ! <br>
Prendre votre place a aussi un impact particulier pour l'AFUP. Nous vous parlons depuis quelques semaines de nos inquiétudes pour l'avenir de l'AFUP. En prenant vos places pour l'AFUP Day 2026, non seulement vous profitez du partage de connaissances, mais vous apportez également un soutien significatif à l'association. Nos conférences sont des parenthèses précieuses pour que la diffusion des connaissances en PHP continue : chaque action compte ! </p>
<p>Alors<a href="https://event.afup.org"> prenez vos places</a> d'ici vendredi 15 mai, 23h59, et rejoignez-nous lors de ce grand rassemblement de la communauté PHP !</p>]]></description></item><item><title>Faire des requ&#xEA;tes CTE avec Doctrine ORM en PHP</title><link>https://www.jdecool.fr/blog/2026/05/09/faire-des-requetes-cte-avec-doctrine-orm-en-php.html</link><author/><date>Sat, 09 May 2026 00:00:00 +0200</date><description><![CDATA[<p>J’ai déjà évoqué sur ce blog que <a href="/blog/2026/02/18/boring-technology-les-bases-de-donnees-relationnelles.html">le développement “moderne” avec les ORM masque les fonctionnalités avancées des SGBD</a> au point que dorénavant les développeurs ne maitrisent et ne connaissent guère plus que le classique <code>SELECT ... FROM ... WHERE ...</code>.</p>

<p>Dans les mécanismes méconnus et qui pourtant, pourrait permettre de soulager certains traitements applicatifs, on retrouve les CTE (<em>Common Table Expressions</em>). Voyons comment les utiliser avec Doctrine ORM en PHP.</p>

<!--more-->

<p>Commençons par expliquer ce qu’est une CTE. Il s’agit d’une sous-requête utilisable comme une table temporaire. C’est une technique utile pour décomposer des requêtes complexes, éviter la duplication de sous-sélections ou écrire des requêtes récursives.</p>

<p>En presque 20 ans d’expérience professionnelle, j’ai très rarement eu l’occasion d’en voir dans le code que je peux être amené à parcourir quotidiennement. Prenons par exemple, un blog où les articles sont rattachés à des catégories, ces dernières organisées sous forme arborescente sous la forme <code>Category(id, label, parent_id)</code>. Je suis certain que, si l’on demande à un développeur de récupérer toutes les catégories parentes d’une catégorie précise, ce dernier fera le traitement en PHP avec un code ressemblant au suivant:</p>

<figure class="highlight"><pre><code class="language-php" data-lang="php">// src/Repository/CategoryRepository.php
class CategoryRepository extends ServiceEntityRepository
{
    // ...

    /**
     * @return list&lt;Category&gt;
     */
    function getCatagoriesWithParents(int $categoryId): array
    {
        $category = $this-&gt;categoryRepository-&gt;find($categoryId);

        $categories = [
            $category,
        ];

        while ($parent = $category-&gt;getParent()) {
            $categories[] = $parent;
        }

        return $categories;
    }
}</code></pre></figure>

<p>L’inconvénient majeur ici est qu’en interne, Doctrine va faire une requête à chaque tour de boucle. C’est ce que l’on appelle <a href="/blog/2015/12/17/le-probleme-n+1.html">le problème N+1</a>. Pour résoudre ce problème, via une requête SQL, il n’est pas possible de faire un simple <code>SELECT ... FROM ... WHERE</code>, c’est exactement dans ce cas qu’une CTE récursive est utile. Cette dernière peut être écrite de la manière suivante:</p>

<figure class="highlight"><pre><code class="language-sql" data-lang="sql">WITH RECURSIVE cte_category AS (
    -- point de départ
    SELECT id, label, parent_id, 0 AS depth
    FROM category
    WHERE id = :id

    UNION ALL

    -- récursivité
    SELECT c.id, c.label, c.parent_id, cp.depth + 1
    FROM category c
    INNER JOIN cte_category cp ON c.id = cp.parent_id
)
SELECT id, label, parent_id FROM cte_category
ORDER BY depth DESC</code></pre></figure>

<p>La requête commence par récupérer la catégorie identifiée par <code>:id</code>, puis se joint récursivement à elle-même en remontant via <code>parent_id</code> jusqu’à ce qu’il n’y ait plus de parent. La colonne <code>depth</code> permet ensuite de trier du plus ancien ancêtre jusqu’à la catégorie cible.</p>

<p>Le problème pour faire cette requête avec un ORM tel que Doctrine, c’est que ce dernier ne permet pas de gérer les CTE nativement au travers de son <code>QueryBuilder</code> ni même en <code>DQL</code>. Il est alors nécessaire de passer par une requête native où le résultat final sera mappé sur un objet.</p>

<figure class="highlight"><pre><code class="language-php" data-lang="php">// src/Repository/CategoryRepository.php
class CategoryRepository extends ServiceEntityRepository
{
    // ...

    public function findAllWithParents(int $categoryId)
    {
        $rsm = new ResultSetMappingBuilder($this-&gt;getEntityManager());
        $rsm-&gt;addRootEntityFromClassMetadata(Category::class, &#39;c&#39;);

        $sql = &lt;&lt;&lt;SQL
            WITH RECURSIVE with_categories AS (
                SELECT id, label, parent_id, 0 AS depth
                FROM category
                WHERE id = :id

                UNION ALL

                SELECT c.id, c.label, c.parent_id, cp.depth + 1
                FROM category c
                INNER JOIN with_categories cp ON c.id = cp.parent_id
            )
            SELECT id, label, parent_id FROM with_categories
            ORDER BY depth DESC
        SQL;

        return $this-&gt;getEntityManager()
            -&gt;createNativeQuery($sql, $rsm)
            -&gt;setParameter(&#39;id&#39;, $categoryId)
            -&gt;getResult();
    }
}</code></pre></figure>

<p>Dans le code précédent, le <code>ResultSetMappingBuilder</code> se charge de faire correspondre les colonnes retournées avec les propriétés de l’entité <code>Category</code>. On obtient alors en sortie une liste d’instances de <code>Category</code> ordonnés de la racine jusqu’à la catégorie demandée.</p>

<p>Avec ce type de requête, on peut faire énormément de choses, il est par exemple, possible de récupérer tous les articles appartenant à une catégorie enfant en réutilisant la requête précédente:</p>

<figure class="highlight"><pre><code class="language-sql" data-lang="sql">WITH RECURSIVE category_path AS (
    SELECT id, label, parent_id
    FROM category
    WHERE id = :id

    UNION ALL

    SELECT c.id, c.label, c.parent_id
    FROM category c
    INNER JOIN category_path cp ON c.id = cp.parent_id
)
SELECT a.id, a.title, a.category_id
FROM article a
INNER JOIN category_path cp ON a.category_id = cp.id
ORDER BY a.published_date DESC</code></pre></figure>

<p>En une seule requête, on récupère tous les articles liés à la catégorie cible ou à n’importe lequel de ses ancêtres. Sans CTE récursive, il faudrait soit faire plusieurs requêtes successives pour parcourir la hiérarchie une approche bien moins efficace. Un point d’attention néanmoins, étant donné que l’on exécute une requête SQL native, il faudra faire attention à la portabilité de cette dernière, les CTE pouvant ne pas être disponible sur toutes les bases de données supportées par Doctrine.</p>

<p>De plus, l’utilisation du <code>ResultSetMappingBuilder</code> nécessite que le <code>SELECT</code> de la requête contienne l’ensemble des colonnes nécessaire à l’alimentation de l’objet. À défaut, l’entité sera hydratée de manière incomplète sans qu’aucune erreur explicite ne soit levée.</p>
]]></description></item><item><title>Claude Code, Cursor, Symfony/AI, Vercel AI SDK : 3 formations pour garder la main</title><link>https://jolicode.com/blog/claude-code-cursor-symfony-ai-vercel-ai-sdk-3-formations-pour-garder-la-main</link><author>JoliCode Team</author><date>Tue, 28 Apr 2026 15:42:00 +0200</date><description><![CDATA[<p>Trois formations IA sont disponibles dès maintenant sur <a href="https://jolicampus.com">JoliCampus</a>, avec des sessions ouvertes à l'inscription. Elles sont construites sur ce qu'on pratique chez JoliCode et Premier Octet : des projets clients qui tournent en production avec des agents de code IA, des outils qu'on utilise tous les jours, des patterns qu'on a éprouvés, testés et parfois jetés !</p>
<p>Voici ce qu'elles contiennent :</p>
<h2>Maîtriser les agents IA pour le développement</h2>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/formation-ia-article/1.png" data-original-width="1600" data-original-height="900"><source type="image/webp" srcset="/media/cache/content-webp/2026/formation-ia-article/1.00556eaa.webp" /><source type="image/png" srcset="/media/cache/content/2026/formation-ia-article/1.png" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1600 / 900)" src="https://jolicode.com//media/cache/content/2026/formation-ia-article/1.png" alt="les agents IA pour le développement" /></picture></p>
<p>La porte d'entrée ! Une journée pour sortir de l'autocomplete et entrer dans le travail avec des agents. Au programme : fonctionnement réel d'un agent (mémoire, contexte, permissions), standardisation des conventions d'équipe via le fichier <code>AGENTS.md</code> (agnostique, fonctionne avec Claude Code, Codex, Cursor), utilisation de l'agent comme QA automatisée avec génération de tests, lecture des logs et boucle d'auto-réparation sous supervision, puis création de commandes personnalisées pour industrialiser chez vous les revues de code, la détection de N+1, de failles XSS, et les patterns propres à votre équipe.</p>
<p><a href="https://jolicampus.com/formations/maitriser-les-agents-ia-pour-le-developpement">Voir la formation</a></p>
<h2>L'IA pour développeurs frontend, avec Cursor et le Vercel AI SDK</h2>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/formation-ia-article/2.png" data-original-width="1600" data-original-height="900"><source type="image/webp" srcset="/media/cache/content-webp/2026/formation-ia-article/2.97fd7971.webp" /><source type="image/png" srcset="/media/cache/content/2026/formation-ia-article/2.png" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1600 / 900)" src="https://jolicode.com//media/cache/content/2026/formation-ia-article/2.png" alt="IA pour développeurs frontend" /></picture></p>
<p>Les deux faces du sujet. Jour 1 côté workflow : Cursor dans ses trois modes (Ask, Plan, Agent), commandes custom, intégration d'outils via MCP, <code>.cursorrules</code> pour que l'agent respecte l'architecture du projet, gestion du contexte sur les sessions longues.</p>
<p>Jour 2 côté produit : construire un vrai assistant avec le Vercel AI SDK (streaming, tool calling, architecture RAG sur vos contenus, typage strict avec Zod), déploiement et les questions qui vont avec (coûts API, monitoring, stratégies de cache).</p>
<p><a href="https://jolicampus.com/formations/ia-developpement-frontend-cursor-vercel-ai-sdk">Voir la formation</a></p>
<h2>Maîtriser l'IA avec Symfony</h2>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/formation-ia-article/3.png" data-original-width="1600" data-original-height="900"><source type="image/webp" srcset="/media/cache/content-webp/2026/formation-ia-article/3.1a9a7438.webp" /><source type="image/png" srcset="/media/cache/content/2026/formation-ia-article/3.png" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1600 / 900)" src="https://jolicode.com//media/cache/content/2026/formation-ia-article/3.png" alt="IA avec Symfony" /></picture></p>
<p>Pour intégrer l'IA générative dans vos applications Symfony avec la même rigueur que le reste de votre code. On s'appuie <a rel="nofollow noopener noreferrer" href="https://ai.symfony.com/">sur Symfony/AI</a>, le composant officiel de l'écosystème, auquel on contribue directement.</p>
<p>Socle de 2 jours : fondamentaux des LLM, ChatInterface, typage fort des sorties en objets PHP, RAG complet sur vos documents avec pgvector. Puis deux modules optionnels : le premier transforme votre application en orchestrateur d'agents capables d'appeler votre code PHP et vos APIs internes, le second aborde MCP, le McpBundle, les stratégies de test, le monitoring en production et la maîtrise des coûts.</p>
<p><a href="https://jolicampus.com/formations/maitriser-ia-symfony">Voir la formation</a></p>
<h2>Et si vous ne codez pas ?</h2>
<p>POs, chefs de projets, dirigeantes et dirigeants de boîte tech : l'IA change aussi la façon dont vos équipes travaillent, à quelle cadence, sur quelle échelle de temps. Notre formation <a href="https://jolicampus.com/formations/culture-engineering">Culture Engineering</a> a un module dédié pour comprendre ce qui bouge pour mieux collaborer avec vos équipes tech.</p>
<h2>Pourquoi chez nous ?</h2>
<p>On forme sur ce qu'on pratique. Nos projets tournent en production avec ces outils, on contribue directement à Symfony/AI, et on publie sur <a href="https://jolicode.com/blog/tag/ia">notre blog</a> ce qu'on apprend. Ces formations vont évoluer avec l'écosystème. Certains modules seront réécrits dans six mois. Un participant d'aujourd'hui peut revenir dans un an sur une session mise à jour, et ce sera la suite logique, pas une répétition 🙂</p>
<p>Toutes nos formations <a href="https://jolicampus.com/formations/financement">sont certifiées Qualiopi, finançables via les OPCO</a>, et modulables en intra-entreprise. Un doute sur la formation qui correspond à votre équipe ? <a href="https://jolicampus.com/contact">Écrivez-nous !</a>.</p>]]></description></item><item><title>Plan de migration vers Tailwind CSS v4 &#x1F680; : la m&#xE9;thode (presque) sans douleur</title><link>https://jolicode.com/blog/plan-de-migration-vers-tailwind-css-v4-la-methode-presque-sans-douleur</link><author>JoliCode Team</author><date>Mon, 27 Apr 2026 10:20:00 +0200</date><description><![CDATA[<p>Ça y est, le grand jour est arrivé ! Vous avez enfin décidé de vous attaquer à cette fameuse dette technique qui vous fait faire des cauchemars la nuit. 😅</p>
<p>Beaucoup de nos projets (et sans doute les vôtres) reposent encore sur d’anciens frameworks CSS basés sur <a rel="nofollow noopener noreferrer" href="https://sass-lang.com/">Sass</a>, comme <a rel="nofollow noopener noreferrer" href="https://getbootstrap.com/docs/4.6/getting-started/introduction/">Bootstrap v4</a> ou d'autres solutions maison (coucou <a href="https://jolicode.com/blog/notre-framework-dinterface-atomic-builder-partie-2">Atomic Builder</a> 👋). Et soyons honnêtes : maintenir et mettre à jour ces projets relève souvent du parcours du combattant. On fait face à un manque cruel de flexibilité, la dette technique s’accumule, et les dépendances commencent à poser plus de soucis qu'elles n'en résolvent.</p>
<p>Sans oublier que Sass, bien qu’ayant été notre fidèle compagnon pendant de très (très) nombreuses années, devient de moins en moins indispensable avec l'évolution fulgurante du CSS natif. Nous avons d’ailleurs eu l’occasion d’en parler dans notre article expliquant pourquoi <a href="https://jolicode.com/blog/passer-a-postcss-pour-un-projet-sans-sass">passer à PostCSS</a>.</p>
<p>Le choix s'est donc naturellement porté vers <strong>Tailwind CSS v4</strong>. C'est une solution qui a fait ses preuves chez JoliCode (<a href="https://jolicode.com/blog/jai-teste-tailwind-css">J'ai testé Tailwind CSS</a>) et, cerise sur le gâteau, cette nouvelle version ne nécessite aucune dépendance liée à Sass.</p>
<p>L’année dernière, nous avons amorcé des phases de migration pour plusieurs de nos projets clients. Aujourd’hui, j’ai envie de partager avec vous quelques retours d’expérience et une méthodologie (testée et approuvée ✅) pour que ces migrations se passent le mieux possible !</p>
<h2>Phase 1 : Migration des feuilles de styles CSS 🎨</h2>
<p>L’objectif de cette première phase est simple : utiliser du CSS natif et dire officiellement au revoir à notre bon vieux Sass. 👋</p>
<p>La toute première étape consiste à migrer la configuration globale de votre projet (généralement définie dans des fichiers tels que <code>variables.scss</code> ou <code>global.scss</code>) vers un système basé sur des <a rel="nofollow noopener noreferrer" href="https://developer.mozilla.org/fr/docs/Web/CSS/Reference/Properties/--*"><em>custom properties</em></a> (variables CSS), en ciblant la racine du document HTML via la pseudo-classe <a rel="nofollow noopener noreferrer" href="https://developer.mozilla.org/fr/docs/Web/CSS/Reference/Selectors/:root"><code>:root</code></a>.</p>
<p><strong>Avant (Sass) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-2">$color-primary: </span><span class="syntax-3">#f7d325</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">$color-secondary: </span><span class="syntax-3">#ff2951</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">$font-family-sans-serif: </span><span class="syntax-1">"Source Sans Pro"</span><span class="syntax-2">, </span><span class="syntax-9">sans-serif</span><span class="syntax-2">;</span></span></code></pre>
<p><strong>Après (CSS natif) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">:root</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-2">  --color-primary: </span><span class="syntax-3">#f7d325</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">  --color-secondary: </span><span class="syntax-3">#ff2951</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">  --font-sans: </span><span class="syntax-1">"Source Sans Pro"</span><span class="syntax-2">, </span><span class="syntax-9">sans-serif</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p><br />
Utilisez dès maintenant la <a rel="nofollow noopener noreferrer" href="https://tailwindcss.com/docs/theme#default-theme-variable-reference">nomenclature de Tailwind CSS v4</a> pour nommer vos variables CSS. Ça vous fera gagner un temps précieux pour la suite. 👌</p>
        </div>
</div>

<h3>Cas n°1 : Les variables et fonctions</h3>
<p>Une fois votre thème mis en place, votre première mission sera de remplacer tous vos <code>$</code> par des <code>var(--)</code>. C'est aussi l'occasion de traduire vos fonctions Sass en CSS moderne. 👀</p>
<p><strong>Avant (Sass) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">.button</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-5">  width</span><span class="syntax-2">: math.</span><span class="syntax-9">div</span><span class="syntax-2">(</span><span class="syntax-3">100</span><span class="syntax-4">%</span><span class="syntax-2">, </span><span class="syntax-3">3</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-5">  background-color</span><span class="syntax-2">: $color-primary;</span></span>
<span class="line"><span class="syntax-2">  </span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:hover</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:focus-visible</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:active</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-5">    background-color</span><span class="syntax-2">: </span><span class="syntax-9">darken</span><span class="syntax-2">($color-primary, </span><span class="syntax-3">15</span><span class="syntax-4">%</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">  }</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p><strong>Après (CSS natif) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">.button</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-10">  /* Le CSS natif s'occupe des calculs dynamiquement ! */</span></span>
<span class="line"><span class="syntax-5">  width</span><span class="syntax-2">: </span><span class="syntax-9">calc</span><span class="syntax-2">(</span><span class="syntax-3">100</span><span class="syntax-4">%</span><span class="syntax-4"> /</span><span class="syntax-3"> 3</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-5">  background-color</span><span class="syntax-2">: </span><span class="syntax-9">var</span><span class="syntax-2">(--color-primary);</span></span>
<span class="line"><span class="syntax-2">  </span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:hover</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:focus-visible</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:active</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-10">    /* Magie ! Les couleurs relatives en CSS natif */</span></span>
<span class="line"><span class="syntax-5">    background-color</span><span class="syntax-2">: </span><span class="syntax-9">hsl</span><span class="syntax-2">(</span><span class="syntax-12">from</span><span class="syntax-9"> var</span><span class="syntax-2">(--color-primary) </span><span class="syntax-12">h</span><span class="syntax-12"> s</span><span class="syntax-9"> calc</span><span class="syntax-2">(</span><span class="syntax-12">l</span><span class="syntax-4"> -</span><span class="syntax-3"> 15</span><span class="syntax-2">)); </span></span>
<span class="line"><span class="syntax-2">  }</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p>Aujourd'hui, le CSS natif est devenu suffisamment mature pour remplacer la quasi-totalité des fonctions Sass. C’est particulièrement vrai pour les manipulations de couleurs, qui s’écrivent désormais très simplement grâce aux <a href="https://jolicode.com/blog/les-couleurs-relatives-en-css">couleurs relatives en CSS</a>. 🎨</p>
<h3>Cas n°2 : Le piège du sélecteur d’imbrication <code>&amp;</code> et du BEM</h3>
<p><strong>La bonne nouvelle</strong>, c'est que le CSS natif gère désormais très bien le <a rel="nofollow noopener noreferrer" href="https://developer.mozilla.org/fr/docs/Web/CSS/Reference/Selectors/Nesting_selector"><em>nesting</em></a> (l'imbrication). L'esperluette (<code>&amp;</code>) pour cibler des états comme <code>&amp;:hover</code> ou <code>&amp;:focus</code> fonctionne parfaitement sans Sass.</p>
<p><strong>La mauvaise nouvelle ?</strong> Si vous utilisiez le <code>&amp;</code> pour concaténer des classes, typiquement avec la <a rel="nofollow noopener noreferrer" href="https://getbem.com/">méthodologie BEM</a> (<code>&amp;__element</code> ou <code>&amp;--modifier</code>), le CSS natif ne comprendra pas cette syntaxe. Il va falloir « désimbriquer » ces éléments.</p>
<p><strong>Avant (Sass) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">.link</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-5">  color</span><span class="syntax-2">: $color-primary;</span></span>
<span class="line"><span class="syntax-2">  </span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:hover</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:focus-visible</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:active</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-5">    color</span><span class="syntax-2">: $color-secondary;</span></span>
<span class="line"><span class="syntax-2">  }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10">  /* Sass va compiler ce code en ".link--secondary" */</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-2">--secondary {</span></span>
<span class="line"><span class="syntax-5">    color</span><span class="syntax-2">: $color-secondary;</span></span>
<span class="line"><span class="syntax-2">  }</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p><strong>Après (CSS natif) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">.link</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-5">  color</span><span class="syntax-2">: </span><span class="syntax-9">var</span><span class="syntax-2">(--color-primary);</span></span>
<span class="line"><span class="syntax-2">  </span></span>
<span class="line"><span class="syntax-10">  /* Ce code fonctionne toujours en CSS natif ! */</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:hover</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:focus-visible</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-4">  &#x26;</span><span class="syntax-8">:active</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-5">    color</span><span class="syntax-2">: </span><span class="syntax-9">var</span><span class="syntax-2">(--color-secondary);</span></span>
<span class="line"><span class="syntax-2">  }</span></span>
<span class="line"><span class="syntax-2">}</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10">/* Il faut sortir la classe enfant de l'imbrication */</span></span>
<span class="line"><span class="syntax-8">.link--secondary</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-5">  color</span><span class="syntax-2">: </span><span class="syntax-9">var</span><span class="syntax-2">(--color-secondary);</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<h3>Cas n°3 : Les media queries</h3>
<p>Pour les <a rel="nofollow noopener noreferrer" href="https://developer.mozilla.org/fr/docs/Web/CSS/Guides/Media_queries/Using"><em>media queries</em></a> générées via des mixins ou des fonctions Sass (du type <code>@include media-breakpoint-up(md)</code>), passez simplement les valeurs en dur pour le moment (<code>@media (min-width: 768px)</code>). Nous nous en occuperons plus tard, lors de l'intégration de Tailwind.</p>
<h3>Cas n°4 : Les mixins, boucles et règles complexes</h3>
<p>Pour les cas très spécifiques (boucles <code>@for</code>, mixins complexes), la solution la plus pragmatique est de récupérer la version déjà compilée et de la coller dans votre fichier CSS.</p>
<p><strong>Avant (Sass) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">@for</span><span class="syntax-2"> $i </span><span class="syntax-4">from</span><span class="syntax-3"> 1</span><span class="syntax-4"> through</span><span class="syntax-3"> 3</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-8">  .button--size-</span><span class="syntax-2">#{$i} {</span></span>
<span class="line"><span class="syntax-5">    padding</span><span class="syntax-2">: #{$i}rem;</span></span>
<span class="line"><span class="syntax-2">  }</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p><strong>Après (CSS natif) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">.button--size-1</span><span class="syntax-2"> { </span><span class="syntax-5">padding</span><span class="syntax-2">: </span><span class="syntax-3">1</span><span class="syntax-4">rem</span><span class="syntax-2">; }</span></span>
<span class="line"><span class="syntax-8">.button--size-2</span><span class="syntax-2"> { </span><span class="syntax-5">padding</span><span class="syntax-2">: </span><span class="syntax-3">2</span><span class="syntax-4">rem</span><span class="syntax-2">; }</span></span>
<span class="line"><span class="syntax-8">.button--size-3</span><span class="syntax-2"> { </span><span class="syntax-5">padding</span><span class="syntax-2">: </span><span class="syntax-3">3</span><span class="syntax-4">rem</span><span class="syntax-2">; }</span></span></code></pre>
<p>À la fin de cette phase, <strong>le code CSS de votre projet n'utilise techniquement plus aucune fonctionnalité propre à Sass. 👏</strong></p>
<h2>Phase 2 : Migration (provisoire) des classes utilitaires 🧰</h2>
<p>C'est l'étape de la « prise de masse » avant la sèche. 💪</p>
<p>L'idée est de récupérer le CSS compilé de toutes les classes utilitaires de votre ancien framework et de les stocker dans un nouveau dossier, par exemple <code>utilities/</code>. Pour garder l'esprit clair, séparez-les par thématique : <code>utilities/typography.css</code>, <code>utilities/spacing.css</code>, etc.</p>
<p><strong>Exemple d'un fichier <code>utilities/spacing.css</code> (récupéré depuis Bootstrap v4) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">.mt-1</span><span class="syntax-2"> { </span><span class="syntax-5">margin-top</span><span class="syntax-2">: </span><span class="syntax-3">0.25</span><span class="syntax-4">rem</span><span class="syntax-4"> !important</span><span class="syntax-2">; }</span></span>
<span class="line"><span class="syntax-8">.mt-2</span><span class="syntax-2"> { </span><span class="syntax-5">margin-top</span><span class="syntax-2">: </span><span class="syntax-3">0.5</span><span class="syntax-4">rem</span><span class="syntax-4"> !important</span><span class="syntax-2">; }</span></span>
<span class="line"><span class="syntax-8">.mb-3</span><span class="syntax-2"> { </span><span class="syntax-5">margin-bottom</span><span class="syntax-2">: </span><span class="syntax-3">1</span><span class="syntax-4">rem</span><span class="syntax-4"> !important</span><span class="syntax-2">; }</span></span>
<span class="line"><span class="syntax-10">/* ... */</span></span></code></pre>
<p>Votre CSS global va grossir temporairement. C'est normal, ne paniquez pas ! Ces fichiers agiront comme un filet de sécurité visuel en attendant que Tailwind prenne le relais. 😮‍💨</p>
<h2>Phase 3 : On débranche l’ancien framework CSS 💔</h2>
<p>Si les phases 1 et 2 ont été faites minutieusement, vous pouvez supprimer l'ancien framework CSS de vos dépendances. Visuellement, rien ne devrait bouger. 🤞</p>

<div class="c-alert c-alert--warning">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 62"><path fill-rule="evenodd" d="m41.198 3.519 27.854 47.924C71.752 56.135 68.377 62 62.806 62H7.098c-5.402 0-8.947-5.865-6.077-10.557L28.875 3.52c2.7-4.692 9.622-4.692 12.323 0Zm-8.586 2.944L5.427 52.936C4.274 54.725 5.592 57 7.734 57h54.37c2.306 0 3.624-2.275 2.471-4.063L37.39 6.464c-.988-1.95-3.79-1.95-4.778 0ZM33 45.9c1.1-1.1 3.1-1.1 4.2 0 .2.2.3.3.4.5s.2.3.3.5.2.4.2.6c.1.2.1.4.1.6 0 .8-.3 1.6-.9 2.1-.5.6-1.3.9-2.1.9s-1.6-.3-2.3-.9c-.6-.5-.9-1.3-.9-2.1 0-.2.1-.4.1-.6.1-.2.1-.4.2-.6s.2-.3.3-.5.3-.4.4-.5m2.2-27.1c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V21.8c0-1.7 1.3-3 3-3"/></svg>
            </span>
                        <strong>Avertissement</strong>
    </p>
    <div class="c-alert__content">
                <p><br />
<strong>Attention aux comportements JS !</strong> Si votre ancien framework (comme Bootstrap) gérait des modales, des info-bulles ou des menus déroulants, la suppression de son CSS (et de ses scripts associés) risque de casser les animations ou le positionnement. Prévoyez un peu de temps de développement pour vérifier les interactions JavaScript et réécrire ces quelques composants. Profitez-en pour utiliser du JS vanilla ou du CSS moderne (<a rel="nofollow noopener noreferrer" href="https://developer.mozilla.org/fr/docs/Web/API/Popover_API">l'API Popover native</a> est parfaite pour ça, par exemple !).</p>
        </div>
</div>

<h2>Phase 4 : L'adieu à Sass 🫡</h2>
<p>C'est l'heure de désinstaller une fois pour toutes <code>sass</code> (ou <code>node-sass</code>). N’oubliez pas de renommer tous vos fichiers <code>.scss</code> en <code>.css</code>.</p>
<p>Lors de cette étape, il est très probable que le compilateur échoue lors de son premier lancement. Si la console se remplit d'erreurs, pas de panique, c'est un grand classique ! Cela s'explique généralement par l'une de ces trois raisons :</p>
<ol>
<li><strong>L'import fantôme</strong> : Votre <em>bundler</em> (comme <a rel="nofollow noopener noreferrer" href="https://webpack.js.org/">Webpack</a>) ou votre point d'entrée JavaScript (le fameux <code>app.js</code>) pointe toujours vers un fichier portant l’extension <code>.scss</code>. Pensez à bien mettre à jour vos chemins d'importation.</li>
<li><strong>Le reliquat de Sass</strong> : Il reste quelques <code>$</code>, <code>@use</code>, etc. qui traînent dans vos fichiers CSS. Pensez à les supprimer.</li>
<li><strong>Les commentaires</strong> : Les commentaires d'une seule ligne écrits avec <code>//</code> étaient valides avec Sass, mais pas avec votre CSS natif.</li>
</ol>
<p><strong>L'erreur classique à corriger :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-10">// Ce commentaire était valide en Sass, mais fera planter votre CSS natif !</span></span>
<span class="line"><span class="syntax-8">.element</span><span class="syntax-2"> { </span><span class="syntax-5">color</span><span class="syntax-2">: </span><span class="syntax-9">var</span><span class="syntax-2">(--color-primary); }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10">/* Remplacez-le par la syntaxe standard ! */</span></span>
<span class="line"><span class="syntax-8">.element</span><span class="syntax-2"> { </span><span class="syntax-5">color</span><span class="syntax-2">: </span><span class="syntax-9">var</span><span class="syntax-2">(--color-primary); }</span></span></code></pre>
<p>Une fois ces petits ajustements faits, respirez un grand coup. Le plus dur techniquement est derrière vous. 🎉</p>
<h2>Phase 5 : L'entrée en scène de Tailwind CSS v4 🤩</h2>
<p>Il est enfin temps d'installer Tailwind CSS v4 et <a rel="nofollow noopener noreferrer" href="https://postcss.org/">PostCSS</a> (indispensable dans nos projets Symfony avec <a rel="nofollow noopener noreferrer" href="https://symfony.com/doc/current/frontend/encore/index.html">Webpack Encore</a>). Je vous conseille de suivre la <a rel="nofollow noopener noreferrer" href="https://tailwindcss.com/docs/installation/using-postcss">documentation officielle</a> pour le <em>setup</em> initial.</p>
<h3>Le piège de l'import global (et du Preflight)</h3>
<p><strong>La documentation officielle vous recommandera d’importer Tailwind de cette façon :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">@import</span><span class="syntax-1"> "tailwindcss"</span><span class="syntax-2">;</span></span></code></pre>
<p>En utilisant cet import global, Tailwind embarque par défaut plusieurs <a rel="nofollow noopener noreferrer" href="https://developer.mozilla.org/fr/docs/Web/CSS/Reference/At-rules/@layer"><em>layers CSS</em></a> (<code>theme</code>, <code>base</code>, <code>components</code> et <code>utilities</code>), injectant par la même occasion son propre <em>reset CSS</em> (Preflight). Si votre projet possédait déjà un fichier de <em>reset</em> (comme <code>normalize.css</code>), vous risquez d’avoir des conflits.</p>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p><br />
<a rel="nofollow noopener noreferrer" href="https://tailwindcss.com/docs/preflight#disabling-preflight">Désactivez Preflight dans un premier temps</a>, ainsi que l'ensemble des <em>layers CSS</em> importés pour limiter les régressions et les problématiques liées à la <a rel="nofollow noopener noreferrer" href="https://developer.mozilla.org/fr/docs/Web/CSS/Guides/Cascade/Introduction">cascade CSS</a>.</p>
        </div>
</div>

<p><strong>Pour cela, privilégiez des imports ciblés (sans les <em>layers CSS</em>) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">@import</span><span class="syntax-1"> "tailwindcss/theme.css"</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">@import</span><span class="syntax-1"> "tailwindcss/utilities.css"</span><span class="syntax-2">;</span></span></code></pre>
<h3>La magie de la directive <code>@theme</code></h3>
<p>La révolution de la v4, c'est qu'elle est <em>CSS-first</em>. Fini l'énorme fichier <code>tailwind.config.js</code> à la racine de votre projet ! Le thème que vous aviez anticipé lors de la phase 1 s'intègre désormais presque nativement grâce à la nouvelle directive <code>@theme</code>.</p>
<p><strong>Avant :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">:root</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-2">  --color-primary: </span><span class="syntax-3">#f7d325</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">  --color-secondary: </span><span class="syntax-3">#ff2951</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">  --font-sans: </span><span class="syntax-1">"Source Sans Pro"</span><span class="syntax-2">, </span><span class="syntax-9">sans-serif</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p><strong>Après :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-2">@theme static {</span></span>
<span class="line"><span class="syntax-2">  --color-primary: </span><span class="syntax-3">#f7d325</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">  --color-secondary: </span><span class="syntax-3">#ff2951</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">  --font-sans: </span><span class="syntax-1">"Source Sans Pro"</span><span class="syntax-2">, </span><span class="syntax-9">sans-serif</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p><br />
<strong>Gardez vos variables CSS accessibles partout !</strong>  Pensez à générer vos variables CSS avec le comportement <code>static</code>, comme indiqué dans la <a rel="nofollow noopener noreferrer" href="https://tailwindcss.com/docs/theme#generating-all-css-variables">documentation Tailwind</a>. Ainsi, elles ne seront pas limitées aux classes utilitaires de Tailwind, mais resteront utilisables partout dans vos propres composants CSS personnalisés.</p>
        </div>
</div>

<p>C'est aussi le moment parfait pour utiliser la directive <code>@variant</code> afin d'uniformiser ces fameuses <em>media queries</em> que nous avions mises en dur plus tôt !</p>
<p><strong>Avant :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">@media</span><span class="syntax-2"> (</span><span class="syntax-5">min-width</span><span class="syntax-2">: </span><span class="syntax-3">768</span><span class="syntax-4">px</span><span class="syntax-2">) {</span></span>
<span class="line"><span class="syntax-8">  .card</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-5">    color</span><span class="syntax-2">: </span><span class="syntax-9">var</span><span class="syntax-2">(--color-primary);</span></span>
<span class="line"><span class="syntax-2">  }</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p><strong>Après :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-2">@variant md {</span></span>
<span class="line"><span class="syntax-8">  .card</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-5">    color</span><span class="syntax-2">: </span><span class="syntax-9">var</span><span class="syntax-2">(--color-primary);</span></span>
<span class="line"><span class="syntax-2">  }</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p>Ce petit changement vous garantit que tout votre CSS sur-mesure restera parfaitement synchronisé avec le comportement natif des classes utilitaires de Tailwind.</p>
<h2>Phase 6 : Le nettoyage de printemps 🧹</h2>
<p>Je préfère être honnête : cette étape demande de la patience. 🙃</p>
<p>L'objectif est de supprimer le dossier <code>utilities/</code> créé à la phase 2. Pour ce faire, vous allez devoir remplacer dans tous vos templates HTML/Twig les anciennes classes par les nouvelles générées par Tailwind.</p>
<p>Vos meilleurs alliés ici seront l'outil de recherche de votre IDE, les expressions régulières (Regex), et bien sûr votre LLM (<em>Large Language Model</em>) favori (ChatGPT, Claude, GitHub Copilot, etc.) pour automatiser un maximum le processus.</p>
<p><strong>Avant (Bootstrap v4) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-2">&#x3C;</span><span class="syntax-4">div</span><span class="syntax-8"> class</span><span class="syntax-2">=</span><span class="syntax-1">"d-flex flex-column flex-md-row"</span><span class="syntax-2">>...&#x3C;/</span><span class="syntax-4">div</span><span class="syntax-2">></span></span></code></pre>
<p><strong>Après (Tailwind CSS v4) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-2">&#x3C;</span><span class="syntax-4">div</span><span class="syntax-8"> class</span><span class="syntax-2">=</span><span class="syntax-1">"flex flex-col md:flex-row"</span><span class="syntax-2">>...&#x3C;/</span><span class="syntax-4">div</span><span class="syntax-2">></span></span></code></pre>
<h3>Le boss final : Les grilles 😎</h3>
<p>Il n'y a pas de solution magique ici. Les vieux frameworks utilisaient généralement <a rel="nofollow noopener noreferrer" href="https://developer.mozilla.org/fr/docs/Web/CSS/Guides/Flexible_box_layout">Flexbox</a> pour simuler un comportement de grille. Tailwind, lui, utilise le module natif <a rel="nofollow noopener noreferrer" href="https://developer.mozilla.org/fr/docs/Web/CSS/Guides/Grid_layout"><em>CSS Grid Layout</em></a> (modèle de disposition en grille).</p>
<p>Il va falloir repasser sur vos grilles manuellement. 😬</p>
<p><strong>L'ancienne approche (Flexbox) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-2">&#x3C;</span><span class="syntax-4">div</span><span class="syntax-8"> class</span><span class="syntax-2">=</span><span class="syntax-1">"row"</span><span class="syntax-2">></span></span>
<span class="line"><span class="syntax-2">  &#x3C;</span><span class="syntax-4">div</span><span class="syntax-8"> class</span><span class="syntax-2">=</span><span class="syntax-1">"col-12 col-md-6"</span><span class="syntax-2">>...&#x3C;/</span><span class="syntax-4">div</span><span class="syntax-2">></span></span>
<span class="line"><span class="syntax-2">  &#x3C;</span><span class="syntax-4">div</span><span class="syntax-8"> class</span><span class="syntax-2">=</span><span class="syntax-1">"col-12 col-md-6"</span><span class="syntax-2">>...&#x3C;/</span><span class="syntax-4">div</span><span class="syntax-2">></span></span>
<span class="line"><span class="syntax-2">&#x3C;/</span><span class="syntax-4">div</span><span class="syntax-2">></span></span></code></pre>
<p><strong>La nouvelle approche (Grid) :</strong></p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-2">&#x3C;</span><span class="syntax-4">div</span><span class="syntax-8"> class</span><span class="syntax-2">=</span><span class="syntax-1">"grid grid-cols-1 md:grid-cols-2"</span><span class="syntax-2">></span></span>
<span class="line"><span class="syntax-2">  &#x3C;</span><span class="syntax-4">div</span><span class="syntax-2">>...&#x3C;/</span><span class="syntax-4">div</span><span class="syntax-2">></span></span>
<span class="line"><span class="syntax-2">  &#x3C;</span><span class="syntax-4">div</span><span class="syntax-2">>...&#x3C;/</span><span class="syntax-4">div</span><span class="syntax-2">></span></span>
<span class="line"><span class="syntax-2">&#x3C;/</span><span class="syntax-4">div</span><span class="syntax-2">></span></span></code></pre>
<p>C'est fastidieux, mais le DOM en ressort considérablement allégé et plus lisible. 🥳</p>
<h2>Conclusion : Tout ça pour ça ? 🤔</h2>
<p>Oui, mille fois oui. Migrer vers Tailwind CSS v4 n'est pas un parcours de santé pour un projet existant. Mais les avantages sont colossaux.</p>
<p>Vous dites adieu à l'usine à gaz qu'était devenu Sass au fil des années. Le poids final de votre CSS sera drastiquement réduit puisque Tailwind ne compile que ce que vous utilisez réellement. Sans parler des performances pures : avec son nouveau moteur écrit en Rust, les temps de compilation sont si rapides qu’on les remarque à peine.</p>
<p>Enfin, la <em>Developer Experience</em> (DX) de vos équipes s'en trouvera transformée. C'est un investissement en temps conséquent, mais c'est un cadeau inestimable que vous faites au futur de votre projet. 🎁</p>
<h3>Et concrètement, comment on vend ça à sa direction ?</h3>
<p>C'est souvent la question qui fâche. On sait que le chantier est nécessaire, mais il est difficile d'estimer le temps que cela va prendre sans y laisser des plumes, d'où <strong>l'effet tunnel</strong> qui effraie les équipes produit.</p>
<p>Pour débloquer la situation, nous avons l'habitude chez JoliCode de commencer par un <strong>audit flash (1 à 2 jours)</strong>. L'objectif est de poser les choses à plat pour vous fournir un plan de bataille concret à défendre en interne :</p>
<ol>
<li><strong>Un état des lieux clair</strong> de la dette front actuelle (dépendances, risques, obsolescence).</li>
<li><strong>Une estimation chiffrée</strong> de la migration, découpée par phase.</li>
<li><strong>Un plan de déploiement progressif</strong> qui ne bloque pas votre <em>roadmap</em> produit.</li>
<li><strong>Les bénéfices attendus</strong> (gains de performance, vélocité des équipes, etc.).</li>
</ol>
<p>Si vous avez besoin d'aide pour cadrer votre propre migration, <a href="https://jolicode.com/contact">n'hésitez pas à nous faire signe</a> !</p>
<p>J’espère que ce retour d’expérience vous sera utile et vous donnera le courage de sauter le pas. N'hésitez pas à partager vos propres astuces ou vos galères de migration dans les commentaires ! 🙂</p>]]></description></item><item><title>Vibrations, livraison par Pok&#xE9;mon Go et la complexit&#xE9; du temps</title><link>https://www.synolia.com/synolab/outils/vibrations-livraison-par-pokemon-go-et-la-complexite-du-temps/</link><author>Estelle M.</author><date>Thu, 16 Apr 2026 17:03:45 +0200</date><description><![CDATA[<p>Découvrez notre veille technique du mois de mars entre Web Haptics, rumeurs sur Windows 12, livraisons de pizzas avec Pokémon Go et une valorisation de PHP !</p>
<h2 class="western">1, Donner de la vie à vos applications mobiles</h2>
<p>Votre téléphone ne se contente pas d’afficher ou de sonner ; il vit. À chaque notification, message ou appel, une vibration plus ou moins subtile vient accompagner ce que vous voyez sur l’écran.</p>
<p>Ce retour haptique, popularisé notamment par <strong>Apple</strong>, fait aujourd’hui partie intégrante de l’expérience mobile, en ajoutant une dimension tactile à nos interfaces.</p>
<p>Depuis longtemps, cette fonctionnalité était réservée aux applications natives. Mais aujourd’hui, grâce à des solutions comme <a href="https://haptics.lochie.me/">Web Haptics</a>, on peut désormais intégrer des vibrations directement dans les navigateurs.</p>
<p>Au-delà de son aspect technique, l’intérêt de <strong>Web Haptics</strong> réside dans sa capacité à démocratiser une pratique UX jusqu’ici réservée aux applications mobiles. Grâce à son API simple et ses modèles prêts à l’emploi, les développeurs peuvent intégrer rapidement des retours haptiques adaptés à leurs besoins, et plonger leurs utilisateurs dans des interfaces plus immersives, et intuitives.</p>
<h2 class="western">2. Les utilisateurs en colère contre Windows.</h2>
<p>L’expansion de l’IA fait polémique, de nos jours, c’est un fait. Et vous, que diriez-vous si demain, votre système d’exploitation annonçait vouloir utiliser de l’IA pour gérer vos dossiers, vos photos et vos vidéos stockés sur votre ordinateur ?</p>
<p>Selon une rumeur largement relayée, <strong>Windows 12</strong> serait sur le point de sortir avec une approche radicalement différente de ses prédécesseurs, avec un système module fortement centré sur l’intelligence artificielle, et potentiellement accessible via un abonnement. Et si l’on en croit <a href="https://windows.developpez.com/actu/380780/Windows-12-devrait-sortir-cette-annee-sous-forme-d-OS-entierement-modulaire-accessible-via-un-abonnement-et-axe-sur-une-strategie-IA-qui-provoque-deja-un-rejet-massif-de-Windows-11/">cet article</a> de Patrick Ruiz, cette idée est loin de plaire à tout le monde…</p>
<p>Même si l’article revient en réalité sur des informations incertaines, basées sur des rumeurs et des interprétations de projets internes, il démontre malgré tout l’inquiétude fondée des utilisateurs. Selon ces derniers, ces évolutions comme une véritable dérive vers un système plus intrusif, plus dépendant des services en ligne et potentiellement moins maîtrisable. C’est une approche assez polémique qui soulève une question primordiale ; à partir de quel moment notre ordinateur passera d’outil personnel à service ?</p>
<h2 class="western">3. Pokémon Go aide aux livraisons de pizza</h2>
<p><strong>Pokémon Go</strong> a été un succès mondial ; à sa sortie en 2016, il a comptabilisé plus de 500 millions de téléchargements en l’espace de 2 mois. Premier grand succès de la réalité augmentée, il a fait parcourir des milliards de kilomètres à ses utilisateurs prêts à tout pour attraper leur Pokémon préféré, via la caméra de leur téléphone.</p>
<p>Mais cette mine de données, récoltées par ces chasseurs de Pokémons, qu’est-elle devenue, aujourd’hui ? <a href="https://www.technologyreview.com/2026/03/10/1134099/how-pokemon-go-is-helping-robots-deliver-pizza-on-time/">Cet article</a> de la <strong>MIT Technology Review</strong> nous répond ; ils ont modélisé le monde… pour livrer des pizzas.</p>
<p>Cette réutilisation de données pose évidemment des questions. D’un point de vue industriel, on comprend leur immense valeur. Mais d’un point de vue utilisateur, on peut se demander à quel point chacune de nos interactions numériques alimente des systèmes bien au-delà de leur usage initial ?</p>
<p><strong>Pokémon Go</strong> n’était donc pas seulement un jeu en réalité augmentée ; c’était, sans le dire explicitement, une gigantesque opération de cartographie collective dont les bénéficiaires ne sont plus seulement les joueurs.</p>
<h2 class="western">4. Les fausses idées sur le temps.</h2>
<p>En informatique, la notion de temps, globalement universelle, n’est pas seulement une suite de secondes ou de dates ; c’est un calcul plein d’exceptions, de subtilités, et de pièges invisibles. En outre, à chaque fois que l’on peut penser maîtriser une règle simple, une situation concrète vient la remettre en question.</p>
<p>Le site <a href="https://yourcalendricalfallacyis.com/">YourCalendricalFallacyIs</a> illustre parfaitement cela, en confrontant nos idées reçues sur le calcul du temps. À travers une série d’énoncés expliqués et corrigés, il met en évidence les nombreux cas où nos intuitions échouent face à la complexité réelle des calendriers.</p>
<p>Un outil pédagogique et presque ludique, qui rappelle aux développeurs que le temps n’est jamais une donnée « simple ».</p>
<h2 class="western">5. Réaliser des maquettes en un seul clic.</h2>
<p>Dans nos articles de veille, nous avons souvent parlé d’applications web pour créer plein de choses avec un seul clic. Aujourd’hui, dans cette même idée, nous vous présentons <a href="https://stitch.withgoogle.com/">Stitch</a>.</p>
<p>Concevoir une interface est un vrai métier, qui est très souvent composé d’allers-retours incessants entre idées, envies, et faisabilité.</p>
<p>Stitch, de Google, s’inscrit dans une volonté de simplifier radicalement la réalisation de maquettes. Avec l’utilisation d’un prompt classique des IA, il permet de générer des interfaces complètes à partir de croquis ou d’une simple description, tout en produisant du code exploitable. L’outil ne se limite donc pas à la création visuelle ; il relie directement l’idée au développement.</p>
<p>Néanmoins, si l’application semble innovante et efficace, il faut toujours s’interroger sur la place de la conception traditionnelle face à ce type d’automatisation. Car, après tout, ne vaut-il pas mieux privilégier la qualité au détriment de la vitesse ?</p>
<h2 class="western">6. Voyez le bon côté de PHP</h2>
<p>Le langage <strong>PHP</strong> est souvent associé à des anciennes limites et à certaines critiques historiques, au point d’être parfois perçu comme un langage dépassé, malgré sa place centrale dans le développement web. Heureusement, le site <a href="https://haphpiness.com/#/">HaPHPiness</a> est là pour nous aider à voir ses bons côtés !</p>
<p>Organisé par thématique, ce site met en lumière les évolutions récentes de PHP ; typage renforcé, fonctions plus cohérentes, meilleures pratiques de sécurité… Chaque point est accompagné d’exemples concrets, montrant comment ses améliorations simplifient le développement et rendent le langage plus fiable, et plus accessible.</p>
<p>Au-delà de son ton volontairement positif, <strong>HaPHPines</strong><strong>s</strong> joue aussi un rôle pédagogique intéressant : il permet de prendre du recul sur l’image souvent datée de PHP et de découvrir un langage qui continue d’évoluer activement. Et c’est aussi un très bon outil pour les développeurs qui souhaitent se (re)mettre à jour, alors allez-y jeter un œil !</p>
<h2 class="western">Pour aller plus loin&#8230;</h2>
<p>Voici les autres liens que vous avez partagés ce mois-ci, bonne lecture !</p>
<ul>
<li><a href="https://yggleak.top/fr"><span style="font-weight: 400;">YGGLeak</span></a></li>
<li><a href="https://f2r.github.io/en/static-closures"><span style="font-weight: 400;">Why use static closures? | F2R Articles</span></a></li>
<li><a href="https://www.washingtonpost.com/technology/2026/03/04/anthropic-ai-iran-campaign/"><span style="font-weight: 400;">Anthropic’s AI tool Claude central to U.S. campaign in Iran, amid a bitter feud</span></a></li>
<li><a href="https://www.linkedin.com/posts/juozas_chatgpt-is-abandoning-agentic-commerce-its-activity-7435308306329473025-Ncy0/"><span style="font-weight: 400;">LinkedIn : ChatGPT is abandoning agentic commerce.</span></a></li>
<li><a href="https://www.numerama.com/tech/2186497-il-parait-que-les-logiciels-meurent-en-silence-cest-quoi-la-saaspocalypse.html"><span style="font-weight: 400;">SaaSpocalypse : l&rsquo;effondrement des logiciels SaaS &#8211; Numerama</span></a></li>
<li><a href="https://decouverte.jems-group.com/hubfs/MiniLB_Syst%C3%A8mesAgentiques.pdf"><span style="font-weight: 400;">SYSTÈMES AGENTIQUES REDONNER LE POUVOIR AUX MÉTIERS</span></a></li>
<li><a href="https://www.lesnumeriques.com/intelligence-artificielle/c-est-probablement-fini-nvidia-arrete-les-frais-avec-openai-et-tout-le-secteur-de-l-ia-retient-son-souffle-n252435.html"><span style="font-weight: 400;">“C&rsquo;est probablement fini” : Nvidia arrête les frais avec OpenAI, tout le secteur de l&rsquo;IA retient son souffle &#8211; Les Numériques</span></a></li>
<li><a href="https://andrewlock.net/working-with-stacked-branches-in-git-is-easier-with-update-refs/"><span style="font-weight: 400;">Working with stacked branches in Git is easier with &#8211;update-refs</span></a></li>
<li><a href="https://www.wheresyoured.at/the-beginning-of-history/"><span style="font-weight: 400;">The Beginning Of History</span></a></li>
<li><a href="https://www.anthropic.com/research/labor-market-impacts"><span style="font-weight: 400;">Labor market impacts of AI: A new measure and early evidence \ Anthropic</span></a></li>
<li><a href="https://uxcode.fr/articles/php-composer-font-optimizer"><span style="font-weight: 400;">font-optimizer pour réduire de 90% le poids de vos polices dans vos projets PHP</span></a></li>
<li><a href="https://bloomberg.github.io/js-blog/post/temporal/"><span style="font-weight: 400;">Temporal: The 9-Year Journey to Fix Time in JavaScript | Bloomberg JS Blog</span></a></li>
<li><a href="https://www.blogdumoderateur.com/anthropic-classement-metiers-menaces-ia/"><span style="font-weight: 400;">Anthropic dresse un classement des métiers les plus menacés par l’IA</span></a></li>
<li><a href="https://developer.mozilla.org/fr/docs/Web/CSS/Reference/Values/image/image-set"><span style="font-weight: 400;">image-set() &#8211; CSS | MDN</span></a></li>
<li><a href="https://www.linkedin.com/posts/julien-bideau_mes-devs-tapent-de-moins-en-moins-de-code-share-7439988838808190976-zFA8"><span style="font-weight: 400;">LinkedIn : Les devs de mon équipe tapent de moins en moins de code.</span></a></li>
<li><a href="https://www.forbes.com/sites/joetoscano1/2026/03/06/google-just-patented-the-end-of-your-website/"><span style="font-weight: 400;">Google Just Patented The End Of Your Website</span></a></li>
<li><a href="https://gnugat.github.io/2026/03/25/turn-you-php-app-into-a-standalone-binary.html"><span style="font-weight: 400;">Turn your PHP app into a standalone binary</span></a></li>
<li><a href="https://deathbyclawd.com/?url=https://smile.eu/"><span style="font-weight: 400;">SaaSpocalypse Survival Scanner — Death Report</span></a></li>
<li><a href="https://somnai-dreams.github.io/pretext-demos/"><span style="font-weight: 400;">Pretext Demos</span></a></li>
<li><a href="https://github.com/chenglou/pretext"><span style="font-weight: 400;">GitHub &#8211; chenglou/pretext: Fast, accurate &amp; comprehensive text measurement &amp; layout</span></a></li>
<li><a href="https://www.lexpress.fr/economie/high-tech/anthropic-une-fuite-revele-les-risques-de-la-future-ia-claude-mythos-pour-la-cybersecurite-MNECU7RIXRDC5GUSEOFC7WYHCQ/?cmp_redirect=true"><span style="font-weight: 400;">Anthropic : une fuite révèle les risques de la future IA « Claude Mythos » pour la cybersécurité – L&rsquo;Express</span></a></li>
<li><a href="https://www.youtube.com/watch?v=jNMWkD5VsZ8"><span style="font-weight: 400;">Beating every possible game of Pokemon Platinum at the same time</span></a></li>
<li><a href="https://wind-waker-js.vercel.app/"><span style="font-weight: 400;">Wind Waker JS</span></a></li>
</ul>
<p>Cet article <a href="https://www.synolia.com/synolab/outils/vibrations-livraison-par-pokemon-go-et-la-complexite-du-temps/">Vibrations, livraison par Pokémon Go et la complexité du temps</a> est apparu en premier sur <a href="https://www.synolia.com">Synolia, agence e-commerce, CRM, Data, PIM/DAM, OMS</a>.</p>
]]></description></item><item><title>Notre retour sur le SymfonyLive Paris 2026</title><link>https://jolicode.com/blog/notre-retour-sur-le-symfonylive-paris-2026</link><author>JoliCode Team</author><date>Wed, 08 Apr 2026 15:42:00 +0200</date><description><![CDATA[<p>Les années passent, mais certaines traditions restent immuables. Il y a quelques jours, la communauté s'est de nouveau réunie à la Cité Universitaire pour l'édition 2026 du Symfony Live Paris.</p>
<p>Si le monde de la tech avance à toute vitesse, le cru 2026 conserve la recette qui a fait son succès. Nous étions, comme à notre habitude, présents au rendez-vous. Voici notre retour sur une édition qui prouve que Symfony reste à la pointe des évolutions.</p>
<h2>Keynote de Fabien Potencier</h2>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/symfony-live-paris-2026/Fabien_TUI.jpg" data-original-width="3143" data-original-height="1922"><source type="image/webp" srcset="/media/cache/content-webp/2026/symfony-live-paris-2026/Fabien_TUI.4a744ec6.webp" /><source type="image/jpeg" srcset="/media/cache/content/2026/symfony-live-paris-2026/Fabien_TUI.jpg" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(3143 / 1922)" src="https://jolicode.com//media/cache/content/2026/symfony-live-paris-2026/Fabien_TUI.jpg" alt="Fabien pendant la Keynote" /></picture></p>
<p>Fabien Potencier nous a présenté un composant Symfony que beaucoup de gens attendaient impatiemment depuis sa première annonce datant de la <a href="https://jolicode.com/blog/du-code-des-gaufres-et-des-bds-nous-etions-a-la-symfonycon-a-bruxelles#keynote-d-ouverture-facon-fabpot">SymfonyCon 2023</a> : Symfony TUI (pour Terminal User Interface) !</p>
<p>Avec l'arrivée récente et massive de l’IA dans les habitudes de travail de beaucoup de développeurs, Fabien a trouvé une raison parfaite de relancer son travail sur le composant TUI pour permettre une utilisation plus ergonomique et avancée des LLMs directement depuis un terminal.</p>
<p>On a d’ailleurs eu le droit à une démonstration de son propre coding agent pour voir en direct ce à quoi on pourrait s’attendre avec l'adoption de ce composant pour discuter avec des LLMs. Et le rendu rivalise avec ce qui peut aujourd’hui être proposé directement dans nos IDEs.</p>
<p>Mais au-delà de l’intégration évidente avec l’IA, le composant TUI, c’est aussi une évolution du composant Symfony Console que l’on utilise tous (pour rappel, il s’agit de l’un des  premiers composants de l’écosystème Symfony, sorti il y a 15 ans maintenant). L’objectif ici, c’est de laisser Console s’occuper des parties commandes/arguments/output, pour concentrer toute la partie affichage, interaction et interactivité dans TUI.</p>
<p>Lors de ce talk assez orienté technique, Fabien a expliqué comment TUI fonctionne sous le capot. Sans entrer dans les détails ici, on pourra retenir :</p>
<ul>
<li>Il existe trois manières de gérer le style: à la manière stylesheet avec des sélecteurs semblables au CSS ; avec des classes utilitaires, comme on le ferait en Tailwind ; ou directement in-line, pour prendre la main de manière ponctuelle comme c'est possible en HTML. Les breakpoints sont aussi gérés avec des media-queries, pour un rendu nativement responsive ;</li>
<li>Beaucoup de Widgets sont disponibles nativement pour gérer la majorité des cas d’usages (ex: TextWidget pour affichage de texte et ASCII, InputWidget pour les entrées textuelles, SelectListWidget pour des listes scrollables, etc.) mais il est évidemment possible de créer nos propres widgets pour des cas particuliers ;</li>
<li>TUI utilise PHP Fibers et Revolt pour assurer un affichage et des animations complètement asynchrones et une gestion parallèle de l’affichage et de l’interactivité avec le développeur.</li>
</ul>
<p>La liste s’allonge évidemment, et toutes les informations sont disponibles sur le <a rel="nofollow noopener noreferrer" href="https://symfony.com/blog/introducing-the-symfony-tui-component">Blog Post dédié à l’arrivée de Symfony TUI</a>.</p>
<p>Pour conclure cette première conférence, Fabien s'est montré particulièrement enthousiaste. Ce nouveau composant Symfony ouvre des portes immenses, aussi bien pour l'affichage dans la console que pour l'intégration de l'intelligence artificielle.</p>
<p>Pour prouver la puissance de son outil, il a même fait une démonstration impressionnante : un jeu de <strong>Tetris</strong> tournant en direct dans son terminal ! Le rendu est fluide et visuellement bluffant, montrant que l'on peut désormais créer de véritables interfaces graphiques (TUI) modernes, directement en PHP.</p>
<p>Pour terminer, Fabien a lancé une idée très originale pour le futur des contributions sur ce composant : plutôt que d'envoyer une solution toute prête, les développeurs pourraient simplement partager un <strong>prompt</strong> (une instruction pour l'IA).</p>
<p>Fabien utiliserait alors son propre assistant et ses propres ressources pour transformer ces instructions en code réel et donner vie aux futures améliorations du projet !</p>
<h2>La communauté au rythme de l’IA</h2>
<p>On se souvient du <strong>SymfonyLive 2024</strong>, où l’IA générative d'images s'invitait déjà dans de nombreuses présentations. À l'époque, c’était encore une nouveauté impressionnante, bien que limitée.
Cette année, le changement est radical : les <strong>agents IA</strong> étaient omniprésents dans bon nombre de sujets. Cela reflète parfaitement l'évolution de notre quotidien de développeur, qui s'accélère de plus en plus dans cette direction.</p>
<p>Aujourd'hui, l'IA n'est plus juste un gadget visuel, elle est au cœur du développement de Symfony :</p>
<ul>
<li>Les nouvelles versions de <strong>Twig</strong> (le moteur de templates de Symfony) sont désormais gérées de manière quasi automatique par un agent ;</li>
<li>Une grande partie du code source est également générée par des assistants intelligents.</li>
</ul>
<p>Cependant, un point reste essentiel : l'IA aide à produire, mais elle ne remplace pas l'humain. La <strong>responsabilité</strong> finale appartient toujours à la personne qui valide le code. C'est le développeur qui vérifie et garantit la qualité de ce qui est produit avant de l'envoyer en production.</p>
<h3>L’IA au service des devs : Anatomie d'un assistant de Code Review - Thomas Boileau</h3>
<p>La volonté de Thomas est de normaliser l’utilisation de l’IA au sein de sa société. Son constat est qu’il est difficile d’intervenir dans le cycle de développement logiciel, au niveau individuel, car l’usage de l’IA est encore très inégal selon les développeurs. C’est pour ça qu’il a préféré intervenir sur la CI.</p>
<p>Lors de sa présentation, il nous expose donc un cas pratique. Son but : construire un assistant IA qui intervient au moment des code reviews.</p>
<p>Techniquement, dès qu'une PR est labellisé Ready For Review (RFR) alors un webhook est lancé, et l’assistant IA est déclenché.</p>
<p>Ici, ce que l'on apprend n’est pas réellement comment utiliser l’IA, mais plutôt un rappel bienvenu sur l’adoption d’une fonctionnalité par des utilisateurs. Il nous a bien expliqué qu’après sa première itération, quasiment personne n'interagissait avec son agent de revue de code.</p>
<p>En effet, comme toutes les nouveautés, l’essentiel, c'est de construire avec les utilisateurs finaux et d’éviter au maximum la friction. C’est donc après avoir mesuré l’usage de son bot et consulté les développeurs (utilisateurs) qu’il a proposé une nouvelle version, cette fois-ci plus utile pour tout le monde.</p>
<p>Évidement, Thomas nous rappelle qu’il aurait pu utiliser une solution sur étagère, mais il souligne les contraintes réglementaires qui s'appliquent à son domaine.</p>
<p>Sa conclusion est que le plus important dans ce projet reste la DX pour avoir une bonne adoption, et surtout que ce bot IA ne remplace pas l'humain, il est créé dans le but d’être seulement un plus dans la boucle.</p>
<h3>Développer un Coding Agent en PHP : dans les coulisses du &quot;Harness&quot; - Fabien Potencier</h3>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/symfony-live-paris-2026/fabien-potencies-ia-niveau.jpg" data-original-width="1600" data-original-height="738"><source type="image/webp" srcset="/media/cache/content-webp/2026/symfony-live-paris-2026/fabien-potencies-ia-niveau.d189aa63.webp" /><source type="image/png" srcset="/media/cache/content/2026/symfony-live-paris-2026/fabien-potencies-ia-niveau.jpg" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1600 / 738)" src="https://jolicode.com//media/cache/content/2026/symfony-live-paris-2026/fabien-potencies-ia-niveau.jpg" alt="Les différents niveaux d'utilisation de l'IA selon Fabien" /></picture></p>
<p>Tout a commencé par un défi sur Twitter. Un utilisateur affirmait qu'il était impossible de créer un <strong>coding agent</strong> (un assistant capable de coder de façon autonome) performant en utilisant le langage PHP. Piqué au vif, Fabien Potencier, le créateur de Symfony, a décidé de prouver le contraire en développant son propre assistant.</p>
<p>Plutôt que d'utiliser des outils tout prêts comme GitHub Copilot ou Claude Code, fabriquer son propre agent permet de comprendre les coulisses de l’intelligence artificielle. On découvre alors comment se déroule réellement une &quot;discussion&quot; entre un développeur et un modèle de langage (LLM).</p>
<p>Pour rendre l'outil agréable à utiliser, il a utilisé le composant <strong>TUI de Symfony</strong>. Cela permet d'avoir une interface textuelle interactive directement dans sa console.</p>
<p>Pour que l'agent soit intelligent, il doit communiquer avec un modèle (comme Claude Opus, Claude Sonnet, GPT 5). Mais les modèles évoluent sans cesse. Fabien a donc créé un petit outil, <a rel="nofollow noopener noreferrer" href="https://github.com/symfony/models-dev">symfony/models-dev</a>, qui répertorie de manière automatique tous les modèles disponibles afin de toujours utiliser la version la plus récente.</p>
<p>Discuter avec un chat, c'est facile. Mais pour qu'un agent soit utile, il doit pouvoir agir sur votre ordinateur. C'est là qu'interviennent les <em>Tools</em> (outils). De manière surprenante, Fabien n'a eu besoin que de 4 outils de base :</p>
<ul>
<li><em>Read</em> : pour lire le contenu d'un fichier.</li>
<li><em>Write</em> : pour créer un nouveau fichier.</li>
<li><em>Update</em> : pour modifier un fichier existant sans gaspiller de token.</li>
<li><em>Bash</em> : pour exécuter n'importe quelle commande (lancer des tests, installer un package, etc.).</li>
</ul>
<p>Un agent classique oublie tout dès que la session se ferme. Pour corriger cela, chaque échange est enregistré dans une base de données.</p>
<p>L’astuce géniale ? Cette mémoire est stockée sous forme d'<em>arbre</em>. Cela permet à l'agent de revenir en arrière à un point précis pour tester une autre solution si la première n'a pas fonctionné.</p>
<p>Plus on discute avec l'IA, plus le &quot;contexte&quot; (le nombre de mots envoyés) devient important. Si on dépasse la limite du modèle, il sature. Fabien a donc mis en place un système de compression intelligent :</p>
<ol>
<li>Il garde toujours le tout premier message (les instructions de base).</li>
<li>Il garde les derniers messages récents.</li>
<li><em>Il résume</em> tout ce qui se trouve entre les deux.</li>
</ol>
<p><strong>Les conseils de Fabien</strong></p>
<p>Durant sa démonstration, il a partagé quelques astuces précieuses :</p>
<ul>
<li><em>Les Skills</em> : Dès qu'il réalise qu'il répète une tâche, ou une instruction, il crée un &quot;skill&quot; (une compétence) pour son agent. C'est comme écrire des tests : on a l'impression de perdre du temps au début, mais on en gagne énormément sur le long terme ;</li>
<li><em>Le regard neuf</em> : Parfois, l'IA s'embrouille. Fabien conseille de lui demander d'analyser la situation avec &quot;un regard neuf&quot; (<em>fresh eyes</em>). Cela donne souvent des résultats spectaculaires pour débloquer un bug complexe.</li>
</ul>
<p>Bien qu'il n'ait pas eu le temps de tout montrer, notamment son système d'orchestration dans le cloud, la preuve est faite : <strong>le PHP est un langage de choix pour l'intelligence artificielle !</strong></p>
<h3>Embeddings en PHP : Symfony AI en pratique - Grégoire Pineau</h3>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/symfony-live-paris-2026/gregoire-symfony-ai.jpg" data-original-width="4080" data-original-height="3072"><source type="image/webp" srcset="/media/cache/content-webp/2026/symfony-live-paris-2026/gregoire-symfony-ai.c803838f.webp" /><source type="image/jpeg" srcset="/media/cache/content/2026/symfony-live-paris-2026/gregoire-symfony-ai.jpg" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(4080 / 3072)" src="https://jolicode.com//media/cache/content/2026/symfony-live-paris-2026/gregoire-symfony-ai.jpg" alt="Grégoire lors de sa conférence sur Symfony AI" /></picture></p>
<p>Le talk de <a href="https://jolicode.com/qui-sommes-nous/equipe/gregoire-pineau">Grégoire</a> nous met tout de suite dans la pratique avec une vraie mise en situation autour des embeddings et de la similarité de contenu.</p>
<p>Il part sur un cas d’usage qui parle à tout le monde : faire correspondre des URLs entre un ancien et un nouveau site. Là où on pourrait partir sur des règles compliquées ou du matching approximatif, les embeddings offrent une solution plus robuste : on compare directement le sens sémantique des pages.</p>
<p>Ce qui marche particulièrement bien, c’est le fil rouge visuel de la conférence. Un schéma du processus est affiché, puis réutilisé à chaque étape. Ce qui rend la progression assez claire : on comprend où on en est, ce qu’on fait, et pourquoi on le fait.</p>
<p>La conférence prend le temps de poser les bases :</p>
<ul>
<li>ce qu’est un embedding (une représentation vectorielle d’un contenu) ;</li>
<li>à quoi ça sert (mesurer de la similarité sémantique) ;</li>
<li>et surtout dans quels cas ça devient utile.</li>
</ul>
<p>Ensuite, on rentre dans le concret :</p>
<ul>
<li>comment choisir un modèle selon son besoin ;</li>
<li>comment vectoriser ses données depuis Symfony ;</li>
<li>où stocker ces vecteurs (PostgreSQL, Redis, etc.) ;</li>
<li>et comment les requêter efficacement.</li>
</ul>
<p>L'intérêt de cette présentation, c'est que Grégoire nous a montré que tout se fait sans quitter l’écosystème Symfony, grâce à Symfony AI. Cette initiative fournit ainsi toutes les abstractions nécessaires pour manipuler modèles, stores, agents et bien plus encore. N'hésitez pas à consulter le site dédié à <a rel="nofollow noopener noreferrer" href="https://ai.symfony.com/">Symfony AI</a> pour découvrir tout ça.
<a rel="nofollow noopener noreferrer" href="https://speakerdeck.com/lyrixx/embeddings-symfony-ai-en-pratique">Vous pouvez retrouver ses slides en ligne</a>.</p>
<h2>Retours d’expériences et présentations techniques</h2>
<p>Tous ces nouveaux outils basés sur l'IA ne doivent pas éclipser l'importance de la technicité en dehors de l'intelligence artificielle ! Au contraire, nous apprécions également les outils éprouvés et bien établis, et les retours d'expériences de manière générale.</p>
<h3>Chiffrez vos données avec Doctrine, en restant recherchable - Jérôme Tamarelle</h3>
<p>Lors de cette conférence, Jérôme Tamarelle a rappelé un point essentiel : la sécurité des données ne concerne pas uniquement les informations directement identifiantes (comme un email ou un nom), mais aussi les données indirectes. Croisées entre elles, ces dernières peuvent suffire à identifier une personne.</p>
<p>Il est important de distinguer deux approches souvent confondues :</p>
<ul>
<li><em>Le chiffrement</em> : les données sont transformées de manière réversible. On peut les déchiffrer à l’aide d’une clé ;</li>
<li><em>Le hashage</em> : il s’agit d’une empreinte unique et fixe d’une donnée. Cette opération est irréversible.
Plusieurs types de chiffrement existent, dont le chiffrement aléatoire et le chiffrement déterministe.</li>
</ul>
<p>Avec le <em>chiffrement aléatoire</em>, chaque valeur est chiffrée différemment, même si elle est identique à une autre.
Par exemple, une même adresse email enregistrée deux fois en base produira deux valeurs chiffrées différentes.</p>
<p>Avec le <em>chiffrement déterministe</em>, une même donnée produira toujours le même résultat chiffré.</p>
<p>Avec Doctrine, on encapsule le chiffrement directement dans Doctrine via des types personnalisés.
Un champ devient &quot;chiffré&quot; simplement par sa définition.</p>
<p>Mais du coup, on ne peut plus faire de recherche sur ces champs sans passer par Doctrine.</p>
<p>Sécuriser ses données, c’est accepter de complexifier son application. Et surtout, le faire dès la conception.</p>
<h3>Doctrine inheritance - Rémi JANOT</h3>
<p>Rémi commence par présenter la différence entre héritage (mapper une hiérarchie de classe) et polymorphisme (une clef étrangère qui pointe vers une autre classe) car le vocabulaire utilisé par les différents ORM et framework peuvent parfois prêter à confusion.</p>
<p>S'ensuit un rappel bienvenu de l’héritage implémenté directement au niveau de Doctrine ; avec des exemples concrets, il passe en revue toutes les combinaisons possibles : soit avec des MappedSuperClass, soit des DiscriminatorMap.</p>
<p>Fort de son expérience, il nous explique aussi qu’il est possible d’assez facilement passer d’une architecture Single Table Inheritance (STI) vers Class Table Inheritance (CTI). Donc les choix techniques ne sont pas forcément figés, les projets évoluent, et des solutions sont toujours possibles. Il nous rappelle aussi que lorsqu’on utilise les CTI, il est important de bien vérifier les index pour gagner en performance.</p>
<h3>JSON + SQL : hérésie ou élégance ? Retour d'expérience - Rémy Bonfils, Olivier FOURNY</h3>
<p>On reste ici dans le thème de la modélisation de nos bases de données avec un retour d’expérience sur l’utilisation de JSON dans nos tables SQL, via l’exemple d’une application mobile offline permettant de configurer des maisons imprimées en 3D (oui oui).</p>
<p>Étant donné la nature très flexible des paramètres d’impression (80000 configurations possibles, importées depuis un CSV), la question de comment les stocker se pose dès le départ.
Rémy et Olivier nous expliquent vouloir tout d’abord se diriger vers une modélisation de type Entity-Attribute-Valeur, où les paramètres ne sont pas représentés par des colonnes dans nos tables, mais par des lignes (ça doit parler aux personnes devant travailler sur des projets Magento ou Drupal) : beaucoup de flexibilité évidemment, mais aussi l’impossibilité d’avoir un minimum de structure dans nos données (tout est varchar). Et surtout des requêtes beaucoup plus complexes et donc des performances catastrophiques.</p>
<p>L’équipe se penche donc sur une autre solution : le stockage des paramètres dans des colonnes de la base de données en format JSON.</p>
<p>Et la surprise, les performances sont à peine inférieures à une modélisation classique de base de données (avec des tables liées par des clés étrangères), mais en gardant la flexibilité voulue ! Et grâce aux fonctions SQL permettant de manipuler du JSON, les requêtes restent simples et lisibles.</p>
<p>Pour notre part, à JoliCode, nous avons l’habitude de profiter du type JSON dans nos bases de données relationnelles (PostgreSQL ou MySQL), et nous vous le recommandons lorsque le besoin s’en fait ressentir.</p>
<h3>ClickHouse pour les développeurs Symfony - Romain Neutron</h3>
<p><picture class="js-dialog-target" data-original-url="/media/original/2026/symfony-live-paris-2026/clickhouse-romain-neutron.jpg" data-original-width="1600" data-original-height="901"><source type="image/webp" srcset="/media/cache/content-webp/2026/symfony-live-paris-2026/clickhouse-romain-neutron.6afbb7d4.webp" /><source type="image/jpeg" srcset="/media/cache/content/2026/symfony-live-paris-2026/clickhouse-romain-neutron.jpg" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1600 / 901)" src="https://jolicode.com//media/cache/content/2026/symfony-live-paris-2026/clickhouse-romain-neutron.jpg" alt="Romain Neutron lors de son talk sur ClickHouse" /></picture></p>
<p>Dans cette session, Romain Neutron a abordé la problématique de la gestion des données analytiques et des logs à grande échelle, des domaines où les bases relationnelles classiques comme MySQL ou PostgreSQL atteignent souvent leurs limites. Il a présenté <a rel="nofollow noopener noreferrer" href="https://clickhouse.com/">ClickHouse</a>, une base de données orientée colonnes ultra-performante, comme la solution idéale pour traiter des volumes massifs de données en temps réel. L'idée centrale n'est pas de remplacer votre base de données habituelle, mais de l'épauler pour des besoins spécifiques d'agrégation et de dashboards instantanés.</p>
<p>Côté technique, la conférence a mis en lumière la simplicité d'intégration de ClickHouse dans l'écosystème Symfony. Il a également partagé des benchmarks impressionnants comparant les temps de réponse sur des agrégations de plusieurs millions de lignes, montrant que ClickHouse peut transformer des requêtes de plusieurs secondes en résultats quasi instantanés.</p>
<p>Enfin, Romain a insisté sur les bonnes pratiques et les pièges à éviter, notamment sur la structure des données et le choix des moteurs de table (comme MergeTree). C'est un talk indispensable pour les développeurs cherchant à scaler leur stack analytique tout en restant dans un environnement PHP familier. De notre côté, on utilise ClickHouse dans plusieurs projets, surtout dans <a rel="nofollow noopener noreferrer" href="https://redirection.io/">redirection.io</a> pour les parties logs, analytics et crawler. On ne peut donc que vous recommander de vous y intéresser.</p>
<p>Ses slides sont <a rel="nofollow noopener noreferrer" href="https://speakerdeck.com/romainneutron/clickhouse-for-symfony-developers-symfonylive-paris-2026">disponibles en ligne</a> pour retrouver toutes les informations importantes.</p>
<h2>Symfony UX et la suite Hotwired</h2>
<p>Cette année, on continue de parler de Symfony UX, et en particulier, deux retours d’expériences spécifiquement axés sur <a rel="nofollow noopener noreferrer" href="https://hotwired.dev/">hotwired.dev</a>.</p>
<h3>Du web au mobile avec Symfony &amp; Hotwire Native - Imad ZAIRIG</h3>
<p>Imad nous a préparé une conférence sur le nouveau bundle Symfony UX Native qui utilise Hotwire Native. Basé sur un exemple, on peut voir comment l’application est architecturée.</p>
<p>On a eu l'exemple d'un bouton, rendu avec un composant bouton mobile, mais dont l'événement click est écouté par stimulus du côté de l’application Symfony</p>
<p>Cela fonctionne avec des webview pour que ce soit toujours Symfony qui gère le back-end et le front, mais avec des comportements mobiles gérés nativement (ex : la navigation et les transitions). On note qu’il y a quand même encore quelques fois ou il faut lancer le projet mobile avec Xcode par exemple pour iOS.</p>
<p>Pour utiliser les capacités natives des applications mobiles (type appareil photo) il faut passer par des &quot;Bridges Component&quot;, ça demande malgré tout du code côté mobile.</p>
<p>Selon la complexité de l’application et la taille de l’équipe, Symfony UX Native est une piste à explorer.</p>
<h3>Édition simultanée : facile avec Symfony UX - David Buchmann</h3>
<p>Au travers d’un exemple concret David nous a fait voir comment intégrer toute la suite d’outils de hotwired.dev. Il commence avec Turbo (et un peu de Turbo Frames aussi) et nous fait voir à quel point c’est bien intégré à Symfony UX. Puis sa conférence continue avec la mise en place de Mercure (grâce à son intégration dans FrankenPHP), et finalement le tout s’intègre parfaitement via des contrôleurs Stimulus qui écoutent les messages Mercure.</p>
<p>Il résume les avantages de Hotwire comme ceci : la logique reste dans le backend, la sécurité est intégrée. La complexité du frontend s’en trouve réduite.</p>
<h2>Conclusion</h2>
<p>Si cette édition du SymfonyLive Paris 2026 nous a offert un aperçu saisissant de l'intégration massive de l'Intelligence Artificielle au cœur de l'écosystème Symfony, elle prouve une chose essentielle : l'importance des conférences n'a jamais été aussi grande. Notre métier de développeur est en pleine mutation, et nous avons fort à faire pour rester à jour.</p>
<p>Le fil conducteur de cette année reste cependant une évidence : quelle que soit la puissance des outils, <strong>l'humain reste au centre de la boucle</strong>. L'IA est un assistant extraordinaire pour la production de code et les tâches répétitives, mais c'est bien la communauté, la validation humaine et le partage de connaissances qui garantissent la qualité et la progression de notre écosystème.
Merci aux organisateurs, aux conférenciers, et à la communauté d'avoir fait de cette édition 2026 un moment marquant, et rendez-vous l'année prochaine pour continuer à naviguer ensemble dans le futur du développement web !</p>]]></description></item><item><title>Symfony Live 2026 &#x2013; retours</title><link>https://www.gameandme.fr/divers/symfony-live-2026-retours/</link><author>Yohann Nizon</author><date>Wed, 01 Apr 2026 09:52:19 +0200</date><description><![CDATA[<p>Récemment, j&#8217;ai eu la chance de participer au Symfony Live 2026, l&#8217;occasion pour moi de rencontrer mes collègues de Smile, et de voir les dernières tendances du développement PHP. Je vous propose ici un petit retour de cette sympathique expérience. Text User interface: L&#8217;ouverture de la conférence a été faite par Fabien Potencier &#8211; l&#8217;auteur ... <a title="Symfony Live 2026 &#8211; retours" class="read-more" href="https://www.gameandme.fr/divers/symfony-live-2026-retours/" aria-label="En savoir plus sur Symfony Live 2026 &#8211; retours">Lire la suite</a></p>
<p>Cet article <a href="https://www.gameandme.fr/divers/symfony-live-2026-retours/">Symfony Live 2026 &#8211; retours</a> est apparu en premier sur <a href="https://www.gameandme.fr">Game And Me</a>.</p>
]]></description></item><item><title>Jane supporte maintenant JSON Schema 2020-12 et OpenAPI 3.1</title><link>https://jolicode.com/blog/jane-supporte-maintenant-json-schema-2020-12-et-openapi-3-1</link><author>JoliCode Team</author><date>Mon, 30 Mar 2026 11:34:00 +0200</date><description><![CDATA[<p>La version <strong>v7.11.0</strong> de Jane PHP, le générateur de client d'API et de Normalizer, est désormais disponible. Cette mise à jour majeure du moteur de génération se concentre sur l'alignement avec les derniers standards de l'industrie via le support de <strong>JSON Schema 2020-12</strong> et d'<strong>OpenAPI 3.1</strong>.</p>
<h2>🚀 Évolutions majeures</h2>
<h3>Support de JSON Schema 2020-12</h3>
<p>L'un des changements les plus importants introduits dans cette version est l'intégration du support pour <strong>JSON Schema 2020-12</strong> (PR <a rel="nofollow noopener noreferrer" href="https://github.com/janephp/janephp/pull/918">#918</a>). Cette mise à jour permet à Jane de traiter des schémas de données beaucoup plus modernes et complexes, offrant ainsi une sémantique plus riche pour la description de vos structures.</p>
<p>Il est important de noter que cette évolution a été pensée pour être totalement transparente : Jane conserve une <strong>rétrocompatibilité avec la draft 2019-09</strong>. Vous pouvez donc bénéficier des dernières avancées sans craindre pour vos schémas existants.</p>
<p>Cette double compatibilité permet à l'outil d'offrir une précision accrue dans deux domaines :</p>
<ul>
<li><strong>La génération des modèles PHP</strong> : Les classes générées reflètent plus fidèlement les contraintes et relations définies dans vos schémas, réduisant ainsi le besoin d'ajustements manuels.</li>
<li><strong>La validation des données</strong> : Le support de ces spécifications garantit que la logique de validation intégrée est en parfaite adéquation avec les exigences modernes des API.</li>
</ul>
<h3>Support d'OpenAPI 3.1</h3>
<p>L'autre pilier de cette version est le support de la spécification <strong>OpenAPI 3.1</strong> (PR <a rel="nofollow noopener noreferrer" href="https://github.com/janephp/janephp/pull/904">#904</a>). Cette mise à jour est structurante car elle aligne enfin le standard OpenAPI sur JSON Schema, simplifiant ainsi la gestion des modèles de données.</p>
<p>Grâce à ce support, Jane exploite nativement les nouvelles capacités du standard :</p>
<ul>
<li><strong>Convergence avec JSON Schema</strong> : OpenAPI 3.1 devient un &quot;superset&quot; de JSON Schema, permettant à Jane d'interpréter des définitions complexes sans perte d'information.</li>
<li><strong>Typage natif et nullable</strong> : Jane utilise la nouvelle syntaxe pour générer des propriétés PHP au typage exact (ex <code>?string</code>), assurant une cohérence entre votre contrat d'API et votre code.</li>
</ul>
<h2>📖 Nouvelle documentation officielle</h2>
<p>Parallèlement à ces évolutions techniques, la documentation du projet a reçu un coup de neuf pour offrir une meilleure expérience aux utilisateurs. Elle centralise les guides d'installation, de configuration et d'utilisation pour l'ensemble des composants.</p>
<p>Elle est disponible ici: <a rel="nofollow noopener noreferrer" href="https://jane.jolicode.com/latest/">jane.jolicode.com</a></p>
<h2>🛠️ Améliorations continues et maintenance</h2>
<p>Au-delà de ces évolutions majeures, cette version est aussi l'occasion d'un grand nettoyage de printemps pour le projet. Nous avons consolidé la base de code avec une série de correctifs de stabilité, notamment sur la gestion des types numériques dans les query strings, et une mise à jour globale des outils de maintenance. Ces ajustements, bien que plus discrets, garantissent une meilleure fiabilité du générateur et simplifient l'installation des dépendances pour vos projets.</p>
<h2>📦 Lancez-vous !</h2>
<p>Toutes ces améliorations sont disponibles dès maintenant via le tag <strong>v7.11.0</strong>. Que vous souhaitiez profiter des dernières spécifications OpenAPI ou simplement bénéficier d'un moteur de génération plus robuste, nous vous encourageons vivement à mettre à jour vos projets :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">composer</span><span class="syntax-1"> update</span><span class="syntax-1"> jane-php/</span><span class="syntax-11">*</span><span class="syntax-3"> -W</span></span></code></pre>
<p>N'hésitez pas à tester ces nouveautés, à explorer la nouvelle documentation et à nous faire part de vos retours sur GitHub. Jane continue de grandir grâce à vos usages et vos contributions, alors profitez-en bien !</p>
<ul>
<li>📚 Documentation officielle : <a rel="nofollow noopener noreferrer" href="https://jane.jolicode.com/latest/">jane.jolicode.com</a></li>
<li>💻 Dépôt GitHub : <a rel="nofollow noopener noreferrer" href="https://github.com/janephp/janephp">janephp/janephp</a></li>
<li>🚀 Release v7.11.0 : <a rel="nofollow noopener noreferrer" href="https://github.com/janephp/janephp/releases/tag/v7.11.0">Consulter le changelog</a></li>
</ul>]]></description></item><item><title>D&#xE9;ploiement On-Premise - Partie 2 - Castor &#xE0; la rescousse</title><link>https://jolicode.com/blog/deploiement-on-premise-partie-2-castor-a-la-rescousse</link><author>JoliCode Team</author><date>Thu, 26 Mar 2026 10:41:00 +0100</date><description><![CDATA[<p>Dans le <a href="https://jolicode.com/blog/deploiement-on-premise-le-socle-docker">précédent article</a>, nous avons vu toutes les étapes nécessaires pour préparer les images Docker qui seront utilisées en production. Mais nous allons maintenant aller plus loin pour automatiser et simplifier encore un peu plus cette étape grâce à Castor et les runners GitLab, le but étant de
faciliter la procédure de déploiement de nouvelles versions de l'application afin que le client puisse
être autonome.</p>
<h2>Création et publication des images</h2>
<p>Comme souvent quand nos projets nécessitent de lancer des commandes, nous mettons en place des tâches Castor pour simplifier la DX. Nous avons donc créé une task <code>production:build</code> qui applique tout ce que nous avons vu dans l'article précédent :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">&#x3C;?</span><span class="syntax-3">php</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Castor\Attribute\</span><span class="syntax-5">AsOption</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Castor\Attribute\</span><span class="syntax-5">AsTask</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Castor\Exception\</span><span class="syntax-5">ProblemException</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Symfony\Component\Console\Input\</span><span class="syntax-5">InputOption</span><span class="syntax-2">;</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">capture</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">check</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">context</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">fs</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">io</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">run</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">variable</span><span class="syntax-2">;</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">const</span><span class="syntax-3"> REGISTRY</span><span class="syntax-4"> =</span><span class="syntax-1"> '&#x3C;url du registre>:4567/plancq/arsol/'</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">const</span><span class="syntax-3"> DEFAULT_BRANCH</span><span class="syntax-4"> =</span><span class="syntax-1"> 'main'</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">const</span><span class="syntax-3"> BAKE_FILE</span><span class="syntax-4"> =</span><span class="syntax-3"> __DIR__</span><span class="syntax-4"> .</span><span class="syntax-1"> '/../infrastructure/production/bake.hcl'</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">const</span><span class="syntax-3"> IMAGES_TO_TAG</span><span class="syntax-4"> =</span><span class="syntax-2"> [</span></span>
<span class="line"><span class="syntax-1">    'postgres:16'</span><span class="syntax-4"> =></span><span class="syntax-1"> 'postgres'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-1">    'getmeili/meilisearch:v1.16'</span><span class="syntax-4"> =></span><span class="syntax-1"> 'meilisearch'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">];</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">#[AsTask(description: </span><span class="syntax-1">'Build production docker images'</span><span class="syntax-2">, namespace: </span><span class="syntax-1">'production:docker'</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> build</span><span class="syntax-2">(</span></span>
<span class="line"><span class="syntax-2">    #[AsArgument(description: </span><span class="syntax-1">'Version of the images'</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-4">    ?string</span><span class="syntax-2"> $tagVersion </span><span class="syntax-4">=</span><span class="syntax-3"> null</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">    #[AsOption(description: </span><span class="syntax-1">'Force the build whatever the current branch state'</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-4">    bool</span><span class="syntax-2"> $force </span><span class="syntax-4">=</span><span class="syntax-3"> false</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">    #[AsOption(description: </span><span class="syntax-1">'Push the images to the registry'</span><span class="syntax-2">, mode: </span><span class="syntax-5">InputOption</span><span class="syntax-4">::</span><span class="syntax-3">VALUE_NEGATABLE</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-4">    ?bool</span><span class="syntax-2"> $push </span><span class="syntax-4">=</span><span class="syntax-3"> null</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">    #[AsOption(description: </span><span class="syntax-1">'Update docker-compose.yml with current tag'</span><span class="syntax-2">, mode: </span><span class="syntax-5">InputOption</span><span class="syntax-4">::</span><span class="syntax-3">VALUE_NEGATABLE</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-4">    ?bool</span><span class="syntax-2"> $updateDockerCompose </span><span class="syntax-4">=</span><span class="syntax-3"> null</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">)</span><span class="syntax-4">:</span><span class="syntax-4"> void</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-2">    $currentBranch </span><span class="syntax-4">=</span><span class="syntax-8"> capture</span><span class="syntax-2">([</span><span class="syntax-1">'git'</span><span class="syntax-2">, </span><span class="syntax-1">'branch'</span><span class="syntax-2">, </span><span class="syntax-1">'--show-current'</span><span class="syntax-2">]);</span></span>
<span class="line"><span class="syntax-8">    check</span><span class="syntax-2">(</span><span class="syntax-1">'Checking current branch:'</span><span class="syntax-2">, </span><span class="syntax-1">'You must be on the main branch to build the production images. Change the current branch or use --force to bypass this check.'</span><span class="syntax-2">, </span><span class="syntax-4">static</span><span class="syntax-5"> fn</span><span class="syntax-2"> () => </span><span class="syntax-3">DEFAULT_BRANCH</span><span class="syntax-4"> ===</span><span class="syntax-2"> $currentBranch </span><span class="syntax-4">||</span><span class="syntax-2"> $force);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">    $currentChanges </span><span class="syntax-4">=</span><span class="syntax-8"> capture</span><span class="syntax-2">([</span><span class="syntax-1">'git'</span><span class="syntax-2">, </span><span class="syntax-1">'status'</span><span class="syntax-2">, </span><span class="syntax-1">'--porcelain'</span><span class="syntax-2">]);</span></span>
<span class="line"><span class="syntax-8">    check</span><span class="syntax-2">(</span><span class="syntax-1">'Checking git working tree:'</span><span class="syntax-2">, </span><span class="syntax-1">'You have uncommitted changes. Git stash everything before building image or use --force to bypass this check.'</span><span class="syntax-2">, </span><span class="syntax-4">static</span><span class="syntax-5"> fn</span><span class="syntax-2"> () => </span><span class="syntax-4">!</span><span class="syntax-2">$currentChanges </span><span class="syntax-4">||</span><span class="syntax-2"> $force);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> (</span><span class="syntax-4">!</span><span class="syntax-2">$force) {</span></span>
<span class="line"><span class="syntax-8">        run</span><span class="syntax-2">([</span><span class="syntax-1">'git'</span><span class="syntax-2">, </span><span class="syntax-1">'pull'</span><span class="syntax-2">, </span><span class="syntax-1">'origin'</span><span class="syntax-2">, </span><span class="syntax-3">DEFAULT_BRANCH</span><span class="syntax-2">]);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">    $validateVersion </span><span class="syntax-4">=</span><span class="syntax-4"> static</span><span class="syntax-5"> function</span><span class="syntax-2"> (</span><span class="syntax-4">string</span><span class="syntax-2"> $tagVersion)</span><span class="syntax-4">:</span><span class="syntax-4"> string</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-4">        if</span><span class="syntax-2"> (</span><span class="syntax-4">!</span><span class="syntax-2">$tagVersion) {</span></span>
<span class="line"><span class="syntax-4">            throw</span><span class="syntax-4"> new</span><span class="syntax-5"> \RuntimeException</span><span class="syntax-2">(</span><span class="syntax-1">'Version is required'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">        }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">        if</span><span class="syntax-2"> (</span><span class="syntax-4">!</span><span class="syntax-9">preg_match</span><span class="syntax-2">(</span><span class="syntax-1">'/</span><span class="syntax-4">^</span><span class="syntax-1">20</span><span class="syntax-3">\d</span><span class="syntax-1">{2}</span><span class="syntax-3">\.\d</span><span class="syntax-1">{2}</span><span class="syntax-3">\.\d</span><span class="syntax-1">{2}</span><span class="syntax-4">+</span><span class="syntax-1">(-</span><span class="syntax-3">\d</span><span class="syntax-4">+</span><span class="syntax-1">)?</span><span class="syntax-4">$</span><span class="syntax-1">/'</span><span class="syntax-2">, $tagVersion)) {</span></span>
<span class="line"><span class="syntax-4">            throw</span><span class="syntax-4"> new</span><span class="syntax-5"> \RuntimeException</span><span class="syntax-2">(</span><span class="syntax-1">'Version must be in the format YYYY.MM.DD (eventually with a revision like YYYY.MM.DD-1), got: '</span><span class="syntax-4"> .</span><span class="syntax-2"> $tagVersion);</span></span>
<span class="line"><span class="syntax-2">        }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">        return</span><span class="syntax-2"> $tagVersion;</span></span>
<span class="line"><span class="syntax-2">    };</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> ($tagVersion) {</span></span>
<span class="line"><span class="syntax-2">        $tagVersion </span><span class="syntax-4">=</span><span class="syntax-2"> $validateVersion($tagVersion);</span></span>
<span class="line"><span class="syntax-2">    } </span><span class="syntax-4">else</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-2">        $tagVersion </span><span class="syntax-4">=</span><span class="syntax-8"> io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">ask</span><span class="syntax-2">(</span><span class="syntax-1">'Please provide the version of the production images to build:'</span><span class="syntax-2">, </span><span class="syntax-9">date</span><span class="syntax-2">(</span><span class="syntax-1">'Y.m.d'</span><span class="syntax-2">), $validateVersion);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">    $tags </span><span class="syntax-4">=</span><span class="syntax-2"> [$tagVersion, </span><span class="syntax-1">'lastest'</span><span class="syntax-2">];</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">section</span><span class="syntax-2">(</span><span class="syntax-1">'Building the local development images...'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">    \docker\</span><span class="syntax-8">build</span><span class="syntax-2">();</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> (</span><span class="syntax-8">fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">exists</span><span class="syntax-2">(</span><span class="syntax-8">context</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.dockerignore'</span><span class="syntax-2">)) {</span></span>
<span class="line"><span class="syntax-8">        fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">rename</span><span class="syntax-2">(</span><span class="syntax-8">context</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.dockerignore'</span><span class="syntax-2">, </span><span class="syntax-8">context</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.dockerignore.tmp'</span><span class="syntax-2">, </span><span class="syntax-3">true</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    try</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-2">        $command </span><span class="syntax-4">=</span><span class="syntax-2"> [</span></span>
<span class="line"><span class="syntax-1">            'docker'</span><span class="syntax-2">, </span><span class="syntax-1">'buildx'</span><span class="syntax-2">, </span><span class="syntax-1">'bake'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-1">            '--file'</span><span class="syntax-2">, </span><span class="syntax-3">BAKE_FILE</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-1">            '--load'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">        ];</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">        foreach</span><span class="syntax-2"> (</span><span class="syntax-8">getImagesToBuild</span><span class="syntax-2">() </span><span class="syntax-4">as</span><span class="syntax-2"> $targetName </span><span class="syntax-4">=></span><span class="syntax-2"> $config) {</span></span>
<span class="line"><span class="syntax-4">            foreach</span><span class="syntax-2"> ($tags </span><span class="syntax-4">as</span><span class="syntax-2"> $tag) {</span></span>
<span class="line"><span class="syntax-2">                $command[] </span><span class="syntax-4">=</span><span class="syntax-1"> '--set'</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">                $command[] </span><span class="syntax-4">=</span><span class="syntax-2"> $targetName </span><span class="syntax-4">.</span><span class="syntax-1"> '.tags+='</span><span class="syntax-4"> .</span><span class="syntax-3"> REGISTRY</span><span class="syntax-4"> .</span><span class="syntax-2"> $targetName </span><span class="syntax-4">.</span><span class="syntax-1"> ':'</span><span class="syntax-4"> .</span><span class="syntax-2"> $tag;</span></span>
<span class="line"><span class="syntax-2">            }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">            $command[] </span><span class="syntax-4">=</span><span class="syntax-1"> '--set'</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">            $command[] </span><span class="syntax-4">=</span><span class="syntax-2"> $targetName </span><span class="syntax-4">.</span><span class="syntax-1"> '.args.PROJECT_NAME='</span><span class="syntax-4"> .</span><span class="syntax-8"> variable</span><span class="syntax-2">(</span><span class="syntax-1">'project_name'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">        }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">        run</span><span class="syntax-2">($command);</span></span>
<span class="line"><span class="syntax-2">    } </span><span class="syntax-4">finally</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-4">        if</span><span class="syntax-2"> (</span><span class="syntax-9">file_exists</span><span class="syntax-2">(</span><span class="syntax-8">context</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.dockerignore.tmp'</span><span class="syntax-2">)) {</span></span>
<span class="line"><span class="syntax-8">            fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">rename</span><span class="syntax-2">(</span><span class="syntax-8">context</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.dockerignore.tmp'</span><span class="syntax-2">, </span><span class="syntax-8">context</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.dockerignore'</span><span class="syntax-2">, </span><span class="syntax-3">true</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">        }</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    foreach</span><span class="syntax-2"> (</span><span class="syntax-3">IMAGES_TO_TAG</span><span class="syntax-4"> as</span><span class="syntax-2"> $sourceImage </span><span class="syntax-4">=></span><span class="syntax-2"> $image) {</span></span>
<span class="line"><span class="syntax-4">        foreach</span><span class="syntax-2"> ($tags </span><span class="syntax-4">as</span><span class="syntax-2"> $tag) {</span></span>
<span class="line"><span class="syntax-8">            run</span><span class="syntax-2">([</span><span class="syntax-1">'docker'</span><span class="syntax-2">, </span><span class="syntax-1">'image'</span><span class="syntax-2">, </span><span class="syntax-1">'pull'</span><span class="syntax-2">, $sourceImage]);</span></span>
<span class="line"><span class="syntax-8">            run</span><span class="syntax-2">([</span><span class="syntax-1">'docker'</span><span class="syntax-2">, </span><span class="syntax-1">'image'</span><span class="syntax-2">, </span><span class="syntax-1">'tag'</span><span class="syntax-2">, $sourceImage, </span><span class="syntax-3">REGISTRY</span><span class="syntax-4"> .</span><span class="syntax-2"> $image </span><span class="syntax-4">.</span><span class="syntax-1"> ':'</span><span class="syntax-4"> .</span><span class="syntax-2"> $tag]);</span></span>
<span class="line"><span class="syntax-2">        }</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">success</span><span class="syntax-2">(</span><span class="syntax-1">'Production images are now built.'</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> ($updateDockerCompose </span><span class="syntax-4">||</span><span class="syntax-2"> (</span><span class="syntax-3">null</span><span class="syntax-4"> ===</span><span class="syntax-2"> $updateDockerCompose </span><span class="syntax-4">&#x26;&#x26;</span><span class="syntax-8"> io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">confirm</span><span class="syntax-2">(</span><span class="syntax-1">'Do you want to update the docker-compose with the current version?'</span><span class="syntax-2">, </span><span class="syntax-3">false</span><span class="syntax-2">))) {</span></span>
<span class="line"><span class="syntax-8">        updateDockerCompose</span><span class="syntax-2">($tagVersion);</span></span>
<span class="line"><span class="syntax-2">    } </span><span class="syntax-4">else</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-8">        io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">info</span><span class="syntax-2">(</span><span class="syntax-1">'You can update the production docker-compose.yml file by running the following command:'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-8">        io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">info</span><span class="syntax-2">(</span><span class="syntax-1">'castor production:docker:update-docker-compose '</span><span class="syntax-4"> .</span><span class="syntax-2"> $tagVersion);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> ($push </span><span class="syntax-4">||</span><span class="syntax-2"> (</span><span class="syntax-3">null</span><span class="syntax-4"> ===</span><span class="syntax-2"> $push </span><span class="syntax-4">&#x26;&#x26;</span><span class="syntax-8"> io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">confirm</span><span class="syntax-2">(</span><span class="syntax-1">'Do you want to push the images to the registry (you may want to play with the images before pushing)?'</span><span class="syntax-2">, </span><span class="syntax-3">false</span><span class="syntax-2">))) {</span></span>
<span class="line"><span class="syntax-8">        push</span><span class="syntax-2">($tagVersion);</span></span>
<span class="line"><span class="syntax-2">    } </span><span class="syntax-4">else</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-8">        io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">info</span><span class="syntax-2">(</span><span class="syntax-1">'You can push the images to the registry by running the following command:'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-8">        io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">info</span><span class="syntax-2">(</span><span class="syntax-1">'castor production:docker:push'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">success</span><span class="syntax-2">(</span><span class="syntax-1">'Great job! Everything is now done.'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">}</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">#[AsTask(description: </span><span class="syntax-1">'Push production docker images'</span><span class="syntax-2">, namespace: </span><span class="syntax-1">'production:docker'</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> push</span><span class="syntax-2">(</span><span class="syntax-4">?string</span><span class="syntax-2"> $tag </span><span class="syntax-4">=</span><span class="syntax-3"> null</span><span class="syntax-2">)</span><span class="syntax-4">:</span><span class="syntax-4"> void</span></span>
<span class="line"><span class="syntax-2">{</span></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">info</span><span class="syntax-2">(</span><span class="syntax-1">'Pushing image to the registry...'</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    foreach</span><span class="syntax-2"> ([</span><span class="syntax-4">...</span><span class="syntax-9">array_keys</span><span class="syntax-2">(</span><span class="syntax-8">getImagesToBuild</span><span class="syntax-2">()), </span><span class="syntax-4">...</span><span class="syntax-3">IMAGES_TO_TAG</span><span class="syntax-2">] </span><span class="syntax-4">as</span><span class="syntax-2"> $image) {</span></span>
<span class="line"><span class="syntax-8">        io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">write</span><span class="syntax-2">(\</span><span class="syntax-9">sprintf</span><span class="syntax-2">(</span><span class="syntax-1">'Pushing %s image...'</span><span class="syntax-2">, $image));</span></span>
<span class="line"><span class="syntax-4">        if</span><span class="syntax-2"> ($tag) {</span></span>
<span class="line"><span class="syntax-8">            run</span><span class="syntax-2">([</span><span class="syntax-1">'docker'</span><span class="syntax-2">, </span><span class="syntax-1">'image'</span><span class="syntax-2">, </span><span class="syntax-1">'push'</span><span class="syntax-2">, </span><span class="syntax-1">'--disable-content-trust'</span><span class="syntax-2">, </span><span class="syntax-3">REGISTRY</span><span class="syntax-4"> .</span><span class="syntax-2"> $image </span><span class="syntax-4">.</span><span class="syntax-1"> ':'</span><span class="syntax-4"> .</span><span class="syntax-2"> $tag]);</span></span>
<span class="line"><span class="syntax-2">        } </span><span class="syntax-4">else</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-8">            run</span><span class="syntax-2">([</span><span class="syntax-1">'docker'</span><span class="syntax-2">, </span><span class="syntax-1">'image'</span><span class="syntax-2">, </span><span class="syntax-1">'push'</span><span class="syntax-2">, </span><span class="syntax-1">'--disable-content-trust'</span><span class="syntax-2">, </span><span class="syntax-1">'--all-tags'</span><span class="syntax-2">, </span><span class="syntax-3">REGISTRY</span><span class="syntax-4"> .</span><span class="syntax-2"> $image]);</span></span>
<span class="line"><span class="syntax-2">        }</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">success</span><span class="syntax-2">(\</span><span class="syntax-9">sprintf</span><span class="syntax-2">(</span><span class="syntax-1">'Production images have been pushed to the registry %s'</span><span class="syntax-2">, </span><span class="syntax-3">REGISTRY</span><span class="syntax-2">));</span></span>
<span class="line"><span class="syntax-2">}</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> getImagesToBuild</span><span class="syntax-2">()</span><span class="syntax-4">:</span><span class="syntax-4"> array</span></span>
<span class="line"><span class="syntax-2">{</span></span>
<span class="line"><span class="syntax-2">    $bakeConfigOutput </span><span class="syntax-4">=</span><span class="syntax-8"> capture</span><span class="syntax-2">([</span></span>
<span class="line"><span class="syntax-1">        'docker'</span><span class="syntax-2">, </span><span class="syntax-1">'buildx'</span><span class="syntax-2">, </span><span class="syntax-1">'bake'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-1">        '--file'</span><span class="syntax-2">, </span><span class="syntax-3">BAKE_FILE</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-1">        '--print'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">    ]);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">    $bakeConfig </span><span class="syntax-4">=</span><span class="syntax-9"> json_decode</span><span class="syntax-2">($bakeConfigOutput, </span><span class="syntax-3">true</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> (</span><span class="syntax-3">null</span><span class="syntax-4"> ===</span><span class="syntax-2"> $bakeConfig) {</span></span>
<span class="line"><span class="syntax-4">        throw</span><span class="syntax-4"> new</span><span class="syntax-5"> ProblemException</span><span class="syntax-2">(</span><span class="syntax-1">'Failed to parse bake.hcl output as JSON.'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> (</span><span class="syntax-4">!</span><span class="syntax-2">\</span><span class="syntax-9">is_array</span><span class="syntax-2">($bakeConfig) </span><span class="syntax-4">||</span><span class="syntax-4"> !</span><span class="syntax-9">isset</span><span class="syntax-2">($bakeConfig[</span><span class="syntax-1">'target'</span><span class="syntax-2">]) </span><span class="syntax-4">||</span><span class="syntax-4"> !</span><span class="syntax-2">\</span><span class="syntax-9">is_array</span><span class="syntax-2">($bakeConfig[</span><span class="syntax-1">'target'</span><span class="syntax-2">])) {</span></span>
<span class="line"><span class="syntax-4">        throw</span><span class="syntax-4"> new</span><span class="syntax-5"> ProblemException</span><span class="syntax-2">(</span><span class="syntax-1">'Invalid bake.hcl structure or missing targets.'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    return</span><span class="syntax-2"> $bakeConfig[</span><span class="syntax-1">'target'</span><span class="syntax-2">];</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p>
Nous recommandons généralement de placer les tâches et fonctions du projets dans des fichiers .php dans le dossier <code>.castor/</code> à la racine du dépôt.</p>
        </div>
</div>

<p>Pour résumer, cette task tout-en-un va :</p>
<ol>
<li>s'assurer que vous êtes sur la branche main, à jour et sans modification locale ;</li>
<li>demander la version des tags à créer en prenant par défaut la date du jour ;</li>
<li>construire la stack Docker de dev si nécessaire (pour avoir les images de base utilisées) ;</li>
<li>exécuter la commande Bake pour construire/taguer les images PHP ;</li>
<li>exécuter les commandes Docker pour construire/taguer les images publiques (Postgres et Meilisearch) ;</li>
<li>demander si vous voulez mettre à jour la version des images dans le docker-compose.yml final (si jamais vous voulez tester l'application en local avant de publier la version) ;</li>
<li>demander si vous voulez publier les images sur le registry.</li>
</ol>
<p>Chaque paramètre de cette task (la version à taguer, la confirmation de push ou de mise à jour du docker-compose.yml) est optionnel. S'ils ne sont pas spécifiés, la task les demandera de manière intéractive.</p>
<p>Il est maintenant très facile de publier une nouvelle version du projet pour n'importe quel intervenant du projet (tant qu'il a accès au registre Docker évidemment). Mais on peut aller encore un peu plus loin pour faciliter, cette fois, l'exploitation de l'infrastructure de production.</p>
<h2>Pilotage de l'infrastructure</h2>
<p>Pour démarrer le projet (que ce soit en production, en pré-production ou sur du on-premise), nous avons besoin de 3 choses :</p>
<ul>
<li>créer le fichier docker-compose.yml avec tous les services définis ;</li>
<li>créer un fichier .env pour configurer l'application Symfony ;</li>
<li>lancer la commande <code>docker compose up -d</code>.</li>
</ul>
<p>Nous allons tout d'abord créer un nouvel ensemble de task Castor qui vont permettre de tout de piloter l'infrastructure docker :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">&#x3C;?</span><span class="syntax-3">php</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">namespace</span><span> </span><span class="syntax-6">production</span><span class="syntax-2">;</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Castor\Attribute\</span><span class="syntax-5">AsTask</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Castor\</span><span class="syntax-5">Context</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Castor\Event\</span><span class="syntax-5">BeforeExecuteTaskEvent</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Castor\Exception\</span><span class="syntax-5">ProblemException</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Symfony\Component\Process\Exception\</span><span class="syntax-5">ProcessFailedException</span><span class="syntax-2">;</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">context</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">fs</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">io</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">load_dot_env</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">run</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">wait_for_docker_container</span><span class="syntax-2">;</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">#[AsTask(description: </span><span class="syntax-1">'Start production infrastructure'</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> start</span><span class="syntax-2">()</span><span class="syntax-4">:</span><span class="syntax-4"> void</span></span>
<span class="line"><span class="syntax-2">{</span></span>
<span class="line"><span class="syntax-4">    try</span><span class="syntax-2"> {</span></span>
<span class="line"><span class="syntax-8">        production_docker_compose</span><span class="syntax-2">([</span><span class="syntax-1">'up'</span><span class="syntax-2">, </span><span class="syntax-1">'-d'</span><span class="syntax-2">]);</span></span>
<span class="line"><span class="syntax-2">    } </span><span class="syntax-4">catch</span><span class="syntax-2"> (</span><span class="syntax-5">ProcessFailedException</span><span class="syntax-2"> $e) {</span></span>
<span class="line"><span class="syntax-4">        if</span><span class="syntax-2"> (</span><span class="syntax-9">preg_match</span><span class="syntax-2">(</span></span>
<span class="line"><span class="syntax-1">            '/Bind for (.</span><span class="syntax-4">*</span><span class="syntax-1">):(?&#x3C;port></span><span class="syntax-3">\d</span><span class="syntax-4">+</span><span class="syntax-1">) failed: port is already allocated/mi'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">            $e</span><span class="syntax-4">-></span><span class="syntax-8">getProcess</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">getErrorOutput</span><span class="syntax-2">(),</span></span>
<span class="line"><span class="syntax-2">            $matches</span></span>
<span class="line"><span class="syntax-2">        )) {</span></span>
<span class="line"><span class="syntax-4">            throw</span><span class="syntax-4"> new</span><span class="syntax-5"> ProblemException</span><span class="syntax-2">(\</span><span class="syntax-9">sprintf</span><span class="syntax-2">(</span><span class="syntax-1">'It seems that port %s is already used on your machine. Please free this port and try again.'</span><span class="syntax-2">, $matches[</span><span class="syntax-1">'port'</span><span class="syntax-2">]), </span><span class="syntax-3">previous</span><span class="syntax-2">: $e);</span></span>
<span class="line"><span class="syntax-2">        }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">        throw</span><span class="syntax-2"> $e;</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">success</span><span class="syntax-2">(</span><span class="syntax-1">'Production infrastructure has been started. It should be available in a few seconds.'</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">    $url </span><span class="syntax-4">=</span><span class="syntax-1"> 'https://'</span><span class="syntax-4"> .</span><span class="syntax-2"> $_ENV[</span><span class="syntax-1">'SERVER_NAME'</span><span class="syntax-2">];</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    wait_for_docker_container</span><span class="syntax-2">(</span><span class="syntax-1">'arsol-'</span><span class="syntax-4"> .</span><span class="syntax-2"> $_ENV[</span><span class="syntax-1">'ARSOL_INSTANCE'</span><span class="syntax-2">] </span><span class="syntax-4">.</span><span class="syntax-1"> '-frontend-1'</span><span class="syntax-2">, timeout: </span><span class="syntax-3">60</span><span class="syntax-2">, intervalMs: </span><span class="syntax-3">1000</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">success</span><span class="syntax-2">(\</span><span class="syntax-9">sprintf</span><span class="syntax-2">(</span><span class="syntax-1">'Production infrastructure is now ready at %s. Enjoy!'</span><span class="syntax-2">, $url));</span></span>
<span class="line"><span class="syntax-2">}</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">#[AsTask(description: </span><span class="syntax-1">'Stop production infrastructure'</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> stop</span><span class="syntax-2">()</span><span class="syntax-4">:</span><span class="syntax-4"> void</span></span>
<span class="line"><span class="syntax-2">{</span></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">title</span><span class="syntax-2">(</span><span class="syntax-1">'Stopping production infrastructure'</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    production_docker_compose</span><span class="syntax-2">([</span><span class="syntax-1">'stop'</span><span class="syntax-2">]);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">success</span><span class="syntax-2">(</span><span class="syntax-1">'Production infrastructure has been stopped.'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">}</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> production_docker_compose</span><span class="syntax-2">(</span><span class="syntax-4">array</span><span class="syntax-2"> $arguments)</span><span class="syntax-4">:</span><span class="syntax-4"> void</span></span>
<span class="line"><span class="syntax-2">{</span></span>
<span class="line"><span class="syntax-8">    load_dot_env</span><span class="syntax-2">(</span><span class="syntax-8">context</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.env'</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    run</span><span class="syntax-2">([</span><span class="syntax-1">'docker'</span><span class="syntax-2">, </span><span class="syntax-1">'compose'</span><span class="syntax-2">, </span><span class="syntax-1">'-f'</span><span class="syntax-2">, </span><span class="syntax-1">'docker-compose.yml'</span><span class="syntax-2">, </span><span class="syntax-1">'-p'</span><span class="syntax-2">, </span><span class="syntax-1">'arsol-'</span><span class="syntax-4"> .</span><span class="syntax-2"> $_ENV[</span><span class="syntax-1">'ARSOL_INSTANCE'</span><span class="syntax-2">], </span><span class="syntax-4">...</span><span class="syntax-2">$arguments]);</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p>
Cette fois, nous plaçons les tasks et fonctions destinées à être utilisées en production dans un dossier <code>tools/production/castor.php</code>. Nous expliquerons l'intérêt de séparer ces tasks dans un dossier à part dans le chapitre suivant.</p>
        </div>
</div>

<p>Avec ces deux tasks, on peut maintenant lancer <code>castor production:start</code> et <code>castor production:stop</code>. Mais pour une meilleure DX, on va également créer automatiquement le fichier <code>.env</code> de base ainsi que le fichier <code>docker-compose.yml</code> s'ils n'existent pas encore. Cela se fait facilement avec le système de <em>Listener</em> intégré dans Castor :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Castor\Attribute\</span><span class="syntax-5">AsListener</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-2"> Castor\Event\</span><span class="syntax-5">BeforeExecuteTaskEvent</span><span class="syntax-2">;</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">context</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">fs</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-4">use</span><span class="syntax-5"> function</span><span class="syntax-2"> Castor\</span><span class="syntax-5">io</span><span class="syntax-2">;</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">const</span><span class="syntax-3"> DOT_ENV_GENERABLES</span><span class="syntax-4"> =</span><span class="syntax-2"> [</span></span>
<span class="line"><span class="syntax-1">    'APP_SECRET'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-1">    'POSTGRES_PASSWORD'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-1">    'MEILI_MASTER_KEY'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">];</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">#[AsListener(</span><span class="syntax-5">BeforeExecuteTaskEvent</span><span class="syntax-4">::class</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> configure</span><span class="syntax-2">(</span><span class="syntax-5">BeforeExecuteTaskEvent</span><span class="syntax-2"> $event)</span><span class="syntax-4">:</span><span class="syntax-4"> void</span></span>
<span class="line"><span class="syntax-2">{</span></span>
<span class="line"><span class="syntax-2">    $context </span><span class="syntax-4">=</span><span class="syntax-8"> context</span><span class="syntax-2">();</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">    $taskName </span><span class="syntax-4">=</span><span class="syntax-2"> (</span><span class="syntax-5">string</span><span class="syntax-2">) $event</span><span class="syntax-4">-></span><span class="syntax-2">task</span><span class="syntax-4">-></span><span class="syntax-8">getName</span><span class="syntax-2">();</span></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> (</span><span class="syntax-4">!</span><span class="syntax-8">str_starts_with</span><span class="syntax-2">($taskName, </span><span class="syntax-1">'production:'</span><span class="syntax-2">)</span></span>
<span class="line"><span class="syntax-4">        ||</span><span class="syntax-8"> str_starts_with</span><span class="syntax-2">($taskName, </span><span class="syntax-1">'production:docker:'</span><span class="syntax-2">)</span></span>
<span class="line"><span class="syntax-4">        ||</span><span class="syntax-1"> 'production:repack'</span><span class="syntax-4"> ===</span><span class="syntax-2"> $taskName) {</span></span>
<span class="line"><span class="syntax-4">        return</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> (</span><span class="syntax-4">!</span><span class="syntax-8">fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">exists</span><span class="syntax-2">($context</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/docker-compose.yml'</span><span class="syntax-2">)) {</span></span>
<span class="line"><span class="syntax-8">        io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">info</span><span class="syntax-2">(</span><span class="syntax-1">'No docker-compose.yml file found in the current directory. Creating one from the default template.'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-8">        fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">copy</span><span class="syntax-2">(</span><span class="syntax-3">__DIR__</span><span class="syntax-4"> .</span><span class="syntax-1"> '/docker-compose.yml'</span><span class="syntax-2">, $context</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/docker-compose.yml'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    if</span><span class="syntax-2"> (</span><span class="syntax-4">!</span><span class="syntax-8">fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">exists</span><span class="syntax-2">($context</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.env'</span><span class="syntax-2">)) {</span></span>
<span class="line"><span class="syntax-8">        io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">info</span><span class="syntax-2">(</span><span class="syntax-1">'No .env file found in the current directory. Creating one from the default template.'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-8">        fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">copy</span><span class="syntax-2">(</span><span class="syntax-3">__DIR__</span><span class="syntax-4"> .</span><span class="syntax-1"> '/.env.production'</span><span class="syntax-2">, $context</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.env'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    foreach</span><span class="syntax-2"> (</span><span class="syntax-3">DOT_ENV_GENERABLES</span><span class="syntax-4"> as</span><span class="syntax-2"> $envVar) {</span></span>
<span class="line"><span class="syntax-2">        $dotEnvContent </span><span class="syntax-4">=</span><span class="syntax-9"> file_get_contents</span><span class="syntax-2">($context</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.env'</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">        if</span><span class="syntax-2"> (</span><span class="syntax-9">preg_match</span><span class="syntax-2">(</span><span class="syntax-1">'/^'</span><span class="syntax-4"> .</span><span class="syntax-9"> preg_quote</span><span class="syntax-2">($envVar, </span><span class="syntax-1">'/'</span><span class="syntax-2">) </span><span class="syntax-4">.</span><span class="syntax-1"> '=.+$/m'</span><span class="syntax-2">, $dotEnvContent)) {</span></span>
<span class="line"><span class="syntax-4">            continue</span><span class="syntax-2">;</span></span>
<span class="line"><span class="syntax-2">        }</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">        $value </span><span class="syntax-4">=</span><span class="syntax-9"> bin2hex</span><span class="syntax-2">(</span><span class="syntax-8">random_bytes</span><span class="syntax-2">(</span><span class="syntax-3">16</span><span class="syntax-2">));</span></span>
<span class="line"><span class="syntax-2">        $dotEnvContent </span><span class="syntax-4">=</span><span class="syntax-9"> preg_replace</span><span class="syntax-2">(</span><span class="syntax-1">'/^'</span><span class="syntax-4"> .</span><span class="syntax-9"> preg_quote</span><span class="syntax-2">($envVar, </span><span class="syntax-1">'/'</span><span class="syntax-2">) </span><span class="syntax-4">.</span><span class="syntax-1"> '=.*/m'</span><span class="syntax-2">, $envVar </span><span class="syntax-4">.</span><span class="syntax-1"> '='</span><span class="syntax-4"> .</span><span class="syntax-2"> $value, $dotEnvContent);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-9">        file_put_contents</span><span class="syntax-2">($context</span><span class="syntax-4">-></span><span class="syntax-2">workingDirectory </span><span class="syntax-4">.</span><span class="syntax-1"> '/.env'</span><span class="syntax-2">, $dotEnvContent);</span></span>
<span class="line"><span class="syntax-2">    }</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p>Nous avons également ajouté quelques tasks supplémentaires pour afficher les logs du projet Docker compose, pour afficher l'état des conteneurs ou encore pour détruire complètement toute trace du projet (pratique quand on veut juste tester la stack).</p>
<h2>Création d'un exécutable</h2>
<p>Castor propose une <a rel="nofollow noopener noreferrer" href="https://castor.jolicode.com/docs/going-further/extending-castor/repack/">fonctionnalité de repack</a> qui permet de packager un projet Castor avec ses tasks dans un Phar autonome, ce qui permet de le partager et l'utiliser sans avoir besoin d'avoir le code du projet, ni même d'avoir Castor installé. C'est parfait pour notre environnement de production / On-Premise car hormis PHP, nous avons rien à installer à l'avance pour pouvoir démarrer l'application.</p>
<p>Dans le dossier <code>tools/production/</code>, nous allons donc placer plusieurs fichiers qui seront inclus dans le phar :</p>
<ul>
<li>un fichier .env.production avec les vars d'env à définir obligatoirement ;</li>
<li>le fichier docker-compose.yml vu dans le précédent article ;</li>
<li>le fichier castor.php du chapitre précédent qui contient les tasks pour piloter la stack.</li>
</ul>
<p>Nous allons donc maintenant pouvoir repacker le projet Castor situé dans ce dossier <code>tools/production/</code>. La commande à lancer en dev pour repacker notre projet sera évidemment encapsulée dans une task Castor (donc placée dans le dossier habituel <code>.castor/</code>) :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">const</span><span class="syntax-3"> PRODUCTION_DIRECTORY</span><span class="syntax-4"> =</span><span class="syntax-3"> __DIR__</span><span class="syntax-4"> .</span><span class="syntax-1"> '/../tools/production/'</span><span class="syntax-2">;</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">#[AsTask(description: </span><span class="syntax-1">'Repack production application in a new phar'</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> repack</span><span class="syntax-2">()</span><span class="syntax-4">:</span><span class="syntax-4"> void</span></span>
<span class="line"><span class="syntax-2">{</span></span>
<span class="line"><span class="syntax-8">    io</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">title</span><span class="syntax-2">(</span><span class="syntax-1">'Repacking production application.'</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10">    // Castorception \o/</span></span>
<span class="line"><span class="syntax-8">    run</span><span class="syntax-2">(</span><span class="syntax-1">'castor repack --app-name=arsol --no-logo'</span><span class="syntax-2">, context: </span><span class="syntax-8">context</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">withWorkingDirectory</span><span class="syntax-2">(</span><span class="syntax-3">PRODUCTION_DIRECTORY</span><span class="syntax-2">));</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">    fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">mkdir</span><span class="syntax-2">(</span><span class="syntax-3">PRODUCTION_DIRECTORY</span><span class="syntax-4"> .</span><span class="syntax-1"> '/build'</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-8">    fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">remove</span><span class="syntax-2">(</span><span class="syntax-8">finder</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">in</span><span class="syntax-2">(</span><span class="syntax-3">PRODUCTION_DIRECTORY</span><span class="syntax-4"> .</span><span class="syntax-1"> '/build'</span><span class="syntax-2">)</span><span class="syntax-4">-></span><span class="syntax-8">ignoreDotFiles</span><span class="syntax-2">(</span><span class="syntax-3">false</span><span class="syntax-2">));</span></span>
<span class="line"><span class="syntax-8">    fs</span><span class="syntax-2">()</span><span class="syntax-4">-></span><span class="syntax-8">rename</span><span class="syntax-2">(</span><span class="syntax-3">PRODUCTION_DIRECTORY</span><span class="syntax-4"> .</span><span class="syntax-1"> '/arsol.linux.phar'</span><span class="syntax-2">, </span><span class="syntax-3">PRODUCTION_DIRECTORY</span><span class="syntax-4"> .</span><span class="syntax-1"> '/build/arsol.phar'</span><span class="syntax-2">, </span><span class="syntax-3">true</span><span class="syntax-2">);</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p>Il ne reste qu'à installer le fichier <code>tools/production/build/arsol.phar</code> sur le serveur, par exemple dans <code>/usr/bin/local/arsol</code>. On peut dès maintenant lancer la commande <code>arsol production:start</code> (notez le nom de l'exécutable 😎) pour initialiser et démarrer complètement l'infrastructure.</p>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p>
Si nous le voulions, nous pourrions également compiler ce phar dans un binaire statique contenant PHP, ce qui aurait éliminé le besoin d'avoir PHP installé sur le serveur pour pouvoir utiliser le projet repacké. N'hésitez pas à jeter un œil à la <a rel="nofollow noopener noreferrer" href="https://castor.jolicode.com/docs/going-further/extending-castor/compile/">documentation Castor qui explique comment compiler son projet</a>.</p>
        </div>
</div>

<p><picture class="js-dialog-target" data-original-url="/media/original/2026/on-premise-docker-castor/arsol-production-phar.png" data-original-width="1242" data-original-height="559"><source type="image/webp" srcset="/media/cache/content-webp/2026/on-premise-docker-castor/arsol-production-phar.d2bfb0f1.webp" /><source type="image/png" srcset="/media/cache/content/2026/on-premise-docker-castor/arsol-production-phar.png" /><img loading="lazy" decoding="async" style="width: 996px; ; aspect-ratio: calc(1242 / 559)" src="https://jolicode.com//media/cache/content/2026/on-premise-docker-castor/arsol-production-phar.png" alt="Les tasks disponibles dans l'exécutable arsol" /></picture></p>
<h2>Automatiser le build depuis Gitlab</h2>
<p>Dernière étape pour simplifier la vie du client, nous allons automatiser plusieurs choses directement depuis Gitlab :</p>
<ul>
<li>Le build des images Docker de prod et le push sur le registre Docker ;</li>
<li>Le repack du projet tools/production dans un phar autonome ;</li>
<li>Ajout de ce phar dans les artefacts associés du job pour le rendre facilement accessible.</li>
</ul>
<p>Voici un extrait du fichier <code>.gitlab-ci.yml</code> qui permet de faire cela :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">stages</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-10">  # ...</span></span>
<span class="line"><span class="syntax-2">  - </span><span class="syntax-1">release</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">variables</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">  CASTOR_CONTEXT</span><span class="syntax-2">: </span><span class="syntax-1">ci</span></span>
<span class="line"><span class="syntax-4">  CASTOR_WORKING_DIR</span><span class="syntax-2">: </span><span class="syntax-1">/tmp/castor/${CI_PIPELINE_ID}</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># ...</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">release</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">  stage</span><span class="syntax-2">: </span><span class="syntax-1">release</span></span>
<span class="line"><span class="syntax-4">  script</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">export TAG=$(date +%Y.%m.%d)</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">export RELEASE_DIRECTORY=/tmp/castor-release/${TAG}</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">rm -rf ${RELEASE_DIRECTORY}</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">git clone . ${RELEASE_DIRECTORY}</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">cd $RELEASE_DIRECTORY</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">echo "$CI_REGISTRY_PASSWORD" | docker login $CI_REGISTRY -u $CI_REGISTRY_USER --password-stdin</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">castor production:docker:build --push --update-docker-compose "$TAG" --force</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">castor production:repack</span></span>
<span class="line"><span class="syntax-10">    # On déplace le phar à la racine, pour qu'il soit exposé en tant qu'artefact du job</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">cp tools/production/build/arsol.phar "$CI_PROJECT_DIR/"</span></span>
<span class="line"><span class="syntax-10">    # On est sur un self-hosted runner donc on fait le ménage avant de terminer</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">castor docker:destroy --force</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-1">rm -rf $RELEASE_DIRECTORY</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10">  # Cet artefact sera associé au job, et donc facilement récupérable depuis GitLab</span></span>
<span class="line"><span class="syntax-4">  artifacts</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">    paths</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-2">      - </span><span class="syntax-1">arsol.phar</span></span>
<span class="line"><span class="syntax-4">    expire_in</span><span class="syntax-2">: </span><span class="syntax-1">1 week</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10">  # Ce job est à lancer manuellement et n'est disponible que sur la branche main</span></span>
<span class="line"><span class="syntax-4">  when</span><span class="syntax-2">: </span><span class="syntax-1">manual</span></span>
<span class="line"><span class="syntax-4">  allow_failure</span><span class="syntax-2">: </span><span class="syntax-3">true</span></span>
<span class="line"><span class="syntax-4">  rules</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-4">if</span><span class="syntax-2">: </span><span class="syntax-1">'$CI_COMMIT_BRANCH == "main"'</span></span>
<span class="line"><span class="syntax-4">      when</span><span class="syntax-2">: </span><span class="syntax-1">manual</span></span>
<span class="line"><span class="syntax-2">    - </span><span class="syntax-4">when</span><span class="syntax-2">: </span><span class="syntax-1">never</span></span></code></pre>
<p>Avant de finir cet article, je voudrais revenir sur un point vu précédemment. Vous vous souvenez de la variable <code>PROJECT_NAME</code> qui était employée pour préfixer le nom de l'image de la stack de dev ? C'était nécessaire justement quand la stack de prod est construite dans la CI GitLab.</p>
<p>En effet, comme nous utilisons un runner self-hosté, les jobs ne sont pas isolés et tournent sur la même machine en parallèle. Pour ne pas avoir de conflits dans les noms et avoir une stack Docker indépendante entre chaque build de la CI, nous avons donc besoin que les projets Docker compose utilisent un nom unique pour chaque build. Notre template docker-starter est parfaitement compatible avec ce use-case et expose une variable dans le contexte qui permet d'adapter le nom du projet Docker compose à notre guise :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-10">// castor.php à la racine du projet</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> create_default_variables</span><span class="syntax-2">()</span><span class="syntax-4">:</span><span class="syntax-4"> array</span></span>
<span class="line"><span class="syntax-2">{</span></span>
<span class="line"><span class="syntax-4">    return</span><span class="syntax-2"> [</span></span>
<span class="line"><span class="syntax-10">        // Nom du projet docker compose par défaut en local</span></span>
<span class="line"><span class="syntax-1">        'project_name'</span><span class="syntax-4"> =></span><span class="syntax-1"> 'arsol'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-10">        // ...</span></span>
<span class="line"><span class="syntax-2">    ];</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-10">// .castor/context.php</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">#[AsContext(name: </span><span class="syntax-1">'ci'</span><span class="syntax-2">)]</span></span>
<span class="line"><span class="syntax-5">function</span><span class="syntax-8"> create_ci_context</span><span class="syntax-2">()</span><span class="syntax-4">:</span><span class="syntax-5"> Context</span></span>
<span class="line"><span class="syntax-2">{</span></span>
<span class="line"><span class="syntax-2">    $pipelineId </span><span class="syntax-4">=</span><span class="syntax-2"> $_SERVER[</span><span class="syntax-1">'CI_PIPELINE_ID'</span><span class="syntax-2">] </span><span class="syntax-4">??</span><span class="syntax-4"> throw</span><span class="syntax-4"> new</span><span class="syntax-5"> \RuntimeException</span><span class="syntax-2">(</span><span class="syntax-1">'CI_PIPELINE_ID is not set. This context should only be used in a CI environment.'</span><span class="syntax-2">);</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-2">    $c </span><span class="syntax-4">=</span><span class="syntax-8"> create_test_context</span><span class="syntax-2">();</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">    return</span><span class="syntax-2"> $c</span></span>
<span class="line"><span class="syntax-4">        -></span><span class="syntax-8">withData</span><span class="syntax-2">([</span></span>
<span class="line"><span class="syntax-1">            'project_name'</span><span class="syntax-4"> =></span><span class="syntax-1"> 'arsol-ci-'</span><span class="syntax-4"> .</span><span class="syntax-2"> $pipelineId,</span></span>
<span class="line"><span class="syntax-1">            'docker_compose_files'</span><span class="syntax-4"> =></span><span class="syntax-2"> [</span></span>
<span class="line"><span class="syntax-1">                'docker-compose.yml'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-1">                'docker-compose.ci.yml'</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">            ],</span></span>
<span class="line"><span class="syntax-2">        ], recursive: </span><span class="syntax-3">false</span><span class="syntax-2">)</span></span>
<span class="line"><span class="syntax-2">    ;</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p>Comme nous forçons le context <code>CASTOR_CONTEXT=ci</code> dans GitLab, toutes les stacks construites dans cet environnement sont automatiquement nommées avec un suffixe qui reprend l'id de la pipeline actuelle.</p>
<p>Au passage, on rajoute un <code>docker-compose.ci.yml</code> au projet qui va rajouter quelques configurations spécifiques à la CI (comme des variables d'environnement ou un routeur adaptés)</p>
<h2>Conclusion</h2>
<p>Pour conclure, grâce au template docker-starter et à Castor, nous avons pu mettre en place un déploiement d'<em>ArSol</em> qui convient à la fois pour la production et le On-Premise mais qui reste simple à l'usage :</p>
<ul>
<li>Les images Docker pré-construites garantissent des déploiements fiables et déterministes ;</li>
<li>Les images sont optimisées pour ne contenir que ce qui est nécessaire, sans les outils de build ;</li>
<li>Tout passe par Castor, la complexité Docker/CI est masquée ;</li>
<li>Le <em>repack</em> Castor génère un seul exécutable (<code>arsol.phar</code>) pour tout gérer (démarrer, arrêter, mettre à jour) sur site, même sans être un expert système.</li>
</ul>
<p>L'automatisation complète via Castor et GitLab CI permet au client d'être autonome pour préparer et déployer une mise à jour pour tous les environnements. Une preuve que Docker et Castor sont la bonne formule pour transformer des contraintes de terrain en solutions d'infrastructure efficaces et élégantes.</p>]]></description></item><item><title>D&#xE9;ploiement On-Premise - Partie 1 - Le socle Docker</title><link>https://jolicode.com/blog/deploiement-on-premise-partie-1-le-socle-docker</link><author>JoliCode Team</author><date>Wed, 25 Mar 2026 10:41:00 +0100</date><description><![CDATA[<p>Dans cet article, nous vous expliquons notre approche de déploiement hybride pour une application Symfony conteneurisée avec Docker. Ce système permet un déploiement à la fois sur des serveurs connectés à Internet et en mode local (on-premise) pour les zones de travail sans connectivité réseau.</p>
<h2>Le contexte</h2>
<p>Nous avons récemment entrepris la refonte complète de l'application <em>ArSol</em> pour l'équipe archéologique de l'université de Tours. Le logiciel original, une application desktop, était obsolète. Nous l'avons entièrement modernisé en développant une application web sur mesure... avec une interface utilisateur considérablement rajeunie de plusieurs décennies propulsée avec Symfony 7.4, PHP 8.4 et FrankenPHP.</p>
<p>Une des particularités du projet, c'est que l'application peut être utilisée sur des lieux de fouilles archéologiques ne disposant pas de réseau. Pour plusieurs raisons, l'idée d'une <abbr title="Progressive Web App">PWA</abbr> a été écartée assez rapidement. Nous avons plutôt opté pour un mode de déploiement On-Premise : chaque site de fouille pourra ainsi faire tourner l'infrastructure complète (serveur web, bases de données et application Symfony) sur une machine locale. Les contraintes métiers nous ont permis de développer, sans trop de complexité, un système de verrouillage partiel de l'application (pour éviter tout conflit) et une synchronisation des données entre le <abbr title="Software as a Service">SaaS</abbr> (c'est-à-dire la production, le serveur central) et les instances On-Premise.</p>
<p><picture><source type="image/webp" srcset="/media/cache/content-webp/2026/on-premise-docker-castor/arsol-schema-onpremise.b3de4a68.webp" /><source type="image/png" srcset="/media/cache/content/2026/on-premise-docker-castor/arsol-schema-onpremise.png" /><img loading="lazy" decoding="async" style="width: 777px; ; aspect-ratio: calc(777 / 757)" src="https://jolicode.com//media/cache/content/2026/on-premise-docker-castor/arsol-schema-onpremise.png" alt="Le schéma des différentes instances" /></picture></p>
<p>Je vais vous montrer aujourd'hui comment nous avons mis en place ce déploiement On-Premise (que j'abrégerai <abbr title="On-Premise">OP</abbr> dans la suite de cet article). D'abord, nous verrons comment se présente la stack Docker, puis comment nous avons automatisé la création des images et le déploiement.</p>
<h2>La base Docker</h2>
<p>Pour ce projet, nous avons choisi de déployer l'application via des images Docker, aussi bien pour la production que pour les instances OP. Ainsi, ce sont les mêmes images Docker qui seront utilisées dans le mode SaaS et dans le mode OP. L’activation des différentes options et feature flags repose exclusivement sur des variables d’environnement.</p>
<h3>La stack de dev</h3>
<p>Sur tous nos projets, nous utilisons <a rel="nofollow noopener noreferrer" href="https://github.com/jolicode/docker-starter">docker-starter</a> et <em>ArSol</em> n'y a pas fait exception. Ce squelette fournit une stack Docker complète, avec tout ce qu'il faut dedans pour que chaque intervenant du projet puisse le faire tourner en local facilement.</p>
<p>Docker-starter s'est amélioré au fil des années pour offrir une excellente <abbr title="Developer eXperience">DX</abbr> à tous nos développeurs, qu'ils soient développeurs PHP ou intégrateurs, qu'ils soient à l'aise avec le fonctionnement de Docker ou pas du tout.</p>
<p>Pour cela, toute la stack est pilotée par des tasks Castor 🦫 :</p>
<ul>
<li><code>castor start</code> : construit les images si nécessaire, les démarre, installe les dépendances Composer/Yarn/npm, build les assets front, etc. Bref, cette seule commande suffit pour rendre le projet complètement fonctionnel en local, que ce soit au premier lancement ou aux lancements suivants ;</li>
<li><code>castor migrate</code> : joue les migrations Doctrine ;</li>
<li><code>castor stop</code> : stoppe toute la stack ;</li>
<li>et plein d'autres tasks pour les power users ou pour ceux qui veulent lancer une tâche particulière, par exemple ré-installer les dépendances, exécuter les tests, etc.</li>
</ul>
<p><strong>Cette infrastructure dockerisée est parfaite pour le développement</strong> :</p>
<ul>
<li>Les tâches castor fournies couvrent une bonne partie des besoins du quotidien ;</li>
<li>Le code du projet n'est pas copié/collé dans les conteneurs, mais &quot;monté&quot; dans des volumes pour chaque conteneur. Ainsi, les modifications dans le code sont directement disponibles dans les conteneurs, pas de build/restart à faire à chaque modification.</li>
</ul>
<h3>Comment passer en production ?</h3>
<p>Si Docker-starter est parfait pour l'environnement de développement, il ne doit toutefois pas être utilisé tel quel en production.</p>
<p>En production, la priorité est la fiabilité, la sécurité, la rapidité de déploiement et la reproductibilité de l'environnement. Contrairement à l'environnement de développement où le montage de volume permet l'itération rapide du code, en production, on cherche à minimiser les étapes au moment du déploiement.</p>
<p>Avoir des images pré-construites garantit que l'image qui a été testée et validée contient exactement le code, les dépendances (Composer, Yarn/npm) et les assets frontend nécessaires et compilées. Cela élimine le besoin d'exécuter des commandes de <em>build</em> ou d'installation au moment du lancement des conteneurs (sur les serveurs de production ou sur les instances On-Premise). Cela réduit ainsi le risque d'erreurs dues à des dépendances externes ou des configurations de l'environnement hôte. C'est la garantie d'un déploiement &quot;figé&quot; et déterministe.
D'ailleurs, comme les assets sont buildées en amont, nous n'avons pas besoin de NodeJS dans le conteneur final, ce qui permet également d'avoir des images plus légères in-fine.</p>
<p>L'objectif est d'avoir des images Docker prêtes pour la production, mais aussi utilisables pour la pré-production et le déploiement on-premise.</p>
<h3>L'important, c'est la santé</h3>
<p>Dans l'idéal, nous souhaitons également que chaque service définisse son propre <a rel="nofollow noopener noreferrer" href="https://docs.docker.com/reference/dockerfile/#healthcheck">healthcheck</a>. Un healthcheck est une commande que Docker pourra exécuter pour déterminer si le conteneur est toujours en bon état. Si ce n'est pas le cas, Docker tentera de redémarrer le conteneur. Voilà un exemple de healthcheck permettant de vérifier si un serveur MySQL est toujours opérationnel dans un conteneur :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">mysqladmin</span><span class="syntax-1"> ping</span><span class="syntax-3"> -h</span><span class="syntax-1"> localhost</span></span></code></pre>
<p>Il se configure de cette manière dans un docker-compose.yml classique:</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">services</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">  mysql</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">    image</span><span class="syntax-2">: </span><span class="syntax-1">"mysql"</span></span>
<span class="line"><span class="syntax-4">    restart</span><span class="syntax-2">: </span><span class="syntax-1">unless-stopped</span></span>
<span class="line"><span class="syntax-4">    healthcheck</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">      test</span><span class="syntax-2">: [</span><span class="syntax-1">"CMD"</span><span class="syntax-2">, </span><span class="syntax-1">"mysqladmin"</span><span class="syntax-2"> ,</span><span class="syntax-1">"ping"</span><span class="syntax-2">, </span><span class="syntax-1">"-h"</span><span class="syntax-2">, </span><span class="syntax-1">"localhost"</span><span class="syntax-2">]</span></span>
<span class="line"><span class="syntax-4">      timeout</span><span class="syntax-2">: </span><span class="syntax-1">20s</span></span>
<span class="line"><span class="syntax-4">      retries</span><span class="syntax-2">: </span><span class="syntax-3">10</span></span></code></pre>
<p>En général, je préfère que les images &quot;applicatives&quot; déclarent elles-mêmes leur healthcheck plutôt que de laisser l'utilisateur le définir lui-même dans son docker-compose.yml. Cela offre, selon moi, deux avantages :</p>
<ul>
<li>l'image garde la responsabilité de tout configurer comme il faut : l'utilisateur n'a pas besoin de savoir ce qui tourne dans l'image, comment vérifier que tout fonctionne (faut-il utiliser wget, curl ou un autre outil pour avoir l'état du service), etc ;</li>
<li>le docker-compose.yml reste le plus simple possible pour l'utilisateur.</li>
</ul>
<p>Cela se fait grâce à l'instruction <a rel="nofollow noopener noreferrer" href="https://docs.docker.com/reference/dockerfile/#healthcheck"><code>HEALTHCHECK</code></a> directement dans le dockerfile de l'image en question. Voici un exemple d'un healthcheck qu'on pourrait définir dans le Dockerfile pour un conteneur faisant tourner un serveur web :</p>
<pre><code>HEALTHCHECK --interval=5m --timeout=3s CMD curl -f http://localhost/ || exit 1
</code></pre>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p>
Certaines images publiques ne fournissent volontairement pas de healthcheck. Il faudra donc le configurer nous-même, soit dans une image à vous, soit dans le docker-compose.yml.</p>
        </div>
</div>

<h3>Publication et utilisation des images finales</h3>
<p>Une fois les images construites, il faut les publier sur un registre Docker pour les mettre à disposition des différents environnements cibles (que ce soit votre serveur de production, dans un Kubernetes, etc). Docker fournit un registre par défaut qui s'appelle Docker Hub. C'est sur ce service que Docker va chercher les images qu'il ne connaît pas encore localement (par exemple depuis un <code>FROM xxx</code> dans un Dockerfile ou depuis un docker-compose.yml). La plupart des systèmes de gestion de code comme GitHub ou GitLab fournissent également un registre de conteneur pour stocker de manière privée vos images Docker. Ces images, dans le cadre d'<em>ArSol</em>, sont stockées dans le registre GitLab du client.</p>
<p>Une fois que tout est prêt, nous obtenons le docker-compose.yml suivant (simplifié dans le cadre de cet article) :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">volumes</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">  postgres-data</span><span class="syntax-2">: {}</span></span>
<span class="line"><span class="syntax-4">  caddy_data</span><span class="syntax-2">: {}</span></span>
<span class="line"><span class="syntax-4">  caddy_config</span><span class="syntax-2">: {}</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">services</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">  frontend</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">    image</span><span class="syntax-2">: </span><span class="syntax-1">"&#x3C;url du registre>/arsol/frontend:2025.10.23"</span></span>
<span class="line"><span class="syntax-4">    restart</span><span class="syntax-2">: </span><span class="syntax-1">unless-stopped</span></span>
<span class="line"><span class="syntax-4">    env_file</span><span class="syntax-2">: </span><span class="syntax-1">.env</span></span>
<span class="line"><span class="syntax-4">    depends_on</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">      postgres</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">        condition</span><span class="syntax-2">: </span><span class="syntax-1">service_healthy</span></span>
<span class="line"><span class="syntax-4">      meilisearch</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">        condition</span><span class="syntax-2">: </span><span class="syntax-1">service_healthy</span></span>
<span class="line"><span class="syntax-4">    ports</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-2">      - </span><span class="syntax-1">"80:80"</span></span>
<span class="line"><span class="syntax-2">      - </span><span class="syntax-1">"443:443"</span></span>
<span class="line"><span class="syntax-2">      - </span><span class="syntax-1">"443:443/udp"</span></span>
<span class="line"><span class="syntax-4">    volumes</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-2">      - </span><span class="syntax-1">caddy_data:/data</span></span>
<span class="line"><span class="syntax-2">      - </span><span class="syntax-1">caddy_config:/config</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">  postgres</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">    image</span><span class="syntax-2">: </span><span class="syntax-1">"&#x3C;url du registre>/arsol/postgres:2025.10.23"</span></span>
<span class="line"><span class="syntax-4">    restart</span><span class="syntax-2">: </span><span class="syntax-1">unless-stopped</span></span>
<span class="line"><span class="syntax-4">    env_file</span><span class="syntax-2">: </span><span class="syntax-1">.env</span></span>
<span class="line"><span class="syntax-4">    volumes</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-2">      - </span><span class="syntax-1">postgres-data:/var/lib/postgresql/data</span></span>
<span class="line"><span class="syntax-4">    healthcheck</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">      test</span><span class="syntax-2">: [</span><span class="syntax-1">"CMD-SHELL"</span><span class="syntax-2">, </span><span class="syntax-1">"pg_isready -U app"</span><span class="syntax-2">]</span></span>
<span class="line"><span class="syntax-4">      interval</span><span class="syntax-2">: </span><span class="syntax-1">5s</span></span>
<span class="line"><span class="syntax-4">      timeout</span><span class="syntax-2">: </span><span class="syntax-1">5s</span></span>
<span class="line"><span class="syntax-4">      retries</span><span class="syntax-2">: </span><span class="syntax-3">5</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">  worker-messenger</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">    image</span><span class="syntax-2">: </span><span class="syntax-1">"&#x3C;url du registre>/arsol/worker-messenger:2025.10.23"</span></span>
<span class="line"><span class="syntax-4">    restart</span><span class="syntax-2">: </span><span class="syntax-1">unless-stopped</span></span>
<span class="line"><span class="syntax-4">    env_file</span><span class="syntax-2">: </span><span class="syntax-1">.env</span></span>
<span class="line"><span class="syntax-4">    depends_on</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">      frontend</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">          condition</span><span class="syntax-2">: </span><span class="syntax-1">service_healthy</span></span>
<span class="line"><span class="syntax-4">      postgres</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">        condition</span><span class="syntax-2">: </span><span class="syntax-1">service_healthy</span></span></code></pre>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p>
Les volumes pour caddy sont importants pour permettre la génération automatique des certificats SSL.</p>
        </div>
</div>

<p>Vous noterez que nous avons spécifié, pour chaque image, un tag basé sur une date (en l'occurrence <code>2025.10.23</code>). En effet, quand Docker a déjà récupéré un tag pour une image donnée, il ne cherchera pas à la mettre à jour à moins de nettoyer les images locales (ou à moins de forcer le <em>pull</em> avec l'option <code>docker run --pull=always</code>). Si on utilisait un tag fixe (comme <code>latest</code> par exemple), les images ne seraient jamais mises à jour sur la machine, quand bien même le tag en question aurait changé sur le registre pour cibler une nouvelle version.</p>
<p>Une fois le docker-compose.yml configuré, et le fichier <code>.env</code> créé, nous pouvons lancer <code>docker compose -f docker-compose.yml up -d</code>, et voilà 🎉 : l'infrastructure de production est opérationnelle en HTTP et HTTPS.</p>
<p>La seule différence pour mettre en place une instance OP sera le contenu du <code>.env</code> pour activer/désactiver certaines fonctionnalités spécifiques à ce mode (comme les écrans pour déclencher la synchronisation avec le SaaS, ou la désactivation des données des autres sites archéologiques). Et pour déployer une nouvelle version, il nous faut construire et taguer une nouvelle version de nos images, mettre à jour le docker-compose.yml pour utiliser la bonne version des images et relancer la commande <code>docker compose</code>.</p>
<p>Maintenant que l'objectif est clair, voyons en détails comment y parvenir.</p>
<h2>Construction des images</h2>
<p>Ici, nous voulons construire toutes les images Docker nécessaires pour faire tourner le projet. À cette étape, nous devons considérer deux cas, suivant si nous utilisons des images publiques telles quelles ou s'il s'agit de nos propres images spécifiques à <em>ArSol</em>.</p>
<h3>Images publiques</h3>
<p>Dans un premier temps, parlons des images publiques que nous utilisons telles quelles (comme pour Postgres ou Meilisearch). Nous pourrions réutiliser ces images présentes sur le Docker Hub. Mais à la place, nous allons plutôt taguer ces images avec notre système de tag et les pousser sur notre propre registre Docker. Cela apporte plusieurs avantages :</p>
<ul>
<li>toutes les images du projet utilisent le même tag (plus simple pour s'y retrouver) ;</li>
<li>le projet n'est dépendant que d'un seul registre Docker, celui du client.</li>
</ul>
<p>Pour celles-ci, nous allons simplement créer un nouveau tag sur les images en question et les publier sur notre registre Docker privé :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-10"># Tag de l'image</span></span>
<span class="line"><span class="syntax-8">docker</span><span class="syntax-1"> image</span><span class="syntax-1"> tag</span><span class="syntax-4"> &#x3C;</span><span class="syntax-1">le</span><span class="syntax-1"> nom</span><span class="syntax-1"> de</span><span class="syntax-1"> l'image>:&#x3C;la version de l'imag</span><span class="syntax-2">e</span><span class="syntax-4">></span><span class="syntax-4"> &#x3C;</span><span class="syntax-1">url</span><span class="syntax-1"> du</span><span class="syntax-1"> registr</span><span class="syntax-2">e</span><span class="syntax-4">></span><span class="syntax-1">/arsol/</span><span class="syntax-4">&#x3C;</span><span class="syntax-1">le</span><span class="syntax-1"> nom</span><span class="syntax-1"> de</span><span class="syntax-1"> l'image chez nous>:&#x3C;la version de l'applicati</span><span class="syntax-2">f</span><span class="syntax-4">></span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># Publication de l'image sur le registre</span></span>
<span class="line"><span class="syntax-8">docker</span><span class="syntax-1"> image</span><span class="syntax-1"> push</span><span class="syntax-3"> --disable-content-trust</span><span class="syntax-4"> &#x3C;</span><span class="syntax-1">url</span><span class="syntax-1"> du</span><span class="syntax-1"> registr</span><span class="syntax-2">e</span><span class="syntax-4">></span><span class="syntax-1">/arsol/</span><span class="syntax-4">&#x3C;</span><span class="syntax-1">le</span><span class="syntax-1"> nom</span><span class="syntax-1"> de</span><span class="syntax-1"> l'image chez nous>:&#x3C;la version de l'applicati</span><span class="syntax-2">f</span><span class="syntax-4">></span></span></code></pre>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p>
Ici, nous n'allons pas utiliser le système de signature des images, donc nous désactivons la validation des images côté registre en utilisant l'option <code>--disable-content-trust</code>.</p>
        </div>
</div>

<p>Par exemple, pour meilisearch, cela nous donnerait quelque comme cela pour publier le tag &quot;daté&quot; ainsi que le tag <code>latest</code> :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">docker</span><span class="syntax-1"> image</span><span class="syntax-1"> tag</span><span class="syntax-1"> getmeili/meilisearch:v1.16</span><span class="syntax-4"> &#x3C;</span><span class="syntax-1">url</span><span class="syntax-1"> du</span><span class="syntax-1"> registr</span><span class="syntax-2">e</span><span class="syntax-4">></span><span class="syntax-1">:4567/plancq/arsol/meilisearch:2025.10.23</span></span>
<span class="line"><span class="syntax-8">docker</span><span class="syntax-1"> image</span><span class="syntax-1"> tag</span><span class="syntax-1"> getmeili/meilisearch:v1.16</span><span class="syntax-4"> &#x3C;</span><span class="syntax-1">url</span><span class="syntax-1"> du</span><span class="syntax-1"> registr</span><span class="syntax-2">e</span><span class="syntax-4">></span><span class="syntax-1">:4567/plancq/arsol/meilisearch:latest</span></span>
<span class="line"><span class="syntax-8">docker</span><span class="syntax-1"> image</span><span class="syntax-1"> push</span><span class="syntax-3"> --disable-content-trust</span><span class="syntax-4"> &#x3C;</span><span class="syntax-1">url</span><span class="syntax-1"> du</span><span class="syntax-1"> registr</span><span class="syntax-2">e</span><span class="syntax-4">></span><span class="syntax-1">:4567/plancq/arsol/meilisearch:2025.10.23</span></span>
<span class="line"><span class="syntax-8">docker</span><span class="syntax-1"> image</span><span class="syntax-1"> push</span><span class="syntax-3"> --disable-content-trust</span><span class="syntax-4"> &#x3C;</span><span class="syntax-1">url</span><span class="syntax-1"> du</span><span class="syntax-1"> registr</span><span class="syntax-2">e</span><span class="syntax-4">></span><span class="syntax-1">:4567/plancq/arsol/meilisearch:latest</span></span></code></pre>
<p>Nous pouvons maintenant utiliser cette image directement dans notre docker-compose.yml.</p>
<h3>Images applicatives</h3>
<p>En revanche, pour les images avec PHP (frontend et worker) contenant le code de l'application, les dépendances &amp; cie, c'est un peu plus compliqué comme nous allons le voir.</p>
<h4>La stack de dev comme base</h4>
<p>Nous allons nous servir des images de la stack de dev comme base pour nos images de production. En effet, dans Docker-starter, nos images customs suivent déjà plusieurs bonnes pratiques, notamment pour optimiser leur poids :</p>
<ul>
<li>les instructions RUN sont regroupées le plus possible pour réduire le nombre de couches de l'image (layer squashing) ;</li>
<li>un nettoyage immédiat du cache et des fichiers temporaires est fait pour chaque commande afin de diminuer la taille de chaque layer, et donc le poids final de l'image ;</li>
<li>le build &quot;multi-stage&quot; est utilisé pour ne pas inclure les outils de dev dans l'image finale (composer, nodejs, yarn, etc) mais uniquement dans une image <em>builder</em> utilisée quand il y a besoin de ces outils.</li>
</ul>
<p>Pour la production, nous allons appliquer la même logique. Nous créerons donc un <code>Dockerfile</code> unique avec plusieurs stages qui nous donnera les différentes images finales à construire, mais en partant des différentes images de dev pour éviter d'avoir à dupliquer et maintenir une autre installation de PHP dans la bonne version, avec les bonnes extensions, configurer FrankenPHP et caddy, etc.</p>
<p>Voyons à quoi ressemble ce Dockerfile dans les grandes lignes.</p>
<h4>Le builder et la préparation de l'application</h4>
<p>En premier, nous définissons un stage &quot;builder&quot;, qui se base sur notre builder de dev et va faire toutes les étapes nécessaires pour installer le projet (installations composer et yarn, construction des assets, etc) :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">ARG</span><span class="syntax-2"> PROJECT_NAME</span></span>
<span class="line"><span class="syntax-4">FROM</span><span class="syntax-2"> ${PROJECT_NAME}-builder </span><span class="syntax-4">AS</span><span class="syntax-2"> production-builder</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">ENV</span><span class="syntax-2"> APP_ENV=prod</span></span>
<span class="line"><span class="syntax-4">ENV</span><span class="syntax-2"> COMPOSER_MIRROR_PATH_REPOS=1</span></span>
<span class="line"><span class="syntax-4">ENV</span><span class="syntax-2"> NODE_ENV=production</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># C'est dans ce dossier que nous allons travailler</span></span>
<span class="line"><span class="syntax-4">WORKDIR</span><span class="syntax-2"> /var/www</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># On récupère les fichiers composer.json et composer.lock et on lance Composer</span></span>
<span class="line"><span class="syntax-4">COPY</span><span class="syntax-2"> composer.* /var/www/</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">RUN</span><span class="syntax-2"> composer install \</span></span>
<span class="line"><span class="syntax-2">    --no-dev \</span></span>
<span class="line"><span class="syntax-2">    --prefer-dist \</span></span>
<span class="line"><span class="syntax-2">    --no-scripts \</span></span>
<span class="line"><span class="syntax-2">    --no-interaction \</span></span>
<span class="line"><span class="syntax-2">    &#x26;&#x26; composer clear-cache</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># Pareil pour Yarn</span></span>
<span class="line"><span class="syntax-4">COPY</span><span class="syntax-2"> package.json yarn.lock .yarnrc.yml /var/www/</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">RUN</span><span class="syntax-2"> yarn install --immutable</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># On récupère le reste des fichiers</span></span>
<span class="line"><span class="syntax-4">COPY</span><span class="syntax-2"> . /var/www/</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># Et enfin, on lance toutes les tasks nécessaires pour avoir l'application opérationnelle </span></span>
<span class="line"><span class="syntax-4">RUN</span><span class="syntax-2"> composer dump-autoload --optimize \</span></span>
<span class="line"><span class="syntax-2">    &#x26;&#x26; yarn run build \</span></span>
<span class="line"><span class="syntax-2">    &#x26;&#x26; bin/console cache:warmup \</span></span>
<span class="line"><span class="syntax-2">    &#x26;&#x26; bin/console assets:install public --relative \</span></span>
<span class="line"><span class="syntax-2">    &#x26;&#x26; rm -rf node_modules</span></span></code></pre>
<p>Plusieurs choses sont à noter ici. Déjà, vous remarquez que nous mentionnons un argument de build <code>PROJECT_NAME</code> pour préfixer le nom de l'image de base. Nous verrons dans le prochain article pourquoi c'est nécessaire. Dites vous dans un premier temps que la variable a comme valeur <code>arsol</code>, ce qui correspond au nom du projet Docker compose de la stack de dev en local.</p>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p>
J'ai voulu dissocier le Dockerfile de la stack de dev du Dockerfile de la stack de prod, d'où la nécessité de pouvoir référencer l'image de la stack de dev. Si nous avions mergé les deux Dockerfile, nous n'aurions pas eu besoin de cette variable <code>PROJECT_NAME</code>.</p>
        </div>
</div>

<p>Ensuite, vous vous demandez peut-être la raison pour laquelle nous effectuons l'installation de Composer et Yarn <strong>avant</strong> de <code>COPY</code> le code et l'ensemble des fichiers de l'application. Cette approche permet de tirer parti du cache de couches : Docker commence la construction en vérifiant le cache pour la première instruction et, en cas de correspondance, il réutilise la couche et passe à l'instruction suivante. Mais si une instruction invalide le cache (par exemple, un <code>COPY</code> avec un fichier modifié), toutes les instructions suivantes seront exécutées sans utiliser le cache, ce qui ralentit la construction. Étant donné que les dépendances sont moins sujettes à changement que le code, il est plus probable que les étapes d'installation de Composer et Yarn soient réutilisées depuis le cache, car elles précèdent l'opération de <code>COPY</code> du code.</p>
<p>On peut maintenant préparer le stage docker qui contiendra uniquement php et les outils nécessaires pour le runtime (FrankenPHP, Caddy, etc), en se basant sur l'image du conteneur frontend :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">ARG</span><span class="syntax-2"> PROJECT_NAME</span></span>
<span class="line"><span class="syntax-4">FROM</span><span class="syntax-2"> ${PROJECT_NAME}-frontend </span><span class="syntax-4">AS</span><span class="syntax-2"> production-php-base</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">WORKDIR</span><span class="syntax-2"> /var/www</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># Symfony tournera dans son env prod</span></span>
<span class="line"><span class="syntax-4">ENV</span><span class="syntax-2"> APP_ENV=prod</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># On récupère le code de l'application, ses dépendances et assets depuis le stage builder vu précédemment</span></span>
<span class="line"><span class="syntax-4">COPY</span><span class="syntax-2"> --from=production-builder /var/www /var/www</span></span></code></pre>
<p>Il faut bien faire attention à ce qui est inclus dans les conteneurs. C'est pour cette raison que nous allons créer un <code>Dockerfile.gitignore</code> au même niveau que le <code>Dockerfile</code> du projet. On retire tout ce qui n'est pas nécessaire, comme les dépendances ou les assets qui auraient été installées/construites dans votre stack de dev :</p>
<pre><code>.castor/
.castor.stub.php
.env.local
.env.ci
*.cache
.git/
.idea/
.home/
.yarn/
doc/
infrastructure/
!infrastructure/docker/services/php-production/
tests/
tools/
node_modules/
var/
vendor/
public/assets/
public/build/
public/bundles/
public/media/
!public/media/.gitkeep
</code></pre>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p>
Après réflexion, on aurait peut-être mieux fait de tout bloquer par défaut et ne lister que ce qu'il fallait garder (src, config, public, etc). 😝</p>
        </div>
</div>

<h4>Frontend et worker</h4>
<p>Maintenant que nous avons un stage avec l'application opérationnelle, nous allons pouvoir construire les images finales pour notre projet. Voilà l'image qui se base sur le stage construit ci-dessus :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">FROM</span><span class="syntax-2"> production-php-base </span><span class="syntax-4">AS</span><span class="syntax-2"> production-frontend</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># Mise en place d'un entrypoint qui s'occupera d'initialiser l'application</span></span>
<span class="line"><span class="syntax-4">COPY</span><span class="syntax-2"> infrastructure/docker/services/php-production/entrypoint-frontend.sh /entrypoint.sh</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># Configuration de Caddy</span></span>
<span class="line"><span class="syntax-4">COPY</span><span class="syntax-2"> infrastructure/docker/services/php-production/etc/. /etc/</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">RUN</span><span class="syntax-2"> [</span><span class="syntax-1">"chmod"</span><span class="syntax-2">, </span><span class="syntax-1">"+x"</span><span class="syntax-2">, </span><span class="syntax-1">"/entrypoint.sh"</span><span class="syntax-2">]</span></span>
<span class="line"><span class="syntax-4">ENTRYPOINT</span><span class="syntax-2"> [</span><span class="syntax-1">"/entrypoint.sh"</span><span class="syntax-2">]</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># Indique les ports utilisés par ce conteneur </span></span>
<span class="line"><span class="syntax-4">EXPOSE</span><span class="syntax-2"> 80</span></span>
<span class="line"><span class="syntax-4">EXPOSE</span><span class="syntax-2"> 443</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-10"># Commande qui sera exécutée dans le conteneur</span></span>
<span class="line"><span class="syntax-4">CMD</span><span class="syntax-2"> [ </span><span class="syntax-1">"frankenphp"</span><span class="syntax-2">, </span><span class="syntax-1">"run"</span><span class="syntax-2">, </span><span class="syntax-1">"--config"</span><span class="syntax-2">, </span><span class="syntax-1">"/etc/caddy/Caddyfile"</span><span class="syntax-2">, </span><span class="syntax-1">"--adapter"</span><span class="syntax-2">, </span><span class="syntax-1">"caddyfile"</span><span class="syntax-2">]</span></span></code></pre>
<p>Nous avons défini un entrypoint pour ce conteneur. Lors du démarrage de ce dernier, il permet d'initialiser toute la partie data (schéma SQL, migrations Doctrine à jouer, configuration du transport pour Messenger, indexation des données dans Meilisearch). Cela est rendu possible car nous n'aurons toujours qu'une seule instance de ce conteneur en production (aucun pic de trafic à gérer). Si ce n'est pas votre cas, il faudra peut-être adapter cette technique.</p>
<p>Voilà à quoi ressemble cet entrypoint :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-10">#!/bin/bash</span></span>
<span class="line"><span class="syntax-9">set</span><span class="syntax-3"> -e</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-9">echo</span><span class="syntax-1"> "Updating all databases..."</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-8">php</span><span class="syntax-1"> bin/console</span><span class="syntax-1"> doctrine:database:create</span><span class="syntax-3"> --if-not-exists</span><span class="syntax-3"> --env=prod</span><span class="syntax-3"> --no-interaction</span></span>
<span class="line"><span class="syntax-8">php</span><span class="syntax-1"> bin/console</span><span class="syntax-1"> doctrine:migrations:sync-metadata-storage</span><span class="syntax-3"> --env=prod</span><span class="syntax-3"> --no-interaction</span></span>
<span class="line"><span class="syntax-8">php</span><span class="syntax-1"> bin/console</span><span class="syntax-1"> doctrine:migrations:migrate</span><span class="syntax-3"> --env=prod</span><span class="syntax-3"> --no-interaction</span></span>
<span class="line"><span class="syntax-8">php</span><span class="syntax-1"> bin/console</span><span class="syntax-1"> messenger:setup-transports</span><span class="syntax-3"> --env=prod</span><span class="syntax-3"> --no-interaction</span></span>
<span class="line"><span class="syntax-8">php</span><span class="syntax-1"> bin/console</span><span class="syntax-1"> app:meilisearch:index</span><span class="syntax-3"> --env=prod</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-9">echo</span><span class="syntax-1"> "Ready to start the frontend service."</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-9">exec</span><span class="syntax-1"> "</span><span class="syntax-12">$@</span><span class="syntax-1">"</span></span></code></pre>
<p>Enfin, il ne nous manque plus que le stage qui permettra de construire l'image faisant tourner le conteneur pour le worker Messenger :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">FROM</span><span class="syntax-2"> production-php-base </span><span class="syntax-4">AS</span><span class="syntax-2"> production-worker-messenger</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">RUN</span><span class="syntax-2"> apt-get update \</span></span>
<span class="line"><span class="syntax-2">    &#x26;&#x26; apt-get install -y --no-install-recommends \</span></span>
<span class="line"><span class="syntax-2">        procps \</span></span>
<span class="line"><span class="syntax-2">    &#x26;&#x26; apt-get clean \</span></span>
<span class="line"><span class="syntax-2">    &#x26;&#x26; rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-4">CMD</span><span class="syntax-2"> [</span><span class="syntax-1">"php"</span><span class="syntax-2">, </span><span class="syntax-1">"-d"</span><span class="syntax-2">, </span><span class="syntax-1">"memory_limit=-1"</span><span class="syntax-2">, </span><span class="syntax-1">"bin/console"</span><span class="syntax-2">, </span><span class="syntax-1">"messenger:consume"</span><span class="syntax-2">, </span><span class="syntax-1">"-vv"</span><span class="syntax-2">, </span><span class="syntax-1">"async"</span><span class="syntax-2">]</span></span></code></pre>
<p>Ici, on note l'installation de <code>procps</code> qui fournit le binaire pgrep, utile pour vérifier si le processus qui fait tourner le worker est toujours actif. Il sera employé dans le healthcheck de ce service :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-4">services</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">  worker-messenger</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-10">    # ...</span></span>
<span class="line"><span class="syntax-4">    healthcheck</span><span class="syntax-2">:</span></span>
<span class="line"><span class="syntax-4">      test</span><span class="syntax-2">: [</span><span class="syntax-1">"CMD-SHELL"</span><span class="syntax-2">, </span><span class="syntax-1">"pgrep -f </span><span class="syntax-3">\"</span><span class="syntax-1">messenger:consume</span><span class="syntax-3">\"</span><span class="syntax-1"> || exit 1"</span><span class="syntax-2">]</span></span>
<span class="line"><span class="syntax-4">      interval</span><span class="syntax-2">: </span><span class="syntax-1">5s</span></span>
<span class="line"><span class="syntax-4">      timeout</span><span class="syntax-2">: </span><span class="syntax-1">5s</span></span>
<span class="line"><span class="syntax-4">      retries</span><span class="syntax-2">: </span><span class="syntax-3">5</span></span></code></pre>
<p>Grâce au multi-stage de Docker, nous avons ainsi pu construire toutes nos images utilisant PHP dans un même Dockerfile.</p>
<h4>A table !</h4>
<p>Maintenant que nos images peuvent être construites, il va nous falloir les taguer puis les envoyer sur le registre. On pourrait lancer les mêmes commandes <code>docker image tag|push</code> vues précédemment. Mais à la place, on va simplifier et automatiser le processus grâce à <a rel="nofollow noopener noreferrer" href="https://docs.docker.com/build/bake/">Bake</a>.</p>
<p>Cet outil permet de définir l'ensemble des cibles de build dans un fichier de configuration (<code>bake.hcl</code> par exemple) et de les construire/pousser en une seule commande. Voici un extrait de ce à quoi ressemble notre fichier bake :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-6">group</span><span class="syntax-2"> "default" {</span></span>
<span class="line"><span class="syntax-2">  targets </span><span class="syntax-4">=</span><span class="syntax-2"> [</span></span>
<span class="line"><span class="syntax-1">    "frontend"</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-1">    "worker-messenger"</span><span class="syntax-2">,</span></span>
<span class="line"><span class="syntax-2">  ]</span></span>
<span class="line"><span class="syntax-2">}</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-6">target</span><span class="syntax-2"> "frontend" {</span></span>
<span class="line"><span class="syntax-2">  context    </span><span class="syntax-4">=</span><span class="syntax-1"> "."</span></span>
<span class="line"><span class="syntax-2">  dockerfile </span><span class="syntax-4">=</span><span class="syntax-1"> "./infrastructure/docker/services/php-production/Dockerfile"</span></span>
<span class="line"><span class="syntax-2">  target     </span><span class="syntax-4">=</span><span class="syntax-1"> "production-frontend"</span></span>
<span class="line"><span class="syntax-2">}</span></span>
<span class="line"></span>
<span class="line"><span class="syntax-6">target</span><span class="syntax-2"> "worker-messenger" {</span></span>
<span class="line"><span class="syntax-2">  context    </span><span class="syntax-4">=</span><span class="syntax-1"> "."</span></span>
<span class="line"><span class="syntax-2">  dockerfile </span><span class="syntax-4">=</span><span class="syntax-1"> "./infrastructure/docker/services/php-production/Dockerfile"</span></span>
<span class="line"><span class="syntax-2">  target     </span><span class="syntax-4">=</span><span class="syntax-1"> "production-worker-messenger"</span></span>
<span class="line"><span class="syntax-2">}</span></span></code></pre>
<p>Avec ce fichier, il ne nous reste qu'à lancer la commande suivant pour construire les images, les tagger et les envoyer au registre docker :</p>
<pre class="syntax-0" tabindex="0"><code><span class="line"><span class="syntax-8">docker</span><span class="syntax-1"> buildx</span><span class="syntax-1"> bake</span><span class="syntax-3"> --file</span><span class="syntax-1"> bake.hcl</span><span class="syntax-3"> --push</span></span></code></pre>

<div class="c-alert c-alert--note">
    <p class="c-alert__title">
                    <span class="c-icon c-icon--monospace">
                <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="c-icon__svg" focusable="false" viewBox="0 0 70 71"><path fill-rule="nonzero" d="M35 .9c19.3 0 35 15.7 35 35s-15.7 35-35 35-35-15.7-35-35S15.7.9 35 .9m0 5c-16.552 0-30 13.449-30 30s13.448 30 30 30c16.552.103 30-13.448 30-30 0-16.551-13.448-30-30-30m0 24.9c1.7 0 3 1.3 3 3v15.3c0 1.7-1.3 3-3 3s-3-1.3-3-3V33.8c0-1.7 1.3-3 3-3m0-11c.8 0 1.6.3 2.3.9.6.5.9 1.3.9 2.1 0 .2-.1.4-.1.6-.1.2-.1.4-.2.6s-.2.3-.3.5-.3.4-.4.5c-1.1 1.1-3.1 1.1-4.2 0-.2-.2-.3-.3-.4-.5s-.2-.3-.3-.5-.2-.4-.2-.6c-.1-.2-.1-.4-.1-.6 0-.8.3-1.6.9-2.1.5-.6 1.3-.9 2.1-.9"/></svg>
            </span>
                        <strong>Info</strong>
    </p>
    <div class="c-alert__content">
                <p>
Malheureusement, Bake n'a pas l'air de permettre de juste taguer des images existantes, donc nous ne pourrons pas l'utiliser pour remplacer les <code>docker image tag|push</code> des images publiques.</p>
        </div>
</div>

<p>Nos images sont maintenant disponibles sur le registre du client :</p>
<p><picture><source type="image/webp" srcset="/media/cache/content-webp/2026/on-premise-docker-castor/arsol-docker-registry.f99c2888.webp" /><source type="image/png" srcset="/media/cache/content/2026/on-premise-docker-castor/arsol-docker-registry.png" /><img loading="lazy" decoding="async" style="width: 869px; ; aspect-ratio: calc(869 / 550)" src="https://jolicode.com//media/cache/content/2026/on-premise-docker-castor/arsol-docker-registry.png" alt="Les images disponibles sur le registre GitLab" /></picture></p>
<h2>Conclusion</h2>
<p>Nous avons vu dans cet article une bonne partie des étapes qui nous permettent de construire les images Docker dont nous aurons besoin pour faire tourner l'application dans tous nos environnements.</p>
<p>Je n'en ai pas parlé jusque-là mais il reste quelques points de sécurité à garder en tête avant de mettre en production cette infrastructure (comme les capabilities Docker ou encore les logs générés par Docker Compose qui peuvent vite remplir le disque par défaut en cas de fort trafic).</p>
<p>Le client devant être autonome pour déployer les prochaines évolutions de l'application, nous ne nous sommes pas arrêtés là. Nous avons donc mis en place tout un ensemble de task Castor permettant d'automatiser la création et la publication des images, ainsi que de simplifier le pilotage de la stack dans les différents environnements. Mais nous verrons tout cela dans le prochain article.</p>]]></description></item><item><title>Le signal d'alarme est tir&#xE9; &#xE0; l'AFUP</title><link>https://afup.org/news/1254-signal-dalarme-tire-a-lafup</link><author/><date>Tue, 17 Mar 2026 06:09:00 +0100</date><description><![CDATA[<h3>Plusieurs signaux nous alarment</h3>
<p>Ce sont plusieurs sonnettes d’alarme qui ont déclenché une vague d’inquiétude au sein de l’équipe. Tout d’abord, depuis janvier, plusieurs de nos sponsors historiques nous ont annoncé l'impossibilité de débloquer des budgets cette année. Nous avons perdu 40% de nos financements pour l’AFUP Day 2026 par rapport à 2025. D'autres événements techniques annoncent également leurs difficultés.
Du côté des billetteries de l'AFUP Day 2026, elles affichent un retard de 50% par rapport à la même période en 2025. Et ce ne sont pas que les événements qui sont touchés ! Même la participation à l’<a href="https://barometre.afup.org">enquête 2026 du baromètre des salaires PHP</a>, un outil construit pour et par la communauté, accuse un net recul par rapport à la même période en 2025.</p>
<h3>Quel impact pour l’AFUP ?</h3>
<p>Le sponsoring et la billetterie sont nos seules sources de financement pour l’organisation de nos événements. Sans le soutien de l’écosystème, c’est l’existence même de nos événements sous le format que vous connaissez qui est en péril. Qu'est-ce que ça veut dire concrètement ? Soyons clairs : sans soutien significatif dans les prochaines semaines, nous serons contraints de revoir sérieusement le budget du Forum PHP 2026, en particulier les conditions d’accueil et la variété du programme.</p>
<h3>Pourquoi nous aider ?</h3>
<p>Nos conférences sont des parenthèses précieuses : celles où vous retrouvez vos pair·e·s, où vous progressez grâce à d'autres devs qui partagent la même passion. Celles où vous croisez un futur membre de votre équipe, où vous ressentez cet esprit communautaire bienveillant et convivial qui nous est si cher. Ne laissons pas disparaître ces occasions d'être ensemble, de s'émerveiller, d'échanger et de grandir collectivement. La diffusion des savoirs PHP, la valorisation de nos métiers, les espaces d'échange et de montée en compétences : tout cela repose sur votre engagement. </p>
<h3>Comment nous aider ?</h3>
<p>L'AFUP, c'est une poignée de bénévoles passionné·e·s. Ce qui nous fait tenir ? Vous. La communauté. Le sens de ce qu'on construit ensemble. Sans cet écosystème, porté par les devs, les entreprises PHP, les partenaires, il n'y a plus d'AFUP.
Alors si vous pensiez prendre vos places pour l'AFUP Day 2026, <a href="http://event.afup.org">inscrivez-vous</a> maintenant ! Vous envisagiez de sponsoriser l'AFUP Day ou le Forum PHP ? <a href="https://afup.org/become-sponsor">Parlons-en</a> aujourd'hui. Votre adhésion est à renouveler ? <a href="https://afup.org/association/devenir-membre">Faites-le</a> ! Chaque action est importante, et nous montre votre soutien à l’association.</p>
<p><strong>Merci à celles et ceux qui sont déjà là. Et à tous les autres qui vont se manifester : on compte sur vous. Pour que la diffusion des savoirs en PHP continue, et ce encore longtemps.</strong></p>]]></description></item><item><title>Installer et configurer Caddy 2 avec certificat SSL pour tous vos sous-domaines</title><link>https://blog.eleven-labs.com/fr/caddy-wildcard-dns-challenge/</link><author/><date>Wed, 11 Mar 2026 01:00:00 +0100</date><description><![CDATA[<div><p>Suite aux offres OVH VPS 2026 j'ai décidé de migrer mon vieux Digital Ocean toujours bloqué sur une debian 12.
J'aime héberger mes différents services en utilisant des containers et en mettant un reverse proxy devant.
Sur mon ancienne configuration j'utilisais Traefik, pour changer un peu j'ai décidé que c'était l'occasion de tester Caddy.</p>
<p>J'ai cherché un peu de doc afin de le configurer correctement (notamment la partie wildcard avec dns challenge) et je n'ai pas trouvé d'article récent parlant de ce sujet, du coup je vous partage mon expérience en espérant pouvoir vous aider :)</p>
<p><strong>Attention, j'utilise la version Docker de Caddy, mais vous pouvez tout de même suivre cet article si vous l'avez installé directement sur votre système !</strong></p>
<p><strong>Prérequis</strong> :</p>
<ul>
<li>Avoir installé Caddy version 2 (&gt;2.10.0 pour ne pas avoir à ajouter l'option <code>auto_https prefer_wildcard</code> plus de détails <a href="https://github.com/caddyserver/caddy/releases/tag/v2.10.0" target="_blank">ici</a>) via Docker ou directement.</li>
<li>Au niveau de votre provider dns avoir déjà redirigé vos domaines sur votre serveur, cela inclut votre domain de base + le wildcard de votre domain, donc par exemple avoir un enregistrement du type <code>*.example.com IN A 1.1.1.1</code> (où <code>1.1.1.1</code> correspond à l'ip de votre serveur) si vous utilisez ovh vous pouvez vous référer à cette <a href="https://help.ovhcloud.com/csm/fr-dns-edit-dns-zone?id=kb_article_view&amp;sysparm_article=KB0051684" target="_blank">doc</a></li>
</ul>
<h2>Trouver le bon plugin</h2>
<p>La première étape est de trouver son provider DNS dans le repository suivant : <a href="https://github.com/caddy-dns" target="_blank">https://github.com/caddy-dns</a></p>
<p>J'utilise personnellement ovh. Pour la suite de l'article ce sera donc : <a href="https://github.com/caddy-dns/ovh" target="_blank">https://github.com/caddy-dns/ovh</a></p>
<h2>Installer le plugin</h2>
<p>Il faut maintenant ajouter le plugin à Caddy :</p>
<p>Installation direct : <code>xcaddy build --with github.com/caddy-dns/ovh</code></p>
<p>Pour Docker on va créer un dossier par exemple dans notre home : <code>mkdir -p ~/caddy/config</code> (le dossier config vous sera utile juste après)</p>
<p>Ensuite créer un Dockerfile avec le contenu suivant dans notre dossier <code>~/caddy</code> :</p>
<pre><code>FROM caddy:builder AS builder

RUN --mount=type=cache,target=/go/pkg/mod \
    --mount=type=cache,target=/root/.cache/go-build \
    xcaddy build \
    --with github.com/caddy-dns/ovh

FROM caddy:latest

COPY --from=builder /usr/bin/caddy /usr/bin/caddy
</code></pre>
<h2>Préparer le Caddyfile</h2>
<p>Exemple de Caddyfile à utiliser (pour une installation via Docker le placer dans le path suivant : <code>~/caddy/config/Caddyfile</code> il sera utilisé par le <code>compose.yaml</code> plus tard) :</p>
<pre><code>{
    debug
}

*.example.com, example.com {
    tls {
        dns ovh {
            endpoint {$OVH_ENDPOINT}
            application_key {$OVH_APPLICATION_KEY}
            application_secret {$OVH_APPLICATION_SECRET}
            consumer_key {$OVH_CONSUMER_KEY}
        }
    }
    # default handle
    handle {
      respond "it works !"
    }
}
</code></pre>
<p>(n'oubliez pas de remplacer <code>example.com</code> par votre nom de domaine)</p>
<p>Les variables d'environnement nécessaires à la configuration d'OVH seront renseignées dans les chapitres suivants.</p>
<p><strong>Attention, ici j'ai pris l'exemple de configurations pour ovh, veillez à la remplacer par celle de votre provider que vous trouverez dans le README du repository <a href="https://github.com/caddy-dns" target="_blank">https://github.com/caddy-dns</a> de votre provider.</strong></p>
<h2>Trouver les identifiants du provider OVH</h2>
<p>Afin de trouver les informations requises par Let's Encrypt pour communiquer et gérer nos enregistrements DNS OVH le README nous indique qu'il va falloir aller créer une application (avec accès API) à notre compte OVH.</p>
<p>La documentation Caddy nous redirige vers ce lien : <a href="https://github.com/libdns/ovh#authenticating" target="_blank">https://github.com/libdns/ovh#authenticating</a></p>
<p>Qui ensuite nous mène ici : <a href="https://github.com/ovh/go-ovh#supported-apis" target="_blank">https://github.com/ovh/go-ovh#supported-apis</a></p>
<p>L'idée est de trouver quelle est notre OVH région afin de suivre le lien "Create script credentials (all keys at once)".</p>
<p>La mienne étant Europe, je vais donc suivre <a href="https://eu.api.ovh.com/createToken/" target="_blank">https://eu.api.ovh.com/createToken/</a></p>
<p>Authentifiez-vous à votre compte OVH et vous devriez arriver sur cette page :</p>
<p></p>
<p>Vous allez remplir le formulaire de la manière suivante :</p>
<p></p>
<p>Si vous avez un doute référez vous à la page que j'ai indiqué précédemment : <a href="https://github.com/libdns/ovh#authenticating" target="_blank">https://github.com/libdns/ovh#authenticating</a> . Je vous conseille de suivre la configuration pour un simple domaine, mais si vous avez vocation à laisser votre Caddy gérer plusieurs domaines différents, alors vous devriez suivre la configuration pour multiple domaines !</p>
<p>Une fois enregistré, n'oubliez pas de sauvegarder les informations suivantes (<strong>Attention, vous ne pourrez plus accéder à ces informations par la suite</strong>) :</p>
<ul>
<li><strong>application key</strong></li>
<li><strong>application secret</strong></li>
<li><strong>consumer key</strong></li>
</ul>
<p>Nous allons les utiliser dès maintenant !</p>
<h2>Ajouter les identifiants du provider OVH</h2>
<p>Si vous avez installé Caddy directement alors modifiez les info dans votre Caddyfile.</p>
<p>Si vous avez utilisé Docker je vous conseille de fournir ces infos via un <code>compose.yaml</code> :</p>
<pre><code>services:
  caddy:
    build: .
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./conf:/etc/caddy
      - ./site:/srv
      - caddy_data:/data
      - caddy_config:/config
    environment:
      OVH_ENDPOINT: "ovh-eu"
      OVH_APPLICATION_KEY: "votre-application-key"
      OVH_APPLICATION_SECRET: "votre-application-secret"
      OVH_CONSUMER_KEY: "votre-consumer-key"

volumes:
  caddy_data:
  caddy_config:
</code></pre>
<h2>Conclusion</h2>
<p>Le moment de vérité est arrivé !
Relancez Caddy pour qu'il prenne en compte votre nouvelle configuration</p>
<p>Sans Docker :
<code>sudo systemctl restart caddy</code></p>
<p>Avec Docker :
<code>sudo docker compose up -d &amp;&amp; sudo docker compose logs -f</code></p>
<p>Rendez-vous sur votre nom de domaine et vous devriez voir la phrase "it works !" ainsi qu'un certificat tls !</p>
<p>Si vous voulez tester un sous domain, rien de plus simple.</p>
<p>Ajoutez le bloc suivant à votre Caddyfile (en modifiant bien <code>subdomain.example.com</code> par votre nom de domaine et le sous domain désiré)</p>
<pre><code>@subdomain host subdomain.example.com
handle @subdomain: {
  respond "subdomain works !"
}
</code></pre>
<p>Dans le bloc précédemment ajouté, entre le bloc <code>tls</code> et l'instruction <code>handle</code></p>
<p>Relancez Caddy via les commandes suivantes :</p>
<p>Sans Docker :
<code>sudo systemctl reload caddy</code></p>
<p>Avec Docker :
<code>sudo docker compose exec -w /etc/caddy caddy caddy reload</code></p>
<p>Si vous avez une erreur sur le formattage de votre fichier Caddy vous pouvez utiliser la commande suivante :
<code>sudo docker compose exec -w /etc/caddy caddy caddy fmt --override</code></p>
<p>Puis reload Caddy.</p>
<p>Et allez tester votre sous-domaine :)</p>
<p>Have fun !</p>
<h2>Liens utiles</h2>
<ul>
<li><a href="https://caddyserver.com/docs/automatic-https#wildcard-certificates" target="_blank">https://caddyserver.com/docs/automatic-https#wildcard-certificates</a></li>
<li><a href="https://caddyserver.com/docs/caddyfile/patterns#wildcard-certificates" target="_blank">https://caddyserver.com/docs/caddyfile/patterns#wildcard-certificates</a></li>
<li><a href="https://caddyserver.com/docs/automatic-https#dns-challenge" target="_blank">https://caddyserver.com/docs/automatic-https#dns-challenge</a></li>
<li><a href="https://caddy.community/t/how-to-use-dns-provider-modules-in-caddy-2/8148" target="_blank">https://caddy.community/t/how-to-use-dns-provider-modules-in-caddy-2/8148</a></li>
<li><a href="https://github.com/caddy-dns/ovh" target="_blank">https://github.com/caddy-dns/ovh</a></li>
<li><a href="https://github.com/libdns/ovh#authenticating" target="_blank">https://github.com/libdns/ovh#authenticating</a></li>
<li><a href="https://github.com/ovh/go-ovh#supported-apis" target="_blank">https://github.com/ovh/go-ovh#supported-apis</a></li>
</ul></div>]]></description></item><item><title>Les plannings de l'AFUP Day 2026 sont sortis</title><link>https://afup.org/news/1253-planning-afupday2026-sortis</link><author/><date>Tue, 03 Mar 2026 07:04:00 +0100</date><description><![CDATA[<h3>Les 4 plannings sont disponibles</h3>
<p>Ce matin du 3 mars 2026 ont été publiés les déroulés du vendredi 22 mai à Bordeaux, Lille, Lyon et Paris. Découvrez comment s'enchaineront les conférences dans chaque ville, et ainsi prévoyez votre venue, que vous viviez à proximité de la salle ou que vous deviez réserver un train. Retrouvez les plannings de l'<a href="https://event.afup.org/afup-day-2026/afup-day-2026-bordeaux/planning/">AFUP Day 2026 Bordeaux</a>, de l'<a href="https://event.afup.org/afup-day-2026/afup-day-2026-lille/planning/">AFUP Day 2026 Lille</a>, de l'<a href="https://event.afup.org/afup-day-2026/afup-day-2026-lyon/planning/">AFUP Day 2026 Lyon</a> et de l'<a href="https://event.afup.org/afup-day-2026/afup-day-2026-paris/planning/">AFUP Day 2026 Paris</a> !</p>
<h3>Prenez votre place et profitez du weekend de 3 jours.</h3>
<p>Les 4 éditions ont dévoilé des programmes de qualité, techniques et variés, portés par des expert·e·s dans leur domaine : la communauté répond à l'appel ! L'édition parisienne est d'ailleurs déjà complète. Prenez vite vos places à Bordeaux, Lille et Lyon avant qu'il ne soit trop tard.
Pour info, l'AFUP Day 2026 est suivi du lundi de Pentecôte : l'occasion de prolonger votre séjour et de profiter d'un weekend de tourisme.
<strong>Pas de place pour l'édition parisienne ? </strong>Nous avons quelques tickets réservés pour nos sponsors, <a href="mailto:bonjour@afup.org">contactez-nous</a> pour en savoir plus. Une <a href="https://afup.org/event/afupday2026paris/tickets">liste d'attente</a> est également disponible, au cas où des billets viendraient à se libérer.</p>]]></description></item><item><title>L'enqu&#xEA;te 2026 du barom&#xE8;tre des salaires en PHP 2026 est lanc&#xE9;e !</title><link>https://afup.org/news/1252-enquete-barometre-salaires-php-2026</link><author/><date>Mon, 02 Mar 2026 06:30:00 +0100</date><description><![CDATA[<h3>Appel à toutes et tous : faites entendre votre voix</h3>
<p>Développeuses et développeurs PHP, responsables d’équipe ou de projet, architectes, dirigeant·e·s, juniors comme seniors, salarié·e·s ou freelances, autodidactes ou issu·e·s de formation : votre expérience compte. <a href="https://barometre.afup.org">Partagez des informations</a> sur votre parcours, votre entreprise, votre quotidien professionnel et votre rémunération afin d’éclairer l’évolution des salaires et des conditions de travail dans un secteur aujourd’hui sous tension.
Dans un contexte où le marché de l'emploi des devs en France traverse une période agitée, recueillir des données fiables et actuelles est plus essentiel que jamais. L’édition 2025 avait déjà mobilisé 721 participant·e·s ; poursuivons cet effort collectif pour disposer d’un panorama précis et utile à toute la profession.
Comme chaque année, les résultats publiés en fin d’année offriront une photographie détaillée du secteur. Les devs pourront s’appuyer sur cette analyse pour valoriser leurs compétences, tandis que les entreprises disposeront d’un référentiel objectif pour mieux accompagner les carrières de leurs équipes.</p>
<h3>Des repères solides et un focus renforcé sur l’IA générative</h3>
<p>Les questions historiques qui ont fait la réputation du baromètre sont bien entendu reconduites : niveau de rémunération, satisfaction professionnelle, localisation et taille de l’entreprise, technologies utilisées, frameworks, versions de PHP, formation, management… Autant d’indicateurs essentiels pour suivre l’évolution du secteur dans la durée.
Mais fidèle à sa vocation d’observatoire des tendances, l’enquête 2026 approfondit également l’un des sujets majeurs du moment : l’intelligence artificielle générative. De nouvelles questions viennent compléter celles introduites l’an dernier afin de mieux comprendre ses usages concrets, son impact sur les pratiques de développement et la manière dont les équipes PHP s’en emparent.</p>
<h3>À propos du baromètre des salaires en PHP</h3>
<p>Chaque année, plusieurs centaines de professionnelles et professionnels contribuent anonymement à cette étude en quelques minutes. L’objectif est de recueillir un maximum de réponses d’ici au 2 juin 2026, date de clôture de l’enquête, afin d’établir un état des lieux précis qui bénéficiera à toute la communauté lors de sa publication en fin d’année , un rendez-vous devenu incontournable notamment à l’approche des entretiens annuels.</p>
<p>Répondez à l’<a href="https://barometre.afup.org">enquête</a>, anonymement et en quelques minutes, avant le 2 juin 2026 : votre participation est essentielle pour comprendre et défendre l’avenir de notre écosystème. Et si vous souhaitez mieux comprendre la situation actuelle du marché, consultez les résultats de l’édition 2025 pour situer votre profil et mesurer les évolutions récentes.</p>]]></description></item><item><title>Rejoignez la communaut&#xE9; pour le Super Ap&#xE9;ro PHP 2026</title><link>https://afup.org/news/1251-rejoignez-communaute-superaperophp2026</link><author/><date>Tue, 24 Feb 2026 07:22:00 +0100</date><description><![CDATA[<p>Notez la date : le Super Apéro PHP 2026 se tiendra le soir du mercredi 11 mars.  Dès 18h30, dans les antennes AFUP participantes, la communauté PHP est conviée à une soirée mêlant conférences courtes, discussions, rencontres et, bien sûr, un apéro convivial. Quel que soit le programme imaginé par votre antenne locale, attendez-vous à un moment bienveillant avec les devs de votre région : une belle occasion de se retrouver, d’échanger, d’apprendre et de célébrer ensemble le langage qui nous rassemble.</p>
<p>Découvrez ce que vous réservent les antennes AFUP participantes sur la page du <a href="https://afup.org/superapero">Super Apéro PHP 2026</a> et inscrivez-vous sans tarder : certains lieux ont une capacité limitée !</p>
<p>Votre antenne AFUP n’a pas encore communiqué d’informations ? Pas d’inquiétude, certaines finalisent encore leur programme. Revenez consulter la page dans les prochains jours ! Et si votre antenne semble en sommeil depuis quelque temps, pourquoi ne pas saisir l’occasion pour la relancer ? Faites-nous signe si l’aventure vous tente.</p>]]></description></item><item><title>Boring technology: les bases de donn&#xE9;es relationnelles</title><link>https://www.jdecool.fr/blog/2026/02/18/boring-technology-les-bases-de-donnees-relationnelles.html</link><author/><date>Wed, 18 Feb 2026 00:00:00 +0100</date><description><![CDATA[<p><a href="/blog/2026/02/12/savoir-jusqu-ou-utiliser-les-boring-technologies.html">La semaine dernière, j’évoquais les « boring technologies » et le fait qu’elles soient sous-cotées</a> dans l’esprit collectif. Les bases de données relationnelles et le langage SQL en sont probablement l’exemple le plus courant. Très largement utilisées dans les projets nécessitant de stocker des informations, elles sont pourtant régulièrement boudées par les développeurs au premier problème.</p>

<!--more-->

<div class="linkedin-post" style="background-color: var(--linkedin-bg, #fff3cd); color: var(--linkedin-text, #856404); padding: 1rem; margin: 1rem 0; border: 1px solid var(--linkedin-border, #ffeeba); border-radius: 0.5rem; text-align: center;">
    <strong>Ce billet a été initialement publié sur LinkedIn</strong><br />
    <a href="https://www.linkedin.com/posts/jdecool_la-semaine-derni%C3%A8re-j%C3%A9voquais-les-boring-activity-7427336081718603777-Batv?utm_source=share&amp;utm_medium=member_desktop&amp;rcm=ACoAAAKq5-4BZAcC_zglQex0GjSf3UmQDPMiUUw" target="_blank" rel="noopener" style="color: var(--linkedin-link, #0066cc);">Voir la publication originale</a><br />
    <small>Cette dernière est republiée ici afin de ne pas dépendre entièrement d'une plateforme tierce.</small>
</div>

<p>C’est le constat que je fais depuis plusieurs années et la cause est que de moins en moins de développeurs en maîtrisent le fonctionnement ou ne connaissent réellement le langage SQL. Je ne pense pas que cela soit réellement dû à un manque d’intérêt, je pense surtout que les frameworks et les ORM que nous utilisons au quotidien ont leur part de responsabilité.</p>

<p>De nombreuses couches d’abstraction sont conçues de manière générique pour permettre d’interchanger rapidement et simplement le système relationnel. Cela se fait au détriment des fonctionnalités avancées, des optimisations spécifiques ou des mécanismes évolués permettant d’améliorer drastiquement les performances de nos applications (colonnes générées, gestion des vues, index partiels, CTE, requêtes récursives, partitionnement, …).</p>

<p>Cela ne se remarque pas à charge ou volumétrie réduite. Mais dès que l’on change un peu d’échelle, c’est là que les problèmes commencent. Les temps de réponse se dégradent, les performances chutent et si l’on ne s’intéresse pas à ce qu’il se passe sous le capot du SGBD, cela devient très compliqué de s’en sortir.</p>

<p>Les ORM ne sont pas le problème. Ce sont des outils très pratiques qui permettent de gagner du temps. Mais eux aussi, il convient de les maîtriser pour optimiser les requêtes générées et savoir comment tirer parti des fonctionnalités avancées des bases de données. La plupart d’entre eux ont des couches « bas niveau » et permettent généralement de faire des requêtes SQL directement et éventuellement de « mapper » la réponse dans des objets.</p>

<p>Comme je le dis régulièrement, il est essentiel, voire indispensable, de s’attacher aux fondamentaux, de comprendre et maîtriser les outils que l’on utilise. Le langage SQL et le fonctionnement des bases de données en font partie. C’est ainsi que l’on peut se donner les moyens de construire des applications qui tiennent la charge sur le long terme sans multiplier les technologies.</p>
]]></description></item><item><title>L'AFUP Day 2026 Paris annonce complet</title><link>https://afup.org/news/1250-afupday-2026-paris-complet</link><author/><date>Tue, 17 Feb 2026 22:19:00 +0100</date><description><![CDATA[<h3>Un événement très attendu par la communauté</h3>
<p>La communauté parisienne a répondu à l'appel de l'AFUP Paris, elle qui attendait avec impatience le retour d'un cycle de conférences AFUP dans Paris intra-muros depuis que le Forum PHP s'est installé à Disneyland Paris. L'annonce du sold-out plus de 3 mois avant le jour J ne nous a donc pas surpris, mais elle déçoit certainement quelques devs qui espéraient bien rejoindre la communauté le vendredi 22 mai prochain. Que faire si vous n'avez pas eu de place ? </p>
<h3>Option 1 : l'inscription sur liste d'attente</h3>
<p>Une <a href="https://afup.org/event/afupday2026paris/tickets">liste d'attente</a> est disponible. Indiquez vos nom, prénom et adresse email : si certaines places venaient à se libérer (par exemple, si une personne inscrite nous informe qu'elle ne pourra finalement pas être présente à l'événement), nous contacterons les personnes sur liste d'attente, dans l'ordre chronologique d'inscription. Et si cela peut sembler comme un coup de poker, il est fréquent que nous redistribuions des places par ce biais !</p>
<h3>Option 2 : devenez sponsor de l'événement</h3>
<p>Nous avons de côté un petit quota de places réservé aux sponsors de l'événement : si vous souhaitez soutenir l'AFUP Day 2026, sachez qu'il vous sera également possible de profiter de quelques billets en complément de votre sponsoring. Vous pourrez ainsi convier vos équipes à la journée de partage de connaissances que vous soutenez. Avec des offres de sponsoring démarrant à 900€HT pour les entreprises et 250€HT pour les devs et freelances, c'est une option qui peut se révéler intéressante ! <a href="https://afup.org/event/afupday2026paris/sponsor/become-sponsor">Téléchargez</a> le dossier de sponsoring et contactez-nous pour en savoir plus. </p>
<h3>Option 3 : nous rejoindre à Lille, Lyon et Bordeaux</h3>
<p>Certes, le programme de l'édition parisienne est alléchant : mais avez-vous regardé ce qui vous attend le 22 mai à Lille, Lyon ou Bordeaux ? Ce sont des sélections tout aussi intéressantes et prestigieuses qui vous attendent. Et profitez-en pour passer un weekend de 3 jours dans l'une de ces villes, le lundi suivant étant ferié.</p>
<p>Bravo à l'équipe de l'AFUP Paris, qui prépare dans l'ombre ce rassemblement pour la communauté PHP, et rendez-vous le vendredi 22 mai à l'ESGI pour la communauté parisienne !</p>]]></description></item><item><title>Simplifier vos objets immuables avec PHP 8.5</title><link>https://www.jdecool.fr/blog/2026/02/16/simplifier-vos-objets-immuables-avec-php-8-5.html</link><author/><date>Mon, 16 Feb 2026 00:00:00 +0100</date><description><![CDATA[<p>PHP 8.5 a été publié le 20 novembre 2025 et, dans les nouvelles fonctionnalités proposées par cette version, on trouve notamment la possibilité de mettre à jour des propriétés lors du clonage d’objets. Une amélioration qui va permettre de simplifier nos objets immuables.</p>

<!--more-->

<p>En programmation orientée objet, un objet immuable est un objet dont l’état ne peut pas être modifié après sa création. Ainsi, toute “modification” visant à changer l’état de ce dernier conduit à la création d’une nouvelle instance avec les valeurs mises à jour. Cela représente un réel avantage, car leur état ne changeant jamais, les effets de bord et bugs liés à des modifications inattendues de l’objet sont ainsi limités.</p>

<p>Avant PHP 8.5, la modification d’un objet immuable pouvait s’avérer fastidieuse, car il était nécessaire de créer une nouvelle instance avec les nouvelles valeurs. Cela pouvait être d’autant plus contraignant si l’objet avait de nombreuses propriétés.</p>

<p>Par exemple:</p>

<figure class="highlight"><pre><code class="language-php" data-lang="php">readonly class GPSLocation
{
    public function __construct(
        public float $latitude,
        public float $longitude,
        public float $altitude,
        public DateTimeImmutable $timestamp,
    ) {
    }

    public function withCoordinates(float $latitude, float $longitude): GPSLocation
    {
        return new GPSLocation(
            $latitude,
            $longitude,
            $this-&gt;altitude,
            $this-&gt;timestamp,
        );
    }

    public function withAltitude(float $altitude): GPSLocation
    {
        return new GPSLocation(
            $this-&gt;latitude,
            $this-&gt;longitude,
            $altitude,
            $this-&gt;timestamp,
        );
    }
}</code></pre></figure>

<p>PHP 8.5 nous permet de simplifier cette opération en permettant de cloner l’objet tout en autorisant de mettre à jour certaines propriétés lors du clonage. Seules les propriétés devant être modifiées doivent être précisées:</p>

<figure class="highlight"><pre><code class="language-php" data-lang="php">readonly class GPSLocation
{
    public function __construct(
        public float $latitude,
        public float $longitude,
        public float $altitude,
        public DateTimeImmutable $timestamp,
    ) {
    }

    public function withCoordinates(float $latitude, float $longitude): GPSLocation
    {
        return clone($this, [
            &#39;latitude&#39; =&gt; $latitude,
            &#39;longitude&#39; =&gt; $longitude,
        ]);
    }

    public function withAltitude(float $altitude): GPSLocation
    {
        return clone($this, [
            &#39;altitude&#39; =&gt; $altitude,
        ]);
    }
}</code></pre></figure>

]]></description></item></channel></rss>
