Jonny Wenmoth пре 11 година
родитељ
комит
887474e9a4
10 измењених фајлова са 705 додато и 99 уклоњено
  1. 3 4
      advanced.html
  2. 3 4
      debugging.html
  3. 59 0
      documentation.html
  4. 9 5
      index.html
  5. 88 82
      installation.html
  6. 120 0
      markdown/index.md
  7. 108 0
      markdown/installation.md
  8. 264 0
      markdown/usage.md
  9. 48 0
      troubleshooting.html
  10. 3 4
      usage.html

+ 3 - 4
advanced.html

@@ -8,7 +8,7 @@
 
     <link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
 
-    <title>php-phantomjs</title>
+    <title>PHP PhantomJS // Advanced</title>
   </head>
 
   <body>
@@ -18,7 +18,7 @@
         <header class="inner">
           <a id="forkme_banner" href="https://github.com/jonnnnyw/php-phantomjs">View on GitHub</a>
 
-          <h1 id="project_title">php-phantomjs</h1>
+          <h1 id="project_title">PHP PhantomJS</h1>
           <h2 id="project_tagline">Execute PhantomJS commands through PHP</h2>
 
         </header>
@@ -27,8 +27,7 @@
     <!-- MAIN CONTENT -->
     <div id="main_content_wrap" class="outer">
       <section id="main_content" class="inner">
-        <h1>
-            <a name="introduction" class="anchor" href="#introduction"><span class="octicon octicon-link"></span></a>Advanced</h1>
+        <h1>Advanced</h1>
 
             <p>This documentation will be up in a couple of days.</p>
             

+ 3 - 4
debugging.html

@@ -8,7 +8,7 @@
 
     <link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
 
-    <title>php-phantomjs</title>
+    <title>PHP PhantomJS // Debugging</title>
   </head>
 
   <body>
@@ -18,7 +18,7 @@
         <header class="inner">
           <a id="forkme_banner" href="https://github.com/jonnnnyw/php-phantomjs">View on GitHub</a>
 
-          <h1 id="project_title">php-phantomjs</h1>
+          <h1 id="project_title">PHP PhantomJS</h1>
           <h2 id="project_tagline">Execute PhantomJS commands through PHP</h2>
 
         </header>
@@ -27,8 +27,7 @@
     <!-- MAIN CONTENT -->
     <div id="main_content_wrap" class="outer">
       <section id="main_content" class="inner">
-        <h1>
-            <a name="introduction" class="anchor" href="#introduction"><span class="octicon octicon-link"></span></a>Debugging</h1>
+        <h1>Debugging</h1>
 
             <p>This documentation will be up in a couple of days.</p>
             

+ 59 - 0
documentation.html

@@ -0,0 +1,59 @@
+<!DOCTYPE html>
+<html>
+
+  <head>
+    <meta charset='utf-8' />
+    <meta http-equiv="X-UA-Compatible" content="chrome=1" />
+    <meta name="description" content="php-phantomjs : Execute PhantomJS commands through PHP" />
+
+    <link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
+
+    <title>PHP PhantomJS // Documentation</title>
+  </head>
+
+  <body>
+
+    <!-- HEADER -->
+    <div id="header_wrap" class="outer">
+        <header class="inner">
+          <a id="forkme_banner" href="https://github.com/jonnnnyw/php-phantomjs">View on GitHub</a>
+
+          <h1 id="project_title">PHP PhantomJS</h1>
+          <h2 id="project_tagline">Execute PhantomJS commands through PHP</h2>
+
+        </header>
+    </div>
+
+    <!-- MAIN CONTENT -->
+    <div id="main_content_wrap" class="outer">
+      <section id="main_content" class="inner">
+      
+        <h1>Documentation</h1>
+            
+            <p>Browse the PHP PhantomJS documentation.</p>
+            
+            <nav>
+                <ul>
+                    <li><a href="http://jonnnnyw.github.io/php-phantomjs/installation.html">Installation</a></li>
+                    <li><a href="http://jonnnnyw.github.io/php-phantomjs/usage.html">Usage</a></li>
+                    <li><a href="http://jonnnnyw.github.io/php-phantomjs/advanced.html">Advanced</a></li>
+                    <li><a href="http://jonnnnyw.github.io/php-phantomjs/debugging.html">Debugging</a></li>
+                    <li><a href="http://jonnnnyw.github.io/php-phantomjs/troubleshooting.html">Troubleshooting</a></li>
+                </ul>
+            </nav>
+
+      </section>
+    </div>
+
+    <!-- FOOTER  -->
+    <div id="footer_wrap" class="outer">
+      <footer class="inner">
+        <p class="copyright">php-phantomjs maintained by <a href="https://github.com/jonnnnyw">jonnnnyw</a></p>
+        <p>Published with <a href="http://pages.github.com">GitHub Pages</a></p>
+      </footer>
+    </div>
+
+    
+
+  </body>
+</html>

+ 9 - 5
index.html

@@ -7,7 +7,7 @@
     <meta name="description" content="php-phantomjs : Execute PhantomJS commands through PHP">
     <link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
 
-    <title>php-phantomjs</title>
+    <title>PHP PhantomJS</title>
 </head>
 
 <body>
@@ -15,17 +15,21 @@
 
     <div id="header_wrap" class="outer">
         <header class="inner">
+        
             <a id="forkme_banner" href="https://github.com/jonnnnyw/php-phantomjs">View on GitHub</a>
 
-            <h1 id="project_title">php-phantomjs</h1>
-
+            <h1 id="project_title">PHP PhantomJS</h1>
             <h2 id="project_tagline">Execute PhantomJS commands through PHP</h2>
+            
         </header>
     </div><!-- MAIN CONTENT -->
 
     <div id="main_content_wrap" class="outer">
+      
         <section id="main_content" class="inner">
-            <h1><a name="introduction" class="anchor" href="#introduction"></a>Introduction</h1>
+            
+            
+            <h1>Introduction</h1>
 
             <p>PHP PhantomJS is a flexible PHP library to load pages through the PhantomJS headless browser and return the page response. It is handy for testing websites that demand javascript support and also supports screen captures.</p>
 
@@ -156,7 +160,7 @@ composer require "jonnyw/php-phantomjs:3.*"
 </pre>
             </div>
 
-            <p>For more detailed examples see the <a href="http://jonnnnyw.github.io/php-phantomjs/examples.html">examples</a> section, or to create your own custom scripts check out the <a href="http://jonnnnyw.github.io/php-phantomjs/advanced.html">advanced</a> documentation.</p>
+            <p>For more detailed examples see the <a href="http://jonnnnyw.github.io/php-phantomjs/usage.html">usage</a> section, or to create your own custom scripts check out the <a href="http://jonnnnyw.github.io/php-phantomjs/advanced.html">advanced</a> documentation.</p>
         </section>
     </div><!-- FOOTER  -->
 

+ 88 - 82
installation.html

@@ -1,51 +1,49 @@
 <!DOCTYPE html>
-<html>
-
-  <head>
-    <meta charset='utf-8' />
-    <meta http-equiv="X-UA-Compatible" content="chrome=1" />
-    <meta name="description" content="php-phantomjs : Execute PhantomJS commands through PHP" />
 
+<html>
+<head>
+    <meta charset='utf-8'>
+    <meta http-equiv="X-UA-Compatible" content="chrome=1">
+    <meta name="description" content="php-phantomjs : Execute PhantomJS commands through PHP">
     <link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
 
-    <title>php-phantomjs</title>
-  </head>
-
-  <body>
+    <title>PHP PhantomJS // Installation</title>
+</head>
 
+<body>
     <!-- HEADER -->
+
     <div id="header_wrap" class="outer">
         <header class="inner">
-          <a id="forkme_banner" href="https://github.com/jonnnnyw/php-phantomjs">View on GitHub</a>
+            <a id="forkme_banner" href="https://github.com/jonnnnyw/php-phantomjs">View on GitHub</a>
 
-          <h1 id="project_title">php-phantomjs</h1>
-          <h2 id="project_tagline">Execute PhantomJS commands through PHP</h2>
+            <h1 id="project_title">PHP PhantomJS</h1>
 
+            <h2 id="project_tagline">Execute PhantomJS commands through PHP</h2>
         </header>
-    </div>
+    </div><!-- MAIN CONTENT -->
 
-    <!-- MAIN CONTENT -->
     <div id="main_content_wrap" class="outer">
-      <section id="main_content" class="inner">
-        <h1>
-<a name="installation" class="anchor" href="#installation"><span class="octicon octicon-link"></span></a>Installation</h1>
+        <section id="main_content" class="inner">
+            <h1>Installation</h1>
 
-<h2>
-<a name="prerequisites" class="anchor" href="#prerequisites"><span class="octicon octicon-link"></span></a>Prerequisites</h2>
+            <h2><a name="prerequisites" class="anchor" href="#prerequisites"></a>Prerequisites</h2>
 
-<p>PHP PhantomJS requires PHP <strong>5.3.0</strong> or greater to run.</p>
+            <p>PHP PhantomJS requires PHP <strong>5.3.0</strong> or greater to run.</p>
 
-<h2>
-<a name="installing-via-composer" class="anchor" href="#installing-via-composer"><span class="octicon octicon-link"></span></a>Installing via Composer</h2>
+            <h2><a name="installing-via-composer" class="anchor" href="#installing-via-composer"></a>Installing via Composer</h2>
 
-<p>Install <a href="https://getcomposer.org/">Composer</a> for your project:</p>
+            <p>Install <a href="https://getcomposer.org/">Composer</a> for your project:</p>
+            <pre lang="Shell">
+<code>    curl -s http://getcomposer.org/installer | php
+</code>
+</pre>
 
-<pre lang="Shell"><code>    curl -s http://getcomposer.org/installer | php
-</code></pre>
+            <p>Create a <code>composer.json</code> file in the root of your project:</p>
 
-<p>Create a <code>composer.json</code> file in the root of your project:</p>
-
-<div class="highlight highlight-YAML"><pre>    <span class="p-Indicator">{</span>
+            <div class="highlight highlight-YAML">
+                <pre>
+    <span class="p-Indicator">{</span>
         <span class="s">"require"</span><span class="p-Indicator">:</span> <span class="p-Indicator">{</span>
             <span class="s">"jonnyw/php-phantomjs"</span><span class="p-Indicator">:</span> <span class="s">"3.*"</span>
         <span class="p-Indicator">},</span>
@@ -61,81 +59,89 @@
             <span class="p-Indicator">]</span>
         <span class="p-Indicator">}</span>
     <span class="p-Indicator">}</span>
-</pre></div>
-
-<p>It is important that you have the 'scripts' section shown above in your <code>composer.json</code> file as it will install the latest version of PhantomJS for your system to your project's bin folder. It is recommended that you create a bin folder in the root of your project as this is where the PHP PhantomJS library will look for your PhantomJS executable. If you would prefer to use a PhantomJS executable in a custom location, see the <a href="#custom-installation">Custom Installation</a> section.</p>
+</pre>
+            </div>
 
-<p>Finally, install the composer depedencies for your project:</p>
+            <p>It is important that you have the 'scripts' section shown above in your <code>composer.json</code> file as it will install the latest version of PhantomJS for your system to your project's bin folder. It is recommended that you create a bin folder in the root of your project as this is where the PHP PhantomJS library will look for your PhantomJS executable. If you would prefer to use a PhantomJS executable in a custom location, see the <a href="#custom-installation">Custom Installation</a> section.</p>
 
-<pre lang="Shell"><code>    php composer.phar install
-</code></pre>
+            <p>Finally, install the composer depedencies for your project:</p>
+            <pre lang="Shell">
+<code>    php composer.phar install
+</code>
+</pre>
 
-<h2>
-<a name="custom-installation" class="anchor" href="#custom-installation"><span class="octicon octicon-link"></span></a>Custom Installation</h2>
+            <h2><a name="custom-installation" class="anchor" href="#custom-installation"></a>Custom Installation</h2>
 
-<p>If you would prefer to use a custom install location for the PhantomJS executable, you simply need to tell the client where to find the executable file:</p>
+            <p>If you would prefer to use a custom install location for the PhantomJS executable, you simply need to tell the client where to find the executable file:</p>
 
-<div class="highlight highlight-php"><pre>    <span class="k">use</span> <span class="nx">JonnyW\PhantomJs\Client</span><span class="p">;</span>
+            <div class="highlight highlight-php">
+                <pre>
+    <span class="k">use</span> <span class="nx">JonnyW\PhantomJs\Client</span><span class="p">;</span>
 
     <span class="nv">$client</span> <span class="o">=</span> <span class="nx">Client</span><span class="o">::</span><span class="na">getInstance</span><span class="p">();</span>
     <span class="nv">$client</span><span class="o">-&gt;</span><span class="na">setPhantomJs</span><span class="p">(</span><span class="s1">'/path/to/phantomjs'</span><span class="p">);</span>
-</pre></div>
+</pre>
+            </div>
 
-<p>If you would like composer to install the PhantomJS executable to a custom location when installing dependencies, set the bin dir location in your project's <code>composer.json</code> file:</p>
+            <p>If you would like composer to install the PhantomJS executable to a custom location when installing dependencies, set the bin dir location in your project's <code>composer.json</code> file:</p>
 
-<div class="highlight highlight-YAML"><pre>    <span class="p-Indicator">{</span>
+            <div class="highlight highlight-YAML">
+                <pre>
+    <span class="p-Indicator">{</span>
         <span class="s">"config"</span><span class="p-Indicator">:</span> <span class="p-Indicator">{</span>
             <span class="s">"bin-dir"</span><span class="p-Indicator">:</span> <span class="s">"/path/to/your/projects/bin/dir"</span>
         <span class="p-Indicator">}</span>
     <span class="p-Indicator">}</span>
-</pre></div>
-
-<p>You will need to make sure that this directory exists and is writable by Composer before running the composer install.</p>
+</pre>
+            </div>
 
-<p>Once you have updated your bin location run composer install to install PhantomJS:</p>
+            <p>You will need to make sure that this directory exists and is writable by Composer before running the composer install.</p>
 
-<pre lang="Shell"><code>    php composer.phar install
-</code></pre>
+            <p>Once you have updated your bin location run composer install to install PhantomJS:</p>
+            <pre lang="Shell">
+<code>    php composer.phar install
+</code>
+</pre>
 
-<p>This should install the correct PhantomJS executable for your system to the bin locaiton you defined in your <code>composer.json</code> file. As mentioned above, you will need to tell the client where to find your PhantomJS executable as it is not installed in the default location:</p>
+            <p>This should install the correct PhantomJS executable for your system to the bin locaiton you defined in your <code>composer.json</code> file. As mentioned above, you will need to tell the client where to find your PhantomJS executable as it is not installed in the default location:</p>
 
-<div class="highlight highlight-php"><pre>    <span class="k">use</span> <span class="nx">JonnyW\PhantomJs\Client</span><span class="p">;</span>
+            <div class="highlight highlight-php">
+                <pre>
+    <span class="k">use</span> <span class="nx">JonnyW\PhantomJs\Client</span><span class="p">;</span>
 
     <span class="nv">$client</span> <span class="o">=</span> <span class="nx">Client</span><span class="o">::</span><span class="na">getInstance</span><span class="p">();</span>
     <span class="nv">$client</span><span class="o">-&gt;</span><span class="na">setPhantomJs</span><span class="p">(</span><span class="s1">'/path/to/phantomjs'</span><span class="p">);</span>
-</pre></div>
-
-<h2>
-<a name="installing-from-tarball-" class="anchor" href="#installing-from-tarball-"><span class="octicon octicon-link"></span></a>Installing from tarball </h2>
-
-<p>The PHP PhantomJS library contains several depedencies in order to function so it is recommended that you install it via composer as this will handle your dependencies for you. If you do wish to install it from a <a href="https://github.com/jonnnnyw/php-phantomjs/tags">tarball release</a> then you will need to install the dependencies manually.</p>
-
-<p>The PHP PhantomJS library currently requires the following depdencies:</p>
-
-<ul>
-<li>
-<a href="https://github.com/symfony/Config">Symfony Config Component</a> ~2.5</li>
-<li>
-<a href="https://github.com/symfony/DependencyInjection">Symfony Dependency Injection Component</a> ~2.5</li>
-<li>
-<a href="https://github.com/symfony/filesystem">Symfony Filesystem Component</a> ~2.5</li>
-<li>
-<a href="https://github.com/fabpot/Twig">Twig templating Component</a> ~1.16</li>
-<li>
-<a href="http://phantomjs.org/">PhantomJS</a> ~1.9</li>
-</ul><p>Make sure the components are in your include path and that the PhantomJS executable is installed to your projects bin folder as mentioned in the <a href="#custom-installation">Custom Installation</a> section.</p>
-      </section>
-    </div>
+</pre>
+            </div>
 
-    <!-- FOOTER  -->
-    <div id="footer_wrap" class="outer">
-      <footer class="inner">
-        <p class="copyright">php-phantomjs maintained by <a href="https://github.com/jonnnnyw">jonnnnyw</a></p>
-        <p>Published with <a href="http://pages.github.com">GitHub Pages</a></p>
-      </footer>
-    </div>
+            <h2><a name="installing-from-tarball-" class="anchor" href="#installing-from-tarball-"></a>Installing from tarball</h2>
+
+            <p>The PHP PhantomJS library contains several depedencies in order to function so it is recommended that you install it via composer as this will handle your dependencies for you. If you do wish to install it from a <a href="https://github.com/jonnnnyw/php-phantomjs/tags">tarball release</a> then you will need to install the dependencies manually.</p>
+
+            <p>The PHP PhantomJS library currently requires the following depdencies:</p>
+
+            <ul>
+                <li><a href="https://github.com/symfony/Config">Symfony Config Component</a> ~2.5</li>
+
+                <li><a href="https://github.com/symfony/DependencyInjection">Symfony Dependency Injection Component</a> ~2.5</li>
+
+                <li><a href="https://github.com/symfony/filesystem">Symfony Filesystem Component</a> ~2.5</li>
 
-    
+                <li><a href="https://github.com/fabpot/Twig">Twig templating Component</a> ~1.16</li>
 
-  </body>
+                <li><a href="http://phantomjs.org/">PhantomJS</a> ~1.9</li>
+            </ul>
+
+            <p>Make sure the components are in your include path and that the PhantomJS executable is installed to your projects bin folder as mentioned in the <a href="#custom-installation">Custom Installation</a> section.</p>
+        </section>
+    </div><!-- FOOTER  -->
+
+    <div id="footer_wrap" class="outer">
+        <footer class="inner">
+            <p class="copyright">php-phantomjs maintained by <a href="https://github.com/jonnnnyw">jonnnnyw</a></p>
+
+            <p>Published with <a href="http://pages.github.com">GitHub Pages</a></p>
+        </footer>
+    </div>
+</body>
 </html>

+ 120 - 0
markdown/index.md

@@ -0,0 +1,120 @@
+Introduction
+============
+
+PHP PhantomJS is a flexible PHP library to load pages through the PhantomJS headless browser and return the page response. It is handy for testing websites that demand javascript support and also supports screen captures.
+
+Feature List
+------------
+
+*  Load webpages through the PhantomJS headless browser
+*  View detailed response data including page content, headers, status
+   code etc.
+*  Handle redirects
+*  View javascript console errors
+*  View detailed PhantomJS debuged information
+*  Save screen captures to local disk
+*  Define screen capture x, y, width and height parameters
+*  Delay page rendering for a specified time
+*  Execute PhantomJS with command line options
+*  Easily build and run custom PhantomJS scripts
+
+Prerequisites
+-------------
+
+PHP PhantomJS requires PHP **5.3.0** or greater to run.
+
+Installation
+------------
+
+It is recommended that you use Composer to install PHP PhantomJS. First, add the following to your project’s `composer.json` file:
+
+```yaml
+
+    "scripts": {
+        "post-install-cmd": [
+            "PhantomInstaller\\Installer::installPhantomJS"
+        ],
+        "post-update-cmd": [
+            "PhantomInstaller\\Installer::installPhantomJS"
+        ]
+    }
+```
+
+This will ensure the latest version of PhantomJS is installed for your system, in your bin folder. If you haven’t defined your bin folder in your composer.json, add the path:
+
+```yaml
+
+    "config": {
+        "bin-dir": "bin"
+    }
+```
+
+Finally, install PHP PhantomJS from the root of your project:
+
+```shell
+
+    composer require "jonnyw/php-phantomjs:3.*"
+```
+
+If you would like to use another installation method or would like to see more detailed installation instructions, see the [installation](http://jonnnnyw.github.io/php-phantomjs/installation.html) documentation.
+
+Basic Usage
+-----------
+
+The following illustrates how to make a basic GET request and output the page content:
+
+```php
+
+    <?php
+
+    use JonnyW\PhantomJs\Client;
+
+    $client = Client::getInstance();
+
+    /** 
+     * @see JonnyW\PhantomJs\Message\Request 
+     **/
+    $request = $client->getMessageFactory()->createRequest('http://google.com', 'GET');
+
+    /** 
+     * @see JonnyW\PhantomJs\Message\Response 
+     **/
+    $response = $client->getMessageFactory()->createResponse();
+
+    // Send the request
+    $client->send($request, $response);
+
+    if($response->getStatus() === 200) {
+
+        // Dump the requested page content
+        echo $response->getContent();
+    }
+```
+
+And if you would like to save a screen capture to local disk:
+
+```php
+
+    <?php
+
+    use JonnyW\PhantomJs\Client;
+
+    $client = Client::getInstance();
+
+    /** 
+     * @see JonnyW\PhantomJs\Message\CaptureRequest
+     **/
+    $request = $client->getMessageFactory()->createCaptureRequest('http://google.com', 'GET');
+    $request->setCaptureFile('/path/to/save/capture/file.jpg');
+
+    /** 
+     * @see JonnyW\PhantomJs\Message\Response 
+     **/
+    $response = $client->getMessageFactory()->createResponse();
+
+    // Send the request
+    $client->send($request, $response);
+```
+
+For more detailed examples see the [examples](http://jonnnnyw.github.io/php-phantomjs/examples.html) section, or to create your own custom scripts check out the [advanced](http://jonnnnyw.github.io/php-phantomjs/advanced.html) documentation.
+

+ 108 - 0
markdown/installation.md

@@ -0,0 +1,108 @@
+Installation
+============
+
+Prerequisites
+-------------
+
+PHP PhantomJS requires PHP **5.3.0** or greater to run.
+
+Installing via Composer
+-----------------------
+
+Install [Composer](https://getcomposer.org/) for your project:
+
+``shell
+
+        curl -s http://getcomposer.org/installer | php
+``
+
+Create a `composer.json` file in the root of your project:
+
+```yaml
+
+        {
+            "require": {
+                "jonnyw/php-phantomjs": "3.*"
+            },
+            "config": {
+                "bin-dir": "bin"
+            },
+            "scripts": {
+                "post-install-cmd": [
+                    "PhantomInstaller\\Installer::installPhantomJS"
+                ],
+                "post-update-cmd": [
+                    "PhantomInstaller\\Installer::installPhantomJS"
+                ]
+            }
+        }
+```
+
+It is important that you have the 'scripts' section shown above in your `composer.json` file as it will install the latest version of PhantomJS for your system to your project's bin folder. It is recommended that you create a bin folder in the root of your project as this is where the PHP PhantomJS library will look for your PhantomJS executable. If you would prefer to use a PhantomJS executable in a custom location, see the [Custom Installation](#custom-installation) section.
+
+Finally, install the composer depedencies for your project:
+
+```shell
+
+        php composer.phar install
+```
+
+Custom Installation
+-------------------
+
+If you would prefer to use a custom install location for the PhantomJS executable, you simply need to tell the client where to find the executable file:
+
+```php
+
+        use JonnyW\PhantomJs\Client;
+
+        $client = Client::getInstance();
+        $client->setPhantomJs('/path/to/phantomjs');
+```
+
+If you would like composer to install the PhantomJS executable to a custom location when installing dependencies, set the bin dir location in your project's `composer.json` file:
+
+```yaml
+
+        {
+            "config": {
+                "bin-dir": "/path/to/your/projects/bin/dir"
+            }
+        }
+```
+
+You will need to make sure that this directory exists and is writable by Composer before running the composer install.
+
+Once you have updated your bin location run composer install to install PhantomJS:
+
+```shell
+
+        php composer.phar install
+```
+
+This should install the correct PhantomJS executable for your system to the bin locaiton you defined in your `composer.json` file. As mentioned above, you will need to tell the client where to find your PhantomJS executable as it is not installed in the default location:
+
+```php
+
+        use JonnyW\PhantomJs\Client;
+
+        $client = Client::getInstance();
+        $client->setPhantomJs('/path/to/phantomjs');
+```
+
+Installing from tarball
+-----------------------
+
+The PHP PhantomJS library contains several depedencies in order to function so it is recommended that you install it via composer as this will handle your dependencies for you. If you do wish to install it from a [tarball release](https://github.com/jonnnnyw/php-phantomjs/tags) then you will need to install the dependencies manually.
+
+The PHP PhantomJS library currently requires the following depdencies:
+
+-  [Symfony Config Component](https://github.com/symfony/Config) ~2.5
+-  [Symfony Dependency Injection Component](https://github.com/symfony/DependencyInjection) ~2.5
+-  [Symfony Filesystem Component](https://github.com/symfony/filesystem) ~2.5
+-  [Twig templating Component](https://github.com/fabpot/Twig) ~1.16
+-  [PhantomJS](http://phantomjs.org/) ~1.9
+
+Make sure the components are in your include path and that the PhantomJS
+executable is installed to your projects bin folder as mentioned in the
+[Custom Installation](#custom-installation) section.

+ 264 - 0
markdown/usage.md

@@ -0,0 +1,264 @@
+Usage
+========
+
+This page contains some common examples of how to use the PHP PhantomJS library.
+
+* [Basic Request](#basic-request)
+* [POST Request](#post-request)
+* [Other Request Methods](#other-request-methods)
+* [Response Data](#response-data)
+* [Screen Captures](#screen-captures)
+* [Custom Timeout](#custom-timeout)
+* [Delay Page Render](#delay-page-render)
+* [Custom Run Options](#custom-run-options)
+
+Basic Request
+-------------
+
+A basic GET request:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    
+    $request  = $client->getMessageFactory()->createRequest();
+    $response = $client->getMessageFactory()->createResponse();
+    
+    $request->setMethod('GET');
+    $request->setUrl('http://google.com');
+    
+    $client->send($request, $response);
+    
+    if($response->getStatus() === 200) {
+        echo $response->getContent();
+    }
+```
+
+You can also set the URL, request method and timeout period when creating a new request instance through the message factory:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    
+    $request  = $client->getMessageFactory()->createRequest('http://google.com', 'GET', 5000);
+    $response = $client->getMessageFactory()->createResponse();
+        
+    $client->send($request, $response);
+    
+    if($response->getStatus() === 200) {
+        echo $response->getContent();
+    }
+```
+
+POST Request
+------------
+
+A basic POST request:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    
+    $request  = $client->getMessageFactory()->createRequest();
+    $response = $client->getMessageFactory()->createResponse();
+    
+    $data = array(
+        'param1' => 'Param 1',
+        'param2' => 'Param 2'
+    );
+    
+    $request->setMethod('POST');
+    $request->setUrl('http://google.com');
+    $request->setRequestData($data); // Set post data
+    
+    $client->send($request, $response);
+```
+
+Other Request Methods
+---------------------
+
+The PHP PhantomJS library supports the following request methods:
+
+* OPTIONS
+* GET
+* HEAD
+* POST
+* PUT
+* DELETE
+* PATCH
+
+The request method can be set when creating a new request instance through the message factory:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    
+    $request  = $client->getMessageFactory()->createRequest('http://google.com', 'PUT');
+```
+
+Or on the request instance itself:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    
+    $request  = $client->getMessageFactory()->createRequest();
+    $request->setMethod('PATCH');
+```
+
+Response Data
+-------------
+
+A standard response gives you access to the following interface:
+
+| Accessor            | Description                                                                               |  Return Type   |
+| :-----------------: | ----------------------------------------------------------------------------------------- | :------------: |
+| getHeaders()        | Returns an array of all response headers.                                                 | Array          |
+| getHeader(*header*) | Returns the value for a specific response header e.g. Content-Type.                       | Mixed          |
+| getStatus()         | The response status code e.g. 200.                                                        | Int            |
+| getContent()        | The raw page content of the requested page.                                               | String         |
+| getContentType()    | The content type of the requested page.                                                   | String         |
+| getUrl()            | The URL of the requested page.                                                            | String         |
+| getRedirectUrl()    | If the response was a redirect, this will return the redirect URL.                        | String         |
+| isRedirect()        | Will return true if the response was a redirect or false otherwise.                       | Boolean        |
+| getConsole()        | Returns an array of any javascript errors on the requested page along with a stack trace. | Array          |
+
+If the response contains a status code of 0, chances are the request failed. Check the request [debug log](https://github.com/jonnnnyw/php-phantomjs/blob/master/doc/debugging.rst) for more detailed information about what may have gone wrong.
+
+Screen Captures
+---------------
+
+You can save screen captures of a page to your local disk by creating a screen capture request and setting the path you wish to save the file to:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    
+    $request  = $client->getMessageFactory()->createCaptureRequest('http://google.com');
+    $response = $client->getMessageFactory()->createResponse();
+    
+    $file = '/path/to/save/your/screen/capture/file.jpg';
+    
+    $request->setCaptureFile($file);
+    
+    $client->send($request, $response);
+```
+
+You will need to make sure the directory that you are saving the file to exists and is writable by your application.
+
+You can also set the width, height, x and y axis for your screen capture:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    
+    $request  = $client->getMessageFactory()->createCaptureRequest('http://google.com');
+    $response = $client->getMessageFactory()->createResponse();
+    
+    $file = '/path/to/save/your/screen/capture/file.jpg';
+    
+    $top    = 10;
+    $left   = 10;
+    $width  = 200;
+    $height = 400;
+    
+    $request->setCaptureFile($file);
+    $request->setCaptureDimensions($width, $height, $top, $left);
+    
+    $client->send($request, $response);
+```
+
+Custom Timeout
+--------------
+
+By default, each request will timeout after 5 seconds. You can set a custom timeout period (in milliseconds) for each request:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    
+    $request  = $client->getMessageFactory()->createRequest('http://google.com');
+    $response = $client->getMessageFactory()->createResponse();
+    
+    $timeout = 10000; // 10 seconds
+    
+    $request->setTimeout($timeout);
+    
+    $client->send($request, $response);
+```
+
+Delay Page Render
+-----------------
+
+Sometimes when taking screen captures you may want to wait until the page is completely loaded before saving the capture. In this instance you can set a page render delay (in seconds) for the request:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    
+    $request  = $client->getMessageFactory()->createCaptureRequest('http://google.com');
+    $response = $client->getMessageFactory()->createResponse();
+    
+    $delay = 5; // 5 seconds
+    
+    $request->setDelay($delay);
+    
+    $client->send($request, $response);
+```
+
+You can set a page render delay for standard requests also.
+
+
+Custom Run Options
+------------------
+
+The PhantomJS API contains a range of command line options that can be passed when executing the PhantomJS executable. These can also be passed in via the client before a request:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    $client->addOption('--load-images=true');
+    $client->addOption('--ignore-ssl-errors=true');
+    
+    $request  = $client->getMessageFactory()->createRequest('http://google.com');
+    $response = $client->getMessageFactory()->createResponse();
+
+    $client->send($request, $response);
+```
+
+You can also set a path to a JSON configuration file that contains multiple PhantomJS options:
+
+```php
+
+    use JonnyW\PhantomJs\Client;
+    
+    $client = Client::getInstance();
+    $client->addOption('--config=/path/to/config.json');
+    
+    $request  = $client->getMessageFactory()->createRequest('http://google.com');
+    $response = $client->getMessageFactory()->createResponse();
+
+    $client->send($request, $response);
+```
+
+See the [PhantomJS Documentation](http://phantomjs.org/api/command-line.html) for a full list of command line options.

+ 48 - 0
troubleshooting.html

@@ -0,0 +1,48 @@
+<!DOCTYPE html>
+<html>
+
+  <head>
+    <meta charset='utf-8' />
+    <meta http-equiv="X-UA-Compatible" content="chrome=1" />
+    <meta name="description" content="php-phantomjs : Execute PhantomJS commands through PHP" />
+
+    <link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
+
+    <title>php-phantomjs</title>
+  </head>
+
+  <body>
+
+    <!-- HEADER -->
+    <div id="header_wrap" class="outer">
+        <header class="inner">
+          <a id="forkme_banner" href="https://github.com/jonnnnyw/php-phantomjs">View on GitHub</a>
+
+          <h1 id="project_title">php-phantomjs</h1>
+          <h2 id="project_tagline">Execute PhantomJS commands through PHP</h2>
+
+        </header>
+    </div>
+
+    <!-- MAIN CONTENT -->
+    <div id="main_content_wrap" class="outer">
+      <section id="main_content" class="inner">
+        <h1>Troubleshooting</h1>
+
+            <p>This documentation will be up in a couple of days.</p>
+            
+      </section>
+    </div>
+
+    <!-- FOOTER  -->
+    <div id="footer_wrap" class="outer">
+      <footer class="inner">
+        <p class="copyright">php-phantomjs maintained by <a href="https://github.com/jonnnnyw">jonnnnyw</a></p>
+        <p>Published with <a href="http://pages.github.com">GitHub Pages</a></p>
+      </footer>
+    </div>
+
+    
+
+  </body>
+</html>

+ 3 - 4
examples.html → usage.html

@@ -8,7 +8,7 @@
 
     <link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
 
-    <title>php-phantomjs</title>
+    <title>PHP PhantomJS // Usage</title>
   </head>
 
   <body>
@@ -18,7 +18,7 @@
         <header class="inner">
           <a id="forkme_banner" href="https://github.com/jonnnnyw/php-phantomjs">View on GitHub</a>
 
-          <h1 id="project_title">php-phantomjs</h1>
+          <h1 id="project_title">PHP PhantomJS</h1>
           <h2 id="project_tagline">Execute PhantomJS commands through PHP</h2>
 
         </header>
@@ -27,8 +27,7 @@
     <!-- MAIN CONTENT -->
     <div id="main_content_wrap" class="outer">
       <section id="main_content" class="inner">
-        <h1>
-            <a name="introduction" class="anchor" href="#introduction"><span class="octicon octicon-link"></span></a>Examples</h1>
+        <h1>Usage</h1>
 
             <p>This documentation will be up in a couple of days.</p>