# Známá omezení

Cílem Phasis je chovat se stejně jako V8 ve všech pozorovatelných testech specifikace. Tato stránka uvádí místa, kde se v praxi tato shoda vytrácí — obvykle kvůli zásadním rozdílům mezi interpretem PHP, který prochází strom, a strojem v C++ kompilovaným pomocí JIT.

## Výkonnostní strop

Stroj prochází syntaktický strom, využívá také příležitostný bajtkódový VM a transpiler JsToPhp, který převádí těla s převahou čísel a lokálních proměnných (včetně tvarů `obj.method()`, `new Ctor()` a `this.member`) na nativní uzávěry PHP, které JIT s trasováním z PHP 8.5 může zkompilovat do strojového kódu. Většina horkých cest vykonávání probíhá uvnitř přepínací smyčky VM nebo přímo v kódu PHP zkompilovaném JIT, nikoli procházením AST. Každá instrukce VM ale stále nese náklady na PHP, a každý tvar, který JsToPhp zatím nepodporuje, se vrací k pomalejší VM. U úloh omezených rychlostí vykonávání je strop přibližně **100× pomalejší než V8**.

U úloh využívajících vložený stroj — spouštění logiky dodané uživatelem nad daty PHP, kanálů pro transformaci obsahu a pravidel ověřování — tento strop obvykle nevadí. V8 trvá 100 ms; Phasis trvá 10 s; obojí je výrazně pod časovým limitem požadavku. Další zmenšení rozdílu by vyžadovalo rozšířit JsToPhp o více tvarů (odvozování typů parametrů, převod `await` / `yield*`) nebo generovat přímo opkódy opcache místo zprostředkování přes `eval()`. Viz [Srovnávací testy § Plán dalšího vývoje](https://phasis.inline0.dev/cs/docs/advanced/benchmarks#roadmap).

## Souběh více agentů

Model `SharedArrayBuffer` + `Atomics.wait` + `postMessage` v JavaScript předpokládá, že hostitelské prostředí může spouštět skutečná vlákna operačního systému. PHP to nedokáže (bez `pcntl_fork`, které není dostupné v každém hostitelském prostředí).

Phasis simuluje jediného agenta — `Atomics.wait` okamžitě vrací „not-equal“ nebo „timed-out“, `notify` vždy vrací 0. Projdou tak všechny testy test262 pro jednoho agenta (ověřování vstupu, chybové cesty, notifikace bez účinku), což zahrnuje 376 z 376 testů Atomics.

Testy, které vyžadují, aby se dva souběžní agenti navzájem pozorovali, nejsou podporovány. Pro skutečný paralelismus použijte frontu workerů na úrovni PHP (Redis, Beanstalkd, …).

## Sémantika realmů

`ShadowRealm` je implementováno, ale každá podřízená realm běží ve stejném procesu PHP jako hostitel. Funkce hostitele mohou mezi realmami předávat reference, pokud nebudete pečlivě izolovat kód PHP. Specifikace to umožňuje; V8 vynucuje přísnější izolaci pomocí samostatných instancí v8::Isolate.

`createRealm()` (testovací hook hostitele test262) interně vytvoří novou instanci `Phasis\Engine` a propojí standardní knihovnu.

## Volba regexového enginu

Phasis používá PCRE2 z PHP jako hlavní backend pro regexy a pro případy, které PCRE2 nedokáže přesně zpracovat, používá vlastní porovnávač (lookbehind se zachycenými skupinami, kvantifikované skupiny s resetem a určitou sémantiku příznaku `/v`). Vlastní porovnávač je pomalejší než PCRE2 a používá se pouze tehdy, když dispečer rozpozná nekompatibilní vzor.

Významným důsledkem je, že PCRE2 může používat jinou tabulku převodu velikosti písmen než verze ICU v V8, zejména ve starších distribucích Linux (Ubuntu 22.04 obsahuje ICU 70; Phasis přibaluje tabulku převodu velikosti písmen z ICU 76+, která potlačí rozdíly verzí hostitele u vzorů `/iu`).

## Model správy paměti

Správce paměti PHP založený na počítání referencí se liší od trasovacího správce V8. Objekty PHP zachycené v uzávěrech hostitele zůstávají naživu, dokud je engine drží; cykly mezi nimi se uvolní až po zničení `Engine`. Pro mezipaměti, které nemají objekty udržovat naživu, použijte `WeakMap` / `WeakRef`.

`process.memoryUsage()` a podobná introspekční rozhraní API specifická pro V8 nejsou implementována.

## Načítání modulů

Načítač modulů ES řeší relativní importy podle souborového systému, ale nerozumí konvencím bundlerů:

- Bez rozlišení `node_modules`.
- Bez mapy `package.json` `exports`.
- Bez odvozování přípon souborů (musíte napsat `import './foo.mjs'`, nikoli `import './foo'`).
- Bez importů HTTP.

To odpovídá základní specifikaci ECMAScript, ale ne chování Node. Neexistuje hook pro vlastní resolver modulů. Chcete-li používat balíčky npm, před předáním do Phasis je pomocí nástroje, jako je esbuild, sbalte do jediného skriptu nebo modulu.

## Wasm

`WebAssembly` není implementováno. Není k dispozici žádné běhové prostředí wasm PHP, na které by se dalo navázat.

## Webová API dostupná pouze v prohlížeči, která vynecháváme

Phasis obsahuje kompletní **Web Platform Pack** (`URL`, `TextEncoder`/`TextDecoder`, `atob`/`btoa`, `structuredClone`, `performance`, `DOMException`), kompletní **Fetch Pack** (`fetch`, `Request`, `Response`, `Headers`, `Body`, `AbortController`/`AbortSignal`, `Blob`/`File`, `FormData`, `EventTarget`/`Event`, kompletní WHATWG Streams, `navigator`), dále `crypto` (`getRandomValues`, `randomUUID`, kompletní `SubtleCrypto`: digest, HMAC, AES-GCM/CBC/CTR, RSA-OAEP/PSS/PKCS1, ECDSA, ECDH, HKDF, PBKDF2), `WebSocket` (konstruktor + kodek rámců RFC 6455, vyměnitelný přenos), `XMLHttpRequest` (založené na přenosové vrstvě fetch) a skutečnou smyčku událostí (`setTimeout`, `setInterval`, `clearTimeout`, `clearInterval`, `queueMicrotask`, `AsyncContext`). Viz [Webová API](https://phasis.inline0.dev/cs/docs/compatibility/web-apis).

Co není součástí:

- `window`, `document`, strom DOM — Phasis není prohlížeč.
- `localStorage`, `sessionStorage`, `IndexedDB` — záležitosti hostitele; za uchovávání dat odpovídá vložená aplikace.
- `Worker`, `SharedWorker`, `MessageChannel` — vyžadují skutečná vlákna operačního systému, která PHP nenabízí.
- Service Workers, Push API, Notifications, BroadcastChannel — mimo prohlížeč nemají využití.

## Globální proměnné Node

`process`, `Buffer`, `__dirname`, `__filename`, `require()` — neexistuje ani jedna z nich. Jde o konvence hostitelského prostředí Node, nikoli o vlastnosti jazyka.

Při portování kódu z Node nahraďte `require('foo')` za `import 'foo'`, vyměňte `process.env.X` za `env.X` navázané na hostitele a předejte cesty ekvivalentní `__dirname` z PHP.

## Přesnost desetinných čísel

Čísla ECMAScript jsou 64bitová čísla s pohyblivou řádovou čárkou IEEE 754. Desetinné výpočty s více než 15 platnými číslicemi ztrácejí přesnost stejně jako v každém jiném enginu JS. Pro přesnou celočíselnou aritmetiku použijte `BigInt`; potřebujete-li přesné výpočty se zlomky, použijte desetinnou knihovnu JS.

PHP interně používá `bcmath` pro `BigInt`; jediným skutečným rozdílem oproti V8 je, že operace s velmi velkými hodnotami bigint jsou v PHP pomalejší než v implementaci V8 v C++. Číselné výsledky jsou stejně přesné.