keerill/php-java-optional

Full implementation of Java8 Optional for PHP

v1.0.2 2023-12-13 13:33 UTC

Requires

• php: ^8.1

Requires (Dev)

• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^10.0

Apache-2.0

• Serhat ÖZDAL
• Kirill Popkov

• php optional
• java optional
• php java optional

README

Full implementation of JAVA8 Optional for PHP

Usage

// ofEmpty refers Optional#empty() in java
// It is renamed as ofEmpty() because of empty() is reserved by PHP 
Optional::ofEmpty()
    ->isPresent(); // false

Optional::of('value')
    ->orElse('elseValue'); // value
 
Optional::ofEmpty()
    ->orElseThrow(fn () => new InvalidArgumentException()); // throws exception

Optional::ofEmpty()
    ->filter(fn ($a) => (int) $a); // function is not executed

Optional::of(5)
    ->map(fn ($a) => $a * 2)
    ->get(); // returns 10

Optional::ofEmpty()
    ->orElseGet(fn () => 10); // returns 10

Installation

composer require keerill/php-java-optional

Resources

• Java 8 Optional Documentation
• Java 8 Optional Usage

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• kEERIll
• serhatozdal
• All Contributors

License

The MIT License (MIT). Please see License File for more information.