2017 © Pedro Peláez
 

library gotenberg-php-client

A client for sending files to a Gotenberg API

image

thecodingmachine/gotenberg-php-client

A client for sending files to a Gotenberg API

  • Tuesday, June 12, 2018
  • by thecodingmachine
  • Repository
  • 7 Watchers
  • 16 Stars
  • 1,644 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 5 Versions
  • 242 % Grown

The README.md

⚠️ For Gotenberg 7.x, use gotenberg-/gotenberg-php instead., (*1)

This library is unmaintained and will not receive updates. Consider migrating to Gotenberg 7.x and the according new library instead., (*2)

Gotenberg PHP client

A simple PHP client for interacting with a Gotenberg API., (*3)

Install

Unless your project already have a PSR7 HttpClient, install php-http/guzzle6-adapter:, (*4)

$ composer require php-http/guzzle6-adapter

Then the PHP client:, (*5)

$ composer require thecodingmachine/gotenberg-php-client

Usage

use TheCodingMachine\Gotenberg\Client;
use TheCodingMachine\Gotenberg\ClientException;
use TheCodingMachine\Gotenberg\DocumentFactory;
use TheCodingMachine\Gotenberg\HTMLRequest;
use TheCodingMachine\Gotenberg\Request;
use TheCodingMachine\Gotenberg\RequestException;
use GuzzleHttp\Psr7\LazyOpenStream;

# create the client.
$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
# ... or the following if you want the client to discover automatically an installed implementation of the PSR7 `HttpClient`.
$client = new Client('http://localhost:3000');

# prepare the files required for your conversion.

# from a path.
$index = DocumentFactory::makeFromPath('index.html', '/path/to/file');
# ... or from your own stream.
$stream = new LazyOpenStream('/path/to/file', 'r');
$index = DocumentFactory::makeFromStream('index.html', $stream);
// ... or from a string.
$index = DocumentFactory::makeFromString('index.html', '<html>Foo</html>');

$header = DocumentFactory::makeFromPath('header.html', '/path/to/file');
$footer = DocumentFactory::makeFromPath('footer.html', '/path/to/file');
$assets = [
    DocumentFactory::makeFromPath('style.css', '/path/to/file'),
    DocumentFactory::makeFromPath('img.png', '/path/to/file'),
];

try {
    $request = new HTMLRequest($index);
    $request->setHeader($header);
    $request->setFooter($footer);
    $request->setAssets($assets);
    $request->setPaperSize(Request::A4);
    $request->setMargins(Request::NO_MARGINS);
    $request->setScale(0.75);

    # store method allows you to... store the resulting PDF in a particular destination.
    $client->store($request, 'path/you/want/the/pdf/to/be/stored.pdf');

    # if you wish to redirect the response directly to the browser, you may also use:
    $client->post($request);          
} catch (RequestException $e) {
    # this exception is thrown if given paper size or margins are not correct.
} catch (ClientException $e) {
    # this exception is thrown by the client if the API has returned a code != 200.
}

For more complete usages, head to the documentation., (*6)

Badges

Travis CI Scrutinizer, (*7)

The Versions

12/06 2018

dev-master

9999999-dev https://github.com/thecodingmachine/gotenberg-php-client

A client for sending files to a Gotenberg API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Julien Neuhart

api html markdown client pdf word office powerpoint gotenberg

30/05 2018

2.0.1

2.0.1.0 https://github.com/thecodingmachine/gotenberg-php-client

A client for sending files to a Gotenberg API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Julien Neuhart

api html markdown client pdf word office powerpoint gotenberg

19/04 2018

2.0.0

2.0.0.0 https://github.com/thecodingmachine/gotenberg-php-client

A client for sending files to a Gotenberg API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Julien Neuhart

api html markdown client pdf word office powerpoint gotenberg

19/04 2018

1.0.1

1.0.1.0 https://github.com/thecodingmachine/gotenberg-php-client

A client for sending files to a Gotenberg API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Julien Neuhart

api html markdown client pdf word office powerpoint gotenberg

18/04 2018

1.0.0

1.0.0.0 https://github.com/thecodingmachine/gotenberg-php-client

A client for sending files to a Gotenberg API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Julien Neuhart

api html markdown client pdf word office powerpoint gotenberg