PHPackages jarir-ahmed/bd-nid-parser - 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. [Parsing & Serialization](/categories/parsing) 4. / 5. jarir-ahmed/bd-nid-parser ActiveLibrary[Parsing & Serialization](/categories/parsing) jarir-ahmed/bd-nid-parser ========================= Parse and validate Bangladesh National ID (NID) numbers. Extract number, digit type (10/17), date of birth, and name from raw OCR text. Zero dependencies. v1.1.1(1mo ago)22MITPHPPHP >=7.2 Since Jul 9Pushed 1mo agoCompare [ Source](https://github.com/jarir2020/bd-nid-parser)[ Packagist](https://packagist.org/packages/jarir-ahmed/bd-nid-parser)[ RSS](/packages/jarir-ahmed-bd-nid-parser/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (1)Versions (4)Used By (0) bd-nid-parser ============= [](#bd-nid-parser) **Parse and validate Bangladesh National ID (NID) numbers.** Extract NID number, digit type (10-digit old card / 17-digit smart card), date of birth, and name from raw OCR text. Zero dependencies. ``` composer require jarir-ahmed/bd-nid-parser ``` --- Quick Start ----------- [](#quick-start) ``` use JarirAhmed\BdNid\BdNid; // Parse full card OCR text $result = BdNid::parse("Name: MD. JARIR AHMED NID: 4212964672 Date of Birth: 17 May 2000"); // [ // 'number' => '4212964672', // 'type' => '10', // 'name' => 'MD. JARIR AHMED', // 'dateOfBirth' => '2000-05-17', // ] // Validate NID number BdNid::validate('4212964672'); // true BdNid::validate('12345678901234567'); // true (smart card) BdNid::validate('12345'); // false // Detect card type BdNid::getDigitType('4212964672'); // '10' BdNid::getDigitType('12345678901234567'); // '17' ``` --- API --- [](#api) ### `parse(string $text): array` [](#parsestring-text-array) Extract NID number, type, name, and DOB from raw OCR text. Returns: - `number` — NID number (digits only), or `null` - `type` — `'10'` (old card) or `'17'` (smart card), or `null` - `name` — Person name in uppercase, or `null` - `dateOfBirth` — DOB in `YYYY-MM-DD` format, or `null` ### `validate(string $number): bool` [](#validatestring-number-bool) Check if an NID number is valid (10 or 17 digits). ### `getDigitType(string $number): ?string` [](#getdigittypestring-number-string) Detect card type: `'10'` or `'17'`, returns `null` if invalid. --- Supported DOB Formats --------------------- [](#supported-dob-formats) FormatExampleDate of Birth: DD Mon YYYY`Date of Birth: 17 May 2000`DD Mon YYYY (standalone)`05 January 1990`DD-MM-YYYY`01-12-1990`DD/MM/YYYY`15/06/1985`YYYY-MM-DD (ISO)`1990-01-17`DD-Mon-YYYY`01-Jan-1995`Supports both English and Bangla (`নাম`) name extraction. --- Optional: NID Verification via nidlive.com ------------------------------------------ [](#optional-nid-verification-via-nidlivecom) The package includes an optional `NidLiveVerifier` that integrates with **[nidlive.com](https://nidlive.com)** — an identity verification service using image-based face/NID matching. This package uses their API for verification, and we credit them for providing this service. To use the verifier, **sign up at [nidlive.com](https://nidlive.com)**, purchase a subscription, and obtain your Client ID & Secret from the dashboard. ``` use JarirAhmed\BdNid\Verifiers\NidLiveVerifier; $verifier = new NidLiveVerifier( clientId: 'your-client-id', clientSecret: 'your-client-secret' ); // Submit NID front/back images + selfie for verification $result = $verifier->submitVerification( nidFrontBase64: $frontImageBase64, nidBackBase64: $backImageBase64, selfieBase64: $selfieBase64, ); // Check verification status $status = $verifier->checkStatus('VRF-ABC123'); // Test API connectivity (no auth required) $info = $verifier->testConnection(); ``` ### nidlive.com Plans [](#nidlivecom-plans) PlanAPI CallsRate LimitStarter1,000 / month60 / minuteProfessional10,000 / month300 / minuteEnterpriseCustomCustomRequires `ext-curl` and `ext-json`. See full API docs at [nidlive.com/api-docs](https://nidlive.com/api-docs). --- Testing ------- [](#testing) ``` composer install composer test ``` --- License ------- [](#license) MIT bd-nid-parser ============= [](#bd-nid-parser-1) ### Health Score 34 — LowBetter than 74% of packages Maintenance90 Actively maintained with recent releases Popularity5 Limited adoption so far Community6 Small or concentrated contributor base Maturity31 Early-stage or recently created project 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 ~1 days Total 3 Last Release 46d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/20700f34ff813055154e843bbdbe04d33320c1e6a81bbb3301cad67cb8350fd3?d=identicon)[jarircse16](/maintainers/jarircse16) --- Top Contributors [![jarir2020](https://avatars.githubusercontent.com/u/175597633?v=4)](https://github.com/jarir2020 "jarir2020 (4 commits)") --- Tags validateparseOCRnational idbangladeshbdnid ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/jarir-ahmed-bd-nid-parser/health.svg) ``` [![Health](https://phpackages.com/badges/jarir-ahmed-bd-nid-parser/health.svg)](https://phpackages.com/packages/jarir-ahmed-bd-nid-parser) ``` ### Alternatives [aranyasen/hl7 HL7 parser, generator and sender. 1972.0M1](/packages/aranyasen-hl7)[olamedia/nokogiri HTML Parser 22778.5k3](/packages/olamedia-nokogiri)[nihongodera/limelight A php Japanese language text analyzer and parser. 11283.9k](/packages/nihongodera-limelight)[kherge/json Encodes, decodes, and validates JSON data. 61242.0k6](/packages/kherge-json)[adci/full-name-parser Parses a human name 29763.4k12](/packages/adci-full-name-parser)[dimabdc/php-fast-simple-html-dom-parser PHP Fast Simple HTML DOM parser. 8956.8k](/packages/dimabdc-php-fast-simple-html-dom-parser) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)