cline/monad

Rust-aligned Option, Result, and Either monads for type-safe error handling in PHP

1.1.0 2025-10-06 15:07 UTC

Requires

• php: ^8.4.0

Requires (Dev)

• cline/php-cs-fixer: ^1.0
• ergebnis/composer-normalize: ^2.49@dev
• laravel/pint: ^1.25.1
• orchestra/testbench: ^10.6
• peckphp/peck: ^0.1.3
• pestphp/pest: ^3.8.4
• pestphp/pest-plugin-type-coverage: ^3.6.1
• phpstan/phpstan: ^2.1.30
• rector/rector: ^2.2.0
• symfony/var-dumper: ^7.3.4

MIT

• Brian Faust

• php
• option
• functional-programming
• monad
• error-handling
• result
• rust
• either
• type-safety

README

This package provides a Rust-aligned Option, Result, and Either types providing expressive, type-safe error handling and ergonomic controller helpers for Laravel applications.

Requirements

Requires PHP 8.4+

Installation

composer require cline/monad

Documentation

• Option Guide - Complete guide with real-world examples for null-safe operations
• Result Guide - Comprehensive error handling patterns with Ok/Err semantics
• Either Guide - Advanced Left/Right branching for complex scenarios
• Transpose Guide - Swapping nested monads (Option ↔ Result)
• Quick Reference - API overview and highlights

Change log

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

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.

Credits

• Brian Faust
• All Contributors

License

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