Added a delete method.

fixes paquettg#43

Author: paquettg

README.md

@@ -1,7 +1,7 @@
 PHP Html Parser
 ==========================
 
-Version 1.6.9
+Version 1.6.9 - DEV
 
 [![Build Status](https://travis-ci.org/paquettg/php-html-parser.png)](https://travis-ci.org/paquettg/php-html-parser)
 [![Coverage Status](https://coveralls.io/repos/paquettg/php-html-parser/badge.png)](https://coveralls.io/r/paquettg/php-html-parser)
@@ -206,3 +206,14 @@ $tag = $a->getTag();
 $tag->setAttribute('class', 'foo');
 echo $a->getAttribute('class'); // "foo"
 ```
+
+It is also possible to remove a node from the tree. Simply call the `delete` method on any node to remove it from the tree. It is important to note that you should unset the node after removing it from the `DOM``, it will still take memory as long as it is not unset.
+
+```php
+$dom = new Dom;
+$dom->load('<div class="all"><p>Hey bro, <a href="google.com">click here</a><br /> :)</p></div>');
+$a   = $dom->find('a')[0];
+$a->delete();
+unset($a);
+echo $dom; // '<div class="all"><p>Hey bro, <br /> :)</p></div>');
+```

src/PHPHtmlParser/Dom.php

@@ -1,7 +1,7 @@
 <?php
 namespace PHPHtmlParser;
 
-use PHPHtmlPArser\Dom\AbstractNode;
+use PHPHtmlParser\Dom\AbstractNode;
 use PHPHtmlParser\Dom\HtmlNode;
 use PHPHtmlParser\Dom\TextNode;
 use PHPHtmlParser\Exceptions\NotLoadedException;

src/PHPHtmlParser/Dom/AbstractNode.php

@@ -152,6 +152,21 @@ public function setParent(InnerNode $parent)
         return $this;
     }
 
+    /**
+     * Removes this node and all its children from the
+     * DOM tree.
+     *
+     * @return void
+     */
+    public function delete()
+    {
+        if ( ! is_null($this->parent)) {
+            $this->parent->removeChild($this->id);
+        }
+
+        $this->parent = null;
+    }
+
     /**
      * Sets the encoding class to this node.
      *

tests/DomTest.php

@@ -309,4 +309,14 @@ public function testCodeTag()
 		$dom->load('<strong>hello</strong><code class="language-php">$foo = "bar";</code>');
 		$this->assertEquals('<strong>hello</strong><code class="language-php">$foo = "bar";</code>', (string) $dom);
 	}
+
+	public function testDeleteNode()
+	{
+		$dom = new Dom;
+		$dom->load('<div class="all"><p>Hey bro, <a href="google.com">click here</a><br /> :)</p></div>');
+		$a   = $dom->find('a')[0];
+		$a->delete();
+		unset($a);
+		$this->assertEquals('<div class="all"><p>Hey bro, <br /> :)</p></div>', (string) $dom);
+	}
 }