feat(serializer): global defaults.normalization_context.gen_id configuration option

[olinox14]

Q	A
Branch?	main
Tickets	None
License	MIT
Doc PR	api-platform/docs#2252

Add the possibility to set a new option in api/config/packages/api_platform.yaml (or config/api-platform.php for Laravel) :

api_platform:
defaults:
normalization_context:
gen_id: false

If set to false, this will globally disable the Skolem IRIs generation for all properties.
If not set, the default value for $context['output']['gen_id'] would stay true.
#[ApiProperty(genId: true|false)] will still take precedence.

[soyuka]

Hi thanks for the feature! Could you add a test (functional or unit your choice)?

I wonder if it would be nice to have actual property defaults.

[olinox14]

I added the tests, please note that I only tested it for the use case that pushed me to propose this PR, i.e. a DTO ApiResource with embedded sub-resources (which are not defined as ApiResources). I'm not sure if there are cases where this feature could be needed with the child resources also defined as ApiResources?

Property defaults defined in the configuration file would be even more elegant imo, but I don’t know the project enough to realize the feasibility

[soyuka]

This is perfect thanks!