mmalyszko/vinfast-php

Lightweight VIN decoder for PHP 8+. Quickly decode vehicle brand, model, year, country, and region from a VIN — 100% local, no external API required.

v1.0.0 2025-06-06 11:14 UTC

Requires

• php: ^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.75
• phpstan/phpstan: ^1.11
• phpunit/phpunit: ^9.0

MIT

README

Decode vehicle brand, model, year, country and region from a VIN number using a fast, local PHP library — no external API calls, no rate limits.

Installation

composer require mmalyszko/vinfast-php

Usage

use Vinfast\Vin;

$vin = new Vin('W0L0TGF487G011234');

echo $vin->decodeBrand();   // Opel
echo $vin->decodeModel();   // Astra (if available in VDS database)
echo $vin->decodeYear();    // 2007
echo $vin->decodeCountry(); // Germany
echo $vin->decodeRegion();  // Europe

VDS Database

Most common VDS codes matched to popular models are included by default. You can override the database with your own file:

$vin->setVdsDataFilePath('/path/to/your/vds.php');

Testing

Run all tests and check coverage (100%):

composer test
composer test:cover