- How do I install werk365/identitydocuments in a Laravel app?
- Install it with composer require werk365/identitydocuments, then confirm the package service provider is registered; Laravel auto-discovery may handle this. The package is stateless, so there are no migrations or persistence steps. Publish and adjust configuration only if you need to override defaults.
- Does this Laravel package parse passport images or only MRZ text?
- The technical evaluation indicates it consumes pre-extracted MRZ strings or OCR text, not raw document images. You remain responsible for image capture, document detection, and OCR upstream. Confirm this behavior in a spike before sizing the integration.
- Which Laravel versions does werk365/identitydocuments support?
- The last release was in May 2022, so composer constraints are likely pinned to the Laravel 8 or 9 era. There is no confirmed support for Laravel 10, 11, or 12. Check composer.json constraints in a test install and avoid ignore-platform-reqs in production.
- Is werk365/identitydocuments GPL-3.0 safe for commercial use?
- GPL-3.0 is generally acceptable for internal-only SaaS use because it has no AGPL-style network clause. Distribution triggers source-disclosure obligations for the combined work, so on-prem appliances, white-label SDKs, mobile bundles, or embedded products can be blocked. Review your distribution model with legal before adopting it.
- How does it integrate with Laravel validation for identity documents?
- The package integrates with Laravel validation to verify identity details such as document numbers, dates of birth, and expiry dates. Wrap it behind an internal DocumentParser interface and call it from an adapter, not directly from controllers or domain services. Validate the rules against your actual document mix and upstream OCR quality.
- What MRZ formats does this identity document package support?
- The overview does not confirm exact coverage for TD1, TD2, TD3, or MRV-A/B formats. It also does not state whether check digits are validated and surfaced as errors or silently ignored. Test against your real passport, ID card, and visa samples and treat unsupported formats as explicit failures.
- Is werk365/identitydocuments maintained and production-ready?
- The package shows a last release in 2022, zero dependents, and a low adoption signal despite its star count. That creates maintenance and framework-version risk for production use. Plan for defensive wrapping, owned tests, and either a maintained fork or an alternative parser behind your adapter.
- Can I use this package for KYC onboarding and date of birth or expiry checks?
- It parses MRZ data and checks document numbers, dates of birth, and expiry dates, which fits KYC and onboarding verification flows. The main risk is silent misparse of dates or document numbers, which directly affects compliance and fraud decisions. Fail closed on parse errors and keep audit-friendly validation results.
- What are alternatives if werk365/identitydocuments is stale or GPL blocks distribution?
- Capture the capability behind your own DocumentParser port and use an owned fork, a maintained MRZ parser, or the upstream library directly. The Laravel wrapper is thin, so replacing the adapter should have a low blast radius. Review the license and maintenance status of any upstream parser before depending on it.
- How should I test and wrap identity document parsing in production?
- Unit test the adapter with representative MRZ samples, malformed strings, unsupported formats, and encoding edge cases. Assert check digits, dates, and document numbers, and verify exceptions are converted into explicit failures. Keep the package isolated behind an interface so a fork or replacement does not affect domain services.