--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/vendor/symfony/src/Symfony/Component/DomCrawler/Crawler.php Sat Sep 24 15:40:41 2011 +0200
@@ -0,0 +1,670 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\DomCrawler;
+
+use Symfony\Component\CssSelector\CssSelector;
+
+/**
+ * Crawler eases navigation of a list of \DOMNode objects.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @api
+ */
+class Crawler extends \SplObjectStorage
+{
+ private $uri;
+
+ /**
+ * Constructor.
+ *
+ * @param mixed $node A Node to use as the base for the crawling
+ * @param string $uri The current URI or the base href value
+ *
+ * @api
+ */
+ public function __construct($node = null, $uri = null)
+ {
+ $this->uri = $uri;
+
+ $this->add($node);
+ }
+
+ /**
+ * Removes all the nodes.
+ *
+ * @api
+ */
+ public function clear()
+ {
+ $this->removeAll($this);
+ }
+
+ /**
+ * Adds a node to the current list of nodes.
+ *
+ * This method uses the appropriate specialized add*() method based
+ * on the type of the argument.
+ *
+ * @param null|\DOMNodeList|array|\DOMNode $node A node
+ *
+ * @api
+ */
+ public function add($node)
+ {
+ if ($node instanceof \DOMNodeList) {
+ $this->addNodeList($node);
+ } elseif (is_array($node)) {
+ $this->addNodes($node);
+ } elseif (is_string($node)) {
+ $this->addContent($node);
+ } elseif (is_object($node)) {
+ $this->addNode($node);
+ }
+ }
+
+ /**
+ * Adds HTML/XML content.
+ *
+ * @param string $content A string to parse as HTML/XML
+ * @param string $type The content type of the string
+ */
+ public function addContent($content, $type = null)
+ {
+ if (empty($type)) {
+ $type = 'text/html';
+ }
+
+ // DOM only for HTML/XML content
+ if (!preg_match('/(x|ht)ml/i', $type, $matches)) {
+ return null;
+ }
+
+ $charset = 'ISO-8859-1';
+ if (false !== $pos = strpos($type, 'charset=')) {
+ $charset = substr($type, $pos + 8);
+ if (false !== $pos = strpos($charset, ';')) {
+ $charset = substr($charset, 0, $pos);
+ }
+ }
+
+ if ('x' === $matches[1]) {
+ $this->addXmlContent($content, $charset);
+ } else {
+ $this->addHtmlContent($content, $charset);
+ }
+ }
+
+ /**
+ * Adds an HTML content to the list of nodes.
+ *
+ * @param string $content The HTML content
+ * @param string $charset The charset
+ *
+ * @api
+ */
+ public function addHtmlContent($content, $charset = 'UTF-8')
+ {
+ $dom = new \DOMDocument('1.0', $charset);
+ $dom->validateOnParse = true;
+
+ @$dom->loadHTML($content);
+ $this->addDocument($dom);
+
+ $base = $this->filter('base')->extract(array('href'));
+
+ if (count($base)) {
+ $this->uri = current($base);
+ }
+ }
+
+ /**
+ * Adds an XML content to the list of nodes.
+ *
+ * @param string $content The XML content
+ * @param string $charset The charset
+ *
+ * @api
+ */
+ public function addXmlContent($content, $charset = 'UTF-8')
+ {
+ $dom = new \DOMDocument('1.0', $charset);
+ $dom->validateOnParse = true;
+
+ // remove the default namespace to make XPath expressions simpler
+ @$dom->loadXML(str_replace('xmlns', 'ns', $content));
+ $this->addDocument($dom);
+ }
+
+ /**
+ * Adds a \DOMDocument to the list of nodes.
+ *
+ * @param \DOMDocument $dom A \DOMDocument instance
+ *
+ * @api
+ */
+ public function addDocument(\DOMDocument $dom)
+ {
+ if ($dom->documentElement) {
+ $this->addNode($dom->documentElement);
+ }
+ }
+
+ /**
+ * Adds a \DOMNodeList to the list of nodes.
+ *
+ * @param \DOMNodeList $nodes A \DOMNodeList instance
+ *
+ * @api
+ */
+ public function addNodeList(\DOMNodeList $nodes)
+ {
+ foreach ($nodes as $node) {
+ $this->addNode($node);
+ }
+ }
+
+ /**
+ * Adds an array of \DOMNode instances to the list of nodes.
+ *
+ * @param array $nodes An array of \DOMNode instances
+ *
+ * @api
+ */
+ public function addNodes(array $nodes)
+ {
+ foreach ($nodes as $node) {
+ $this->add($node);
+ }
+ }
+
+ /**
+ * Adds a \DOMNode instance to the list of nodes.
+ *
+ * @param \DOMNode $node A \DOMNode instance
+ *
+ * @api
+ */
+ public function addNode(\DOMNode $node)
+ {
+ if ($node instanceof \DOMDocument) {
+ $this->attach($node->documentElement);
+ } else {
+ $this->attach($node);
+ }
+ }
+
+ /**
+ * Returns a node given its position in the node list.
+ *
+ * @param integer $position The position
+ *
+ * @return A new instance of the Crawler with the selected node, or an empty Crawler if it does not exist.
+ *
+ * @api
+ */
+ public function eq($position)
+ {
+ foreach ($this as $i => $node) {
+ if ($i == $position) {
+ return new static($node, $this->uri);
+ }
+ }
+
+ return new static(null, $this->uri);
+ }
+
+ /**
+ * Calls an anonymous function on each node of the list.
+ *
+ * The anonymous function receives the position and the node as arguments.
+ *
+ * Example:
+ *
+ * $crawler->filter('h1')->each(function ($node, $i)
+ * {
+ * return $node->nodeValue;
+ * });
+ *
+ * @param \Closure $closure An anonymous function
+ *
+ * @return array An array of values returned by the anonymous function
+ *
+ * @api
+ */
+ public function each(\Closure $closure)
+ {
+ $data = array();
+ foreach ($this as $i => $node) {
+ $data[] = $closure($node, $i);
+ }
+
+ return $data;
+ }
+
+ /**
+ * Reduces the list of nodes by calling an anonymous function.
+ *
+ * To remove a node from the list, the anonymous function must return false.
+ *
+ * @param \Closure $closure An anonymous function
+ *
+ * @return Crawler A Crawler instance with the selected nodes.
+ *
+ * @api
+ */
+ public function reduce(\Closure $closure)
+ {
+ $nodes = array();
+ foreach ($this as $i => $node) {
+ if (false !== $closure($node, $i)) {
+ $nodes[] = $node;
+ }
+ }
+
+ return new static($nodes, $this->uri);
+ }
+
+ /**
+ * Returns the first node of the current selection
+ *
+ * @return Crawler A Crawler instance with the first selected node
+ *
+ * @api
+ */
+ public function first()
+ {
+ return $this->eq(0);
+ }
+
+ /**
+ * Returns the last node of the current selection
+ *
+ * @return Crawler A Crawler instance with the last selected node
+ *
+ * @api
+ */
+ public function last()
+ {
+ return $this->eq(count($this) - 1);
+ }
+
+ /**
+ * Returns the siblings nodes of the current selection
+ *
+ * @return Crawler A Crawler instance with the sibling nodes
+ *
+ * @throws \InvalidArgumentException When current node is empty
+ *
+ * @api
+ */
+ public function siblings()
+ {
+ if (!count($this)) {
+ throw new \InvalidArgumentException('The current node list is empty.');
+ }
+
+ return new static($this->sibling($this->getNode(0)->parentNode->firstChild), $this->uri);
+ }
+
+ /**
+ * Returns the next siblings nodes of the current selection
+ *
+ * @return Crawler A Crawler instance with the next sibling nodes
+ *
+ * @throws \InvalidArgumentException When current node is empty
+ *
+ * @api
+ */
+ public function nextAll()
+ {
+ if (!count($this)) {
+ throw new \InvalidArgumentException('The current node list is empty.');
+ }
+
+ return new static($this->sibling($this->getNode(0)), $this->uri);
+ }
+
+ /**
+ * Returns the previous sibling nodes of the current selection
+ *
+ * @return Crawler A Crawler instance with the previous sibling nodes
+ *
+ * @api
+ */
+ public function previousAll()
+ {
+ if (!count($this)) {
+ throw new \InvalidArgumentException('The current node list is empty.');
+ }
+
+ return new static($this->sibling($this->getNode(0), 'previousSibling'), $this->uri);
+ }
+
+ /**
+ * Returns the parents nodes of the current selection
+ *
+ * @return Crawler A Crawler instance with the parents nodes of the current selection
+ *
+ * @throws \InvalidArgumentException When current node is empty
+ *
+ * @api
+ */
+ public function parents()
+ {
+ if (!count($this)) {
+ throw new \InvalidArgumentException('The current node list is empty.');
+ }
+
+ $node = $this->getNode(0);
+ $nodes = array();
+
+ while ($node = $node->parentNode) {
+ if (1 === $node->nodeType && '_root' !== $node->nodeName) {
+ $nodes[] = $node;
+ }
+ }
+
+ return new static($nodes, $this->uri);
+ }
+
+ /**
+ * Returns the children nodes of the current selection
+ *
+ * @return Crawler A Crawler instance with the children nodes
+ *
+ * @throws \InvalidArgumentException When current node is empty
+ *
+ * @api
+ */
+ public function children()
+ {
+ if (!count($this)) {
+ throw new \InvalidArgumentException('The current node list is empty.');
+ }
+
+ return new static($this->sibling($this->getNode(0)->firstChild), $this->uri);
+ }
+
+ /**
+ * Returns the attribute value of the first node of the list.
+ *
+ * @param string $attribute The attribute name
+ *
+ * @return string The attribute value
+ *
+ * @throws \InvalidArgumentException When current node is empty
+ *
+ * @api
+ */
+ public function attr($attribute)
+ {
+ if (!count($this)) {
+ throw new \InvalidArgumentException('The current node list is empty.');
+ }
+
+ return $this->getNode(0)->getAttribute($attribute);
+ }
+
+ /**
+ * Returns the node value of the first node of the list.
+ *
+ * @return string The node value
+ *
+ * @throws \InvalidArgumentException When current node is empty
+ *
+ * @api
+ */
+ public function text()
+ {
+ if (!count($this)) {
+ throw new \InvalidArgumentException('The current node list is empty.');
+ }
+
+ return $this->getNode(0)->nodeValue;
+ }
+
+ /**
+ * Extracts information from the list of nodes.
+ *
+ * You can extract attributes or/and the node value (_text).
+ *
+ * Example:
+ *
+ * $crawler->filter('h1 a')->extract(array('_text', 'href'));
+ *
+ * @param array $attributes An array of attributes
+ *
+ * @return array An array of extracted values
+ *
+ * @api
+ */
+ public function extract($attributes)
+ {
+ $attributes = (array) $attributes;
+
+ $data = array();
+ foreach ($this as $node) {
+ $elements = array();
+ foreach ($attributes as $attribute) {
+ if ('_text' === $attribute) {
+ $elements[] = $node->nodeValue;
+ } else {
+ $elements[] = $node->getAttribute($attribute);
+ }
+ }
+
+ $data[] = count($attributes) > 1 ? $elements : $elements[0];
+ }
+
+ return $data;
+ }
+
+ /**
+ * Filters the list of nodes with an XPath expression.
+ *
+ * @param string $xpath An XPath expression
+ *
+ * @return Crawler A new instance of Crawler with the filtered list of nodes
+ *
+ * @api
+ */
+ public function filterXPath($xpath)
+ {
+ $document = new \DOMDocument('1.0', 'UTF-8');
+ $root = $document->appendChild($document->createElement('_root'));
+ foreach ($this as $node) {
+ $root->appendChild($document->importNode($node, true));
+ }
+
+ $domxpath = new \DOMXPath($document);
+
+ return new static($domxpath->query($xpath), $this->uri);
+ }
+
+ /**
+ * Filters the list of nodes with a CSS selector.
+ *
+ * This method only works if you have installed the CssSelector Symfony Component.
+ *
+ * @param string $selector A CSS selector
+ *
+ * @return Crawler A new instance of Crawler with the filtered list of nodes
+ *
+ * @throws \RuntimeException if the CssSelector Component is not available
+ *
+ * @api
+ */
+ public function filter($selector)
+ {
+ if (!class_exists('Symfony\\Component\\CssSelector\\CssSelector')) {
+ // @codeCoverageIgnoreStart
+ throw new \RuntimeException('Unable to filter with a CSS selector as the Symfony CssSelector is not installed (you can use filterXPath instead).');
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $this->filterXPath(CssSelector::toXPath($selector));
+ }
+
+ /**
+ * Selects links by name or alt value for clickable images.
+ *
+ * @param string $value The link text
+ *
+ * @return Crawler A new instance of Crawler with the filtered list of nodes
+ *
+ * @api
+ */
+ public function selectLink($value)
+ {
+ $xpath = sprintf('//a[contains(concat(\' \', normalize-space(string(.)), \' \'), %s)] ', static::xpathLiteral(' '.$value.' ')).
+ sprintf('| //a/img[contains(concat(\' \', normalize-space(string(@alt)), \' \'), %s)]/ancestor::a', static::xpathLiteral(' '.$value.' '));
+
+ return $this->filterXPath($xpath);
+ }
+
+ /**
+ * Selects a button by name or alt value for images.
+ *
+ * @param string $value The button text
+ *
+ * @return Crawler A new instance of Crawler with the filtered list of nodes
+ *
+ * @api
+ */
+ public function selectButton($value)
+ {
+ $xpath = sprintf('//input[((@type="submit" or @type="button") and contains(concat(\' \', normalize-space(string(@value)), \' \'), %s)) ', static::xpathLiteral(' '.$value.' ')).
+ sprintf('or (@type="image" and contains(concat(\' \', normalize-space(string(@alt)), \' \'), %s)) or @id="%s" or @name="%s"] ', static::xpathLiteral(' '.$value.' '), $value, $value).
+ sprintf('| //button[contains(concat(\' \', normalize-space(string(.)), \' \'), %s) or @id="%s" or @name="%s"]', static::xpathLiteral(' '.$value.' '), $value, $value);
+
+ return $this->filterXPath($xpath);
+ }
+
+ /**
+ * Returns a Link object for the first node in the list.
+ *
+ * @param string $method The method for the link (get by default)
+ *
+ * @return Link A Link instance
+ *
+ * @throws \InvalidArgumentException If the current node list is empty
+ *
+ * @api
+ */
+ public function link($method = 'get')
+ {
+ if (!count($this)) {
+ throw new \InvalidArgumentException('The current node list is empty.');
+ }
+
+ $node = $this->getNode(0);
+
+ return new Link($node, $this->uri, $method);
+ }
+
+ /**
+ * Returns an array of Link objects for the nodes in the list.
+ *
+ * @return array An array of Link instances
+ *
+ * @api
+ */
+ public function links()
+ {
+ $links = array();
+ foreach ($this as $node) {
+ $links[] = new Link($node, $this->uri, 'get');
+ }
+
+ return $links;
+ }
+
+ /**
+ * Returns a Form object for the first node in the list.
+ *
+ * @param array $values An array of values for the form fields
+ * @param string $method The method for the form
+ *
+ * @return Form A Form instance
+ *
+ * @throws \InvalidArgumentException If the current node list is empty
+ *
+ * @api
+ */
+ public function form(array $values = null, $method = null)
+ {
+ if (!count($this)) {
+ throw new \InvalidArgumentException('The current node list is empty.');
+ }
+
+ $form = new Form($this->getNode(0), $this->uri, $method);
+
+ if (null !== $values) {
+ $form->setValues($values);
+ }
+
+ return $form;
+ }
+
+ static public function xpathLiteral($s)
+ {
+ if (false === strpos($s, "'")) {
+ return sprintf("'%s'", $s);
+ }
+
+ if (false === strpos($s, '"')) {
+ return sprintf('"%s"', $s);
+ }
+
+ $string = $s;
+ $parts = array();
+ while (true) {
+ if (false !== $pos = strpos($string, "'")) {
+ $parts[] = sprintf("'%s'", substr($string, 0, $pos));
+ $parts[] = "\"'\"";
+ $string = substr($string, $pos + 1);
+ } else {
+ $parts[] = "'$string'";
+ break;
+ }
+ }
+
+ return sprintf("concat(%s)", implode($parts, ', '));
+ }
+
+ private function getNode($position)
+ {
+ foreach ($this as $i => $node) {
+ if ($i == $position) {
+ return $node;
+ }
+ // @codeCoverageIgnoreStart
+ }
+
+ return null;
+ // @codeCoverageIgnoreEnd
+ }
+
+ private function sibling($node, $siblingDir = 'nextSibling')
+ {
+ $nodes = array();
+
+ do {
+ if ($node !== $this->getNode(0) && $node->nodeType === 1) {
+ $nodes[] = $node;
+ }
+ } while ($node = $node->$siblingDir);
+
+ return $nodes;
+ }
+}