https://github.com/mmalyszko/php-local-vin-decoder
Simple, 100% offline VIN decoder for PHP 8+. No API required. Decodes car make, model, year, and country 🚗
https://github.com/mmalyszko/php-local-vin-decoder
iso-3779 local-library php-library php8 vehicle-identification vin-decoder vin-parser
Last synced: 2 months ago
JSON representation
Simple, 100% offline VIN decoder for PHP 8+. No API required. Decodes car make, model, year, and country 🚗
- Host: GitHub
- URL: https://github.com/mmalyszko/php-local-vin-decoder
- Owner: mmalyszko
- Created: 2025-05-30T06:30:06.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-09T12:32:47.000Z (5 months ago)
- Last Synced: 2026-01-13T22:58:31.601Z (5 months ago)
- Topics: iso-3779, local-library, php-library, php8, vehicle-identification, vin-decoder, vin-parser
- Language: PHP
- Homepage:
- Size: 34.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Lightweight VIN Decoder for PHP 8+
[](https://github.com/mmalyszko/php-local-vin-decoder/actions/workflows/ci.yml)
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
```php
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:
```php
$vin->setVdsDataFilePath('/path/to/your/vds.php');
```
## Testing
Run all tests and check coverage (100%):
```bash
composer test
composer test:cover
```