# Введение
Phasis — это чистый PHP-движок JavaScript. Он выполняет лексический анализ, разбирает и исполняет ECMAScript в процессе хоста PHP — без `exec('node …')`, без FFI и без пользовательского бинарного расширения. Для работы нужны три стандартных расширения PHP: `ext-mbstring`, `ext-bcmath` и `ext-curl` (транспорт `fetch()` по умолчанию). `ext-intl` и `ext-openssl` необязательны. Сборки без `bcmath` описаны в [Начале работы](https://phasis.inline0.dev/ru/docs/getting-started).

- **Встраиваемый** — добавьте среду выполнения JS в любое приложение PHP, фреймворк или инструмент CLI через класс `Phasis\Engine`.
- **Соответствует спецификации** — проходит официальный набор тестов test262 на 100 %, во всех категориях, без пропусков.
- **Веб-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` и полноценный цикл событий. Проходят 100 % импортированных Web Platform Tests.
- **Современные возможности** — стрелочные функции, классы, async/await, Promises, генераторы, Symbol, BigInt, Proxy, Reflect, Temporal, Intl, TypedArrays, полная поддержка модулей.
- **Взаимодействие PHP↔JS** — передавайте скаляры и массивы PHP в JS (массивы копируются), привязывайте замыкания PHP как функции JS и вызывайте функции JS из PHP. Объектами PHP пока нельзя делиться с JS; см. [Общие объекты](https://phasis.inline0.dev/ru/docs/interop/shared-objects).

## Зачем нужен Phasis

PHP-приложениям, которым нужно выполнять пользовательский JavaScript, — например, шаблонизаторам, прослойкам для SSR интерфейса, правилам проверки данных, изолированным средам для контента и автономным средствам запуска тестов, — обычно приходится запускать Node.js во внешнем процессе или отказываться от этой функции. Оба варианта усложняют эксплуатацию: требуется вторая среда выполнения, граница сериализации, сеть каналов между подпроцессами и сложная для развертывания архитектура на shared-хостинге.

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`, генераторы, асинхронные итераторы, модули.
- Предоставляет API **Web Platform**, наличие которых реальные библиотеки JS проверяют заранее: `URL`, `URLSearchParams`, `TextEncoder`/`TextDecoder`, `atob`/`btoa`, `structuredClone`, `performance`, `DOMException`. Полный список возможностей см. в разделе [Веб-API](https://phasis.inline0.dev/ru/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` для передачи значений через границы асинхронных операций.
- Поддерживает современный синтаксис — деструктуризацию, spread/rest, вычисляемые свойства, опциональную цепочку вызовов, оператор объединения с null, шаблонные строки, шаблоны с тегами, классы (с приватными полями, статическими блоками, декораторами), await верхнего уровня.
- Преобразует значения на границе PHP↔JS. Скалярные значения и массивы копируются при передаче внутрь, вызываемые объекты PHP становятся функциями JS, а результаты JS возвращаются как скалярные значения и массивы PHP. Точные правила см. в разделе [Преобразование значений](https://phasis.inline0.dev/ru/docs/interop/values).
- Работает под управлением хоста. Хост управляет транспортом `fetch` и хуками политик; цикл событий использует виртуальное время, а фиксированный предел глубины стека вызовов останавливает бесконечную рекурсию. Ограничение числа итераций цикла предусмотрено, но пока не применяется к циклам, выполняемым виртуальной машиной байт-кода; также нет ограничений на длину строк, вывод или реальное время. См. [API: setLimit](https://phasis.inline0.dev/ru/docs/api#setlimit).
- Проверяется с помощью Node.js (V8). CI запускает наборы модульных тестов и тестов с эталонными результатами при каждом отправлении изменений в `main` и каждом pull request, а Web Platform Tests и тесты популярных пакетов — при изменении исходного кода движка. Полная матрица test262 запускается вручную, а ее снимок фиксируется в `COMPAT.md`. См. [Совместимость](https://phasis.inline0.dev/ru/docs/compatibility).

## Чем merql не является

Phasis — не JIT-компилятор. Это интерпретатор с обходом дерева и виртуальной машиной байт-кода, которая используется при подходящих условиях. В задачах, ограниченных диспетчеризацией, ожидайте скорость примерно в 100× ниже, чем у V8. Компромисс — отсутствие зависимостей, чистый PHP и выполнение под управлением хоста: это идеально для встраивания JavaScript в приложения PHP, где корректность и изоляция важнее максимальной пропускной способности.

## С чего начать

- [Начало работы](https://phasis.inline0.dev/ru/docs/getting-started) — установите и запустите первый скрипт.
- [CLI](https://phasis.inline0.dev/ru/docs/cli) — `bin/phasis` для запуска файлов, вычисления исходного кода и вывода AST.
- [API](https://phasis.inline0.dev/ru/docs/api) — встроить `Phasis\Engine` в приложение PHP.
- [Взаимодействие](https://phasis.inline0.dev/ru/docs/interop) — передавайте значения и вызываемые объекты PHP в JavaScript.
- [Совместимость](https://phasis.inline0.dev/ru/docs/compatibility) — покрытие test262 и поддерживаемые возможности.
- [Парсер](https://phasis.inline0.dev/ru/docs/parser) — разбирайте JavaScript в типизированное AST или ESTree без выполнения.
- [Форматтер](https://phasis.inline0.dev/ru/docs/formatter) — форматируйте JavaScript, JSON и CSS в стиле, совместимом с Prettier.
- [Дополнительные сведения](https://phasis.inline0.dev/ru/docs/advanced) — архитектура, виртуальная машина байт-кода, тесты производительности и модель тестирования с эталонными результатами.