saurabhsharma/dl-data-extractor

A simple class to return Driving License information, such as Driver First Name, Last Name, License Number etc.

v1.0.3 2026-04-10 11:36 UTC

Requires

• php: ^8.2 || ^8.3

Requires (Dev)

• pestphp/pest: ^3.0
• phpstan/phpstan: ^1.11

MIT

• Saurabh Sharma

• driving License data Extractor
• pdf14 data extractor
• DL parsing

README

A small PHP library for extracting AAMVA-style fields from a driver license PDF417 payload.

Compatibility

• PHP: ^8.2 || ^8.3
• Tested with Pest 3

Installation

composer require saurabhsharma/dl-data-extractor

Usage

<?php

use SaurabhSharma\DLExtractor\DLExtractor;

$payload = 'DCSDOE DACJANE DAQ1234';

// Backward-compatible default: canonical fields + aliases
DLExtractor::parse($payload)->toArray();

// Canonical-only mode (stable output contract)
DLExtractor::parse($payload, 'pdf417', ['aliases' => false])->toArray();

// JSON output
DLExtractor::parse($payload)->toJson();

Supported parser types

• pdf417

Unknown types throw UnsupportedTransformerException.

Field model

The parser now builds a canonical field map per code and can optionally emit alias keys for backward compatibility.

Security & privacy

Driver license payloads may contain PII. Avoid logging raw payloads in production, and redact extracted values in diagnostics.

Development

composer test
composer lint