# はじめに
Phasisは純粋なPHP製のJavaScriptエンジンです。ホストのPHPプロセス内でECMAScriptを字句解析、構文解析、実行します。`exec('node …')`、FFI、カスタムバイナリ拡張は不要です。標準のPHP拡張が3つ必要です。`ext-mbstring`、`ext-bcmath`、およびデフォルトの`fetch()`トランスポートである`ext-curl`です。`ext-intl`と`ext-openssl`は任意です。`bcmath`を含めないビルドについては[はじめに](https://phasis.inline0.dev/ja/docs/getting-started)をご覧ください。

- **埋め込み可能** — `Phasis\Engine`クラスを使って、任意のPHPアプリ、フレームワーク、CLIツールにJSランタイムを組み込めます。
- **仕様準拠** — 公式test262スイートの全カテゴリをスキップなしで100 %通過します。
- **Web API** — **Web Platform Pack**全機能（URL、TextEncoder/Decoder、atob/btoa、structuredClone、performance、DOMException）、**Fetch Pack**全機能（fetch、Request、Response、Headers、Body、AbortController/Signal、Blob、File、FormData、EventTarget、WHATWG Streams全機能、navigator）に加え、`crypto` + `SubtleCrypto`、`WebSocket`、`XMLHttpRequest`、実際のイベントループを搭載。インポートしたWeb Platform Testsの100 %に合格します。
- **モダンな機能** — アロー関数、クラス、async/await、Promises、ジェネレーター、Symbol、BigInt、Proxy、Reflect、Temporal、Intl、TypedArrays、モジュールの完全サポート。
- **PHP↔JS相互運用** — PHPのスカラー値と配列をJSに渡せます（配列はコピーされます）。PHPのクロージャをJS関数としてバインドし、PHPからJS関数を呼び出せます。PHPオブジェクトはまだJSと共有できません。[共有オブジェクト](https://phasis.inline0.dev/ja/docs/interop/shared-objects)をご覧ください。

## Phasisが作られた理由

ユーザー提供のJavaScriptを実行する必要があるPHPアプリ（テンプレートエンジン、フロントエンドSSRの代替手段、データ検証ルール、コンテンツのサンドボックス、ヘッドレステストランナーなど）は、通常Node.jsを別プロセスで起動するか、機能自体を見送ります。どちらの方法でも運用は複雑になります。2つ目のランタイム、シリアライズ境界、サブプロセスとの多数のパイプ、共有ホスティングでの扱いにくいデプロイ構成が必要です。

Phasisはその課題を解決します。PHPのコードはJavaScriptを字句解析、構文解析、実行できます。必要なのはPHP 8.2+、`mbstring`、`bcmath`、`curl`だけです。エンジンはComposerパッケージとして提供され、シンプルで小さなAPIインターフェースを備えています。

## 機能

- ECMAScript標準ライブラリ全体を実装：`Array`、`String`、`Object`、`Math`、`JSON`、`Date`、`RegExp`、`Map`、`Set`、`Promise`、`Proxy`、`Reflect`、`Symbol`、`BigInt`、`TypedArray`、`Temporal`、`Intl`、ジェネレーター、asyncイテレーター、モジュール。
- 実際のJSライブラリが事前に存在を確認する**Web Platform** APIを搭載：`URL`、`URLSearchParams`、`TextEncoder`/`TextDecoder`、`atob`/`btoa`、`structuredClone`、`performance`、`DOMException`。全機能については[Web API](https://phasis.inline0.dev/ja/docs/compatibility/web-apis)をご覧ください。
- **`fetch`** にFetch関連の全機能を搭載 — `Request`、`Response`、`Headers`、ボディの読み取りメソッド、`AbortController`/`AbortSignal`、`Blob`、`File`、`FormData`、`EventTarget`/`Event`、WHATWG Streams全機能（`ReadableStream`、`WritableStream`、`TransformStream`、BYOB、キューイング戦略）。実際のHTTPはPHPの`ext-curl`によってすぐに使えます。
- **`crypto`** と`SubtleCrypto`全機能（SHAファミリー、HMAC、AES-GCM/CBC/CTR、RSA-OAEP/PSS/PKCS1、ECDSA、ECDH、HKDF、PBKDF2）、**`WebSocket`**（RFC 6455 + 交換可能なトランスポート）、**`XMLHttpRequest`**（同じfetchトランスポートを基盤として実装）を搭載。
- 実際の**イベントループ**を搭載：`setTimeout`、`setInterval`、`clearTimeout`、`clearInterval`、`queueMicrotask`に加え、非同期境界を越えて値を伝播するStage-3の`AsyncContext`。
- モダンな構文をサポート — 分割代入、スプレッド/レスト、計算されたプロパティ、オプショナルチェーン、Null合体、テンプレートリテラル、タグ付きテンプレート、クラス（プライベートフィールド、staticブロック、デコレーターを含む）、トップレベルawait。
- PHP↔JS境界で値を変換。スカラー値と配列はコピーして渡され、PHPの呼び出し可能オブジェクトはJS関数になり、JSからの結果はPHPのスカラー値と配列として返されます。詳しい規則は[値の変換](https://phasis.inline0.dev/ja/docs/interop/values)をご覧ください。
- ホスト側で制御して実行。`fetch`トランスポートとポリシーフックはホストが管理し、イベントループは仮想時間で動作します。固定のコールスタック上限で無限再帰を防ぎます。ループ反復回数の上限はありますが、バイトコードVMが実行するループにはまだ適用されず、文字列長、出力、実時間の上限もありません。[API: setLimit](https://phasis.inline0.dev/ja/docs/api#setlimit)をご覧ください。
- Node.js（V8）に対して検証済み。CIはすべてのpushとプルリクエストで`main`のユニットテストとオラクルテストを実行し、エンジンのソースに変更があった場合はWeb Platform Testsと人気パッケージのテストも実行します。test262の全マトリクスは手動で実行し、結果のスナップショットを`COMPAT.md`にコミットします。[互換性](https://phasis.inline0.dev/ja/docs/compatibility)をご覧ください。

## merqlでできないこと

PhasisはJITコンパイラーではありません。ツリーウォーキングインタープリターと、状況に応じて使われるバイトコードVMです。ディスパッチがボトルネックとなる処理では、V8の約100倍の実行時間を見込んでください。依存関係ゼロの純粋なPHPと、ホストが実行を制御できることが利点です。生の処理速度より正確性と分離が重要なPHPアプリにJavaScriptを組み込む用途に最適です。

## まず読むページ

- [はじめに](https://phasis.inline0.dev/ja/docs/getting-started) — インストールして最初のスクリプトを実行します。
- [CLI](https://phasis.inline0.dev/ja/docs/cli) — ファイルの実行、ソースの評価、ASTの出力に使う`bin/phasis`。
- [API](https://phasis.inline0.dev/ja/docs/api) — PHPアプリに`Phasis\Engine`を埋め込みます。
- [相互運用](https://phasis.inline0.dev/ja/docs/interop) — PHPの値や呼び出し可能オブジェクトをJavaScriptに渡します。
- [互換性](https://phasis.inline0.dev/ja/docs/compatibility) — test262のカバレッジとサポート対象の機能。
- [パーサー](https://phasis.inline0.dev/ja/docs/parser) — JavaScriptを実行せずに型付きASTまたはESTreeへ解析します。
- [フォーマッター](https://phasis.inline0.dev/ja/docs/formatter) — prettier互換のレイアウトでJavaScript、JSON、CSSを整形します。
- [高度な内容](https://phasis.inline0.dev/ja/docs/advanced) — アーキテクチャ、バイトコードVM、ベンチマーク、オラクルテストの仕組み。