https://github.com/wiz-develop/php-monad
📦 Implemented the concept of monads in functional programming in PHP.
https://github.com/wiz-develop/php-monad
Last synced: about 1 year ago
JSON representation
📦 Implemented the concept of monads in functional programming in PHP.
- Host: GitHub
- URL: https://github.com/wiz-develop/php-monad
- Owner: wiz-develop
- License: mit
- Created: 2024-05-03T13:46:54.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-08T05:05:32.000Z (about 1 year ago)
- Last Synced: 2025-04-08T05:30:30.283Z (about 1 year ago)
- Language: PHP
- Size: 129 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# php-monad
[](https://packagist.org/packages/wiz-develop/php-monad)
[](https://packagist.org/packages/wiz-develop/php-monad)
[](https://github.com/endou-mame/php-monad/actions)
[](LICENSE)
[](https://packagist.org/packages/wiz-develop/php-monad)
📦 PHP で関数型プログラミングのモナドの概念を実装したライブラリです。
## 目次
- [php-monad](#php-monad)
- [目次](#目次)
- [Features](#features)
- [Installation](#installation)
- [プロジェクト構造](#プロジェクト構造)
- [Usage](#usage)
- [Option Monad](#option-monad)
- [Result Monad](#result-monad)
- [API Reference](#api-reference)
- [Option\](#optiont)
- [静的メソッド](#静的メソッド)
- [インスタンスメソッド](#インスタンスメソッド)
- [Result\](#resultt-e)
- [静的メソッド](#静的メソッド-1)
- [インスタンスメソッド](#インスタンスメソッド-1)
- [Contributing](#contributing)
- [License](#license)
- [References](#references)
## Features
- `Option` - 「値がある」(`Some`)か「値がない」(`None`)かを表現する型
- `Result` - 「成功」(`Ok`)か「失敗」(`Err`)かを表現する型
## Installation
```bash
composer require wiz-develop/php-monad
```
## プロジェクト構造
以下の図は、php-monadプロジェクトの構造を表しています。コアライブラリ、テスト、ツールとその関連性を視覚的に示しています。
```mermaid
flowchart TD
%% Core Library Subgraph
subgraph "Core Library"
M("Monad"):::core
O("Option"):::core
R("Result"):::core
SF("Shared Functions"):::core
S("Some"):::core
N("None"):::core
OH("Option Helpers"):::core
Ok("Ok"):::core
Er("Err"):::core
RH("Result Helpers"):::core
end
%% Tests Subgraph
subgraph "Tests"
TI("Test Infrastructure"):::test
OT("Option Tests"):::test
RT("Result Tests"):::test
end
%% Tooling and Configuration Subgraph
subgraph "Tooling and Configuration"
C("Composer"):::tool
SA("Static Analysis"):::tool
CS("Code Style"):::tool
CICD("CI/CD"):::tool
DEV("Dev Environment"):::tool
end
%% Relationships within Core Library
M -->|"extends"| O
M -->|"extends"| R
O -->|"implements"| S
O -->|"implements"| N
O -->|"supports"| OH
R -->|"implements"| Ok
R -->|"implements"| Er
R -->|"supports"| RH
SF -->|"supports"| O
SF -->|"supports"| R
%% Relationships from Tests to Core Library Components
TI -->|"validates"| O
TI -->|"validates"| R
OT -->|"tests"| O
RT -->|"tests"| R
%% Relationships from Tools to Core Library (via Monad as a representative)
C -->|"manages"| M
SA -->|"analyzes"| M
CS -->|"styles"| M
CICD -->|"CI/CD"| M
DEV -->|"dev-environment"| M
%% Styles for Nodes
classDef core fill:#AED6F1,stroke:#2471A3,stroke-width:2px;
classDef test fill:#A9DFBF,stroke:#239B56,stroke-width:2px;
classDef tool fill:#F9E79F,stroke:#B7950B,stroke-width:2px;
%% Click Events
click M "https://github.com/endou-mame/php-monad/blob/main/src/Monad.php"
click O "https://github.com/endou-mame/php-monad/blob/main/src/Option.php"
click S "https://github.com/endou-mame/php-monad/blob/main/src/Option/Some.php"
click N "https://github.com/endou-mame/php-monad/blob/main/src/Option/None.php"
click OH "https://github.com/endou-mame/php-monad/blob/main/src/Option/functions.php"
click R "https://github.com/endou-mame/php-monad/blob/main/src/Result.php"
click Ok "https://github.com/endou-mame/php-monad/blob/main/src/Result/Ok.php"
click Er "https://github.com/endou-mame/php-monad/blob/main/src/Result/Err.php"
click RH "https://github.com/endou-mame/php-monad/blob/main/src/Result/functions.php"
click SF "https://github.com/endou-mame/php-monad/blob/main/src/functions.php"
click TI "https://github.com/endou-mame/php-monad/blob/main/tests/TestCase.php"
click OT "https://github.com/endou-mame/php-monad/tree/main/tests/Unit/Option"
click RT "https://github.com/endou-mame/php-monad/tree/main/tests/Unit/Result"
click C "https://github.com/endou-mame/php-monad/blob/main/composer.json"
click SA "https://github.com/endou-mame/php-monad/blob/main/phpstan.neon.dist"
click CS "https://github.com/endou-mame/php-monad/blob/main/.php-cs-fixer.dist.php"
click CICD "https://github.com/endou-mame/php-monad/tree/main/.github/workflows"
click DEV "https://github.com/endou-mame/php-monad/blob/main/.devcontainer/devcontainer.json"
```
この図は以下の構成要素を示しています：
1. **コアライブラリ**：
- 基本となるMonadクラス
- Option型とそのSome/None実装
- Result型とそのOk/Err実装
- 共有関数やヘルパー関数
2. **テスト**：
- テストインフラストラクチャ
- Option型とResult型のテスト
3. **ツールと設定**：
- Composer（依存関係管理）
- 静的解析ツール
- コードスタイルチェック
- CI/CD設定
- 開発環境設定
各ノードはGitHubリポジトリ内の該当ファイルにリンクされています。
## Usage
### Option Monad
`Option` は値が存在する可能性がある場合に使用します。`null` の代わりに使用することで、より型安全なコードを書くことができます。
```php
use WizDevelop\PhpMonad\Option;
// 値がある場合（Some）
$some = Option::some("Hello, World!");
echo $some->unwrap(); // "Hello, World!"
// 値がない場合（None）
$none = Option::none();
// echo $none->unwrap(); // 例外が発生します
// 値の存在チェック
if ($some->isSome()) {
echo "値が存在します";
}
// デフォルト値の提供
echo $none->unwrapOr("Default Value"); // "Default Value"
// mapによる値の変換
$length = $some->map(fn($str) => strlen($str)); // Option::some(13)
// フィルタリング
$filtered = $some->filter(fn($str) => strlen($str) > 10); // Option::some("Hello, World!")
$filtered = $some->filter(fn($str) => strlen($str) > 20); // Option::none()
// 複数のOptionを連鎖
function findUser(string $id): Option {
// ...
}
function getUserPreferences(User $user): Option {
// ...
}
$preferences = findUser("123")
->flatMap(fn($user) => getUserPreferences($user));
```
### Result Monad
`Result` は処理が成功するか失敗するかを表現するのに使用します。例外を投げる代わりに使用することで、エラーハンドリングを型安全に行うことができます。
```php
use WizDevelop\PhpMonad\Result;
// 成功の場合（Ok）
$ok = Result::ok(42);
echo $ok->unwrap(); // 42
// 失敗の場合（Err）
$err = Result::err("Something went wrong");
// echo $err->unwrap(); // 例外が発生します
echo $err->unwrapErr(); // "Something went wrong"
// エラーチェック
if ($ok->isOk()) {
echo "処理は成功しました";
}
if ($err->isErr()) {
echo "エラーが発生しました";
}
// デフォルト値の提供
echo $err->unwrapOr(0); // 0
// mapによる値の変換
$doubled = $ok->map(fn($n) => $n * 2); // Result::ok(84)
// エラー値の変換
$newErr = $err->mapErr(fn($e) => "Error: " . $e); // Result::err("Error: Something went wrong")
// 複数のResultを連鎖
function fetchData(string $url): Result {
// ...
}
function processData($data): Result {
// ...
}
$processed = fetchData("https://api.example.com")
->flatMap(fn($data) => processData($data));
```
## API Reference
### Option\
#### 静的メソッド
- `Option::some($value)` - Some\インスタンスを生成
- `Option::none()` - Noneインスタンスを生成
- `Option::from($value)` - 値からOptionを生成（nullの場合はNone、それ以外はSome）
#### インスタンスメソッド
- `isSome(): bool` - 値が存在するかチェック
- `isNone(): bool` - 値が存在しないかチェック
- `unwrap(): T` - 値を取り出す（Noneの場合は例外）
- `unwrapOr($default): T` - 値を取り出すか、デフォルト値を返す
- `map(callable $f): Option` - 値を変換
- `flatMap(callable $f): Option` - 値を別のOptionに変換
- `filter(callable $predicate): Option` - 条件に合致する場合のみSomeを返す
- `expect(string $msg): T` - 値を取り出す（Noneの場合はカスタムメッセージで例外）
- `toResult($err): Result` - OptionをResultに変換
### Result\
#### 静的メソッド
- `Result::ok($value)` - Ok\インスタンスを生成
- `Result::err($error)` - Err\インスタンスを生成
#### インスタンスメソッド
- `isOk(): bool` - 処理が成功したかチェック
- `isErr(): bool` - 処理が失敗したかチェック
- `unwrap(): T` - 値を取り出す（Errの場合は例外）
- `unwrapOr($default): T` - 値を取り出すか、デフォルト値を返す
- `unwrapErr(): E` - エラー値を取り出す（Okの場合は例外）
- `map(callable $f): Result` - 値を変換
- `mapErr(callable $f): Result` - エラー値を変換
- `flatMap(callable $f): Result` - 値を別のResultに変換
- `expect(string $msg): T` - 値を取り出す（Errの場合はカスタムメッセージで例外）
- `toOption(): Option` - ResultをOptionに変換
## Contributing
貢献は歓迎します！バグ報告、機能リクエスト、プルリクエストなど、どんな形でも構いません。
1. リポジトリをフォークする
2. 機能ブランチを作成する (`git checkout -b feature/amazing-feature`)
3. 変更をコミットする (`git commit -m 'Add some amazing feature'`)
4. ブランチをプッシュする (`git push origin feature/amazing-feature`)
5. プルリクエストを作成する
## License
MIT License - [LICENSE](LICENSE)ファイルをご覧ください。
## References
- [Option型とResult型で安全なPHPを書こう](https://zenn.dev/pixiv/articles/f109b02aa9d4e0)
- [Rust - Option enum](https://doc.rust-lang.org/std/option/enum.Option.html)
- [Rust - Result enum](https://doc.rust-lang.org/std/result/enum.Result.html)
- [Functional programming in PHP](https://phel-lang.org/)