This PR was merged into the 6.2 branch.

Discussion
----------

[Serializer] SerializedPath documentation

Adds documentation for the `SerializedPath` annotation (symfony/symfony#43534). This fixes #17389.

Commits
-------

375c089 Documentation for the SerializedPath definition

Since symfony/symfony#43534 (released with `symfony/serializer` 6.2.0),
Symfony's ObjectNormalizer has a hard dependency to the
`symfony/property-access` package. As we're using the ObjectNormalizer,
we must ensure to meet this requirement by explicitly adding the
package as requirement in `composer.json`.

Since symfony/symfony#43534 (released with `symfony/serializer` 6.2.0),
Symfony's ObjectNormalizer has a hard dependency to the
`symfony/property-access` package. As we're using the ObjectNormalizer,
we must ensure to meet this requirement by explicitly adding the
package as requirement in `composer.json`.

…enner)

This PR was merged into the 6.2 branch.

Discussion
----------

[Serializer] Fix serialized path for non-scalar values

| Q             | A
| ------------- | ---
| Branch?       | 6.2
| Bug fix?      | yes
| New feature?  | no
| Deprecations? | no
| Tickets       | Fix #49494
| License       | MIT
| Doc PR        | no

This relates to #49494 and #49225. When non-scalar values are normalized, they are normalized twice in the `normalize()` function:

```php
if (null !== $attributeValue && !\is_scalar($attributeValue)) {
	$stack[$attribute] = $attributeValue;
}
$data = $this->updateData($data, $attribute, $attributeValue, $class, $format, $attributeContext, $attributesMetadata, $classMetadata);
```

and a bit later:

```php
foreach ($stack as $attribute => $attributeValue) {
	...
	$data = $this->updateData($data, $attribute, $this->serializer->normalize($attributeValue, $format, $childContext), $class, $format, $attributeContext, $attributesMetadata, $classMetadata);
}
```

For non-scalar values with a `SerializedPath` annotation this leads to an exception because the serializer is trying to re-populate the path. Running `updateData()` only once fixes this, but breaks a couple of tests across the components as it changes the order of elements in the serialized string (non-scalar values will be pushed to the end). Other than the string comparisons, nothing seems to break. This was also an issue while reviewing the PR for the `SerializedPath` annotation (#43534 (comment)) and got reverted because of the potential BC break.

I'm not sure what benefit normalizing twice brings, so I added the test from `@HonzaMatosik`, changed the behavior in the normalizer and fixed the broken tests. If that's not the preferred solution here, I'd be ok with just eleminating the "The element you are trying to set is already populated" exception in the `SerializedPath` and allow overwriting values.

Commits
-------

d82ec41 [Serializer] Fix serializedpath for non scalar types

…enner)

This PR was merged into the 6.2 branch.

Discussion
----------

[Serializer] Fix serialized path for non-scalar values

| Q             | A
| ------------- | ---
| Branch?       | 6.2
| Bug fix?      | yes
| New feature?  | no
| Deprecations? | no
| Tickets       | Fix #49494
| License       | MIT
| Doc PR        | no

This relates to symfony/symfony#49494 and symfony/symfony#49225. When non-scalar values are normalized, they are normalized twice in the `normalize()` function:

```php
if (null !== $attributeValue && !\is_scalar($attributeValue)) {
	$stack[$attribute] = $attributeValue;
}
$data = $this->updateData($data, $attribute, $attributeValue, $class, $format, $attributeContext, $attributesMetadata, $classMetadata);
```

and a bit later:

```php
foreach ($stack as $attribute => $attributeValue) {
	...
	$data = $this->updateData($data, $attribute, $this->serializer->normalize($attributeValue, $format, $childContext), $class, $format, $attributeContext, $attributesMetadata, $classMetadata);
}
```

For non-scalar values with a `SerializedPath` annotation this leads to an exception because the serializer is trying to re-populate the path. Running `updateData()` only once fixes this, but breaks a couple of tests across the components as it changes the order of elements in the serialized string (non-scalar values will be pushed to the end). Other than the string comparisons, nothing seems to break. This was also an issue while reviewing the PR for the `SerializedPath` annotation (symfony/symfony#43534 (comment)) and got reverted because of the potential BC break.

I'm not sure what benefit normalizing twice brings, so I added the test from `@HonzaMatosik`, changed the behavior in the normalizer and fixed the broken tests. If that's not the preferred solution here, I'd be ok with just eleminating the "The element you are trying to set is already populated" exception in the `SerializedPath` and allow overwriting values.

Commits
-------

d82ec41d18 [Serializer] Fix serializedpath for non scalar types