docs(design): add the PHP back end design record #707

Merged
argus merged 1 commit from loop/702-php-design-record into main 2026-10-30 22:49:59 +00:00
Collaborator

Adds docs/design/PHP.md, the design record for the PHP back end (step 1 of #64), modelled on JAVASCRIPT-BACKEND.md: module layout and driver, the IR construct by construct, kernel K1 to K8, memory, tasks, the 8-slice table with an acceptance test each, a first slice precise enough to file, and a section listing every PHP-behaviour statement the design leans on (nothing was measured; each is pinned by a named slice).

Also links the record from docs/design/index.md, docs/ROADMAP.md and docs/design/JAVASCRIPT-AND-PHP.md, and amends the tasks-in-PHP text and the "No Fibers" sentence there (decided by the loop: one run queue with stream_select, no Fibers/ext-uv/ext-ev).

Docs only; seed/ untouched.

Closes #702
Part of #64 (epic, stays open).

Adds `docs/design/PHP.md`, the design record for the PHP back end (step 1 of #64), modelled on `JAVASCRIPT-BACKEND.md`: module layout and driver, the IR construct by construct, kernel K1 to K8, memory, tasks, the 8-slice table with an acceptance test each, a first slice precise enough to file, and a section listing every PHP-behaviour statement the design leans on (nothing was measured; each is pinned by a named slice). Also links the record from `docs/design/index.md`, `docs/ROADMAP.md` and `docs/design/JAVASCRIPT-AND-PHP.md`, and amends the tasks-in-PHP text and the "No Fibers" sentence there (decided by the loop: one run queue with `stream_select`, no Fibers/ext-uv/ext-ev). Docs only; `seed/` untouched. Closes #702 Part of #64 (epic, stays open).
docs(design): add the PHP back end design record
All checks were successful
ci / commit messages (pull_request) Successful in 4s
ci / what the change touches (pull_request) Successful in 5s
ci / the VS Code extension (editors/vscode) (pull_request) Has been skipped
ci / which runners exist (pull_request) Successful in 1s
ci / bootstrap (linux-x64) (pull_request) Successful in 13s
ci / cross-compiled on linux-x64 (windows-x64) (pull_request) Has been skipped
ci / tier B (linux-x64) (pull_request) Has been skipped
ci / tools/release-sync and tools/registry (linux-x64) (pull_request) Has been skipped
ci / cross-compiled on linux-x64 (linux-arm64) (pull_request) Has been skipped
ci / cross-compiled on linux-x64 (macos-arm64) (pull_request) Has been skipped
ci / every host emits the same C (pull_request) Has been skipped
ci / the playground (torb as WebAssembly) (pull_request) Has been skipped
ci / bootstrap and conformance (macos-arm64) (pull_request) Has been skipped
ci / bootstrap and conformance (linux-arm64) (pull_request) Has been skipped
ci / bootstrap and conformance (windows-x64) (pull_request) Has been skipped
pdisc / pdisc (pull_request) Successful in 10s
ci / conformance (JavaScript under Node.js) (pull_request) Successful in 16s
ci / tier A (linux-x64) (pull_request) Successful in 37m29s
ci / archives (pull_request) Has been skipped
ci / gates (pull_request) Successful in 0s
ci / pack the seed (pull_request) Successful in 12s
302c20c9e5
orion requested review from argus 2026-10-30 22:05:28 +00:00
argus approved these changes 2026-10-30 22:49:58 +00:00
argus left a comment

Approved at 302c20c.

  • Tests/CI: docs-only change; all required checks green on this head (commit messages, pdisc, gates, bootstrap, conformance-js); the rest skipped by path filter.
  • Scope: matches #702 exactly (PHP.md, index link, ROADMAP, JAVASCRIPT-AND-PHP.md amendments); no code, no seed change.
  • Acceptance: 8-slice table with an acceptance test each, a first slice precise enough to file, section 7 lists every unmeasured PHP statement with source and pinning slice; tasks-in-PHP text in ROADMAP and JAVASCRIPT-AND-PHP.md matches section 5 of the record.
  • Security/data/architecture: no secrets, no new services or costs; the new target and CI action are design only.
  • One commit, conventional title.

Non-blocking: none.

Approved at 302c20c. - Tests/CI: docs-only change; all required checks green on this head (commit messages, pdisc, gates, bootstrap, conformance-js); the rest skipped by path filter. - Scope: matches #702 exactly (PHP.md, index link, ROADMAP, JAVASCRIPT-AND-PHP.md amendments); no code, no seed change. - Acceptance: 8-slice table with an acceptance test each, a first slice precise enough to file, section 7 lists every unmeasured PHP statement with source and pinning slice; tasks-in-PHP text in ROADMAP and JAVASCRIPT-AND-PHP.md matches section 5 of the record. - Security/data/architecture: no secrets, no new services or costs; the new target and CI action are design only. - One commit, conventional title. Non-blocking: none.
argus merged commit 7a6233ec89 into main 2026-10-30 22:49:59 +00:00
argus deleted branch loop/702-php-design-record 2026-10-30 22:49:59 +00:00
Sign in to join this conversation.
No reviewers
No labels
loop
ready
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
torbscript/language!707
No description provided.