Doc/article by Arthurlbc · Pull Request #1 · Arthurlbc/Mapping-with-php

Arthurlbc · 2025-03-21T13:44:21Z

No description provided.

bobby-ar · 2025-03-21T14:28:18Z

doc/article.md

+
+J’aimerais vous présenter une autre alternative :
+
+**Méconnu mais pourtant si pratique**, plein d’avantages, mais ayant certains prérequis, le mapping Doctrine avec PHP est un outil qui m’a personnellement beaucoup plu. C’est dans le cadre d’un projet **from scratch**, avec un découpage en oignon permettant une séparation claire des responsabilités en trois couches distinctes, que nous avons choisi d’utiliser le mapping Doctrine avec PHP.


Suggested change

**Méconnu mais pourtant si pratique**, plein d’avantages, mais ayant certains prérequis, le mapping Doctrine avec PHP est un outil qui m’a personnellement beaucoup plu. C’est dans le cadre d’un projet **from scratch**, avec un découpage en oignon permettant une séparation claire des responsabilités en trois couches distinctes, que nous avons choisi d’utiliser le mapping Doctrine avec PHP.

**Méconnu mais pourtant si pratique**, plein d’avantages, mais ayant certains prérequis, le mapping Doctrine avec PHP est une technique qui m’a personnellement beaucoup plu. C’est dans le cadre d’un projet **from scratch**, avec un découpage du code en oignon permettant une séparation claire des responsabilités en trois couches distinctes, que nous avons choisi d’utiliser le mapping Doctrine avec PHP.

bobby-ar · 2025-03-21T14:29:24Z

doc/article.md

+    public function __construct(
+    /** @ORM\Column(type="string", length=255) */
+    private string $name
+    ){}


Suggested change

public function __construct(

/** @ORM\Column(type="string", length=255) */

private string $name

){}

public function __construct(

/** @ORM\Column(type="string", length=255) */

private string $name

){}

bobby-ar · 2025-03-21T14:30:00Z

doc/article.md

+Même classe représentant notre modèle du domaine :  
+```php
+class User {
+    protected int $id;


Suggested change

protected int $id;

protected ?int $id;

j'ai rendu le retour de getId() non nullable plutôt.

bobby-ar · 2025-03-21T14:31:29Z

doc/article.md

+## Inconvénients :
+
+- La prise en main.
+- Cela peut paraître verbeux à première vue.


à préciser car c'est aussi l'inconvénient de l'autre méthode

bobby-ar · 2025-03-21T14:34:03Z

doc/article.md

+- La prise en main.
+- Cela peut paraître verbeux à première vue.
+
+Comme vu sur les écrans, nous pouvons créer une entité qui étend notre modèle. Ensuite, **Doctrine** nous fournit tous les outils nécessaires pour créer notre mapping. Je conseille tout de même d’abstraire cette logique via des services personnalisé qui seront la seul partie du code a modifier en cas de changement d'ORM. Je vous invite à consulter la classe **ClassMetaData** de Doctrine et la classe **ClassMetaDataBuilder**. L’une permet de charger votre entité et l’autre de construire votre mapping.


Suggested change

Comme vu sur les écrans, nous pouvons créer une entité qui étend notre modèle. Ensuite, **Doctrine** nous fournit tous les outils nécessaires pour créer notre mapping. Je conseille tout de même d’abstraire cette logique via des services personnalisé qui seront la seul partie du code a modifier en cas de changement d'ORM. Je vous invite à consulter la classe **ClassMetaData** de Doctrine et la classe **ClassMetaDataBuilder**. L’une permet de charger votre entité et l’autre de construire votre mapping.

Comme vu sur les écrans, nous pouvons créer une entité qui étend notre modèle. Ensuite, **Doctrine** nous fournit tous les outils nécessaires pour créer notre mapping. Je conseille tout de même d’abstraire cette logique via des services personnalisés qui seront la seul partie du code à modifier en cas de changement d'ORM. Je vous invite à consulter la classe **ClassMetaData** de Doctrine et la classe **ClassMetaDataBuilder**. L’une permet de charger votre entité et l’autre de construire votre mapping.

louislebrault

C'est simple et concis, c'est cool.

Je suis pas fan d'autant d'utilisation des pronoms possessifs (j'aimerais, je, nous, notre, etc...), je pense que le sujet pourrait etre amené de facon moins subjective, plus neutre.

louislebrault · 2025-04-04T12:19:56Z

doc/article.md

+
+**Méconnu mais pourtant si pratique**, plein d’avantages, mais avec certains prérequis, le mapping Doctrine avec PHP est une technique qui m’a personnellement beaucoup plu. C’est dans le cadre d’un projet **from scratch**, avec un découpage du code en oignon permettant une séparation claire des responsabilités en trois couches distinctes, que nous avons choisi d’utiliser le mapping Doctrine avec PHP.
+
+L’architecture choisie a pour but de séparer la partie métier pure des dépendances et interactions que peut avoir l’application. Ainsi, notre projet n’est pas fortement dépendant des modifications (non-maintenance ou suppression des librairies utilisées).


la vulgarisation est un peu maladroite et je pense que ça rend pas service au sujet principale de l'article que de tergiverser sur ce genre de considération complexe, le mapping des entités avec doctrine peut etre présenté comme une bonne pratique en dehors du contexte d'une archi hexagonale non ?

louislebrault · 2025-04-04T12:20:53Z

doc/article.md

+- Sépare le modèle du domaine (classe **PHP** "pure") de son mapping dans l’infrastructure: Pas de dépendances dans notre logique métier.
+- Cela permet une implémentation plus concise et logique.
+- Nous évitons aussi la nécessité d’un troisième fichier de mapping, ce qui simplifie la structure du projet.
+- **Testable !**


louislebrault · 2025-04-04T12:21:32Z

doc/article.md

+
+## Inconvénients :
+
+- La prise en main.


un peu flou pour moi ce qu'on entend par "prise en main"

louislebrault · 2025-04-04T12:22:56Z

doc/article.md

+## Inconvénients :
+
+- La prise en main.
+- Cela peut paraître complexe à première vue.


C'est très subjectif, on peut peut-etre plutot evoquer les criteres objectifs qui peuvent amener a considerer que l'approche est complexe.

louislebrault · 2025-04-04T12:23:26Z

doc/article.md

+- La prise en main.
+- Cela peut paraître complexe à première vue.
+
+Comme vu sur les exemples, nous pouvons créer une entité qui étend notre modèle. Ensuite, **Doctrine** nous fournit tous les outils nécessaires pour créer notre mapping. Je vous invite à consulter la classe **ClassMetaData** de Doctrine et la classe **ClassMetaDataBuilder**. L’une permet de charger votre entité et l’autre de construire votre mapping.


ajouter des liens vers le repo de doctrine vers les classes concernées ?

louislebrault · 2025-04-04T12:25:07Z

doc/article.md

+            ->build();
+```
+
+Je conseille tout de même d’abstraire cette logique via des services personnalisés qui seront la seule partie du code a modifier en cas de changement d'ORM.


Il vaudrait mieux en ce cas utilisé des exemples de cas qui ne sont pas déconseillés imho. Dans quel cas cette approche est-elle utile ?

louislebrault · 2025-04-04T12:26:14Z

doc/article.md

+
+## Conclusion
+
+L’adoption de l’architecture hexagonale et du découpage en oignon, couplée à Doctrine, nous a permis d’organiser notre code de manière claire et évolutive. En séparant la logique métier des dépendances externes, nous gagnons en maintenabilité et en testabilité. De plus, le mapping PHP permet d’être couvert par des outils d'analyse statique comme **PHPStan**.


notion d'archi hexagonale hors sujet et dessert le propos imo

fix

4fff86f

Arthurlbc force-pushed the doc/article branch from f054654 to 30beb94 Compare March 21, 2025 14:18

update article

e27c804

Arthurlbc force-pushed the doc/article branch from 30beb94 to e27c804 Compare March 21, 2025 14:18

bobby-ar reviewed Mar 21, 2025

View reviewed changes

fix: Bobby's review

d1f3627

Arthurlbc requested a review from bobby-ar March 21, 2025 15:03

louislebrault reviewed Apr 4, 2025

View reviewed changes

fix: Louis's review and update makefile and readme

5143623

Arthurlbc requested a review from louislebrault April 7, 2025 06:56

doc: add image

b1202f0

Arthurlbc marked this pull request as ready for review June 19, 2025 12:30


		J’aimerais vous présenter une autre alternative :

		Méconnu mais pourtant si pratique, plein d’avantages, mais ayant certains prérequis, le mapping Doctrine avec PHP est un outil qui m’a personnellement beaucoup plu. C’est dans le cadre d’un projet from scratch, avec un découpage en oignon permettant une séparation claire des responsabilités en trois couches distinctes, que nous avons choisi d’utiliser le mapping Doctrine avec PHP.


		Méconnu mais pourtant si pratique, plein d’avantages, mais avec certains prérequis, le mapping Doctrine avec PHP est une technique qui m’a personnellement beaucoup plu. C’est dans le cadre d’un projet from scratch, avec un découpage du code en oignon permettant une séparation claire des responsabilités en trois couches distinctes, que nous avons choisi d’utiliser le mapping Doctrine avec PHP.

		L’architecture choisie a pour but de séparer la partie métier pure des dépendances et interactions que peut avoir l’application. Ainsi, notre projet n’est pas fortement dépendant des modifications (non-maintenance ou suppression des librairies utilisées).


		## Conclusion

		L’adoption de l’architecture hexagonale et du découpage en oignon, couplée à Doctrine, nous a permis d’organiser notre code de manière claire et évolutive. En séparant la logique métier des dépendances externes, nous gagnons en maintenabilité et en testabilité. De plus, le mapping PHP permet d’être couvert par des outils d'analyse statique comme PHPStan.

Conversation

Arthurlbc commented Mar 21, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

louislebrault left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants