PHPackages valbeat/result - 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. [Utility & Helpers](/categories/utility) 4. / 5. valbeat/result ActiveLibrary[Utility & Helpers](/categories/utility) valbeat/result ============== A Result type implementation for PHP inspired by Rust v0.0.3(5mo ago)6624↓18.2%MITPHPPHP ^8.4CI passing Since Jul 15Pushed 1mo agoCompare [ Source](https://github.com/valbeat/php-result)[ Packagist](https://packagist.org/packages/valbeat/result)[ Docs](https://github.com/valbeat/php-result)[ RSS](/packages/valbeat-result/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (3)Versions (7)Used By (0) PHP Result ========== [](#php-result) [![Packagist Version](https://camo.githubusercontent.com/980aac8b6c90b8af619ea952853f0db47c8d913746bcaf882de7789478facdad/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f76616c626561742f726573756c74)](https://camo.githubusercontent.com/980aac8b6c90b8af619ea952853f0db47c8d913746bcaf882de7789478facdad/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f76616c626561742f726573756c74)[![codecov](https://camo.githubusercontent.com/7511f59a5fa294ac08ec4871f81fbde740594ac22afb239c88a5b19e86c02f50/68747470733a2f2f636f6465636f762e696f2f67682f76616c626561742f7068702d726573756c742f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/valbeat/php-result) A Result type implementation for PHP inspired by Rust's `Result` type. This library provides a robust way to handle operations that might fail, without relying on exceptions. It encourages explicit error handling and makes it impossible to accidentally ignore errors. Installation ------------ [](#installation) ``` composer require valbeat/result ``` Requirements ------------ [](#requirements) - PHP 8.4 or higher - Composer Basic Usage ----------- [](#basic-usage) ``` use Valbeat\Result\Ok; use Valbeat\Result\Err; use Valbeat\Result\Result; // Creating Results $success = new Ok(42); $failure = new Err("Something went wrong"); // Pattern matching with match expression $message = $success->match( ok: fn($value) => "Success: $value", err: fn($error) => "Error: $error" ); echo $message; // "Success: 42" // Checking if a Result is Ok or Err if ($success->isOk()) { echo "Operation succeeded!"; } if ($failure->isErr()) { echo "Operation failed!"; } // Unwrapping values (throws exception on error) $value = $success->unwrap(); // 42 // $failure->unwrap(); // throws LogicException // Safe unwrapping with default values $value = $failure->unwrapOr(0); // 0 $value = $failure->unwrapOrElse(fn($err) => strlen($err)); // 19 ``` Advanced Usage -------------- [](#advanced-usage) ### Transforming Results [](#transforming-results) ``` // Map over success values $result = (new Ok(5)) ->map(fn($x) => $x * 2) ->map(fn($x) => $x + 1); echo $result->unwrap(); // 11 // Map over error values $result = (new Err("error")) ->mapErr(fn($e) => strtoupper($e)); echo $result->unwrapErr(); // "ERROR" ``` ### Chaining Operations [](#chaining-operations) ``` // Chain operations that might fail $result = (new Ok(10)) ->andThen(fn($x) => $x > 5 ? new Ok($x * 2) : new Err("Too small")) ->andThen(fn($x) => new Ok($x + 5)); echo $result->unwrap(); // 25 // Short-circuit on first error $result = (new Ok(2)) ->andThen(fn($x) => $x > 5 ? new Ok($x * 2) : new Err("Too small")); echo $result->unwrapErr(); // "Too small" ``` ### Combining Results [](#combining-results) ``` // Use first Ok value $result = (new Err("first error")) ->or(new Err("second error")) ->or(new Ok(42)); echo $result->unwrap(); // 42 // Use first Ok or call function $result = (new Err("error")) ->orElse(fn($e) => new Ok(strlen($e))); echo $result->unwrap(); // 5 ``` ### Side Effects [](#side-effects) ``` // Inspect values without consuming the Result $result = (new Ok(42)) ->inspect(fn($x) => print("Value is: $x\n")) ->map(fn($x) => $x * 2); // Inspect errors $result = (new Err("oops")) ->inspectErr(fn($e) => error_log("Error occurred: $e")); ``` API Reference ------------- [](#api-reference) ### Result Methods [](#result-methods) All Result types (both Ok and Err) implement these methods: #### Type Checking [](#type-checking) - `isOk(): bool` - Returns true if the Result is Ok - `isOkAnd(callable $fn): bool` - Returns true if the Result is Ok and the predicate returns true - `isErr(): bool` - Returns true if the Result is Err - `isErrAnd(callable $fn): bool` - Returns true if the Result is Err and the predicate returns true #### Value Extraction [](#value-extraction) - `unwrap(): mixed` - Returns the success value or throws LogicException - `unwrapErr(): mixed` - Returns the error value or throws LogicException - `unwrapOr(mixed $default): mixed` - Returns the success value or a default - `unwrapOrElse(callable $fn): mixed` - Returns the success value or computes it from the error #### Transformation [](#transformation) - `map(callable $fn): Result` - Maps a Result<T, E> to Result<U, E> by applying a function to the success value - `mapErr(callable $fn): Result` - Maps a Result<T, E> to Result<T, F> by applying a function to the error value - `mapOr(mixed $default, callable $fn): mixed` - Maps the success value or returns a default - `mapOrElse(callable $defaultFn, callable $fn): mixed` - Maps the success value or computes a default from the error #### Combination [](#combination) - `and(Result $res): Result` - Returns the second Result if the first is Ok, otherwise returns the first Err - `andThen(callable $fn): Result` - Chains another operation that returns a Result - `or(Result $res): Result` - Returns the first Ok or the second Result if the first is Err - `orElse(callable $fn): Result` - Returns the first Ok or calls a function with the error to produce a Result #### Side Effects [](#side-effects-1) - `inspect(callable $fn): Result` - Calls a function with the success value if Ok - `inspectErr(callable $fn): Result` - Calls a function with the error value if Err #### Pattern Matching [](#pattern-matching) - `match(callable $okFn, callable $errFn): mixed` - Pattern match on the Result License ------- [](#license) This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. ### Health Score 43 — FairBetter than 91% of packages Maintenance81 Actively maintained with recent releases Popularity24 Limited adoption so far Community9 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 71.4% 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 ~46 days Total 4 Last Release 168d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/da8040b74364fe9a4f820bea150770a248a2b00cc9b67f658f6524507e174dc8?d=identicon)[valbeat](/maintainers/valbeat) --- Top Contributors [![valbeat](https://avatars.githubusercontent.com/u/3125309?v=4)](https://github.com/valbeat "valbeat (95 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (34 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (4 commits)") --- Tags phpresult-patternresult-typetyperesultfunctionalerror handlingmonadrust ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/valbeat-result/health.svg) ``` [![Health](https://phpackages.com/badges/valbeat-result/health.svg)](https://phpackages.com/packages/valbeat-result) ``` ### Alternatives [phpoption/phpoption Option Type for PHP 2.7k541.2M159](/packages/phpoption-phpoption)[graham-campbell/result-type An Implementation Of The Result Type 552378.1M7](/packages/graham-campbell-result-type)[jetbrains/phpstorm-stubs PHP runtime & extensions header files for PhpStorm 1.4k27.7M68](/packages/jetbrains-phpstorm-stubs)[marc-mabe/php-enum Simple and fast implementation of enumerations with native PHP 49644.8M97](/packages/marc-mabe-php-enum)[symfony/type-info Extracts PHP types information. 19951.9M114](/packages/symfony-type-info)[chippyash/monad Functional programming Monad support 2828.1k8](/packages/chippyash-monad) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)