omitobisam / conditional
A fluent helper for object-oriented style of if-else statements
Requires
- php: >=7.4
Requires (Dev)
- phpunit/phpunit: ~8.0
- symfony/var-dumper: ^6.4
README
About Conditional
if-else statements in a cleaner and beautiful way.
conditional(isset($data)) ->then(fn() => doThis()) ->else(fn() => doThat());
Installation
composer require omitobisam/conditional
Minimum Requirement
- PHP >=7.4
Usage
You can call it simply statically:
use Conditional\Conditional; $data = null; Conditional::if(is_null($data)) ->then(fn() => doThis()) ->else(fn() => doThat());
Conditional also comes with a helper function called conditional()
and its used like so:
conditional(isset($data)) ->then(fn() => doThis()) ->else(fn() => doThat());
🎉 Now like a tenary operator. Conditional at version 1.2 else()
immediately returns the value of the last truthy execution:
conditional('1' === 'a', 1, 2); //returns 2 - without calling ->value() conditional(false, 1) ->else(2); //returns 2 - without calling ->value() // Of course the normal one conditional(false) ->then(1) ->else(2); //returns 2
You can also evaluate a closure call on the conditional if
method:
use Conditional\Conditional; Conditional::if(fn() => '1' == 1) // or conditional(fn() => 1 + 1) ->then(fn() => doThis()) // doThis() is executed ->else(fn() => doThat());
Conditional also allows returning values passed in the conditions.
You use value()
method to get the values either the result of the closure passed or the values as they are.
use Conditional\Conditional; $value = Conditional::if(fn() => 'a' !== 1) // or conditional(fn() => 'a' !== 1) ->then(1) ->value(); // returns 2 (because a !== 1) //do something with $value
Finally, then()
and else()
methods accepts invokable class or objects. Lets see:
use Conditional\Conditional; class Invokable { public function __invoke() { return 'I was Invoked'; } } $invokableClass = new Invokable(); $value = Conditional::if(fn() => 'a' === 1) // or conditional(fn() => 1 + 1) ->then(1) ->else($invokableClass); //Value returns 'I was Invoked' // Do something with $value
You are also allowed to throw exception based on the condition like so:
\conditional('foo' === 'bar') ->then('foo === bar') ->else(new TestException('Foo is not the same as bar')); //this exception is thrown
Newly released
elseIf()
method of Conditional like so:
conditional(isset($data)) ->then(fn() => doThis()) ->elseIf(is_int(1)) ->then(fn() => doThat()) ->else(2);
elseIf()
can be called multiple times on an instance:
$value = Conditional::if(false) ->then('a') ->elseIf('b' == 1) //first one ->then('b') ->elseIf('b' !== 2) //another ->then('2') ->else(1); // $value is '2'
Coming Soon
If()
and elseIf()
statement accepting a default value when no condition is met and else()
is not called like so:
Conditional::if(is_array('a'), 'ninja') //default value is ninja ->then(fn() => doThis()) ->elseIf(is_int("")) ->then(fn() => doThat()) ->value(); // 'ninja' is returned :scream:
Multiple conditional check like a && b && c && d
or a || b || c ||...
syntax
- Help wanted for this
Caveats (or Awareness)
- As at version 1.x, Calling
if()
method returns an instance of Condtional, so do not call it twice on the same instance for example:
// This is Wrong! Conditional::if(true) ->then(1) ->else(2) ->if('1'); // Don't do it except you intend to start a new and fresh if Conditional
See: tests/ConditionalTest::testEveryIfCallCreatesNewFreshInstance test. On the last line of that test, the two conditionals are not the same.
- Conditional relies on closures to return non closure values passed to then.
In the future release it will be optional for
then
andelse
method
Contributions
- More tests are needed
- Issues have been opened
- How about those static properties, any idea how to reduce the number of static properties used?
- Performance optimization (?)
Development
For new feature, checkout with prefix feat-#issueid
e.g feature-#100-add-auto-deloy
- Clone this repository
- run
sh dockerizer.sh
orbash dockerizer.sh
- execute into the docker environment with
docker-compose exec conditional sh
(sh
can be another bash) - run tests with
vendor/bin/phpunit
Licence
MIT (see LICENCE file)
Additional Information
Other related packages:
- https://github.com/transprime-research/piper [A functional PHP pipe in object-oriented way]
- https://github.com/transprime-research/arrayed [A smart PHP array class object-oriented way]
- https://github.com/transprime-research/attempt [A smart PHP try...catch statement]
- https://github.com/omitobi/carbonate [A smart Carbon + Collection package]
- https://github.com/omitobi/laravel-habitue [Jsonable Http Request(er) package with Collections response]