Skip to content

docs: remove config keys deleted in 5.0, document %param% resolution - #2334

Merged
soyuka merged 1 commit into
api-platform:mainfrom
soyuka:docs/remove-5.0-deleted-config
Sep 13, 2026
Merged

docs: remove config keys deleted in 5.0, document %param% resolution#2334
soyuka merged 1 commit into
api-platform:mainfrom
soyuka:docs/remove-5.0-deleted-config

Conversation

@soyuka

@soyuka soyuka commented Sep 12, 2026

Copy link
Copy Markdown
Member

Summary

  • Removes six configuration keys/options deleted by api-platform/core#8367 (e22e74464),
    verified absent from src/ at upstream/main of api-platform/core:
    • validator.query_parameter_validation (core/configuration.md)
    • resource_class_directories (core/configuration.md)
    • graphql.graphql_playground (core/configuration.md)
    • http_cache.invalidation.varnish_urls — renamed to urls (core/configuration.md)
    • enable_link_security (core/subresources.md) — Link security is now always enabled
  • Documents the new "container parameters in resource configuration" feature added by
    api-platform/core#8284 (826e847b6): %app.param% now resolves inside YAML/XML/attribute
    resource configuration (Symfony only), verified against
    ContainerParameterResourceMetadataCollectionFactory and the YAML/XML extractors.

Notes

  • xkey was flagged by the audit as removed by #8367 too, but this is not accurate for what the
    docs document: the deprecated top-level http_cache.invalidation.xkey.glue bundle option was
    indeed removed, but the docs only ever documented the resource-level
    defaults.cache_headers.invalidation.xkey.glue, which is still read by
    ApiPlatformExtension::registerCommonConfiguration() and still backed by ApiResource::$cacheHeaders.
    No change made there.
  • core/dto.md (ObjectMapperProcessorObjectMapperInputProcessor/ObjectMapperOutputProcessor)
    is intentionally left untouched: api-platform/docs#2321 (open against 4.3) already makes this
    exact class-split edit at those lines, plus more, and will flow into main through the branch
    merge-up.
  • core/filters.md:716 also documents enable_link_security (for ReadLinkParameterProvider) but
    is out of scope for this PR/branch; left for the agent owning core/filters.md.

soyuka added a commit to soyuka/doc that referenced this pull request Sep 12, 2026
`Configuration.php` on upstream/main no longer exposes this key; Link
security is unconditional since api-platform/core#8367. Matches the
phrasing used in api-platform#2334 (core/subresources.md).
@soyuka
soyuka force-pushed the docs/remove-5.0-deleted-config branch from c756d30 to e32bfd6 Compare September 13, 2026 07:43
@soyuka
soyuka merged commit 615e982 into api-platform:main Sep 13, 2026
3 checks passed
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.

1 participant