[DomCrawler] Document UriExpander

lyrixx · lyrixx · commit f172a93f4fd3 · 2020-02-05T11:01:00.000+01:00
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
@@ -620,6 +620,24 @@ the whole form or specific field(s)::
     $form->disableValidation();
     $form['country']->select('Invalid value');
 
+Expanding URI
+~~~~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    The UriExpander helper was added in Symfony 5.1.
+
+The :class:`Symfony\\Component\\DomCrawler\\UriExpander` class provides method
+to expand a relative link::
+
+    UriExpander::expand($uri, $currentUri);
+    // For example:
+    UriExpander::expand('/foo', 'http://localhost/bar/foo/'); // => 'http://localhost/foo'
+    UriExpander::expand('?a=b', 'http://localhost/bar#foo'; // => 'http://localhost/bar?a=b'
+    UriExpander::expand('../../', 'http://localhost/'; // =>  http://localhost/'
+
+If you need to expand a relative link according to a base URL, you can use UriExpander
+
 Learn more
 ----------
 
