ciarancoza/option-result

Rust-like Option and Result Classes for PHP

v0.10.0 2025-11-30 12:29 UTC

Requires (Dev)

• laravel/pint: ^1.25
• phpdocumentor/phpdocumentor: v3.9.0
• phpunit/phpunit: ^12.4
• saggre/phpdocumentor-markdown: ^1.0

MIT

• Ciaran

README

"So you can take down ~20% of the internet, but with PHP"

This library contains two classes: Option and Result.

Option<T> represents an optional value. An option may be some or none, where some(T) contains a value and none does not.

Result<T,E> represents a success (ok(T)) or an error (err(E)).

Installation

composer require ciarancoza/option-result

Usage

Option

function findUser(int $id): Option {
    $user = User::find($id);
    return $user ? Option::Some($user) : Option::None();
}

function getUserTheme(int $userId): string {
    return findUser($userId)
        ->map(fn ($user) => $user->theme)
        ->map(fn ($theme) => strtolower($theme))
        ->unwrapOr('auto');
}

Result

function fetchOrgData(int $id): Result {
    try {
        $response = Http::get("/api/orgs/{$id}");
        if ($response->failed()) return Result::Err("API request failed: " . $response->status());
        return Result::Ok($response->json());
    } catch (Exception $e) {
        return Result::Err("Connection error: " . $e->getMessage());
    }
}

function getActiveEmails(int $orgId): array {
    return fetchOrgData($orgId)
        ->map(fn ($org) => $org->getEmails())
        ->map(fn ($emails) => $emails['active'])
        ->mapErr(fn ($error) => "Failed to get active emails: " . $error)
        ->mapErr(fn ($error) => Log::error($error))
        ->unwrapOr([]);
}

You can view the generated documentation for more usage details.

Road Map

• Result
  • TODO
    • inspect()
    • inspectErr()
    • or()
    • tryCatch()
  • Refactor for v1

Contributing

Go for it! There are plenty of useful Option / Result features in Rust we could implement in this library.