gr3grst/php-french-business-id-validator

A PHP validator for French business ID including French VAT validator/calculator

Maintainers

Package info

github.com/Gr3G-RST/php-french-business-id-validator

pkg:composer/gr3grst/php-french-business-id-validator

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

dev-main 2025-06-19 12:43 UTC

This package is auto-updated.

Last update: 2026-02-19 14:24:12 UTC


README

A set of PHP classes with : \

  • Validating for French business ID (SIRET/SIREN)
  • Refactoring for French business ID (SIRET/SIREN)
  • Calculating French VAT number from SIREN

Authors

Licence : MIT

Install

composer require gr3grst/php-french-business-id-validator

Class : Validator

Method : isSiren

Validate a SIREN number - 9 digits + Luhn

arguments
string $siren The SIREN number
returns
bool Returns true if the SIRET number is valid, false otherwise.

Method : isSiret

Validate a SIRET number - 14 digits + Luhn

arguments
string $siret The SIRET number
returns
bool Returns true if the SIRET number is valid, false otherwise.

Method : isVatFr

Validates a French VAT (TVA) number.

arguments
string $tva The VAT number to validate, which must follow the French format: "FR" + 2 alphanumeric characters + 9 digits.
returns
bool Returns true if the VAT number is valid according to the format and checks, false otherwise.

Class : Calculator

Method : calculateVatFr

Calculates the French VAT (TVA) number based on a given SIREN number.

arguments
string $siren The SIREN number
returns
string|false Returns the computed French VAT number in the format "FR[key][SIREN]" if the input SIREN is valid. Returns false if the SIREN is not valid.

Class : Refactor

Method : refactorSiren

Refactor a SIREN number - 9 digits and validate it with Luhn

arguments
string $siren The SIREN number to refactor
returns
string|false Returns the SIREN number if valid, false otherwise.

Method : refactorSiret

Refactor a SIREN number - 14 digits and validate it with Luhn

arguments
string $siret The SIRET number to refactor
returns
string|false Returns the SIRET number if valid, false otherwise.

Examples

<?php

$test = new Validator();
$result = ($test->isSiren('<SIREN number to validate>')) ? true : false;
return $result;