Adds assertion for URLs

README.md

@@ -165,6 +165,7 @@ Method                                              | Description
 `ip($value, $message = '')`                         | Check that a string is a valid IP (either IPv4 or IPv6)
 `ipv4($value, $message = '')`                       | Check that a string is a valid IPv4
 `ipv6($value, $message = '')`                       | Check that a string is a valid IPv6
+`url($value, $message = '')`                        | Check that a string is a valid URL
 `email($value, $message = '')`                      | Check that a string is a valid e-mail address
 `notWhitespaceOnly($value, $message = '')`          | Check that a string contains at least one non-whitespace character
 

src/Assert.php

@@ -706,6 +706,24 @@ public static function ipv6($value, $message = '')
         }
     }
 
+    /**
+     * @psalm-pure
+     *
+     * @param mixed  $value
+     * @param string $message
+     *
+     * @throws InvalidArgumentException
+     */
+    public static function url($value, $message = '')
+    {
+        if (false === \filter_var($value, FILTER_VALIDATE_URL)) {
+            static::reportInvalidArgument(\sprintf(
+                $message ?: 'Expected a value to be a valid URL. Got %s',
+                static::valueToString($value)
+            ));
+        }
+    }
+
     /**
      * @param mixed  $value
      * @param string $message

src/Mixin.php

@@ -725,6 +725,26 @@ public static function nullOrIpv6($value, $message = '');
      */
     public static function allIpv6($value, $message = '');
 
+    /**
+     * @psalm-pure
+     *
+     * @param mixed  $value
+     * @param string $message
+     *
+     * @throws InvalidArgumentException
+     */
+    public static function nullOrUrl($value, $message = '');
+
+    /**
+     * @psalm-pure
+     *
+     * @param mixed  $value
+     * @param string $message
+     *
+     * @throws InvalidArgumentException
+     */
+    public static function allUrl($value, $message = '');
+
     /**
      * @param mixed  $value
      * @param string $message

tests/AssertTest.php

@@ -558,6 +558,21 @@ public function getTests()
             array('ipv6', array(array()), false),
             array('ipv6', array(null), false),
             array('ipv6', array(false), false),
+            array('url', array('example.com'), false),
+            array('url', array('://example.com'), false),
+            array('url', array('http ://example.com'), false),
+            array('url', array('http:/example.com'), false),
+            array('url', array('http://example.com::aa'), false),
+            array('url', array('http://example.com:aa'), false),
+            array('url', array('http://'), false),
+            array('url', array('http://localhost/'), true),
+            array('url', array('http://example.com/'), true),
+            array('url', array('https://example.com/'), true),
+            array('url', array('https://username:[email protected]'), true),
+            array('url', array('https://example.com?'), true),
+            array('url', array('https://exemple.com?query=1&order[0]=name'), true),
+            array('url', array('ftp://example.com'), true),
+            array('url', array('faked://example.com'), true),
             array('email', array('foo'), false),
             array('email', array(123), false),
             array('email', array('foo.com'), false),

tests/static-analysis/assert-url.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace Webmozart\Assert\Tests\StaticAnalysis;
+
+use Webmozart\Assert\Assert;
+
+/**
+ * @param mixed $value
+ *
+ * @return mixed
+ */
+function url($value)
+{
+    Assert::url($value);
+
+    return $value;
+}
+
+/**
+ * @param mixed $value
+ *
+ * @return mixed
+ */
+function nullOrUrl($value)
+{
+    Assert::nullOrUrl($value);
+
+    return $value;
+}
+
+/**
+ * @param mixed $value
+ *
+ * @return mixed
+ */
+function allUrl($value)
+{
+    Assert::allUrl($value);
+
+    return $value;
+}