Veebiliidesed

Vaata Markdownina Muuda teenuses GitHub Dokumentatsioon: 5b53f69

Lisaks ECMAScriptile endale tarnib Phasis mitu WHATWG / W3C API-de paketti:

Veebiplatvormi pakett — puhtad väärtustüübid, sisend-väljundita: URL, URLSearchParams, URLPattern, TextEncoder, TextDecoder, atob, btoa, structuredClone, performance, DOMException.
Fetchi pakett — päris HTTP allikast JavaScript: fetch, Request, Response, Headers, Body, AbortController, AbortSignal, Blob, File, FormData, EventTarget, Event, täielikud WHATWG vood (ReadableStream, WritableStream, TransformStream, järjekorda seadmisstrateegiad, BYOB), CompressionStream / DecompressionStream (gzip / deflate / deflate-raw zlibi kaudu; brotli, kui laaditud on kjdev/php-ext-brotli PECL-laiendus), navigator ning HTML spetsifikatsioonile vastav self globaalne alias + reportError.
Krüpto — crypto.getRandomValues, crypto.randomUUID ja täielik SubtleCrypto: digest (SHA-1/256/384/512), HMAC, AES-GCM/CBC/CTR, RSA-OAEP/PSS/PKCS1, ECDSA (P-256/384/521), ECDH, HKDF, PBKDF2 — lisaks JWK import/eksport. Kasutab ext-openssl.
WebSocket — konstruktor, RFC 6455 kaadrikodek ja sündmused. Vaikimisi transport kasutab stream_socket_client; selle saab vahetada Engine::setWebSocketTransport() kaudu, et kasutada ReactPHP / Ratchet / testide imitatsioone.
XMLHttpRequest — kasutab fetchi transpordikihti, seega kehtivad samad poliitikakonksud ja transpordi vahetamise võimalus.
Sündmuste tsükkel — setTimeout, setInterval, clearTimeout, clearInterval, queueMicrotask. Lisaks AsyncContext (Stage 3), mis kannab väärtusi üle mikroülesannete ja taimerite piiride.

Kõik paketid on vaikimisi sisse lülitatud. Lippe ega seadistamist pole vaja — typeof fetch tagastab uues new Engine()-is "function".

Vastavus

Imporditud Web Platform Testsi kogu (tests/Wpt/fixtures/) hõlmab AbortController / AbortSignal, atob / btoa, Blob / File, TextEncoder / TextDecoder, EventTarget / Event, FormData, Headers, performance.now, täielikku voogude standardit (Readable/Writable/Transform + BYOB + järjekorda seadmine), structuredClone, URL / URLSearchParams, kogu crypto / SubtleCrypto liidest (digest, HMAC, AES-GCM/CBC/CTR, RSA-OAEP/PSS/PKCS1, ECDSA, ECDH, HKDF, PBKDF2 — sh tuhandeid tuletatud bittide kombinatsioone allikatest hkdf ja pbkdf2), WebSocket olekumasinat (konstruktor URL ja alamprotokolli valideerimine, sulgemiskoodide semantika, send() stringide / ArrayBuffer / tüübitud massiivivaadete / Blob jaoks, binaryType, bufferedAmount, asünkroonne sulgemine ühenduse loomise ajal, sündmusekäitleja nullitavus) ning suurt osa Fetch + XMLHttpRequest liidestest — responseType olekumasin, katkestamise/saatmise üleminekud, CORS lubatud päised, multipart-FormData üleslaadimised, XMLHttpRequestUpload + ProgressEvent, Response/Headers initsialiseerimise valideerimine, staatilised konstruktorid Response.json / Response.error, Authorizationi eemaldamine ümbersuunamiste ahelas, URL.createObjectURL blob-URL-id, sisu-mixini tarbimine (text / blob / json / formData / arrayBuffer), Response.clone koos structuredClone-ga tükeldatud vood ja sünkroonse XHR-i võrgutõrke tekitamine. Kõik imporditud alamtestid läbivad.

Katvuse laiendamiseks lisage uus *.any.js kausta tests/Wpt/fixtures/<category>/ — käivitaja leiab selle automaatselt. XHR-i ja Fetchi komplekte käitab tests/Wpt/fetch-server.php (WPT resources/*.py käsitlejate ühekohaline emulaator); WebSocketi komplekt kasutab käivitajasse ehitatud passiivset transporti, mis jäljendab ühenduse loomist, vastuse peegeldamist ja sulgemist ning sobib imporditud testandmetega. Käivitage testikogu ise:

Shell

bin/wpt                # everything
bin/wpt --category headers --verbose   # one area, per-subtest output
bin/wpt --json         # machine-readable

fetch() näide

JavaScript

const res = await fetch("https://api.example.com/users", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ name: "alice" }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const user = await res.json();

See töötab kohe. Vaikimisi transport on PHP ext-curl. Sisu voogedastatakse WHATWG ReadableStream Phasis kaudu, seega töötab ka for await (const chunk of res.body).

AbortControlleri näide

JavaScript

const ctrl = new AbortController();
setTimeout(() => ctrl.abort(), 5000);
try {
  const res = await fetch(slowUrl, { signal: ctrl.signal });
} catch (e) {
  if (e.name === "AbortError") {
    // request was cancelled
  }
}

Rakendatud on ka AbortSignal.timeout(ms) (laisk tähtaja kontroll — kontrollitakse lugemisel aborted, mitte ei käivitata sündmust sündmuste tsükli keskel; sobib fetchi transpordiga, mis kontrollib signaali edastuse ajal).

Põimija juhtelemendid (PHP pool)

Kolm konksu Phasis\Engine klassis juhivad fetchi käitumist:

PHP

$engine = new Phasis\Engine();

// 1. Swap the HTTP transport. The callable receives a request descriptor
//    and an optional AbortSignal; returns a response descriptor.
$engine->setFetchTransport(function (array $request, $signal) {
    // ... use Guzzle, Symfony HttpClient, your stub, etc.
    return [
        'status' => 200,
        'statusText' => 'OK',
        'headers' => [['content-type', 'application/json']],
        'body' => '{"data":"value"}',
    ];
});

// 2. Pre-flight policy hook — rewrite, deny, or allow.
$engine->setFetchPolicy(function ($request) {
    $url = $request->get('url')->value;
    if (!str_starts_with($url, 'https://')) {
        throw new \RuntimeException('HTTPS only');
    }
    return null;  // allow as-is; return modified Request to rewrite
});

// 3. Cookie jar. Opt-in. Accepts any object with get(url):string and
//    set(url, header):void methods. JsObject or PHP object both work.
$engine->setCookieJar($myJar);

Kui setFetchTransport() ei kutsuta välja, käivitub vaike-CurlTransport. Küpsiste purk on valikuline — vaikimisi purki pole ning küpsiseid ei salvestata, kui te seda ei paku.

Voogude näide

JavaScript

// Producer: ReadableStream that yields numbers 1..5
const rs = new ReadableStream({
  start(controller) {
    for (let i = 1; i <= 5; i++) controller.enqueue(i);
    controller.close();
  },
});

// Consumer: async iteration
for await (const value of rs) {
  console.log(value);  // 1, 2, 3, 4, 5
}

// Pipe through a transform
const ts = new TransformStream({
  transform(chunk, controller) { controller.enqueue(chunk * 2); },
});
const doubled = new ReadableStream({
  start(c) { [1, 2, 3].forEach(n => c.enqueue(n)); c.close(); }
}).pipeThrough(ts);
for await (const v of doubled) console.log(v);  // 2, 4, 6

Täielik voogude spetsifikatsioon: ReadableStream, WritableStream, TransformStream, ReadableStreamDefaultController, ReadableByteStreamController, ReadableStreamDefaultReader, ReadableStreamBYOBReader, ReadableStreamBYOBRequest, WritableStreamDefaultController, WritableStreamDefaultWriter, TransformStreamDefaultController, ByteLengthQueuingStrategy, CountQueuingStrategy, lisaks pipeTo / pipeThrough / tee.

Sündmussilmus

setTimeout, setInterval, clearTimeout, clearInterval ja queueMicrotask on globaalsel objektil. Mikroülesanded (Promise'i käsitlejad, queueMicrotask) viiakse iga makroülesande vahel lõpuni; taimerid käivituvad tähtaja järjekorras iga keskkonna järjekorra alusel.

JavaScript

console.log('sync');
queueMicrotask(() => console.log('microtask'));
setTimeout(() => console.log('timer'), 0);
// → sync, microtask, timer

const id = setInterval(() => console.log('tick'), 1000);
// ...later
clearInterval(id);

await new Promise(r => setTimeout(r, 50));   // common "delay" pattern works

Tsüklit juhib Phasis Engine::runEventLoop(), mida eval() ja evalAsModule() kutsuvad automaatselt välja pärast sünkroonse koodi lõppu. Vaikimisi töötab tsükkel virtuaalajas — setTimeout(cb, 5000) ei maga PHP, vaid tsükkel nihutab kella tähtajani, et programm kiiresti lõpule jõuaks. Reaalaja põimijad juhivad ise tickEventLoop(). Hostipoolse liidese kohta vaadake API: sündmuste tsükkel.

Mida ei pakuta

Need ainult brauserites või käituskeskkonna mudelis leiduvad API-d jäävad sihilikult ulatusest välja — täieliku selgituse leiate jaotisest Teadaolevad piirangud:

window, document, DOM-puu
localStorage, sessionStorage, IndexedDB
Worker, SharedWorker, MessageChannel
Service Workerid, Push API, teavitused, BroadcastChannel

Vajaduse korral saab põimija enamiku neist $engine->setGlobal() kaudu polütäitena lisada.

WPT testikogu laiendamine

tests/Wpt/upstream/ on web-platform-tests/wpt osaline väljavõte, mis katab fetch/, streams/, FileAPI/, xhr/formdata/, dom/abort/, dom/events/. Katvuse laiendamiseks kopeerige mis tahes *.any.js-fail asukohast upstream/<area>/ kausta tests/Wpt/fixtures/<category>/. Käivitaja leiab faili järgmisel käivitamisel; tõrked logitakse bin/wpt --verbose kaudu.