- How do I install mohamedsabil83/laravel-hijrian in a Laravel app?
- Install it with Composer using composer require mohamedsabil83/laravel-hijrian. Laravel package auto-discovery registers the service provider and facade alias, and the package includes a config file. For v4.3.0, confirm the illuminate/support and PHP constraints in composer.json match your application before upgrading.
- Which Laravel versions does laravel-hijrian support?
- The v4.3.0 release notes widen framework support to Laravel 12 and claim Laravel 13. The package targets Laravel 10, 11, and 12 applications according to the assessment, with Laravel 13 support needing verification. Check the exact illuminate/support constraint in composer.json before relying on it for a roadmap.
- How do I convert a Gregorian date to Hijri or a Hijri date to Gregorian in Laravel?
- The package is built for Gregorian-to-Hijri and Hijri-to-Gregorian conversion and exposes the result through Laravel idioms such as a facade and helpers. Use the facade or helper methods in your service or controller code, then format the returned date as needed. It does not replace Carbon or become a system of record; it is a presentation and formatting layer.
- How do I display a Hijri date in a Blade template with laravel-hijrian?
- The package includes a Blade directive for rendering Hijri dates in templates. Use it wherever your Blade view needs an Islamic date alongside or instead of a Gregorian date. Keep conversion logic out of complex business rules and format at the presentation layer.
- Does laravel-hijrian provide a validation rule for Hijri dates?
- Yes. The package ships a Laravel validation rule for Hijri dates. Use it on request fields that must contain a valid Hijri date, and pair it with your normal authorization and input-normalization rules. Verify the exact rule name and accepted format in the package documentation before shipping.
- Which Hijri calendar algorithm does laravel-hijrian use?
- The provided overview does not state whether laravel-hijrian implements Umm al-Qura, tabular Islamic, or a configurable Hijri algorithm. That matters because different variants can differ by a day, which is visible in payroll, invoicing, contracts, and Ramadan scheduling. Inspect the conversion class and tests, and confirm the algorithm matches your regulator or auditor expectations.
- Is laravel-hijrian safe for production payroll or invoicing dates?
- Treat it as a formatting utility, not a source of truth for regulated dates. Date conversion has real edge cases around Hijri month lengths, leap years, month boundaries, and timezone or DST truncation. For payroll, invoicing, or contract dates, validate outputs against an authoritative calendar source and keep Gregorian dates as the system of record.
- How is laravel-hijrian tested for month boundaries, leap years, and timezones?
- The release notes do not describe coverage of the conversion logic itself. The testbench bump suggests the suite tracks the current framework, but that does not prove boundary cases are tested. Review the test suite for month ends, leap years, timezone handling, and known Hijri variant differences before production use.
- Is mohamedsabil83/laravel-hijrian actively maintained?
- It is a single-maintainer package, and its recent release history is largely automated dependency and CI updates. Cadence is driven by CI hygiene rather than a published roadmap, which is the primary long-term risk. Check for a second maintainer, upgrade guide, deprecation policy, or semver commitment before standardizing on it.
- What are alternatives to laravel-hijrian for Hijri dates in Laravel?
- Alternatives include other Hijri conversion libraries, Carbon localization plugins, or building a small internal converter around a verified algorithm. Choose based on whether you need Umm al-Qura versus tabular Islamic dates, Laravel Blade and validation integration, and active maintenance. Avoid installing overlapping date or i18n packages whose facades or helpers could collide.