Skip to content

docs: complete the published PHP Server configuration and admission reference - #398

Merged
rmcdaniel merged 5 commits into
mainfrom
docs/335-server-config-contract
Oct 23, 2026
Merged

rmcdaniel merged 5 commits into
mainfrom
docs/335-server-config-contract

Conversation

@rmcdaniel

@rmcdaniel rmcdaniel commented Oct 23, 2026 •

Copy link
Copy Markdown
Member

Operators could not find35 declared Server controls or understand namespace HTTP/durable admission. All eight config references now cover the qualified published PHP2.11.0 contract’s164 variables with defaults, purposes and exact legacy aliases. All eight admission guides add counted/exempt route families, fixed-minute/burst behavior, shared-Redis scope, worked default/override/hard-cap examples, refusal/retry hints, durable resource counts and metrics. The selected tuple is unchanged. Refs #335.

The new build check reads a versioned published-contract snapshot with exact source/image provenance, checks every locale, and preserves editable prose. Five focused tests pass, including a name mentioned only in prose, a wrong alias, empty default/purpose and moving-source provenance. All seven source hashes and executable blocks match English; local translation and whitespace checks pass.

Installed qualification records cold configuration controls, actual HTTP rate/minute-reset/refusal/route exemption, service-held concurrency refusal/release and basic SQLite metadata-registration quotas. Two API replicas sharing Redis7.4.11 and an ephemeral SQLite database share one rate/concurrency budget. These controls do not qualify production SQL, HA, native Server or every workflow lifecycle. No source/vendor overlays or product changes were used.

A negative control found a separate published product defect: malformed namespace override JSON is silently dropped, falling back to global defaults even under strict env audit. The guide states this current limitation in all eight locales and narrows503 claims to validated numeric failures/unavailable coordination. It does not substitute documentation for that fix. The original root-holder fixture failure and corrected application-user comparison also remain recorded.

Current source 5cb43b744823bd4c4c0b38460194fb7f4fd8a600 awaits exact-head CI/Sonar review, normal merge, actual Pages and all sixteen live guides. No new Server/runtime/image adoption or released validation safeguard is claimed.

@sonarqubecloud

Copy link
Copy Markdown

@rmcdaniel
rmcdaniel marked this pull request as ready for review October 23, 2026 16:28
@rmcdaniel
rmcdaniel merged commit bae91b9 into main Oct 23, 2026
11 checks passed
@rmcdaniel
rmcdaniel deleted the docs/335-server-config-contract branch October 23, 2026 16:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants