feature #11584 Update serializer.rst: deprecate the setCallbacks (votanlean)

This PR was merged into the 4.2 branch. Discussion ---------- Update serializer.rst: deprecate the setCallbacks Change the deprecated setCallbacks method to the callbacks context option <!-- If your pull request fixes a BUG, use the oldest maintained branch that contains the bug (see https://symfony.com/roadmap for the list of maintained branches). If your pull request documents a NEW FEATURE, use the same Symfony branch where the feature was introduced (and `master` for features of unreleased versions). --> Commits ------- 695b706 Update serializer.rst: deprecate the setCallbacks

Author: wouterj

components/serializer.rst

@@ -623,6 +623,12 @@ and ``remove``.
 Using Callbacks to Serialize Properties with Object Instances
 -------------------------------------------------------------
 
+.. deprecated:: 4.2
+
+ The :method:`Symfony\\Component\\Serializer\\Normalizer\\AbstractNormalizer::setCallbacks`
+ method is deprecated since Symfony 4.2. Use the ``callbacks``
+ key of the context instead.
+
 When serializing, you can set a callback to format a specific object property::
 
  use App\Model\Person;
@@ -631,14 +637,19 @@ When serializing, you can set a callback to format a specific object property::
  use Symfony\Component\Serializer\Serializer;
 
  $encoder = new JsonEncoder();
- $normalizer = new GetSetMethodNormalizer();
 
  // all callback parameters are optional (you can omit the ones you don't use)
  $callback = function ($innerObject, $outerObject, string $attributeName, string $format = null, array $context = []) {
  return $innerObject instanceof \DateTime ? $innerObject->format(\DateTime::ISO8601) : '';
  };
 
- $normalizer->setCallbacks(['createdAt' => $callback]);
+ $defaultContext = [
+ AbstractNormalizer::CALLBACKS => [
+ 'createdAt' => $callback,
+ ],
+ ];
+ 
+ $normalizer = new GetSetMethodNormalizer(null, null, null, null, null, $defaultContext);
 
  $serializer = new Serializer([$normalizer], [$encoder]);