minor #8961 Deprecated the checkDNS and dnsMessage options (javiereguiluz)

javiereguiluz · javiereguiluz · commit b237c8475453 · 2018-01-04T10:12:45.000+01:00
This PR was merged into the master branch. Discussion ---------- Deprecated the checkDNS and dnsMessage options Alternative to #8921 because this feature was deprecated but not removed in 4.1, so we cannot remove the docs yet. Commits ------- 69788ab Deprecated the checkDNS and dnsMessage options
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
@@ -231,6 +231,12 @@ checkDNS
 
 **type**: ``boolean`` **default**: ``false``
 
+.. versionadded:: 4.1
+    This option was deprecated in Symfony 4.1 and will be removed in Symfony 5.0,
+    because checking the DNS records is not reliable enough to validate the
+    existence of the host. Use the :phpfunction:`checkdnsrr` PHP function if you
+    still want to use this kind of validation.
+
 By default, this constraint just validates the syntax of the given URL. If you
 also need to check whether the associated host exists, set the ``checkDNS``
 option to ``true``:
@@ -305,6 +311,12 @@ dnsMessage
 
 **type**: ``string`` **default**: ``The host could not be resolved.``
 
+.. versionadded:: 4.1
+    This option was deprecated in Symfony 4.1 and will be removed in Symfony 5.0,
+    because checking the DNS records is not reliable enough to validate the
+    existence of the host. Use the :phpfunction:`checkdnsrr` PHP function if you
+    still want to use this kind of validation.
+
 This message is shown when the ``checkDNS`` option is set to ``true`` and the
 DNS check failed.
 
