Générer et manipuler des UUID en PHP

Les UUID sont des identifiants de 128 bits normalisés par la RFC 9562. UUIDv4 est aléatoire et largement supporté ; les versions plus récentes apportent d’autres propriétés de génération tout en conservant la forme textuelle canonique.

Démarrage rapide#

L’exemple suivant utilise l’API standard de PHP ou une bibliothèque couramment utilisée pour cette tâche.

Exemple#

1<?php2// Install first: composer require ramsey/uuid3use Ramsey\Uuid\Uuid;45$id = Uuid::uuid4();6echo $id->toString() . PHP_EOL;

Opérations courantes#

Ce second exemple couvre une opération fréquente en production ou une manière plus sûre de traiter des entrées réelles.

Variante courante#

1<?php2use Ramsey\Uuid\Uuid;34if (Uuid::isValid($input)) {5    $uuid = Uuid::fromString($input);6    echo $uuid->toString();7}

Points importants#

Utilisez les types ou bibliothèques UUID de la plateforme au lieu de construire manuellement les bits, et conservez le format canonique aux frontières de sérialisation.

Bonnes pratiques#

1. Considérez toute entrée externe comme non fiable et gérez explicitement les erreurs d’analyse ou de validation.
2. Rendez explicites l’encodage, les unités, les formats et les conventions propres aux bibliothèques aux frontières du système.
3. Ajoutez des tests couvrant l’entrée vide, le texte Unicode, les entrées invalides et des données représentatives de la production.

Références#

• RFC 9562: UUIDs
• PHP Manual