html2pdf http Schnittstelle

http Schnittstelle

PDF Download

Der http WebService von HTML2PDF kann mit der GET oder POST http Methode über diese URI erreicht werden:

http://online.htmltopdf.de/

Diese Parameter werden verarbeitet:

url

Die URL der zu konvertierenden Webseite als maximal 4096 Zeichen langer String. Die URL muss zwingend mit http oder https beginnen – andere Protokolle werden zur Zeit nicht unterstützt.

license

Falls vorhanden, der Lizenzschlüssel als String. Ansonsten kann der Parameter weggelassen werden.

header

Falls ein Lizenzschlüssel vorhanden ist, kann hier ein individueller Text definiert werden, der im Kopf jeder Seite des PDF sichtbar sein soll. Ohne Lizenz steht dort ein Hinweis auf diesen HTML2PDF WebService. Ist keine Lizenz vorhanden, kann dieser Parameter weggelassen werden.

orientation

Übergeben Sie „Portrait“ oder „Landscape“, um die Seitenausrichtung zu bestimmen.

background

Übergeben Sie „1“ oder „0“, um die Verarbeitung von Hintergrundfarben und -bildern ein-/auszuschalten.

print

Übergeben Sie „1“ oder „0“, um die Verarbeitung von CSS für Print-Medien ein-/auszuschalten.

plain

Wird in diesem Parameter der Wert „1“ übergeben, sendet der WebService die Daten des PDF Dokuments ohne base64 Codierung an den Browser. Der Browser versucht dann das PDF eventuell mit Hilfe von ActiveX inline im Browserfenster darzustellen.

filename

Sofern im Parameter plain der Wert „1“ übergeben wurde, kann hier ein Dateiname für das PDF angegeben werden, der einen Dateidownload im Browser startet.

Rückgabe

Der WebService liefert im Erfolgsfall die mit base64 codierten Daten der PDF Datei als String. Wurde im Parameter plain der Wert „1“ übergeben, findet keine base64 Codierung der Daten statt.

Beispiel

Ein Beispiel zur Nutzung des http WebService finden Sie hier:

http://html2pdf.wan24.de/

Dort kommt auch ein JavaScript zum Einsatz, dass ebenfalls die http Schnittstelle nutzt.

Programmierbeispiel in HTML

Dieser einfache HTML Code stellt die http Schnittstelle für beliebige URLs zur Verfügung:

<form action="http://online.htmltopdf.de/" method="POST">
<input name="plain" type="hidden" value="1" />
<input name="filename" type="hidden" value="webseite.pdf" />
URL: <input name="url" size="80" type="text" value="http://www." /><input type="submit" value="PDF erzeugen" />
</form>

Sie können auch diesen einfachen HTML Link auf Ihrer Webseite platzieren:

<a href="http://online.htmltopdf.de">PDF Download</a>

Mehr ist wirklich nicht notwendig! Klicken Sie hier, um diese Seite jetzt als PDF herunterzuladen.

Programmierbeispiel in PHP

So könnte die http Schnittstelle von HTML2PDF in PHP genutzt werden:

class HTML2PDF{
	public static $License=null;

	public static function CreatePDF($url,$header=null,$orientation='Landscape',$background='1',$print='0'){
		$license=$this->License;
		if(!is_null($license)&&$license!='')
			$license=sha1($url.$license);
		$param=Array(
			'url'			=>	$url,
			'license'		=>	$license,
			'header'		=>	$header,
			'orientation'	=>	$orientation,
			'background'	=>	$background,
			'print'			=>	$print,
			'plain'			=>	'1'
		);
		$temp=Array();
		foreach(array_keys($param) as $key)
			$temp[]=urlencode($key).'='.urlencode($param[$key]);
		return file_get_contents('http://online.htmltopdf.de/?'.implode('&',$temp));
	}
}

Und so wird diese PHP Klasse im Code verwendet:

HTML2PDF::License='';// Hier den Lizenzschlüssel eingeben, falls vorhanden
// PDF erzeugen und in die Datei "demo.pdf" schreiben
file_put_contents('demo.pdf',HTML2PDF::CreatePDF('http://wan24.de'));

HTML2PDF Online