# Introduzione
Phasis è un motore JavaScript scritto interamente in PHP. Analizza lessicalmente e sintatticamente ed esegue ECMAScript nel processo host PHP, senza `exec('node …')`, senza FFI e senza un'estensione binaria personalizzata. Richiede tre estensioni standard di PHP: `ext-mbstring`, `ext-bcmath` e `ext-curl` (il trasporto predefinito `fetch()`). `ext-intl` e `ext-openssl` sono facoltativi. Consultate [Per iniziare](https://phasis.inline0.dev/it/docs/getting-started) per le build che escludono `bcmath`.

- **Integrabile** — inserite un runtime JS in qualsiasi app, framework o strumento CLI PHP tramite la classe `Phasis\Engine`.
- **Conforme alle specifiche** — supera la suite ufficiale test262 al 100%, in ogni categoria, senza test saltati.
- **API web** — **Web Platform Pack** completo (URL, TextEncoder/Decoder, atob/btoa, structuredClone, performance, DOMException), **Fetch Pack** completo (fetch, Request, Response, Headers, Body, AbortController/Signal, Blob, File, FormData, EventTarget, WHATWG Streams completi, navigator), oltre a `crypto` + `SubtleCrypto`, `WebSocket`, `XMLHttpRequest` e un vero event loop. Supera il 100% dei Web Platform Tests importati.
- **Funzionalità moderne** — funzioni freccia, classi, async/await, Promises, generatori, Symbol, BigInt, Proxy, Reflect, Temporal, Intl, TypedArrays, supporto completo ai moduli.
- **Interop PHP↔JS** — passate scalari e array PHP a JS (gli array vengono copiati), associate closure PHP come funzioni JS e chiamate funzioni JS da PHP. Gli oggetti PHP non possono ancora essere condivisi con JS; consultate [Oggetti condivisi](https://phasis.inline0.dev/it/docs/interop/shared-objects).

## Perché esiste Phasis

Le applicazioni PHP che devono eseguire codice JavaScript fornito dagli utenti — motori di template, shim SSR per frontend, regole di convalida dei dati, sandbox per i contenuti, runner di test headless — in genere avviano Node.js come processo esterno oppure rinunciano alla funzionalità. Entrambe le soluzioni aggiungono complessità operativa: un secondo runtime, un confine di serializzazione, una rete di pipe tra sottoprocessi e difficoltà di deployment negli ambienti di hosting condiviso.

Phasis colma questa lacuna. Il vostro codice PHP può eseguire il lessing, l'analisi sintattica e l'esecuzione di JavaScript usando solo PHP 8.2+ con `mbstring`, `bcmath` e `curl`. Il motore viene distribuito come pacchetto Composer ed espone una superficie API piccola e unificata.

## Cosa fa

- Implementa la libreria standard ECMAScript completa: `Array`, `String`, `Object`, `Math`, `JSON`, `Date`, `RegExp`, `Map`, `Set`, `Promise`, `Proxy`, `Reflect`, `Symbol`, `BigInt`, `TypedArray`, `Temporal`, `Intl`, generatori, iteratori asincroni, moduli.
- Include le API della **Web Platform** che le librerie JS per uso reale verificano in anticipo: `URL`, `URLSearchParams`, `TextEncoder`/`TextDecoder`, `atob`/`btoa`, `structuredClone`, `performance`, `DOMException`. Consultate [API web](https://phasis.inline0.dev/it/docs/compatibility/web-apis) per l'elenco completo.
- Include **`fetch`** con tutta la famiglia Fetch: `Request`, `Response`, `Headers`, metodi per leggere il corpo, `AbortController`/`AbortSignal`, `Blob`, `File`, `FormData`, `EventTarget`/`Event` e WHATWG Streams completi (`ReadableStream`, `WritableStream`, `TransformStream`, BYOB, strategie di accodamento). Un vero HTTP funziona subito tramite PHP `ext-curl`.
- Include **`crypto`** + `SubtleCrypto` completo (famiglia SHA, HMAC, AES-GCM/CBC/CTR, RSA-OAEP/PSS/PKCS1, ECDSA, ECDH, HKDF, PBKDF2), **`WebSocket`** (RFC 6455 + trasporto sostituibile) e **`XMLHttpRequest`** (basato sullo stesso trasporto fetch).
- Include un vero **event loop**: `setTimeout`, `setInterval`, `clearTimeout`, `clearInterval`, `queueMicrotask` e `AsyncContext` Stage-3 per propagare i valori attraverso i confini asincroni.
- Supporta la sintassi moderna: destrutturazione, spread/rest, proprietà calcolate, concatenamento opzionale, coalescenza nullish, template literal, template taggati, classi (con campi privati, blocchi statici e decorator), await al livello superiore.
- Converte i valori attraverso il confine PHP↔JS. Gli scalari e gli array vengono copiati, i callable PHP diventano funzioni JS e i risultati JS vengono restituiti come scalari e array PHP. Consultate [Conversione dei valori](https://phasis.inline0.dev/it/docs/interop/values) per le regole precise.
- L'esecuzione è controllata dall'host. L'host gestisce il trasporto `fetch` e gli hook delle policy, l'event loop funziona in tempo virtuale e un limite fisso alla profondità dello stack di chiamate arresta la ricorsione incontrollata. Esiste un limite alle iterazioni dei loop, ma non viene ancora applicato ai loop eseguiti dalla VM bytecode; inoltre non ci sono limiti alla lunghezza delle stringhe, all'output o al tempo reale. Consultate [API: setLimit](https://phasis.inline0.dev/it/docs/api#setlimit).
- La compatibilità viene verificata con Node.js (V8). La CI esegue le suite di unit test e oracle a ogni push su `main` e a ogni pull request; esegue inoltre i Web Platform Tests e le suite dei pacchetti più diffusi quando cambia il codice sorgente del motore. L'intera matrice test262 viene eseguita manualmente e il relativo snapshot viene salvato in `COMPAT.md`. Consultate [Compatibilità](https://phasis.inline0.dev/it/docs/compatibility).

## Cosa non è

Phasis non è un compilatore JIT. È un interprete che attraversa l'albero sintattico, affiancato da una VM bytecode usata quando possibile. Nei carichi di lavoro limitati dalla dispatch, aspettatevi tempi di esecuzione circa 100× superiori a quelli di V8. Il compromesso è l'assenza di dipendenze, PHP puro ed esecuzione controllata dall'host: una soluzione ideale per integrare JavaScript nelle app PHP, dove correttezza e isolamento contano più della velocità massima.

## Da dove iniziare

- [Per iniziare](https://phasis.inline0.dev/it/docs/getting-started) — installate il motore ed eseguite il vostro primo script.
- [CLI](https://phasis.inline0.dev/it/docs/cli) — `bin/phasis` per eseguire file, valutare il codice sorgente e stampare l'AST.
- [API](https://phasis.inline0.dev/it/docs/api) — integrate `Phasis\Engine` nella vostra app PHP.
- [Interop](https://phasis.inline0.dev/it/docs/interop) — passate valori e callable PHP a JavaScript.
- [Compatibilità](https://phasis.inline0.dev/it/docs/compatibility) — copertura test262 e funzionalità supportate.
- [Parser](https://phasis.inline0.dev/it/docs/parser) — analizzate JavaScript in un AST tipizzato o in ESTree senza eseguirlo.
- [Formatter](https://phasis.inline0.dev/it/docs/formatter) — formattate JavaScript, JSON e CSS con un layout compatibile con prettier.
- [Avanzate](https://phasis.inline0.dev/it/docs/advanced) — architettura, VM bytecode, benchmark e modello di test oracle.