README.md

Lightweight VIN Decoder for PHP 8+

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/php-local-vin-decoder

Usage

use VinDecoder\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