PHPackages                             maxwellmandela/php-recurrence - 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. maxwellmandela/php-recurrence

ActiveLibrary

maxwellmandela/php-recurrence
=============================

PHP library for working with recurrence rules, uses simshaun/recurr

v0.9.1(6y ago)36PHP

Since Jul 7Pushed 6y agoCompare

[ Source](https://github.com/maxwellmandela/php-recurrence)[ Packagist](https://packagist.org/packages/maxwellmandela/php-recurrence)[ RSS](/packages/maxwellmandela-php-recurrence/feed)WikiDiscussions master Synced 4d ago

READMEChangelog (2)Dependencies (3)Versions (4)Used By (0)

[![](https://camo.githubusercontent.com/4063c6eadfc02df9fd41c1f95749457598eccf24f0983d9838af386e5b981132/68747470733a2f2f696d6167652e666c617469636f6e2e636f6d2f69636f6e732f7376672f3132332f3132333339322e737667)](https://camo.githubusercontent.com/4063c6eadfc02df9fd41c1f95749457598eccf24f0983d9838af386e5b981132/68747470733a2f2f696d6167652e666c617469636f6e2e636f6d2f69636f6e732f7376672f3132332f3132333339322e737667)

Icons made by [Freepik](https://www.freepik.com/ "Freepik") from [www.flaticon.com](https://www.flaticon.com/ "Flaticon") is licensed by [CC 3.0 BY](http://creativecommons.org/licenses/by/3.0/ "Creative Commons BY 3.0")

php-recurrence - A PHP Recurring events library
===============================================

[](#php-recurrence---a-php-recurring-events-library)

> PHP library for working with recurrence rules, uses [simshaun/recurr](https://github.com/simshaun/recurr)

What it does
------------

[](#what-it-does)

> Very simply, php-recurrence enables scheduling recurring events much like simshaun/recurr but with more abtraction, e.g `twice every 3 weeks`This will generate an event recurring two times every 3 weeks It also needs to be mentioned that this is an approach to learning to TDD in PHP

How to
------

[](#how-to)

### Install

[](#install)

Install using [Composer](http://getcomposer.org):

```
composer require maxwellmandela/php-recurrence

```

No composer? You can clone/download the repository and use the package directly by including `bootstrap.php` onto your script

### Seting up

[](#seting-up)

Configure your script for `php-recurrence`

```
use Reccurence\Schedule;

$timezone    = 'Africa/Nairobi';
$schedule = new Schedule($timezone);
```

### Creating a simple weekly frequency

[](#creating-a-simple-weekly-frequency)

You can create a simple array of dates by passing the `start`,`end`,`freq`,`interval` this way

```
$events = $schedule->createEvents([
    'start' => '2019-07-01 00:00:00',
    'end'   => '2019-07-31 00:00:00',
    'interval' => 2,

    // for weekly events, you can change this to either  MONTHLY|YEARLY|DAILY|HOURLY
    // read more here: https://tools.ietf.org/html/rfc5545 for all valid frequencies
    'freq' => 'WEEKLY',
]);
```

### Creating a weekly frequency with `no. of times` per interval

[](#creating-a-weekly-frequency-with-no-of-times-per-interval)

You can create an array of dates and number of recurrence per interval by passing the `start`,`end`,`freq`,`interval`,`recurrence_count` this way

```
$events = $schedule->createEvents([
    'start' => '2019-07-01 00:00:00',
    'end'   => '2019-07-31 00:00:00',
    'interval' => 2,
    'freq' => 'WEEKLY',

    // for an event recurring 3 times(recurrence_count) every(interval)  2 weeks(freq)
    'recurrence_count' => 3,
]);
```

Credits
-------

[](#credits)

##### simshaun/recurr

[](#simshaunrecurr)

##### nesbot/carbon

[](#nesbotcarbon)

Contribution
------------

[](#contribution)

> All is welcome!

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 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 ~0 days

Total

2

Last Release

2504d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/221250d3acdbcfedba0e40060b2aeb524242cf8b9500c8c882a94e15d4410b84?d=identicon)[maxwellmandela](/maintainers/maxwellmandela)

---

Top Contributors

[![maxwellmandela](https://avatars.githubusercontent.com/u/5698497?v=4)](https://github.com/maxwellmandela "maxwellmandela (30 commits)")

---

Tags

phprecurring-eventseventsrecurringrrulerecurrencedates

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/maxwellmandela-php-recurrence/health.svg)

```
[![Health](https://phpackages.com/badges/maxwellmandela-php-recurrence/health.svg)](https://phpackages.com/packages/maxwellmandela-php-recurrence)
```

###  Alternatives

[simshaun/recurr

PHP library for working with recurrence rules

1.6k15.7M40](/packages/simshaun-recurr)[rlanvin/php-rrule

Lightweight and fast recurrence rules for PHP (RFC 5545)

69810.6M39](/packages/rlanvin-php-rrule)[wilianx7/php-recurring

PHP library to make getting dates easier when working with recurring tasks.

1045.0k](/packages/wilianx7-php-recurring)[mollie/laravel-cashier-mollie

Laravel Cashier provides an expressive, fluent interface to Mollie's subscription billing services.

172155.4k1](/packages/mollie-laravel-cashier-mollie)[plummer/calendarful

Calendar generator that allows for recurring events.

1142.1k](/packages/plummer-calendarful)[unclecheese/eventcalendar

Event Calendar for the SilverStripe CMS

3215.2k8](/packages/unclecheese-eventcalendar)

PHPackages © 2026

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