PHPackages                             crawdance/iran-events - 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. [Utility & Helpers](/categories/utility)
4. /
5. crawdance/iran-events

ActiveLibrary[Utility & Helpers](/categories/utility)

crawdance/iran-events
=====================

A simple package to check Iran holidays and events using Jalali Calendar

414PHP

Since Feb 25Pushed 3y ago1 watchersCompare

[ Source](https://github.com/CrawDance/iran-events)[ Packagist](https://packagist.org/packages/crawdance/iran-events)[ RSS](/packages/crawdance-iran-events/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (1)DependenciesVersions (1)Used By (0)

Iran Events And Holidays
------------------------

[](#iran-events-and-holidays)

A simple package to check Iran holidays and events using Jalali Calendar.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require crawdance/iran-events
```

Add this line in your app.php file if your laravel version is below 5.6:

```
'providers' => [
 ...
   CrawDance\IranEvents\Providers\IranEventsServiceProvider::class,
 ...
];
```

Usage:
------

[](#usage)

```
return IranEvents::Check('1408-12-29');
```

The result is:

```
array:3 [▼
  "holiday" => true
  "type" => "تقویم خورشیدی"
  "desc" => "روز ملي شدن صنعت نفت ايران"
]
```

#### Hijri Events:

[](#hijri-events)

```
return IranEvents::Check('1408-4-13');
```

```
array:3 [▼
  "holiday" => true
  "type" => "تقویم قمری"
  "desc" => "اربعين حسيني"
]
```

This package requires [laravel-hijri-date](https://github.com/alkoumi/laravel-hijri-date) and [Carbon](https://github.com/briannesbitt/Carbon) to convert Jalali inserted date to Ummul Qura Hijri and Gregorian.

Issues
------

[](#issues)

If you find a bug while using this package , please open an issue about the bug also affects ... and, unless it is obvious, the reason why you think the current result is wrong.

License
-------

[](#license)

The MIT License (MIT).

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity26

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/4851d2fe1ed9b217c615fac3e13639a5c756892389f970d918eb6437afd1acab?d=identicon)[CrawDance](/maintainers/CrawDance)

---

Top Contributors

[![CrawDance](https://avatars.githubusercontent.com/u/18571116?v=4)](https://github.com/CrawDance "CrawDance (6 commits)")

### Embed Badge

![Health badge](/badges/crawdance-iran-events/health.svg)

```
[![Health](https://phpackages.com/badges/crawdance-iran-events/health.svg)](https://phpackages.com/packages/crawdance-iran-events)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)