PHPackages                             alex-kalanis/simple-vin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. alex-kalanis/simple-vin

ActiveLibrary[Utility & Helpers](/categories/utility)

alex-kalanis/simple-vin
=======================

Simple checking of Vehicle Identification Numbers

v2.0.1(1y ago)0271BSD-3-ClausePHPPHP >=8.1.0CI passing

Since Jul 24Pushed 1y ago1 watchersCompare

[ Source](https://github.com/alex-kalanis/simple-vin)[ Packagist](https://packagist.org/packages/alex-kalanis/simple-vin)[ RSS](/packages/alex-kalanis-simple-vin/feed)WikiDiscussions master Synced today

READMEChangelog (5)Dependencies (6)Versions (6)Used By (0)

Simple VIN
==========

[](#simple-vin)

[![Build Status](https://github.com/alex-kalanis/simple-vin/actions/workflows/code_checks.yml/badge.svg)](https://github.com/alex-kalanis/simple-vin/actions/workflows/code_checks.yml/badge.svg)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/00d368b3c9dc6d8b0371789cb48e87b9b54dd34fce25b51f438eeed1d0159157/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616c65782d6b616c616e69732f73696d706c652d76696e2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/alex-kalanis/simple-vin/?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/664cf7e1b272c8090e78d723fafe27e42cdd7d3cf0743cea9d52b1d44743ef15/68747470733a2f2f706f7365722e707567782e6f72672f616c65782d6b616c616e69732f73696d706c652d76696e2f762f737461626c652e7376673f763d31)](https://packagist.org/packages/alex-kalanis/simple-vin)[![Minimum PHP Version](https://camo.githubusercontent.com/183804d09fec16ca7b6209b007250b7d8db1b915042feb093a9f20e6e1f25359/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230382e312d3838393242462e737667)](https://php.net/)[![Downloads](https://camo.githubusercontent.com/c1bd9c5bd4dff129dc40cf8b29f4aeb8048c402ed0c10fa3198935c07e5e9ac3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c65782d6b616c616e69732f73696d706c652d76696e2e7376673f7631)](https://packagist.org/packages/alex-kalanis/simple-vin)[![License](https://camo.githubusercontent.com/347f234a733856565620a61d2d56b6201af1b35e97162790be52b02cc143e91b/68747470733a2f2f706f7365722e707567782e6f72672f616c65782d6b616c616e69732f73696d706c652d76696e2f6c6963656e73652e7376673f763d31)](https://packagist.org/packages/alex-kalanis/simple-vin)[![Code Coverage](https://camo.githubusercontent.com/8c5d7428e7ed3e57b86912373eb6816172ecf2bf5c83a0b5866ccb010c76c515/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616c65782d6b616c616e69732f73696d706c652d76696e2f6261646765732f636f7665726167652e706e673f623d6d617374657226763d31)](https://scrutinizer-ci.com/g/alex-kalanis/simple-vin/?branch=master)

This is a set of PHP libraries for **V**ehicle **I**dentification **N**umbers.

Ported from .Net library [Vin](https://github.com/dalenewman/Vin) .

PHP installation
----------------

[](#php-installation)

```
composer.phar require alex-kalanis/simple-vin
```

(Refer to [Composer Documentation](https://github.com/composer/composer/blob/master/doc/00-intro.md#introduction) if you are not familiar with composer)

API usage
---------

[](#api-usage)

```
// basic vin check
$lib = new \kalanis\simple_vin\SimpleVin(); // can be set via DI, usually no more dependency need
$x = $lib->isValid('11111111111111111'); // true
$m = $lib->getWorldManufacturer('TMP......D.......'); // Skoda Trolleybuses
$y = $lib->getModelYear('TMP......D.......'); // 2013
$k = $lib->restoreChecksumCharacter('1FTKR1AD_APA11957'); // X
$c = $lib->restoreChecksum('1FTKR1AD_APA11957'); // 1FTKR1ADXAPA11957

// extended vin check
$lib = new \kalanis\simple_vin\DeeperVin(); // can be set via DI, usually no more dependency need
$manufacturers = $lib->getPossibleManufacturers('ZAP......D.......'); // Piaggio, Vespa, Gilera
```

Sources
-------

[](#sources)

- [Wikipedia](https://en.wikipedia.org/wiki/Vehicle_identification_number)
- ISO 3779
- ISO 4030

Changes
-------

[](#changes)

- v1.0.0 - Initial port and refactor with extended tests
- v1.1.0 - Calculate checksum characters from the rest of code
- v1.2.0 - Update VIN manufacturer codes in accordance with the current Wikipedia page
- v2.0.0 - Update VIN manufacturer format, update minimal php version

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance47

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~77 days

Total

5

Last Release

398d ago

Major Versions

v1.2.0 → v2.0.02024-12-21

PHP version history (2 changes)v1.0.0PHP >=8.0.0

v2.0.0PHP >=8.1.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/59184183?v=4)[Petr Plsek](/maintainers/alex-kalanis)[@alex-kalanis](https://github.com/alex-kalanis)

---

Top Contributors

[![alex-kalanis](https://avatars.githubusercontent.com/u/59184183?v=4)](https://github.com/alex-kalanis "alex-kalanis (18 commits)")

---

Tags

identificationcarvincars

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/alex-kalanis-simple-vin/health.svg)

```
[![Health](https://phpackages.com/badges/alex-kalanis-simple-vin/health.svg)](https://phpackages.com/packages/alex-kalanis-simple-vin)
```

###  Alternatives

[symfony/symfony

The Symfony PHP framework

31.4k87.2M2.2k](/packages/symfony-symfony)[ecotone/ecotone

Enterprise architecture layer for Laravel and Symfony — CQRS, Event Sourcing, Durable Workflows (Sagas, Orchestrators), Projections, and Outbox messaging via PHP attributes.

564576.7k52](/packages/ecotone-ecotone)[symfony/clock

Decouples applications from the system clock

436205.7M391](/packages/symfony-clock)[lcobucci/clock

Yet another clock abstraction

800207.5M163](/packages/lcobucci-clock)[flow-php/etl

PHP ETL - Extract Transform Load - Abstraction

378604.0k104](/packages/flow-php-etl)[mcp/sdk

Model Context Protocol SDK for Client and Server applications in PHP

1.5k1.5M88](/packages/mcp-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)