Yhteentoimivuus

Phasis suoritetaan samassa PHP-prosessissa kuin sovelluksesi, joten arvot siirtyvät PHP:n ja JavaScript:n välillä ilman JSON-toimintoa, putkia tai toista ajonaikaista ympäristöä. Siirto tapahtuu muuntamalla: skalaariarvot muunnetaan JS-primitiiveiksi, PHP-taulukot kopioidaan uusiksi JS-taulukoiksi ja -olioiksi, ja JS-tulokset kopioidaan takaisin PHP-taulukoiksi. Muutos, jonka JS tekee muunnettuun taulukkoon, ei näy alkuperäisessä PHP-taulukossa. PHP-kutsuttavat ovat poikkeus, joka pysyy aktiivisena: niistä tulee JS-funktioita, jotka kutsuvat suoraan kohteeseen PHP.

Tässä osiossa käsitellään säännöt.

Sivut

• Arvot — muunnostaulukot molempiin suuntiin: numerot, merkkijonot, totuusarvot, null/undefined, taulukot, oliot ja arvot, joita ei muunneta.
• Isäntäfunktiot — sido PHP callable $engine->setGlobal()-määrityksellä JS-funktioksi. Argumenttien muunnos, paluuarvot ja poikkeusten toiminta.
• Jaetut oliot — mitä tapahtuu, kun välität PHP-olion JS:lle nykytilanteessa (se saapuu muodossa undefined), sekä miten tarjoat PHP-tilan ja toiminnan taulukoilla ja sulkeumilla.
• Fetch-kuljetus — vaihda oletusarvoinen ext-curl HTTP-taustajärjestelmä kohteeseen Guzzle, Symfony HttpClient, mockiin tai kaikki estävään toteutukseen. Lisäksi käytäntökoukku sallittujen listaamiseen, otsakkeiden lisäämiseen ja vuokralaiskohtaiseen sidontaan.
• Evästepurkki — liitä get(url)/set(url, header)-purkki evästeiden säilyttämiseksi hakujen välillä. Muistissa oleva, Symfony BrowserKit tai JS-puolen Map.
• AbortController-mallit — aikakatkaisu, kilpailutus, välitys, AbortSignal.any / .timeout ja se, miten mukautettu PHP-kuljetus kyselee signaalin tilaa siirron aikana.

Pikaesimerkki

$engine = new Phasis\Engine();

// 1. Bind a PHP callable as a JS function
$engine->setGlobal('greet', fn (string $name) => "Hello, $name!");
echo $engine->eval('greet("world")');  // → Hello, world!

// 2. Let JS change PHP state through a closure
$total = 0;
$engine->setGlobal('add', function (int $n) use (&$total): void { $total += $n; });
$engine->eval('add(2); add(3)');
echo $total;  // → 5

// 3. Call a JS function from PHP
$engine->eval('function add(a, b) { return a + b; }');
echo $engine->call('add', 2, 3);  // → 5

Katso myös

• API-viite — koko Phasis\Engine-rajapinta.
• Verkkorajapinnat — Web Platform Pack ja Fetch Pack toimivat saman yhteentoimivuuskerroksen päällä.