Created Dom class to handle any loaded html

Author: hmerritt

src/Dom.php

@@ -0,0 +1,61 @@
+<?php
+namespace hmerritt\Dom;
+
+/**
+*  Class Imdb
+*
+*
+* @package hmerritt/imdb-api
+* @author Harry Merritt
+*/
+class Dom
+{
+
+    /**
+     * Fetch and parse the DOM of a remote site
+     *
+     * @param string $url
+     *
+     * @return Dom
+     */
+    public function fetch(string $url, array $options): Dom
+    {
+        $dom = new Dom;
+        $dom->loadFromUrl($url, [
+            "curlHeaders" => $options["curlHeaders"]
+        ]);
+        return $dom;
+    }
+
+    /**
+     * Find object within DOM (if it exists) and reutrn an attribute
+     *
+     * @param object $dom
+     * @param string $selection
+     *
+     * @return array
+     */
+    public function find(object $dom, string $selection): array
+    {
+        $found = $dom->find($selection);
+        if (count($found) > 0) {
+            return $found;
+        }
+        else {
+            return $this->emptyElement();
+        }
+    }
+
+    /**
+     * Create and parse an empty html string as a DOM element
+     *
+     * @return Dom
+     */
+    private function emptyElement(): Dom
+    {
+        $dom = new Dom;
+        $dom->load('<a src="" href="" data-video=""></a>');
+        return $dom;
+    }
+
+}

src/imdb.php

@@ -30,8 +30,9 @@ private function populateOptions(array $options = []): array
     {
         //  Default options
         $defaults = [
-            'cache'      => true,
-            'techSpecs'  => true,
+            'cache'        => true,
+            'curlHeaders'  => [],
+            'techSpecs'    => true,
         ];
 
         //  Merge any user options with the default ones
@@ -67,7 +68,7 @@ public function film(string $film, array $options = []): array
      * Searches IMDB for films, people and companies
      * @param string $search
      * @param array  $options
-     * @return $searchData
+     * @return array $searchData
      */
     public function search(string $search, array $options = []): array
     {