Skip to content

Generic transformers: the former names of the dashed transformer codes and contextual options no longer work since 5.9 #475

Closed

Description

@njoubert-cleverage

Description

Regression of 5.9 (#438): normalizeKeys(false) on contextual_options and transformers of the generic transformers (Configuration.php) has no compatibility layer. Two configurations working in 5.8 fail in 5.9:

  • an internal transformer written with a dash while its code has an underscore, e.g. transformers: { array-first: ~ }: 5.8 normalized it to array_first, 5.9 throws No transformer with code : array-first;
  • a contextual option declared with a dash (contextual_options: { the-prefix: ... }) and used with an underscore (the_prefix: 'P-', {{ the_prefix }}), the only form that worked in 5.8: 5.9 throws The option "the_prefix" does not exist. Defined options are: "the-prefix", "transformers".

The CHANGELOG lists #438 in the fixes, without deprecation nor UPGRADE entry.

Proposed fix

Restore these former names as deprecated: a transformer code not found with dashes but found with underscores, the underscore form of a dashed contextual option (option and placeholder). Removal in v6.0.

Requirements

  • Documentation updates
    • Reference
    • Cookbooks
    • Changelog
  • Unit tests

Breaking changes

None: restores configurations working in 5.8 (deprecated).

Activity

  1. added 3 commits that reference this issue on Nov 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions