Weave Code
Chhankitek Laravel Package
asorasoft/chhankitek
A Laravel/PHP package for working with the Khmer Chhankitek calendar. It helps convert and handle Cambodian lunar dates, supporting calendar calculations and related helpers for Khmer-language applications and Laravel projects.
A PHP package to convert dates to Lunar (Chhankitek) format — works with or without Laravel
Frequently asked questions about Chhankitek
- How do I install asorasoft/chhankitek in a Laravel application?
- Install it with Composer using composer require asorasoft/chhankitek. If the package ships a ServiceProvider, Laravel package discovery registers it automatically; otherwise instantiate the converter classes directly. Before pinning a version, read its composer.json to confirm the php and illuminate/support constraints match your app.
- Does asorasoft/chhankitek work without Laravel?
- Yes. The package is described as working with or without Laravel, so it can be used in plain PHP scripts and non-Laravel projects. Verify in a scratch branch that conversion runs without a full framework bootstrap, since some calendar packages quietly depend on Laravel helpers or config.
- Which PHP and Laravel versions does chhankitek support?
- The declared ranges live in the package's composer.json, so check the php constraint and any illuminate/support constraint before adopting it. Because the package has no dependents and low visibility, assume the constraint range is not actively tested against new Laravel majors. Run it through your own CI matrix on the PHP and Laravel versions you actually deploy.
- Can chhankitek convert Khmer lunar dates back to Gregorian dates?
- The package description only covers AD to Chhankitek (Khmer lunar) conversion, and no reverse Lunar to AD path is implied. If you need to validate a user-entered observance date, plan that as custom work rather than package work. Confirm with the maintainer or source before you build a roadmap that assumes bidirectional conversion.
- Does the package return structured lunar date components or only a formatted string?
- This is the most important thing to check before adopting it. A string-only API forces you to reimplement lunar day numbering, 29 versus 30 day months, Athikameas leap-month insertion, and Thithi leap-day handling downstream, which duplicates the rules you are paying the dependency for. Prefer a package that exposes day, month, year, and leap flags as discrete values.
- How should I handle timezones when converting to Khmer Chhankitek dates?
- Chhankitek calculations hinge on new-moon boundaries, so timezone handling is not cosmetic. Set Asia/Phnom_Penh (UTC+7) explicitly as an input rather than letting PHP fall back to its default timezone. Midnight rollover in UTC+7 is a classic defect site in lunar calendar code, so test dates that sit close to a day boundary.
- How accurate is the Chhankitek conversion algorithm?
- Accuracy is unverified: the package has a single maintainer, no dependent packages, and no public corroboration in production. A miscalculated leap month can shift an observance by roughly 30 days without throwing an exception, so the failure mode is wrong data rather than a crash. Before trusting it, diff 24 to 36 months of output against an authoritative Khmer calendar source such as a government holiday gazette or a recognized almanac.
- Is asorasoft/chhankitek safe and maintained enough for production?
- It is MIT licensed, so legal friction is low and you can vendor or fork it if it is abandoned. The risks are a bus factor of one, no evidence of review, and a latest release tag dated 2026-09-02 that is worth verifying as genuine rather than a metadata or clock anomaly. Keep it behind an in-house interface so you can substitute or replace it without touching domain code.
- What alternatives exist for Khmer lunar calendar conversion in PHP?
- The niche is narrow, so few maintained PHP packages cover Chhankitek specifically. Realistic alternatives are implementing the rule set yourself from an authoritative Khmer calendar reference, or treating this package as an adapter behind an internal LunarDateConverter interface. If your product is not Cambodia-facing, the dependency is probably unnecessary weight.
- How do I integrate and test chhankitek safely in a Laravel project?
- Run a one to two day spike in a scratch branch: install the package, convert a reference set of 24 to 36 months, and diff the results against a trusted Khmer calendar source. Then define your own LunarDateConverter interface and write a ChhankitekAdapter that wraps the vendor classes. Nothing else in your codebase should import the package directly, and golden-file tests should pin the expected output so a future fork or swap is verifiable.
Weaver
How can I help you explore Laravel packages today?