Merge branch '3.4' into 4.3

* 3.4:
  Add doc about how to get a link by its id or class attribute in DOM crawler page

Author: javiereguiluz

components/dom_crawler.rst

@@ -399,16 +399,26 @@ This behavior is best illustrated with examples::
 Links
 ~~~~~
 
-To find a link by name (or a clickable image by its ``alt`` attribute), use
-the ``selectLink()`` method on an existing crawler. This returns a ``Crawler``
-instance with just the selected link(s). Calling ``link()`` gives you a special
-:class:`Symfony\\Component\\DomCrawler\\Link` object::
-
-    $linksCrawler = $crawler->selectLink('Go elsewhere...');
-    $link = $linksCrawler->link();
-
-    // or do this all at once
-    $link = $crawler->selectLink('Go elsewhere...')->link();
+Use the ``filter()`` method to find links by their ``id`` or ``class``
+attributes and use the ``selectLink()`` method to find links by their content
+(it also finds clickable images with that content in its ``alt`` attribute).
+
+Both methods return a ``Crawler`` instance with just the selected link. Use the
+``link()`` method to get the :class:`Symfony\\Component\\DomCrawler\\Link` object
+that represents the link::
+
+    // first, select the link by id, class or content...
+    $linkCrawler = $crawler->filter('#sign-up');
+    $linkCrawler = $crawler->filter('.user-profile');
+    $linkCrawler = $crawler->selectLink('Log in');
+
+    // ...then, get the Link object:
+    $link = $linkCrawler->link();
+
+    // or do all this at once:
+    $link = $crawler->filter('#sign-up')->link();
+    $link = $crawler->filter('.user-profile')->link();
+    $link = $crawler->selectLink('Log in')->link();
 
 The :class:`Symfony\\Component\\DomCrawler\\Link` object has several useful
 methods to get more information about the selected link itself::