Merge branch '2.3' into 2.7

* 2.3:
  updated VERSION for 2.3.42
  update CONTRIBUTORS for 2.3.42
  updated CHANGELOG for 2.3.42
  Revert "bug #18908 [DependencyInjection] force enabling the external XML entity loaders (xabbuh)"
  Partial revert of previous PR
  [DependencyInjection] Skip deep reference check for 'service_container'
  Catch \Throwable
  [Serializer] Add missing @throws annotations
  Fix for #18843
  force enabling the external XML entity loaders
  Removed UTC specification with timestamp

Author: fabpot

Encoder/ChainDecoder.php

@@ -59,7 +59,7 @@ public function supportsDecoding($format)
      *
      * @return DecoderInterface
      *
-     * @throws RuntimeException if no decoder is found
+     * @throws RuntimeException If no decoder is found.
      */
     private function getDecoder($format)
     {

Encoder/XmlEncoder.php

@@ -460,6 +460,8 @@ private function needsCdataWrapping($val)
      * @param \DOMNode $node
      * @param mixed    $val
      *
+     * @throws UnexpectedValueException
+     * 
      * @return bool
      */
     private function selectNodeType(\DOMNode $node, $val)

Normalizer/DenormalizableInterface.php

@@ -11,6 +11,8 @@
 
 namespace Symfony\Component\Serializer\Normalizer;
 
+use Symfony\Component\Serializer\Exception\Exception;
+
 /**
  * Defines the most basic interface a class must implement to be denormalizable.
  *
@@ -33,6 +35,10 @@ interface DenormalizableInterface
      * @param string|null           $format       The format is optionally given to be able to denormalize differently
      *                                            based on different input formats
      * @param array                 $context      options for denormalizing
+     *
+     * @return object
+     *
+     * @throws Exception
      */
     public function denormalize(DenormalizerInterface $denormalizer, $data, $format = null, array $context = array());
 }

Normalizer/DenormalizerInterface.php

@@ -11,6 +11,8 @@
 
 namespace Symfony\Component\Serializer\Normalizer;
 
+use Symfony\Component\Serializer\Exception\Exception;
+
 /**
  * Defines the interface of denormalizers.
  *
@@ -26,6 +28,8 @@ interface DenormalizerInterface
      * @param string $format  format the given data was extracted from
      * @param array  $context options available to the denormalizer
      *
+     * @throws Exception
+     *                    
      * @return object
      */
     public function denormalize($data, $class, $format = null, array $context = array());

Normalizer/NormalizableInterface.php

@@ -11,6 +11,8 @@
 
 namespace Symfony\Component\Serializer\Normalizer;
 
+use Symfony\Component\Serializer\Exception\Exception;
+
 /**
  * Defines the most basic interface a class must implement to be normalizable.
  *
@@ -33,6 +35,8 @@ interface NormalizableInterface
      *                                        based on different output formats.
      * @param array               $context    Options for normalizing this object
      *
+     * @throws Exception
+     *                                           
      * @return array|string|bool|int|float|null
      */
     public function normalize(NormalizerInterface $normalizer, $format = null, array $context = array());

Normalizer/NormalizerInterface.php

@@ -11,6 +11,8 @@
 
 namespace Symfony\Component\Serializer\Normalizer;
 
+use Symfony\Component\Serializer\Exception\Exception;
+
 /**
  * Defines the interface of normalizers.
  *
@@ -25,6 +27,8 @@ interface NormalizerInterface
      * @param string $format  format the normalization result will be encoded as
      * @param array  $context Context options for the normalizer
      *
+     * @throws Exception
+     *                                           
      * @return array|string|bool|int|float|null
      */
     public function normalize($object, $format = null, array $context = array());

Serializer.php

@@ -183,6 +183,8 @@ public function supportsDenormalization($data, $type, $format = null)
      * @param string $format format name, present to give the option to normalizers to act differently based on formats
      *
      * @return NormalizerInterface|null
+     *
+     * @throws RuntimeException
      */
     private function getNormalizer($data, $format)
     {
@@ -201,6 +203,8 @@ private function getNormalizer($data, $format)
      * @param string $format format name, present to give the option to normalizers to act differently based on formats
      *
      * @return DenormalizerInterface|null
+     *
+     * @throws RuntimeException
      */
     private function getDenormalizer($data, $class, $format)
     {

SerializerInterface.php

@@ -11,6 +11,8 @@
 
 namespace Symfony\Component\Serializer;
 
+use Symfony\Component\Serializer\Exception\Exception;
+
 /**
  * Defines the interface of the Serializer.
  *
@@ -25,6 +27,8 @@ interface SerializerInterface
      * @param string $format  format name
      * @param array  $context options normalizers/encoders have access to
      *
+     * @throws Exception
+     *                    
      * @return string
      */
     public function serialize($data, $format, array $context = array());
@@ -37,6 +41,8 @@ public function serialize($data, $format, array $context = array());
      * @param string $format
      * @param array  $context
      *
+     * @throws Exception
+     * 
      * @return object
      */
     public function deserialize($data, $type, $format, array $context = array());