RPC error (#23)

.travis.yml

@@ -11,13 +11,15 @@ env:
   - secure: CmLh169xwt3OC7l19lDUwdZYfw+l/+XXKjTGxnuJiXHa9hAH+nc4mEUSmqHMHwjquyYE6LnSVGZ94LH8sCaGed/TMm0Lj3DZtZ0VsjYu3sKsNrVJn5WdYEah+GvNJ8i8uzvHnGk1L2fAagLpXFUB2K9UraA1CFiHs1fF5Fua7Ra0mE7lMz0MFvyvzcmc9u8nMz71K2YVsXqn+I/rv8onJCTtc/Ds0hVrBXwG5Fh0T3xHqjOhME9ZI2hRHnnQVdBojSY3USifQ//qAKowfBVc0pebEtgFpyXx/I17A6xCm0KVtnA2tNqu1+XFkjWaBzryaLE9ujhJcTRC/YK0JUZ+QxfYbD5C7jVy9Jlx1lOEjJ42B/ImNxPP+9p3wi2MWNbcbZJPxIe635fnT17lI7CLK2Qg1xjfTQ4WTEKW5IhnYMiyfRKiripFh4PCkDm8cJlTbpntsX1n0uheydbsgf/11vS7o1WGhVQ8+Jelc4DvIbBHCqienQEOLJDBwm7FiK5JbwZJ6ZAGeDM/IhGU1h9PNjVbHUyJhUxYoPYUE9QsZFT7ENCrRQpq49KOzXBRfffyJNJRh+Ep9X5YoW0dUp0MNu5B7z2+6w9X9n/C+loa11xF42bFzniCvvbSOQ37J+EngDinVxJkNPeyivR4fye2ENhIAjAEjouTJLOSXL9nAOU=
 
 stages:
-  - lint
+  - tests
   - publish
 
 jobs:
   include:
-    - stage: lint
+    - stage: tests
       script: make lint
+    - stage: tests
+      script: make tests
     - stage: publish
       if: tag IS present
-      script: make image VERSION=$TRAVIS_TAG && ./scripts/publish.sh $TRAVIS_TAG $DOCKER_USER $DOCKER_PASS
+      script: ./scripts/publish.sh $TRAVIS_TAG $DOCKER_USER $DOCKER_PASS

README.md

@@ -34,7 +34,7 @@ to learn how to interact with it!
 
 [![Docker image layers](https://images.microbadger.com/badges/image/thecodingmachine/gotenberg:3.svg)](https://microbadger.com/images/thecodingmachine/gotenberg:3)
 [![Travis CI](https://travis-ci.org/thecodingmachine/gotenberg.svg?branch=master)](https://travis-ci.org/thecodingmachine/gotenberg)
-[![GoDoc](https://godoc.org/github.com/thecodingmachine/gotenberg?status.svg)](https://godoc.org/github.com/thecodingmachine/gotenberg?status.svg)
+[![GoDoc](https://godoc.org/github.com/thecodingmachine/gotenberg?status.svg)](https://godoc.org/github.com/thecodingmachine/gotenberg)
 [![Go Report Card](https://goreportcard.com/badge/github.com/thecodingmachine/gotenberg)](https://goreportcard.com/report/thecodingmachine/gotenberg)
 
 ---

build/docs/02-html.md

@@ -26,13 +26,13 @@ For instance:
 </html>
 ```
 
-### Guzzle
+### cURL
 
 ```bash
 $ curl --request POST \
     --url http://localhost:3000/convert/html \
     --header 'Content-Type: multipart/form-data' \
-    --form files=@index.html
+    --form files=@index.html \
     > result.pdf
 ```
 
@@ -53,7 +53,17 @@ func main() {
 
 ### PHP
 
-TODO
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\DocumentFactory;
+use TheCodingMachine\Gotenberg\HTMLRequest;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$index = DocumentFactory::makeFromPath('index.html', 'index.html');
+$request = new HTMLRequest($index);
+$dirPath = "/foo";
+$filename = $client->store($request, $dirPath);
+```
 
 ## Header and footer
 
@@ -90,15 +100,15 @@ The following classes allow you to inject printing values:
 > **Attention:** the CSS properties are independant of the ones used in the `index.html` file.
 > Also, `footer.html` CSS properties override the ones from `header.html`.
 
-### Guzzle
+### cURL
 
 ```bash
 $ curl --request POST \
     --url http://localhost:3000/convert/html \
     --header 'Content-Type: multipart/form-data' \
-    --form files=@index.html
+    --form files=@index.html \
-    --form files=@header.html
+    --form files=@header.html \
-    --form files=@footer.html
+    --form files=@footer.html \
     > result.pdf
 ```
 
@@ -123,11 +133,25 @@ func main() {
 
 ### PHP
 
-TODO
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\DocumentFactory;
+use TheCodingMachine\Gotenberg\HTMLRequest;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$index = DocumentFactory::makeFromPath('index.html', 'index.html');
+$header = DocumentFactory::makeFromPath('header.html', 'header.html');
+$footer = DocumentFactory::makeFromPath('footer.html', 'footer.html');
+$request = new HTMLRequest($index);
+$request->setHeader($header);
+$request->setFooter($footer);
+$dirPath = "/foo";
+$filename = $client->store($request, $dirPath);
+```
 
 ## Assets
 
-You may also send additional files. For instance, images, fonts, stylesheets and so on.
+You may also send additional files. For instance: images, fonts, stylesheets and so on.
 
 The only requirement is to make sure that their paths
 are on the same level as the `index.html` file.
@@ -169,16 +193,16 @@ You may also use *remote* paths for Google fonts, images and so on.
 > If you want to install fonts directly in the Gotenberg Docker image,
 > see to the [fonts section](#office.fonts).
 
-### Guzzle
+### cURL
 
 ```bash
 $ curl --request POST \
     --url http://localhost:3000/convert/html \
     --header 'Content-Type: multipart/form-data' \
-    --form files=@index.html
+    --form files=@index.html \
-    --form files=@style.css
+    --form files=@style.css \
-    --form files=@img.png
+    --form files=@img.png \
-    --form files=@font.woff
+    --form files=@font.woff \
     > result.pdf
 ```
 
@@ -204,31 +228,47 @@ func main() {
 
 ### PHP
 
-TODO
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\DocumentFactory;
+use TheCodingMachine\Gotenberg\HTMLRequest;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$index = DocumentFactory::makeFromPath('index.html', 'index.html');
+$assets = [
+    DocumentFactory::makeFromPath('style.css', 'style.css'),
+    DocumentFactory::makeFromPath('img.png', 'img.png'),
+    DocumentFactory::makeFromPath('font.woff', 'font.woff'),
+];
+$request = new HTMLRequest($index);
+$request->setAssets($assets);
+$dirPath = "/foo";
+$filename = $client->store($request, $dirPath);
+```
 
 ## Paper size, margins, orientation
 
-You may also customize the resulting PDF paper.
+You may also customize the resulting PDF format.
 
-By default, it will be rendered in `A4` size with `1 inch` margins and `portrait` orientation.
+By default, it will be rendered with `A4` size, `1 inch` margins and `portrait` orientation.
 
 > Paper size and margins have to be provided in `inches`.
 > Also, you have to set both `paperWidth` and `paperHeight`. Same for margins.
 
-### Guzzle
+### cURL
 
 ```bash
 $ curl --request POST \
     --url http://localhost:3000/convert/html \
     --header 'Content-Type: multipart/form-data' \
-    --form files=@index.html
+    --form files=@index.html \
-    --form paperWidth=8.27
+    --form paperWidth=8.27 \
-    --form paperHeight=11.27
+    --form paperHeight=11.27 \
-    --form marginTop=0
+    --form marginTop=0 \
-    --form marginBottom=0
+    --form marginBottom=0 \
-    --form marginLeft=0
+    --form marginLeft=0 \
-    --form marginRight=0
+    --form marginRight=0 \
-    --form landscape=true
+    --form landscape=true \
     > result.pdf
 ```
 
@@ -254,4 +294,18 @@ func main() {
 
 ### PHP
 
-TODO
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\DocumentFactory;
+use TheCodingMachine\Gotenberg\HTMLRequest;
+use TheCodingMachine\Gotenberg\Request;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$index = DocumentFactory::makeFromPath('index.html', 'index.html');
+$request = new HTMLRequest($index);
+$request->setPaperSize(Request::A4);
+$request->setMargins(Request::NO_MARGINS);
+$request->setLandscape(true);
+$dirPath = "/foo";
+$filename = $client->store($request, $dirPath);
+```

build/docs/03-markdown.md

@@ -11,7 +11,7 @@ It accepts `POST` requests with a `multipart/form-data` Content-Type.
 Markdown conversions work the same as HTML conversions.
 
 Only difference is that you have access to the Go template function `toHTML`
-in the file `index.html` which will convert a given markdown file to HTML.
+in the file `index.html`. This function will convert a given markdown file to HTML.
 
 For instance:
 
@@ -28,14 +28,14 @@ For instance:
 </html>
 ```
 
-### Guzzle
+### cURL
 
 ```bash
 $ curl --request POST \
     --url http://localhost:3000/convert/markdown \
     --header 'Content-Type: multipart/form-data' \
-    --form files=@index.html
+    --form files=@index.html \
-    --form files=@file.md
+    --form files=@file.md \
     > result.pdf
 ```
 
@@ -59,4 +59,17 @@ func main() {
 
 ### PHP
 
-TODO
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\DocumentFactory;
+use TheCodingMachine\Gotenberg\MarkdownRequest;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$index = DocumentFactory::makeFromPath('index.html', 'index.html');
+$markdowns = [
+    DocumentFactory::makeFromPath('file.md', 'file.md'),
+];
+$request = new MarkdownRequest($index, $markdowns);
+$dirPath = "/foo";
+$filename = $client->store($request, $dirPath);
+```

build/docs/04-office.md

@@ -2,7 +2,7 @@
 title: Office
 ---
 
-Gotenberg provides the endpoint `/convert/office` for Office documents conversions.
+Gotenberg provides the endpoint `/convert/office` for Office document conversions.
 
 It accepts `POST` requests with a `multipart/form-data` Content-Type.
 
@@ -26,14 +26,14 @@ All files will be merged into a single resulting PDF.
 > That's why for Office conversions, the API does only one conversion at a time.
 > See the [scalability section](#scalability) to find how to mitigate this issue.
 
-### Guzzle
+### cURL
 
 ```bash
 $ curl --request POST \
     --url http://localhost:3000/convert/office \
     --header 'Content-Type: multipart/form-data' \
-    --form files=@document.docx
+    --form files=@document.docx \
-    --form files=@document2.docx
+    --form files=@document2.docx \
     > result.pdf
 ```
 
@@ -57,7 +57,20 @@ func main() {
 
 ### PHP
 
-TODO
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\DocumentFactory;
+use TheCodingMachine\Gotenberg\OfficeRequest;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$files = [
+    DocumentFactory::makeFromPath('document.docx', 'document.docx'),
+    DocumentFactory::makeFromPath('document2.docx', 'document2.docx'),
+];
+$request = new OfficeRequest($files);
+$dirPath = "/foo";
+$filename = $client->store($request, $dirPath);
+```
 
 ## Fonts
 

build/docs/05-merge.md

@@ -11,14 +11,14 @@ It accepts `POST` requests with a `multipart/form-data` Content-Type.
 Nothing special here: you may send one or more PDF files and the API
 will merge them and return the resulting PDF file.
 
-### Guzzle
+### cURL
 
 ```bash
 $ curl --request POST \
     --url http://localhost:3000/merge \
     --header 'Content-Type: multipart/form-data' \
-    --form files=@file.pdf
+    --form files=@file.pdf \
-    --form files=@file2.pdf
+    --form files=@file2.pdf \
     > result.pdf
 ```
 
@@ -42,4 +42,17 @@ func main() {
 
 ### PHP
 
-TODO
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\DocumentFactory;
+use TheCodingMachine\Gotenberg\MergeRequest;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$files = [
+    DocumentFactory::makeFromPath('file.pdf', 'file.pdf'),
+    DocumentFactory::makeFromPath('file2.pdf', 'file2.pdf'),
+];
+$request = new MergeRequest($files);
+$dirPath = "/foo";
+$filename = $client->store($request, $dirPath);
+```

build/docs/06-webhook.md

@@ -7,19 +7,18 @@ All endpoints accept a form field named `webhookURL`.
 If provided, the API will send the resulting PDF file in a `POST` request with the `application/pdf` Content-Type
 to given URL.
 
-By doing so, your requests to the API will be done before the conversions are actually done!
+By doing so, your requests to the API will be over before the conversions are actually done!
 
 ## Examples
 
-### Guzzle
+### cURL
 
 ```bash
 $ curl --request POST \
     --url http://localhost:3000/convert/html \
     --header 'Content-Type: multipart/form-data' \
-    --form files=@index.html
+    --form files=@index.html \
     --form webhookURL='http://myapp.com/webhook/'
-    > result.pdf
 ```
 
 ### Go
@@ -42,4 +41,14 @@ func main() {
 
 ### PHP
 
-TODO
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\DocumentFactory;
+use TheCodingMachine\Gotenberg\HTMLRequest;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$index = DocumentFactory::makeFromPath('index.html', 'index.html');
+$request = new HTMLRequest($index);
+$request->setWebhookURL('http://myapp.com/webhook/');
+$resp = $client->post($request);
+```

docs/index.html

@@ -168,15 +168,15 @@ which will be converted to PDF.</p>
 <span class="p">&lt;</span><span class="p">/</span><span class="nt">html</span><span class="p">&gt;</span>
 </pre>
 
-<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.basic.guzzle" href="#html.basic.guzzle">
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.basic.c_url" href="#html.basic.c_url">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
-</a>Guzzle</h3>
+</a>cURL</h3>
 
 <pre class="chroma">$ curl --request POST <span class="se">\
 </span><span class="se"></span>    --url http://localhost:3000/convert/html <span class="se">\
 </span><span class="se"></span>    --header <span class="s1">&#39;Content-Type: multipart/form-data&#39;</span> <span class="se">\
-</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html <span class="se">\
-    &gt; result.pdf
+</span><span class="se"></span>    &gt; result.pdf
 </pre>
 
 <h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.basic.go" href="#html.basic.go">
@@ -199,7 +199,16 @@ which will be converted to PDF.</p>
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>PHP</h3>
 
-<p>TODO</p>
+<pre class="chroma"><span class="x">use TheCodingMachine\Gotenberg\Client;
+</span><span class="x">use TheCodingMachine\Gotenberg\DocumentFactory;
+</span><span class="x">use TheCodingMachine\Gotenberg\HTMLRequest;
+</span><span class="x">
+</span><span class="x">$client = new Client(&#39;http://localhost:3000&#39;, new \Http\Adapter\Guzzle6\Client());
+</span><span class="x">$index = DocumentFactory::makeFromPath(&#39;index.html&#39;, &#39;index.html&#39;);
+</span><span class="x">$request = new HTMLRequest($index);
+</span><span class="x">$dirPath = &#34;/foo&#34;;
+</span><span class="x">$filename = $client-&gt;store($request, $dirPath);
+</span><span class="x"></span></pre>
 
 <h2 class="Heading"><a class="Anchor" aria-hidden="true" id="html.header_and_footer" href="#html.header_and_footer">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
@@ -241,17 +250,17 @@ Respectively, a file named <code>header.html</code> and <code>footer.html</code>
 Also, <code>footer.html</code> CSS properties override the ones from <code>header.html</code>.</p>
 </blockquote>
 
-<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.header_and_footer.guzzle" href="#html.header_and_footer.guzzle">
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.header_and_footer.c_url" href="#html.header_and_footer.c_url">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
-</a>Guzzle</h3>
+</a>cURL</h3>
 
 <pre class="chroma">$ curl --request POST <span class="se">\
 </span><span class="se"></span>    --url http://localhost:3000/convert/html <span class="se">\
 </span><span class="se"></span>    --header <span class="s1">&#39;Content-Type: multipart/form-data&#39;</span> <span class="se">\
-</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html <span class="se">\
-    --form <span class="nv">files</span><span class="o">=</span>@header.html
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@header.html <span class="se">\
-    --form <span class="nv">files</span><span class="o">=</span>@footer.html
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@footer.html <span class="se">\
-    &gt; result.pdf
+</span><span class="se"></span>    &gt; result.pdf
 </pre>
 
 <h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.header_and_footer.go" href="#html.header_and_footer.go">
@@ -278,13 +287,26 @@ Also, <code>footer.html</code> CSS properties override the ones from <code>heade
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>PHP</h3>
 
-<p>TODO</p>
+<pre class="chroma"><span class="x">use TheCodingMachine\Gotenberg\Client;
+</span><span class="x">use TheCodingMachine\Gotenberg\DocumentFactory;
+</span><span class="x">use TheCodingMachine\Gotenberg\HTMLRequest;
+</span><span class="x">
+</span><span class="x">$client = new Client(&#39;http://localhost:3000&#39;, new \Http\Adapter\Guzzle6\Client());
+</span><span class="x">$index = DocumentFactory::makeFromPath(&#39;index.html&#39;, &#39;index.html&#39;);
+</span><span class="x">$header = DocumentFactory::makeFromPath(&#39;header.html&#39;, &#39;header.html&#39;);
+</span><span class="x">$footer = DocumentFactory::makeFromPath(&#39;footer.html&#39;, &#39;footer.html&#39;);
+</span><span class="x">$request = new HTMLRequest($index);
+</span><span class="x">$request-&gt;setHeader($header);
+</span><span class="x">$request-&gt;setFooter($footer);
+</span><span class="x">$dirPath = &#34;/foo&#34;;
+</span><span class="x">$filename = $client-&gt;store($request, $dirPath);
+</span><span class="x"></span></pre>
 
 <h2 class="Heading"><a class="Anchor" aria-hidden="true" id="html.assets" href="#html.assets">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>Assets</h2>
 
-<p>You may also send additional files. For instance, images, fonts, stylesheets and so on.</p>
+<p>You may also send additional files. For instance: images, fonts, stylesheets and so on.</p>
 
 <p>The only requirement is to make sure that their paths
 are on the same level as the <code>index.html</code> file.</p>
@@ -326,18 +348,18 @@ are on the same level as the <code>index.html</code> file.</p>
 see to the <a href="#office.fonts">fonts section</a>.</p>
 </blockquote>
 
-<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.assets.guzzle" href="#html.assets.guzzle">
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.assets.c_url" href="#html.assets.c_url">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
-</a>Guzzle</h3>
+</a>cURL</h3>
 
 <pre class="chroma">$ curl --request POST <span class="se">\
 </span><span class="se"></span>    --url http://localhost:3000/convert/html <span class="se">\
 </span><span class="se"></span>    --header <span class="s1">&#39;Content-Type: multipart/form-data&#39;</span> <span class="se">\
-</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html <span class="se">\
-    --form <span class="nv">files</span><span class="o">=</span>@style.css
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@style.css <span class="se">\
-    --form <span class="nv">files</span><span class="o">=</span>@img.png
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@img.png <span class="se">\
-    --form <span class="nv">files</span><span class="o">=</span>@font.woff
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@font.woff <span class="se">\
-    &gt; result.pdf
+</span><span class="se"></span>    &gt; result.pdf
 </pre>
 
 <h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.assets.go" href="#html.assets.go">
@@ -365,37 +387,52 @@ see to the <a href="#office.fonts">fonts section</a>.</p>
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>PHP</h3>
 
-<p>TODO</p>
+<pre class="chroma"><span class="x">use TheCodingMachine\Gotenberg\Client;
+</span><span class="x">use TheCodingMachine\Gotenberg\DocumentFactory;
+</span><span class="x">use TheCodingMachine\Gotenberg\HTMLRequest;
+</span><span class="x">
+</span><span class="x">$client = new Client(&#39;http://localhost:3000&#39;, new \Http\Adapter\Guzzle6\Client());
+</span><span class="x">$index = DocumentFactory::makeFromPath(&#39;index.html&#39;, &#39;index.html&#39;);
+</span><span class="x">$assets = [
+</span><span class="x">    DocumentFactory::makeFromPath(&#39;style.css&#39;, &#39;style.css&#39;),
+</span><span class="x">    DocumentFactory::makeFromPath(&#39;img.png&#39;, &#39;img.png&#39;),
+</span><span class="x">    DocumentFactory::makeFromPath(&#39;font.woff&#39;, &#39;font.woff&#39;),
+</span><span class="x">];
+</span><span class="x">$request = new HTMLRequest($index);
+</span><span class="x">$request-&gt;setAssets($assets);
+</span><span class="x">$dirPath = &#34;/foo&#34;;
+</span><span class="x">$filename = $client-&gt;store($request, $dirPath);
+</span><span class="x"></span></pre>
 
 <h2 class="Heading"><a class="Anchor" aria-hidden="true" id="html.paper_size_margins_orientation" href="#html.paper_size_margins_orientation">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>Paper size, margins, orientation</h2>
 
-<p>You may also customize the resulting PDF paper.</p>
+<p>You may also customize the resulting PDF format.</p>
 
-<p>By default, it will be rendered in <code>A4</code> size with <code>1 inch</code> margins and <code>portrait</code> orientation.</p>
+<p>By default, it will be rendered with <code>A4</code> size, <code>1 inch</code> margins and <code>portrait</code> orientation.</p>
 
 <blockquote>
 <p>Paper size and margins have to be provided in <code>inches</code>.
 Also, you have to set both <code>paperWidth</code> and <code>paperHeight</code>. Same for margins.</p>
 </blockquote>
 
-<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.paper_size_margins_orientation.guzzle" href="#html.paper_size_margins_orientation.guzzle">
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.paper_size_margins_orientation.c_url" href="#html.paper_size_margins_orientation.c_url">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
-</a>Guzzle</h3>
+</a>cURL</h3>
 
 <pre class="chroma">$ curl --request POST <span class="se">\
 </span><span class="se"></span>    --url http://localhost:3000/convert/html <span class="se">\
 </span><span class="se"></span>    --header <span class="s1">&#39;Content-Type: multipart/form-data&#39;</span> <span class="se">\
-</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html <span class="se">\
-    --form <span class="nv">paperWidth</span><span class="o">=</span><span class="m">8</span>.27
+</span><span class="se"></span>    --form <span class="nv">paperWidth</span><span class="o">=</span><span class="m">8</span>.27 <span class="se">\
-    --form <span class="nv">paperHeight</span><span class="o">=</span><span class="m">11</span>.27
+</span><span class="se"></span>    --form <span class="nv">paperHeight</span><span class="o">=</span><span class="m">11</span>.27 <span class="se">\
-    --form <span class="nv">marginTop</span><span class="o">=</span><span class="m">0</span>
+</span><span class="se"></span>    --form <span class="nv">marginTop</span><span class="o">=</span><span class="m">0</span> <span class="se">\
-    --form <span class="nv">marginBottom</span><span class="o">=</span><span class="m">0</span>
+</span><span class="se"></span>    --form <span class="nv">marginBottom</span><span class="o">=</span><span class="m">0</span> <span class="se">\
-    --form <span class="nv">marginLeft</span><span class="o">=</span><span class="m">0</span>
+</span><span class="se"></span>    --form <span class="nv">marginLeft</span><span class="o">=</span><span class="m">0</span> <span class="se">\
-    --form <span class="nv">marginRight</span><span class="o">=</span><span class="m">0</span>
+</span><span class="se"></span>    --form <span class="nv">marginRight</span><span class="o">=</span><span class="m">0</span> <span class="se">\
-    --form <span class="nv">landscape</span><span class="o">=</span><span class="nb">true</span>
+</span><span class="se"></span>    --form <span class="nv">landscape</span><span class="o">=</span><span class="nb">true</span> <span class="se">\
-    &gt; result.pdf
+</span><span class="se"></span>    &gt; result.pdf
 </pre>
 
 <h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.paper_size_margins_orientation.go" href="#html.paper_size_margins_orientation.go">
@@ -423,7 +460,20 @@ Also, you have to set both <code>paperWidth</code> and <code>paperHeight</code>.
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>PHP</h3>
 
-<p>TODO</p>
+<pre class="chroma"><span class="x">use TheCodingMachine\Gotenberg\Client;
+</span><span class="x">use TheCodingMachine\Gotenberg\DocumentFactory;
+</span><span class="x">use TheCodingMachine\Gotenberg\HTMLRequest;
+</span><span class="x">use TheCodingMachine\Gotenberg\Request;
+</span><span class="x">
+</span><span class="x">$client = new Client(&#39;http://localhost:3000&#39;, new \Http\Adapter\Guzzle6\Client());
+</span><span class="x">$index = DocumentFactory::makeFromPath(&#39;index.html&#39;, &#39;index.html&#39;);
+</span><span class="x">$request = new HTMLRequest($index);
+</span><span class="x">$request-&gt;setPaperSize(Request::A4);
+</span><span class="x">$request-&gt;setMargins(Request::NO_MARGINS);
+</span><span class="x">$request-&gt;setLandscape(true);
+</span><span class="x">$dirPath = &#34;/foo&#34;;
+</span><span class="x">$filename = $client-&gt;store($request, $dirPath);
+</span><span class="x"></span></pre>
 
               </div>
             
@@ -442,7 +492,7 @@ Also, you have to set both <code>paperWidth</code> and <code>paperHeight</code>.
 <p>Markdown conversions work the same as HTML conversions.</p>
 
 <p>Only difference is that you have access to the Go template function <code>toHTML</code>
-in the file <code>index.html</code> which will convert a given markdown file to HTML.</p>
+in the file <code>index.html</code>. This function will convert a given markdown file to HTML.</p>
 
 <p>For instance:</p>
 
@@ -458,16 +508,16 @@ in the file <code>index.html</code> which will convert a given markdown file to
 <span class="p">&lt;</span><span class="p">/</span><span class="nt">html</span><span class="p">&gt;</span>
 </pre>
 
-<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="markdown.basic.guzzle" href="#markdown.basic.guzzle">
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="markdown.basic.c_url" href="#markdown.basic.c_url">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
-</a>Guzzle</h3>
+</a>cURL</h3>
 
 <pre class="chroma">$ curl --request POST <span class="se">\
 </span><span class="se"></span>    --url http://localhost:3000/convert/markdown <span class="se">\
 </span><span class="se"></span>    --header <span class="s1">&#39;Content-Type: multipart/form-data&#39;</span> <span class="se">\
-</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html <span class="se">\
-    --form <span class="nv">files</span><span class="o">=</span>@file.md
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@file.md <span class="se">\
-    &gt; result.pdf
+</span><span class="se"></span>    &gt; result.pdf
 </pre>
 
 <h3 class="Heading"><a class="Anchor" aria-hidden="true" id="markdown.basic.go" href="#markdown.basic.go">
@@ -493,7 +543,19 @@ in the file <code>index.html</code> which will convert a given markdown file to
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>PHP</h3>
 
-<p>TODO</p>
+<pre class="chroma"><span class="x">use TheCodingMachine\Gotenberg\Client;
+</span><span class="x">use TheCodingMachine\Gotenberg\DocumentFactory;
+</span><span class="x">use TheCodingMachine\Gotenberg\MarkdownRequest;
+</span><span class="x">
+</span><span class="x">$client = new Client(&#39;http://localhost:3000&#39;, new \Http\Adapter\Guzzle6\Client());
+</span><span class="x">$index = DocumentFactory::makeFromPath(&#39;index.html&#39;, &#39;index.html&#39;);
+</span><span class="x">$markdowns = [
+</span><span class="x">    DocumentFactory::makeFromPath(&#39;file.md&#39;, &#39;file.md&#39;),
+</span><span class="x">];
+</span><span class="x">$request = new MarkdownRequest($index, $markdowns);
+</span><span class="x">$dirPath = &#34;/foo&#34;;
+</span><span class="x">$filename = $client-&gt;store($request, $dirPath);
+</span><span class="x"></span></pre>
 
               </div>
             
@@ -501,7 +563,7 @@ in the file <code>index.html</code> which will convert a given markdown file to
                 <h1 class="Heading"><a class="Anchor" aria-hidden="true" id="office" href="#office">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>Office</h1>
-                <p>Gotenberg provides the endpoint <code>/convert/office</code> for Office documents conversions.</p>
+                <p>Gotenberg provides the endpoint <code>/convert/office</code> for Office document conversions.</p>
 
 <p>It accepts <code>POST</code> requests with a <code>multipart/form-data</code> Content-Type.</p>
 
@@ -531,16 +593,16 @@ That’s why for Office conversions, the API does only one conversion at a time.
 See the <a href="#scalability">scalability section</a> to find how to mitigate this issue.</p>
 </blockquote>
 
-<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="office.basic.guzzle" href="#office.basic.guzzle">
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="office.basic.c_url" href="#office.basic.c_url">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
-</a>Guzzle</h3>
+</a>cURL</h3>
 
 <pre class="chroma">$ curl --request POST <span class="se">\
 </span><span class="se"></span>    --url http://localhost:3000/convert/office <span class="se">\
 </span><span class="se"></span>    --header <span class="s1">&#39;Content-Type: multipart/form-data&#39;</span> <span class="se">\
-</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@document.docx
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@document.docx <span class="se">\
-    --form <span class="nv">files</span><span class="o">=</span>@document2.docx
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@document2.docx <span class="se">\
-    &gt; result.pdf
+</span><span class="se"></span>    &gt; result.pdf
 </pre>
 
 <h3 class="Heading"><a class="Anchor" aria-hidden="true" id="office.basic.go" href="#office.basic.go">
@@ -566,7 +628,19 @@ See the <a href="#scalability">scalability section</a> to find how to mitigate t
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>PHP</h3>
 
-<p>TODO</p>
+<pre class="chroma"><span class="x">use TheCodingMachine\Gotenberg\Client;
+</span><span class="x">use TheCodingMachine\Gotenberg\DocumentFactory;
+</span><span class="x">use TheCodingMachine\Gotenberg\OfficeRequest;
+</span><span class="x">
+</span><span class="x">$client = new Client(&#39;http://localhost:3000&#39;, new \Http\Adapter\Guzzle6\Client());
+</span><span class="x">$files = [
+</span><span class="x">    DocumentFactory::makeFromPath(&#39;document.docx&#39;, &#39;document.docx&#39;),
+</span><span class="x">    DocumentFactory::makeFromPath(&#39;document2.docx&#39;, &#39;document2.docx&#39;),
+</span><span class="x">];
+</span><span class="x">$request = new OfficeRequest($files);
+</span><span class="x">$dirPath = &#34;/foo&#34;;
+</span><span class="x">$filename = $client-&gt;store($request, $dirPath);
+</span><span class="x"></span></pre>
 
 <h2 class="Heading"><a class="Anchor" aria-hidden="true" id="office.fonts" href="#office.fonts">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
@@ -598,16 +672,16 @@ See the <a href="#scalability">scalability section</a> to find how to mitigate t
 <p>Nothing special here: you may send one or more PDF files and the API
 will merge them and return the resulting PDF file.</p>
 
-<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="merge.basic.guzzle" href="#merge.basic.guzzle">
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="merge.basic.c_url" href="#merge.basic.c_url">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
-</a>Guzzle</h3>
+</a>cURL</h3>
 
 <pre class="chroma">$ curl --request POST <span class="se">\
 </span><span class="se"></span>    --url http://localhost:3000/merge <span class="se">\
 </span><span class="se"></span>    --header <span class="s1">&#39;Content-Type: multipart/form-data&#39;</span> <span class="se">\
-</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@file.pdf
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@file.pdf <span class="se">\
-    --form <span class="nv">files</span><span class="o">=</span>@file2.pdf
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@file2.pdf <span class="se">\
-    &gt; result.pdf
+</span><span class="se"></span>    &gt; result.pdf
 </pre>
 
 <h3 class="Heading"><a class="Anchor" aria-hidden="true" id="merge.basic.go" href="#merge.basic.go">
@@ -633,7 +707,19 @@ will merge them and return the resulting PDF file.</p>
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>PHP</h3>
 
-<p>TODO</p>
+<pre class="chroma"><span class="x">use TheCodingMachine\Gotenberg\Client;
+</span><span class="x">use TheCodingMachine\Gotenberg\DocumentFactory;
+</span><span class="x">use TheCodingMachine\Gotenberg\MergeRequest;
+</span><span class="x">
+</span><span class="x">$client = new Client(&#39;http://localhost:3000&#39;, new \Http\Adapter\Guzzle6\Client());
+</span><span class="x">$files = [
+</span><span class="x">    DocumentFactory::makeFromPath(&#39;file.pdf&#39;, &#39;file.pdf&#39;),
+</span><span class="x">    DocumentFactory::makeFromPath(&#39;file2.pdf&#39;, &#39;file2.pdf&#39;),
+</span><span class="x">];
+</span><span class="x">$request = new MergeRequest($files);
+</span><span class="x">$dirPath = &#34;/foo&#34;;
+</span><span class="x">$filename = $client-&gt;store($request, $dirPath);
+</span><span class="x"></span></pre>
 
               </div>
             
@@ -646,22 +732,21 @@ will merge them and return the resulting PDF file.</p>
 <p>If provided, the API will send the resulting PDF file in a <code>POST</code> request with the <code>application/pdf</code> Content-Type
 to given URL.</p>
 
-<p>By doing so, your requests to the API will be done before the conversions are actually done!</p>
+<p>By doing so, your requests to the API will be over before the conversions are actually done!</p>
 
 <h2 class="Heading"><a class="Anchor" aria-hidden="true" id="webhook.examples" href="#webhook.examples">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>Examples</h2>
 
-<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="webhook.examples.guzzle" href="#webhook.examples.guzzle">
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="webhook.examples.c_url" href="#webhook.examples.c_url">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
-</a>Guzzle</h3>
+</a>cURL</h3>
 
 <pre class="chroma">$ curl --request POST <span class="se">\
 </span><span class="se"></span>    --url http://localhost:3000/convert/html <span class="se">\
 </span><span class="se"></span>    --header <span class="s1">&#39;Content-Type: multipart/form-data&#39;</span> <span class="se">\
-</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html
+</span><span class="se"></span>    --form <span class="nv">files</span><span class="o">=</span>@index.html <span class="se">\
-    --form <span class="nv">webhookURL</span><span class="o">=</span><span class="s1">&#39;http://myapp.com/webhook/&#39;</span>
+</span><span class="se"></span>    --form <span class="nv">webhookURL</span><span class="o">=</span><span class="s1">&#39;http://myapp.com/webhook/&#39;</span>
-    &gt; result.pdf
 </pre>
 
 <h3 class="Heading"><a class="Anchor" aria-hidden="true" id="webhook.examples.go" href="#webhook.examples.go">
@@ -687,7 +772,16 @@ to given URL.</p>
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
 </a>PHP</h3>
 
-<p>TODO</p>
+<pre class="chroma"><span class="x">use TheCodingMachine\Gotenberg\Client;
+</span><span class="x">use TheCodingMachine\Gotenberg\DocumentFactory;
+</span><span class="x">use TheCodingMachine\Gotenberg\HTMLRequest;
+</span><span class="x">
+</span><span class="x">$client = new Client(&#39;http://localhost:3000&#39;, new \Http\Adapter\Guzzle6\Client());
+</span><span class="x">$index = DocumentFactory::makeFromPath(&#39;index.html&#39;, &#39;index.html&#39;);
+</span><span class="x">$request = new HTMLRequest($index);
+</span><span class="x">$request-&gt;setWebhookURL(&#39;http://myapp.com/webhook/&#39;);
+</span><span class="x">$resp = $client-&gt;post($request);
+</span><span class="x"></span></pre>
 
               </div>
             

internal/app/api/html_test.go

@@ -11,11 +11,14 @@ import (
 )
 
 func TestHTML(t *testing.T) {
-	body, contentType := test.HTMLMultipartForm(t)
+	body, contentType := test.HTMLTestMultipartForm(t)
 	req := httptest.NewRequest(http.MethodPost, "/convert/html", body)
 	req.Header.Set(echo.HeaderContentType, contentType)
 	rec := httptest.NewRecorder()
 	e := echo.New()
 	c := e.NewContext(req, rec)
-	assert.NoError(t, convertHTML(c))
+	if assert.NoError(t, convertHTML(c)) {
+		assert.Equal(t, http.StatusOK, rec.Code)
+		assert.Equal(t, "application/pdf", rec.Header().Get(echo.HeaderContentType))
+	}
 }

internal/app/api/markdown_test.go

@@ -11,11 +11,14 @@ import (
 )
 
 func TestMarkdown(t *testing.T) {
-	body, contentType := test.MarkdownMultipartForm(t)
+	body, contentType := test.MarkdownTestMultipartForm(t)
 	req := httptest.NewRequest(http.MethodPost, "/convert/markdown", body)
 	req.Header.Set(echo.HeaderContentType, contentType)
 	rec := httptest.NewRecorder()
 	e := echo.New()
 	c := e.NewContext(req, rec)
-	assert.NoError(t, convertMarkdown(c))
+	if assert.NoError(t, convertMarkdown(c)) {
+		assert.Equal(t, http.StatusOK, rec.Code)
+		assert.Equal(t, "application/pdf", rec.Header().Get(echo.HeaderContentType))
+	}
 }

internal/app/api/merge.go

@@ -25,22 +25,25 @@ func merge(c echo.Context) error {
 		return fmt.Errorf("getting result file name: %v", err)
 	}
 	filename := fmt.Sprintf("%s.pdf", baseFilename)
-	dest := fmt.Sprintf("%s/%s", r.dirPath, filename)
+	fpath := fmt.Sprintf("%s/%s", r.dirPath, filename)
 	if r.webhookURL() == "" {
 		// if no webhook URL given, run merge
 		// and directly return the resulting PDF file
 		// or and error.
-		return printer.Merge(fpaths, dest)
+		if err := printer.Merge(fpaths, fpath); err != nil {
+			return err
+		}
+		return c.Attachment(fpath, filename)
 	}
 	// as a webhook URL has been given, we
 	// run the following lines in a goroutine so that
 	// it doesn't block.
 	go func() {
-		if err := printer.Merge(fpaths, dest); err != nil {
+		if err := printer.Merge(fpaths, fpath); err != nil {
 			c.Logger().Errorf("%v", err)
 			return
 		}
-		f, err := os.Open(dest)
+		f, err := os.Open(fpath)
 		if err != nil {
 			c.Logger().Errorf("%v", err)
 			return

internal/app/api/merge_test.go

@@ -11,11 +11,14 @@ import (
 )
 
 func TestMerge(t *testing.T) {
-	body, contentType := test.PDFMultipartForm(t)
+	body, contentType := test.PDFTestMultipartForm(t)
 	req := httptest.NewRequest(http.MethodPost, "/merge", body)
 	req.Header.Set(echo.HeaderContentType, contentType)
 	rec := httptest.NewRecorder()
 	e := echo.New()
 	c := e.NewContext(req, rec)
-	assert.NoError(t, merge(c))
+	if assert.NoError(t, merge(c)) {
+		assert.Equal(t, http.StatusOK, rec.Code)
+		assert.Equal(t, "application/pdf", rec.Header().Get(echo.HeaderContentType))
+	}
 }

internal/app/api/office_test.go

@@ -11,11 +11,14 @@ import (
 )
 
 func TestOffice(t *testing.T) {
-	body, contentType := test.OfficeMultipartForm(t)
+	body, contentType := test.OfficeTestMultipartForm(t)
 	req := httptest.NewRequest(http.MethodPost, "/convert/office", body)
 	req.Header.Set(echo.HeaderContentType, contentType)
 	rec := httptest.NewRecorder()
 	e := echo.New()
 	c := e.NewContext(req, rec)
-	assert.NoError(t, convertOffice(c))
+	if assert.NoError(t, convertOffice(c)) {
+		assert.Equal(t, http.StatusOK, rec.Code)
+		assert.Equal(t, "application/pdf", rec.Header().Get(echo.HeaderContentType))
+	}
 }

internal/pkg/pm2/chrome.go

@@ -54,8 +54,9 @@ func (c *Chrome) getFullname() string {
 
 func (c *Chrome) isViable() bool {
 	// check if Chrome is correctly running.
-	devt := devtool.New("http://127.0.0.1:9222")
+	ctx, cancel := context.WithCancel(context.Background())
-	_, err := devt.Create(context.TODO())
+	defer cancel()
+	_, err := devtool.New("http://localhost:9222").Version(ctx)
 	return err == nil
 }
 

internal/pkg/printer/html.go

@@ -36,14 +36,15 @@ const defaultHeaderFooterHTML string = "<html><head></head><body></body></html>"
 // Print converts HTML to PDF.
 // Credits: https://medium.com/compass-true-north/go-service-to-convert-web-pages-to-pdf-using-headless-chrome-5fd9ffbae1af
 func (html *HTML) Print(destination string) error {
+	ctx, cancel := context.WithCancel(context.Background())
+	defer cancel()
 	// use the DevTools HTTP/JSON API to manage targets (e.g. pages, webworkers).
-	devt := devtool.New("http://127.0.0.1:9222")
+	devt, err := devtool.New("http://localhost:9222").Version(ctx)
-	pt, err := devt.Create(html.Context)
 	if err != nil {
 		return fmt.Errorf("creating DevTools target: %v", err)
 	}
 	// open a new RPC connection to the Chrome Debugging Protocol target.
-	conn, err := rpcc.DialContext(html.Context, pt.WebSocketDebuggerURL)
+	conn, err := rpcc.DialContext(html.Context, devt.WebSocketDebuggerURL)
 	if err != nil {
 		return fmt.Errorf("creating RPC connection: %v", err)
 	}

internal/pkg/printer/printer.go

@@ -23,7 +23,7 @@ func Merge(fpaths []string, destination string) error {
 
 func writeBytesToFile(dst string, b []byte) error {
 	if err := ioutil.WriteFile(dst, b, 0644); err != nil {
-		return fmt.Errorf("%s: writting file: %v", dst, err)
+		return fmt.Errorf("%s: writing file: %v", dst, err)
 	}
 	return nil
 }

pkg/client.go

@@ -148,7 +148,7 @@ func multipartForm(req Request) (*bytes.Buffer, string, error) {
 	}
 	for name, value := range req.getFormValues() {
 		if err := writer.WriteField(name, value); err != nil {
-			return nil, "", fmt.Errorf("%s: writting form field: %v", name, err)
+			return nil, "", fmt.Errorf("%s: writing form field: %v", name, err)
 		}
 	}
 	return body, writer.FormDataContentType(), nil

pkg/doc.go

@@ -17,9 +17,9 @@ For instance, if you want to convert HTML:
          },
          Options: &gotenberg.HTMLOptions{
              HeaderFilePath: "header.html",
-		     FooterFilePath: "footer.html",
+             FooterFilePath: "footer.html",
-		     PaperSize:      gotenberg.A4,
+             PaperSize:      gotenberg.A4,
-		     PaperMargins:   gotenberg.NormalMargins,
+             PaperMargins:   gotenberg.NormalMargins,
          },
      }
      dest := "foo.pdf"

scripts/publish.sh

@@ -2,6 +2,7 @@
 
 set -e
 
+GOLANG_VERSION=1.11.2
 VERSION="$1"
 DOCKER_USER="$2"
 DOCKER_PASSWORD="$3"
@@ -16,6 +17,15 @@ if [ $VERSION_LENGTH -ne 3 ]; then
     exit 1
 fi
 
-docker push thecodingmachine/gotenberg:${SEMVER[0]}
+docker build -t thecodingmachine/gotenberg:base -f build/base/Dockerfile .
-docker push thecodingmachine/gotenberg:${SEMVER[0]}.${SEMVER[1]}
+docker build \
-docker push thecodingmachine/gotenberg:${SEMVER[0]}.${SEMVER[1]}.${SEMVER[2]}
+    --build-arg GOLANG_VERSION=${GOLANG_VERSION} \
+    --build-arg VERSION=${VERSION} \
+    -t thecodingmachine/gotenberg:${SEMVER[0]} \
+    -t thecodingmachine/gotenberg:${SEMVER[0]}.${SEMVER[1]} \
+    -t thecodingmachine/gotenberg:${SEMVER[0]}.${SEMVER[1]}.${SEMVER[2]} \
+    -f build/package/Dockerfile .
+
+docker push "thecodingmachine/gotenberg:${SEMVER[0]}"
+docker push "thecodingmachine/gotenberg:${SEMVER[0]}.${SEMVER[1]}"
+docker push "thecodingmachine/gotenberg:${SEMVER[0]}.${SEMVER[1]}.${SEMVER[2]}"

test/testfunc.go

@@ -16,31 +16,31 @@ import (
 	"github.com/thecodingmachine/gotenberg/internal/pkg/rand"
 )
 
-// HTMLMultipartForm returns the body
+// HTMLTestMultipartForm returns the body
 // for a multipate/form-data request with all
 // files under "html" folder.
-func HTMLMultipartForm(t *testing.T) (*bytes.Buffer, string) {
+func HTMLTestMultipartForm(t *testing.T) (*bytes.Buffer, string) {
 	return multipartForm(t, "html")
 }
 
-// MarkdownMultipartForm returns the body
+// MarkdownTestMultipartForm returns the body
 // for a multipate/form-data request with all
 // files under "markdown" folder.
-func MarkdownMultipartForm(t *testing.T) (*bytes.Buffer, string) {
+func MarkdownTestMultipartForm(t *testing.T) (*bytes.Buffer, string) {
 	return multipartForm(t, "markdown")
 }
 
-// OfficeMultipartForm returns the body
+// OfficeTestMultipartForm returns the body
 // for a multipate/form-data request with all
 // files under "office" folder.
-func OfficeMultipartForm(t *testing.T) (*bytes.Buffer, string) {
+func OfficeTestMultipartForm(t *testing.T) (*bytes.Buffer, string) {
 	return multipartForm(t, "office")
 }
 
-// PDFMultipartForm returns the body
+// PDFTestMultipartForm returns the body
 // for a multipate/form-data request with all
 // files under "pdf" folder.
-func PDFMultipartForm(t *testing.T) (*bytes.Buffer, string) {
+func PDFTestMultipartForm(t *testing.T) (*bytes.Buffer, string) {
 	return multipartForm(t, "pdf")
 }