Add the ability to pass options directly to the PhantomJS binary (#70)

Author: mbardelmeijer

README.md

@@ -106,6 +106,18 @@ $screen->includeJs("console.log('This is supa cool!');");
 
 Just use this method before calling ```save(...)```
 
+##Passing options to PhantomJS
+
+You can set the options that will be passed to the PhantomJS binary.
+
+``` php
+$screenCapture->setOptions([
+    'ignore-ssl-errors' => 'yes',
+    // '--ignore-ssl-errors' => 'yes', // dashes may be omitted
+]);
+```
+
+
 ##Other configurations
 Additionally to the basic usage, you can set so extra configurations.
 

src/Capture.php

@@ -132,6 +132,13 @@ class Capture
      */
     protected $includedJsSnippets = array();
 
+    /**
+     * List of options which will be passed to phantomjs
+     *
+     * @var array
+     */
+    protected $options = array();
+
     /**
      * Capture constructor.
      */
@@ -217,12 +224,19 @@ public function save($imageLocation, $deleteFileIfExists = true)
             file_put_contents($jobPath, $resultString);
         }
 
-        $command = sprintf("%sphantomjs %s", $this->binPath, $jobPath);
+        $command = sprintf("%sphantomjs %s %s", $this->binPath, $this->getOptionsString(), $jobPath);
         $result = exec(escapeshellcmd($command));
 
         return file_exists($this->imageLocation);
     }
 
+    /**
+     * @param string $templateName
+     * @param array $args
+     *
+     * @return string
+     * @throws TemplateNotFoundException
+     */
     private function getTemplateResult($templateName, array $args)
     {
         $templatePath = $this->templatePath . DIRECTORY_SEPARATOR . $templateName . '.php';
@@ -236,6 +250,26 @@ private function getTemplateResult($templateName, array $args)
         return ob_get_clean();
     }
 
+    /**
+     * @return string
+     */
+    private function getOptionsString()
+    {
+        if (empty($this->options)) {
+            return '';
+        }
+
+        $mappedOptions = array_map(function ($value, $key) {
+            if (substr($key, 0, 2) === '--') {
+                $key = substr($key, 2);
+            }
+
+            return sprintf("--%s=%s", $key, $value);
+        }, $this->options, array_keys($this->options));
+
+        return implode(' ', $mappedOptions);
+    }
+
     /**
      * Sets the path to PhantomJS binary, example: "/usr/bin"
      *
@@ -415,4 +449,18 @@ public function includeJs($script)
 
         return $this;
     }
+
+    /**
+     * Sets the options which will be passed to phantomjs
+     *
+     * @param array $options
+     *
+     * @return $this
+     */
+    public function setOptions($options)
+    {
+        $this->options = $options;
+
+        return $this;
+    }
 }