From 8dad10defb49ff7576b8eceec297f12cf9a2de5c Mon Sep 17 00:00:00 2001
From: Vincent Amstoutz <vincent.amstoutz@les-tilleuls.coop>
Date: Fri, 6 Dec 2024 10:38:11 +0100
Subject: [PATCH] docs(external-vocabularies): compatibility with laravel

---
 core/external-vocabularies.md | 57 ++++++++++++++++++++++-------------
 1 file changed, 36 insertions(+), 21 deletions(-)

diff --git a/core/external-vocabularies.md b/core/external-vocabularies.md
index 3abf7cf5449..593430fa891 100644
--- a/core/external-vocabularies.md
+++ b/core/external-vocabularies.md
@@ -7,8 +7,8 @@ API Platform provides attributes usable on PHP classes and properties for specif
 
 ```php
 <?php
-// api/src/Entity/Book.php
-namespace App\Entity;
+// api/src/ApiResource/Book.php with Symfony or app/ApiResource/Book.php with Laravel
+namespace App\ApiResource;
 
 use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\ApiResource;
@@ -52,22 +52,37 @@ The generated JSON for products and the related context document will now use ex
 
 An extended list of existing open vocabularies is available on [the Linked Open Vocabularies (LOV) database](https://lov.linkeddata.es/dataset/lov/).
 
-By default, when using [validations](validation.md) API Platform will try to define known [Schema.org](https://schema.org) types as IRIs for your properties if you did not provide any in your `#[ApiProperty]` attributes.
-Built-in mapping is:
-
-| Constraints                                          | Schema.org type                    |
-| ---------------------------------------------------- | ---------------------------------- |
-| `Symfony\Component\Validator\Constraints\Url`        | `https://schema.org/url`           |
-| `Symfony\Component\Validator\Constraints\Email`      | `https://schema.org/email`         |
-| `Symfony\Component\Validator\Constraints\Uuid`       | `https://schema.org/identifier`    |
-| `Symfony\Component\Validator\Constraints\CardScheme` | `https://schema.org/identifier`    |
-| `Symfony\Component\Validator\Constraints\Bic`        | `https://schema.org/identifier`    |
-| `Symfony\Component\Validator\Constraints\Iban`       | `https://schema.org/identifier`    |
-| `Symfony\Component\Validator\Constraints\Date`       | `https://schema.org/Date`          |
-| `Symfony\Component\Validator\Constraints\DateTime`   | `https://schema.org/DateTime`      |
-| `Symfony\Component\Validator\Constraints\Time`       | `https://schema.org/Time`          |
-| `Symfony\Component\Validator\Constraints\Image`      | `https://schema.org/image`         |
-| `Symfony\Component\Validator\Constraints\File`       | `https://schema.org/MediaObject`   |
-| `Symfony\Component\Validator\Constraints\Currency`   | `https://schema.org/priceCurrency` |
-| `Symfony\Component\Validator\Constraints\Isbn`       | `https://schema.org/isbn`          |
-| `Symfony\Component\Validator\Constraints\Issn`       | `https://schema.org/issn`          |
+By default, when using [validations](validation.md) API Platform will try to define known [Schema.org](https://schema.org)
+types as IRIs for your properties if you did not provide any in your `#[ApiProperty]` attributes.
+
+- Symfony built-in mapping is:
+
+    | Constraints                                          | Schema.org type                    |
+    |------------------------------------------------------|------------------------------------|
+    | `Symfony\Component\Validator\Constraints\Url`        | `https://schema.org/url`           |
+    | `Symfony\Component\Validator\Constraints\Email`      | `https://schema.org/email`         |
+    | `Symfony\Component\Validator\Constraints\Uuid`       | `https://schema.org/identifier`    |
+    | `Symfony\Component\Validator\Constraints\CardScheme` | `https://schema.org/identifier`    |
+    | `Symfony\Component\Validator\Constraints\Bic`        | `https://schema.org/identifier`    |
+    | `Symfony\Component\Validator\Constraints\Iban`       | `https://schema.org/identifier`    |
+    | `Symfony\Component\Validator\Constraints\Date`       | `https://schema.org/Date`          |
+    | `Symfony\Component\Validator\Constraints\DateTime`   | `https://schema.org/DateTime`      |
+    | `Symfony\Component\Validator\Constraints\Time`       | `https://schema.org/Time`          |
+    | `Symfony\Component\Validator\Constraints\Image`      | `https://schema.org/image`         |
+    | `Symfony\Component\Validator\Constraints\File`       | `https://schema.org/MediaObject`   |
+    | `Symfony\Component\Validator\Constraints\Currency`   | `https://schema.org/priceCurrency` |
+    | `Symfony\Component\Validator\Constraints\Isbn`       | `https://schema.org/isbn`          |
+    | `Symfony\Component\Validator\Constraints\Issn`       | `https://schema.org/issn`          |
+
+- Laravel built-in mapping is:
+
+    | Laravel Validation Rule       | Schema.org Type                    |
+    |-------------------------------|------------------------------------|
+    | `url`                         | `https://schema.org/url`           |
+    | `email`                       | `https://schema.org/email`         |
+    | `uuid`                        | `https://schema.org/identifier`    |
+    | `date`                        | `https://schema.org/Date`          |
+    | `date_format:Y-m-d H:i:s`     | `https://schema.org/DateTime`      |
+    | `date_format:H:i`             | `https://schema.org/Time`          |
+    | `image`                       | `https://schema.org/image`         |
+    | `mimes` or `mimetypes`        | `https://schema.org/MediaObject`   |