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

- **Възможност за вграждане** — добавете среда за изпълнение на JS във всяко приложение на PHP, рамка или инструмент на CLI чрез класа `Phasis\Engine`.
- **Съответствие със спецификацията** — преминава официалния набор от тестове test262 на 100 %, във всички категории и без пропуснати тестове.
- **Уеб API** — пълен **пакет за уеб платформата** (URL, TextEncoder/Decoder, atob/btoa, structuredClone, performance, DOMException), пълен **пакет Fetch** (fetch, Request, Response, Headers, Body, AbortController/Signal, Blob, File, FormData, EventTarget, пълна поддръжка на WHATWG Streams, navigator), плюс `crypto` + `SubtleCrypto`, `WebSocket`, `XMLHttpRequest` и реален цикъл на събитията. 100 % от импортираните тестове на уеб платформата преминават.
- **Модерен синтаксис** — стрелкови функции, класове, async/await, Promises, генератори, Symbol, BigInt, Proxy, Reflect, Temporal, Intl, TypedArrays, пълна поддръжка на модули.
- **Взаимодействие между PHP и JS** — подаване на скаларни стойности и масиви на JS чрез PHP (масивите се копират), обвързване на затварянията на PHP като функции на JS и извикване на функции на PHP от JS. Обектите на PHP все още не могат да се споделят с JS; вижте [Споделени обекти](https://phasis.inline0.dev/bg/docs/interop/shared-objects).

## Защо съществува Phasis

Приложенията на PHP, които трябва да изпълняват предоставен от потребителя JavaScript — енджини за шаблони, заместители за SSR във фронтенда, правила за валидиране на данни, изолирани среди за съдържание, безграфични тестови изпълнители — обикновено стартират Node.js като външен процес или пропускат тази функционалност. И двата подхода добавят оперативна сложност: втора среда за изпълнение, граница за сериализация, мрежа от канали за подпроцеси и трудна за защита конфигурация при споделен хостинг.

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`. Вижте [Web APIs](https://phasis.inline0.dev/bg/docs/compatibility/web-apis) за пълния набор.
- Включва **`fetch`** с пълното семейство Fetch — `Request`, `Response`, `Headers`, четци на тялото, `AbortController`/`AbortSignal`, `Blob`, `File`, `FormData`, `EventTarget`/`Event` и пълния WHATWG Streams (`ReadableStream`, `WritableStream`, `TransformStream`, BYOB, стратегии за опашки). Реалният HTTP работи веднага чрез `ext-curl` на PHP.
- Включва **`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, изчисляеми свойства, незадължително свързване, сливане при nullish стойности, шаблонни литерали, маркирани шаблони, класове (с частни полета, статични блокове и декоратори), top-level await.
- Преобразува стойности през границата PHP↔JS. Скаларните стойности и масивите се копират навътре, извикваемите стойности PHP стават функции JS, а резултатите от JS се връщат като скаларни стойности и масиви PHP. Вижте [Преобразуване на стойности](https://phasis.inline0.dev/bg/docs/interop/values) за точните правила.
- Работи под контрола на хоста. Хостът управлява транспорта `fetch` и кукичките за правила, цикълът на събитията работи с виртуално време, а фиксираният лимит на дълбочината на стека спира безконтролната рекурсия. Има лимит за итерациите на цикъла, но той все още не се прилага за цикли, изпълнявани от байткод VM; няма лимити за дължина на низове, изход или реално време. Вижте [API: setLimit](https://phasis.inline0.dev/bg/docs/api#setlimit).
- Проверява се спрямо Node.js (V8). CI изпълнява тестовете за единици и oracle при всяко качване към `main` и при всяка заявка за изтегляне, а тестовете Web Platform Tests и пакетите от реалния свят — при промяна в кода на машината; пълната матрица test262 се изпълнява ръчно и моментната ѝ снимка се комитва в `COMPAT.md`. Вижте [Съвместимост](https://phasis.inline0.dev/bg/docs/compatibility).

## Какво не е

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

## Откъде да започнете

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