README

PHP client for UUIDFactory API – generate and validate UUIDs online

UUIDFactory website | API Documentation | Online Validator | Online Generator

Overview

uuidfactory-php is the official PHP client for the UUIDFactory API.
Easily generate and validate UUIDs in your PHP projects. Supports UUID versions v1, v4, v7, GUID, batch generation, and batch validation, with seamless integration with the UUIDFactory online tools.

Key Features:

• Generate UUID v1, v4, v7, and GUID programmatically
• Validate single UUIDs or multiple UUIDs at once
• Generate multiple UUIDs at once (batch generation)
• Simple, lightweight PHP client using cURL
• Works with UUIDFactory API

Requirements

• PHP 7.4+
• ext-curl
• ext-json

Installation

Install via Composer:

composer require uuidfactory/uuidfactory-php

Usage

<?php

require __DIR__ . '/vendor/autoload.php';

use UuidFactory\UuidFactoryClient;

$client = new UuidFactoryClient();

// Generate a UUID v4
$uuid = $client->generateV4();
echo "Generated UUID v4: " . $uuid . "\n";

// Generate multiple UUIDs
$uuids = $client->generateMultiple('v4', 5);
print_r($uuids);

// Validate a single UUID
$result = $client->validate($uuids[0]);
echo "Is single UUID valid? " . ($result['status'] === 'valid' ? 'yes' : 'no') . "\n";

// Validate multiple UUIDs at once
$validationResults = $client->validateMultiple($uuids);
print_r($validationResults);

Available Methods

Examples

Check the examples/ folder for ready-to-run PHP scripts:

• examples/basic.php – Generate and validate single UUIDs
• examples/batch.php – Generate and validate multiple UUIDs at once

Run from project root after composer install:

php examples/basic.php
php examples/batch.php

Uruchomienie w Dockerze

W katalogu projektu:

docker compose run --rm php composer install
docker compose run --rm php php examples/basic.php
docker compose run --rm php php examples/batch.php

Use Cases

• Quick UUID generation for PHP backend projects
• Validating single or multiple UUIDs before database insertion
• Generating multiple UUIDs for bulk operations
• Integration in Laravel, Symfony, or plain PHP apps

Links & References

• Official UUIDFactory Website
• Online UUID Generator
• UUID Validator
• UUID API Documentation

License

This project is licensed under the MIT License.