DevEx: phpc init --profile fileupload scaffold (006-FileUploadWeb parity)

[PurHur]

Problem

#632 / #1886 / #2000 established phpc init profiles for miniwebapp, sessionsweb, and apijson with template parity checkers (#695, #1902). #1999 adds examples/006-FileUploadWeb/ but contributors cannot scaffold the same tree via CLI.

Goal

./phpc init --profile fileupload my-upload
./phpc lint my-upload/example.php
./phpc serve 127.0.0.1:8080 my-upload
curl -s -F 'doc=@README.md' http://127.0.0.1:8080/example.php

Produces a tree byte-synced to examples/006-FileUploadWeb/ once that example lands.

Scope

Piece	Path
Template	templates/init-fileupload/ from examples/006-FileUploadWeb/
CLI	lib/Cli/PhpcInit.php — PROFILE_FILEUPLOAD = 'fileupload'
Parity checker	script/check-init-fileupload-parity.sh + FILEUPLOAD_INIT_PARITY_GATE=1 in ci-fast (default 0 until template lands)
Test	test/unit/PhpcInitFileUploadTest.php (mirror PhpcInitSessionsWebTest.php)
Docs	docs/phpc-json.md, examples/README.md, ./phpc init --help

Acceptance criteria

./script/ci-fast.sh --filter PhpcInitFileUpload
php script/check-init-fileupload-parity.sh

Verification (local / Docker only)

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  vendor/bin/phpunit --filter PhpcInitFileUpload

No GitHub Actions.

Dependencies

• Examples: 006-FileUploadWeb — multipart $_FILES reference + AOT execute smoke #1999 — canonical example tree on master
• Web: multipart/form-data and application/json POST bodies #52 ✅ / Web: $_FILES population and move_uploaded_file subset #87 ✅ — multipart + nested $_FILES
• Examples: 005-SessionsWeb AOT benchmark columns (#1973) #2003 — optional move_uploaded_file if example saves uploads (not blocking echo-only v1)

Links

• ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 Phase 4 Polish
• Sibling: DevEx: phpc init --profile apijson scaffold (004-ApiJson parity) #2000 apijson init, DevEx: phpc init --profile sessionsweb (005-SessionsWeb scaffold) #1886 sessionsweb init

[PurHur]

Dependency cleared — example tree on master

#1999 closed via #2008. Scaffold can mirror:

• examples/006-FileUploadWeb/phpc.json
• script/init-profiles/fileupload/ (or equivalent pattern from DevEx: phpc init --profile sessionsweb (#1886) #1992 sessionsweb)

Not blocking #2009 (CI default-on) or #2005 (stdlib).

[PurHur]

Batch 104: Canonical example #1999 ✅ on master — unblock implementation. Gate-flip follow-up: #2020 (INIT_FILEUPLOAD_PARITY_GATE). Doc drift siblings: #2017 (ROOT_README), #2018 (rebuild-examples row).

[PurHur]

PM unblock — batch 106 (2026-05-25)

All dependencies are green on master:

Dep	Status
#1999 canonical examples/006-FileUploadWeb/	✅
#52 / #87 multipart + nested $_FILES	✅
#2005 move_uploaded_file	✅ #2021
Gate ladder #2009–#2013	✅ (#2022, #2024, #2031)

#2004 is now the only open step in the 006-FileUploadWeb DevEx ladder (see ROADMAP #78 batch 106).

Implementation pattern (copy from landed work)

Mirror #2032 / #2000 apijson profile:

Piece	Reference
Template	templates/init-fileupload/ ← examples/006-FileUploadWeb/
CLI	lib/Cli/PhpcInit.php — add PROFILE_FILEUPLOAD = 'fileupload'
Parity	script/check-init-fileupload-parity.sh (opt-in gate until template lands)
Test	test/unit/PhpcInitFileUploadTest.php ← PhpcInitSessionsWebTest.php

Follow-up after merge: #2020 flip INIT_FILEUPLOAD_PARITY_GATE=1 in ci-fast.

Acceptance (local / Docker)

./phpc init --profile fileupload /tmp/upload-test
php script/check-init-fileupload-parity.sh
docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  vendor/bin/phpunit --filter PhpcInitFileUpload

No GitHub Actions.