PHPackages                             devsyril/tg-cni-reader - 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. [Validation & Sanitization](/categories/validation)
4. /
5. devsyril/tg-cni-reader

Abandoned → [devsyril/tg-document-reader](/?search=devsyril%2Ftg-document-reader)Library[Validation & Sanitization](/categories/validation)

devsyril/tg-cni-reader
======================

Togolese identity documents OCR processor - extracts and validates data from CNI, passport, and driver license images.

1.1.0(2mo ago)181MITPHPPHP >=8.1

Since May 15Pushed 2mo agoCompare

[ Source](https://github.com/DevSyril/tg_document_reader)[ Packagist](https://packagist.org/packages/devsyril/tg-cni-reader)[ RSS](/packages/devsyril-tg-cni-reader/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (5)Versions (3)Used By (0)

tg-document-reader
==================

[](#tg-document-reader)

**Togolese Identity Documents OCR Processor** — Extrait et valide les données des pièces d'identité togolaises par OCR.

[![PHP](https://camo.githubusercontent.com/6616edde8a65eefafabbf872390d9f158f07816e76b0f5694ec2f4fb2a8ee7be/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d373737424234)](https://camo.githubusercontent.com/6616edde8a65eefafabbf872390d9f158f07816e76b0f5694ec2f4fb2a8ee7be/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d373737424234) [![Licence](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)

---

Table des matières
------------------

[](#table-des-matières)

- [Présentation](#pr%C3%A9sentation)
- [Fonctionnalités](#fonctionnalit%C3%A9s)
- [Documents supportés](#documents-support%C3%A9s)
- [Prérequis système](#pr%C3%A9requis-syst%C3%A8me)
- [Installation](#installation)
- [Utilisation](#utilisation)
    - [Syntaxe de base](#1-syntaxe-de-base)
    - [CNI (Carte Nationale d'Identité)](#2-cni-carte-nationale-didentit%C3%A9)
    - [Permis de conduire](#3-permis-de-conduire)
    - [Passeport](#4-passeport)
    - [Détection automatique](#5-d%C3%A9tection-automatique-du-type-de-document)
    - [Accès aux données extraites](#6-acc%C3%A8s-aux-donn%C3%A9es-extraites)
- [Architecture du package](#architecture-du-package)
    - [Structure des dossiers](#structure-des-dossiers)
    - [Diagramme de dépendances](#diagramme-de-d%C3%A9pendances)
- [Tests](#tests)
- [Dépendances](#d%C3%A9pendances)
- [Licence](#licence)

---

Présentation
------------

[](#présentation)

`tg-document-reader` est une bibliothèque PHP qui utilise **Tesseract OCR** pour lire automatiquement les informations sur les pièces d'identité togolaises :

- **Carte Nationale d'Identité (CNI)**
- **Passeport** (avec décodage MRZ format TD3)
- **Permis de conduire**

La bibliothèque extrait, structure et valide l'ensemble des champs présents sur chaque document.

---

Fonctionnalités
---------------

[](#fonctionnalités)

- **Extraction OCR** via Tesseract (langue française)
- **Architecture pilotée par driver** : chaque type de document a son propre parseur
- **Décodage MRZ** : support des formats TD1 (CNI, 3 lignes) et TD3 (passeport, 2 lignes)
- **Validation MRZ** selon la norme ICAO 9303 (clés de contrôle)
- **Croisement des données** recto/verso (CNI, permis)
- **Dictionnaire des localités togolaises** intégré
- **Drapeaux de validation** individuels par champ (`ValueStat`)
- **Détection d'expiration** du document
- **Détection automatique** du type de document via OCR

---

Documents supportés
-------------------

[](#documents-supportés)

DocumentFacesMRZFormats image supportésCNIRecto + VersoTD1 (3 lignes, `I