Merge branch '3.4' into 4.0

Author: dunglas

core/configuration.md

@@ -68,7 +68,7 @@ api_platform:
     # Enable the data collector and the WebProfilerBundle integration.
     enable_profiler: true
 
-    collection:
+   collection:
         # The name of the query parameter to filter nullable results (with the ExistsFilter).
         exists_parameter_name: 'exists'
 

core/upgrade-guide.md

@@ -1,6 +1,6 @@
 # Upgrade Guide
 
-## API Platform 3.4 
+## API Platform 3.4
 
 Remove the `keep_legacy_inflector`, the `event_listeners_backward_compatibility_layer` and the `rfc_7807_compliant_errors` flag:
 
@@ -17,8 +17,8 @@ If you use a custom normalizer for validation exception use:
 
 ```yaml
 api_platform:
-	validator:
-		legacy_validation_exception: true
+    validator:
+        legacy_validation_exception: true
 ```
 
 Indeed, we will throw another validation class in API Platform 4 we will throw `ApiPlatform\Validator\Exception\ValidationException` instead of `ApiPlatform\Symfony\Validator\Exception\ValidationException`
@@ -27,7 +27,7 @@ It's really important to add the `use_symfony_listeners` flag, set to `true` if
 
 ```yaml
 api_platform:
-	use_symfony_listeners: false
+    use_symfony_listeners: false
 ```
 
 The `keep_legacy_inflector` flag will be removed from API Platform 4, you need to fix your issues first. In API Platform 3.4, the Inflector is available as a service that you can configure through:
@@ -55,6 +55,20 @@ api_platform:
         standard_put: true
 ```
 
+We recommend using the standalone API Platform packages instead of the Core monolithic repository.
+
+Update your `composer.json` like that:
+
+```patch
+ {
+     "require": {
+-        "api-platform/core": "^3",
++        "api-platform/symfony": "^3 || ^4"
++        // also add the extra packages you need, like "api-platform/doctrine-orm"
+     }
+ }
+```
+
 ## API Platform 3.1/3.2
 
 This is the recommended configuration for API Platform 3.2. We review each of these changes in this document.

symfony/debugging.md

@@ -10,7 +10,7 @@ For development purposes such as debugging tests or remote API requests,
 To enable it, run:
 
 ```console
-XDEBUG_MODE=debug docker compose up --wait
+XDEBUG_MODE=debug XDEBUG_SESSION=1 docker compose up --wait
 ```
 
 ## Using Xdebug with PhpStorm