Download the PHP package vldmir/tin without Composer

On this page you can find all versions of the php package vldmir/tin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of vldmir/tin

Informations about the package tin

Latest Stable Version GitHub stars Total Downloads ![GitHub Workflow Status][github workflow status] Type Coverage License

Enhanced Taxpayer Identification Number (TIN) Validator

Description

An enhanced library to validate TIN numbers for individuals with advanced features including input masks, TIN type identification, and comprehensive Docker support. This is a fork of the original loophp/tin library with significant enhancements.

New Features in v2.0.0:

Supported countries:

If your country is not there, feel free to open an issue with your country code, and a link to the specification. Ideally, you can provide a pull request with the algorithm and the tests.

Requirements

Quick Start

Installation

Basic Validation

To simply check the validity of a TIN number:

If you want to get the reason why a number is invalid, you can use:

Advanced Features

Input Masks and Formatting

The library provides comprehensive input mask and formatting capabilities:

TIN Type Identification

Different countries may have multiple types of TINs. The library can identify and categorize them:

Complete Example

Examples by Country

Country Mask Placeholder TIN Types
Belgium (BE) 99.99.99-999.99 85.07.30-033.61 TIN
Spain (ES) 99999999A 12345678Z DNI, NIE, CIF
Germany (DE) 999 999 999 99 123 456 789 01 IdNr, StNr
United Kingdom (UK) AA999999A AB123456C UTR, NINO
France (FR) 9 99 99 99 999 999 1 23 45 67 890 123 TIN
Italy (IT) AAAAAANNANNANAAA RSSMRA85T10A562S TIN

Mask Format:

Docker Development Environment

The library includes a complete Docker setup for easy development and testing:

Quick Start with Docker

Available Commands

Manual Docker Commands

For detailed Docker documentation, see DOCKER.md.

Strict Mode

If you want to use a stricter method (without normalizing the TIN number, that is, using the raw TIN number), use the strict parameter in the check or isValid functions as shown below. By default, it is set to false.

Code Quality, Tests and Benchmarks

Every time changes are introduced into the library, Github run the tests and the benchmarks.

The library has tests written with PHPSpec. Feel free to check them out in the spec directory. Run composer phpspec to trigger the tests.

Before each commit some inspections are executed with GrumPHP, run ./vendor/bin/grumphp run to check manually.

PHPInfection is used to ensure that your code is properly tested, run composer infection to test your code.

Running Tests

Links

Authors

Contributing

We warmly welcome your contributions by submitting pull requests. Our team is highly responsive and will gladly guide you through the entire process, from the initial submission to the final resolution.

Development Setup

  1. Fork the repository
  2. Clone your fork
  3. Set up the Docker environment: make up
  4. Make your changes
  5. Run tests: make phpspec
  6. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

[github workflow status]: https://img.shields.io/github/actions/workflow/status/vldmir/tin/tests.yml?branch=master&style=flat-square

All versions of tin with dependencies

PHP Build Version
Package Version
Requires php Version >= 8.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package vldmir/tin contains the following files

Loading the files please wait ....