symfony/yaml
45.7
Weak · 17 November 2026
4k
lines of production code
PHP
primary language
5
measurements over time
What this system is
Features
Add TaggedValue class for YAML tag support
A new TaggedValue class has been added to the Symfony Yaml component to represent tagged values. This class stores a tag string and its associated value, providing a structured way to handle YAML tags within the library.
Tag · high confidence
Introduce lint:yaml command with JSON Schema validation and CI formats
Adds the \lint:yaml\ command to validate YAML file syntax, supporting multiple files and directories. Users can now validate content against a JSON Schema using the \--check-schema\ option, parse custom tags with \--parse-tags\, and exclude specific paths with \--exclude\. The command also supports CI-friendly output formats (including GitHub Actions and GitLab CI) via the \--format\ option and displays line numbers in JSON output.
Command · high confidence
New yaml-lint binary for validating YAML files
A new executable script, Resources/bin/yaml-lint, has been added to allow users to validate YAML files directly from the command line. This standalone binary bootstraps the Symfony Console application and registers the Yaml Lint command, ensuring it only runs in CLI contexts and providing clear error messages if dependencies are missing.
Resources · high confidence
Symfony Yaml Component v8.2: New tags, JSON Schema validation, and GitLab linting
The Yaml component introduces support for explicit type tags \!!null\, \!!bool\, and \!!int\, along with accepting quoted values for these and \!!float\ tags. It now throws a \ParseException\ if a \!!float\ tag contains an invalid value, rather than silently casting it to \0.0\. The \lint:yaml\ command gains a \--check-schema\ option (and file header support) to validate YAML against JSON Schema, and a new \gitlab\ output format for GitLab Code Quality reports. Additionally, the component now supports parsing a block scalar as the root node of a document and requires the \PARSE\_CUSTOM\_TAGS\ flag for custom tags on block scalars.
(repo-wide) · high confidence
YAML linting now supports JSON Schema validation
The YAML component now includes a new Schema subsystem that allows YAML documents to be validated against a JSON Schema. This is enabled by adding a $schema declaration (e.g., \# yaml-language-server: $schema=...) in the file header. The new FileHeaderSchemaResolver detects this declaration, and the SchemaValidator uses the opis/json-schema library to validate the parsed data, providing structure-aware error reporting that maps JSON Schema validation errors back to specific lines in the YAML file. Also in this area: 1 commit (0 fixes) modifying Schema.
Schema · medium confidence · unverified
Behavioural changes
Yaml component exceptions moved to a dedicated sub-namespace
The exception classes for the Yaml component have been reorganized into a new \Symfony\\Component\\Yaml\\Exception\ sub-namespace. The previous monolithic \Exception\ class has been split into specific types: \ParseException\ (handling parse errors with detailed context like line number and snippet), \DumpException\ (for dumping errors), and \LogicException\ (for programming errors). The base \ExceptionInterface\ now extends \\\Throwable\ directly. This change updates the fully qualified class names for all Yaml-related exceptions, requiring users to update their \use\ statements or \catch\ blocks to reference the new \Symfony\\Component\\Yaml\\Exception/\*\ paths instead of \Symfony\\Component\\Yaml\\Exception\.
Exception · high confidence
Test coverage
Added YAML parser test fixtures and PHP enum fixtures; Added comprehensive test suite for the YAML component; Added tests for YAML schema validation and file header resolution; Added tests for the YAML Lint command.
Dependencies
Symfony Yaml component requires PHP 8.4+ and adds yaml-lint binary
The Symfony Yaml component now requires PHP 8.4.1 or higher and includes a new command-line binary (yaml-lint) for validating YAML files. It also introduces a conflict with symfony/console versions prior to 7.4 and adds the yaml/yaml-test-suite as a development dependency to support comprehensive testing.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 46.6 → 45.7 (-0.9)
- Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 57.9 → 57.6 (-0.3)
- Architecture 99.9 → 97.3 (-2.6)
- Maturity 39.7 → 37.3 (-2.4)
- Readiness 33.3 → 33.3 (0.0)
- Security 100.0 → 100.0 (0.0)
Resolved (3)
- Duplicated block (5 lines × 2) (Inline.php)
- No ADRs found
- Off-boarding risk: anonymized user #1
New (9)
- No ADRs found (composer.json)
- Off the main sequence: Exception
- Off the main sequence: Tag
- Off-boarding risk: anonymized user #1
- Orphaned file (Exception/ParseException.php)
- Orphaned file (Unescaper.php)
- Orphaned files with no living knowledge
- Skipped (documented): testLintFileWithInvalidUtf8NameWithJsonFormat (Tests/Command/LintCommandTest.php)
- Skipped (documented): testLintFilesWithMarkupInTheirName (Tests/Command/LintCommandTest.php)
Changes since last survey
- 24 commits — 20 feature/other, 4 fixes
By area
- (repo) — 17 commits
- (root) — 3 commits
- Command/LintCommand.php — 2 commits
- Schema/SchemaValidator.php — 1 commit
- Tests/ParserTest.php — 1 commit
Notable commits
- fix: [Yaml] Fix anchors, aliases and unsupported entries in flow mapping keys
- fix: [Yaml] Fix block scalars losing their trailing newline after leading comments
- fix: bug #67881 [Yaml] Don't copy long nested blocks at each nesting level (nicolas-grekas)
- fix: bug #68210 [Yaml] Escape the schema path in the text output of lint:yaml (nicolas-grekas)
- change: Merge branch '5.4' into 6.4
- change: Merge branch '6.4' into 7.4
- change: Merge branch '6.4' into 7.4
- change: Merge branch '6.4' into 7.4
- change: Merge branch '6.4' into 7.4
- change: Merge branch '7.4' into 8.1
- change: Merge branch '7.4' into 8.1
- change: Merge branch '7.4' into 8.1
- change: Merge branch '7.4' into 8.1
- change: Merge branch '7.4' into 8.1
- change: Merge branch '8.1' into 8.2
- change: Merge branch '8.1' into 8.2
- change: Merge branch '8.1' into 8.2
- change: Merge branch '8.1' into 8.2
- change: Merge branch '8.1' into 8.2
- change: [Console][Form][FrameworkBundle][HttpKernel][Ldap][Messenger][Yaml] Drop the remaining assertions that cannot run after the expected exception
- …and 4 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
symfony/yaml was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 0e55b93637526aad19aca822d6c867b59ad1101a — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.85+preprod-eba6548ac50f.