max13/dtion

Dtion allows you to serialize and unserialize conditions and results. For instace: if $x between 'A' and 'C', result is 'X'. Else if $x between 'D' and 'F', result is 'Y'.

v1.4.0 2022-09-01 18:51 UTC

This package is auto-updated.

Last update: 2024-10-29 06:19:48 UTC


README

How to serialize and store multiple if/else and the values corresponding to the different conditions?

Dtion is a serializable classes allowing you to store a condition and result. Dtion can store string, int, float, callable and Stringable values as boudaries and result. callable boundaries are evaluated during comparison but the result is returned as stored.

DtionList is also serializable and is used to store a list of Dtion, allowing you to find() the Dtion matching a given criterion, if any. DtionList can also directly return the resultFor() a matching criterion.

Example, you can store conditions like:

  • If the category of the employee is between 1 and 5, the prior notice is 1 month.
  • If the category of the employee is between 6 and 7, the prior notice is 2 months.
  • If the category of the employee is between 8 and 12, the prior notice is 3 months.

Here is another example using date intervals as conditions:

  • If the fixed term contract lasts from 0 to 6 months, then the trial period is 15 days.
  • Above 6 months, the trial period is 1 month.

Expressing these intervals (as DateInterval or CarbonInterval) as conditions with Dtion is easy. See bellow.

Installation

You can use composer: composer require max13/dtion

Usage

Using the examples above:

use Dtion\Dtion;
use Dtion\DtionList;

$priorNoticeList = new DtionList([
    new Dtion(1, 5, new DateInterval('P1M'),
    new Dtion(6, 7, new DateInterval('P2M'),
    new Dtion(8, 12, new DateInterval('P3M'),
]);


$category = 2;
$p = $priorNoticeList->resultFor($category);
// returns DateInterval('P1M')

$dtion = $priorNoticeList->find($category);
// returns the corresponding Dtion, or null if not found.
$result = $dtion->result();

Need help?

Open an issue.

Now have fun.