add PHP and python docs

Author: jsneedles

changelog.md

@@ -16,6 +16,19 @@ Always improving. Updates to HTML/CSS to Image are posted here.
 
 If you have feature requests, please send them to us: support@htmlcsstoimage.com.
 
+### Official Python and PHP clients
+September 3, 2026
+{: .text-delta}
+
+Official HTML/CSS to Image clients are now available for Python and PHP. Each package provides typed requests and responses, configurable HTTP transport, and helpers for templates, batches, render options, image deletion, and signed URLs.
+
+- Python: [`html-css-to-image` on PyPI](https://pypi.org/project/html-css-to-image/) and the [Python examples](/example-code/python/).
+- PHP: [`html-css-to-image/client` on Packagist](https://packagist.org/packages/html-css-to-image/client) and the [PHP examples](/example-code/php/).
+
+The complete package documentation is maintained in the [Python](https://github.com/htmlcsstoimage/python-client) and [PHP](https://github.com/htmlcsstoimage/php-client) repositories.
+
+<hr>
+
 ### HTML/CSS to Image is now verified by n8n
 September 2, 2026
 {: .text-delta}

example-code/index.md

@@ -38,14 +38,16 @@ We provide example code for popular languages, but the API works the same way ev
 
 ## Start with a client library
 
-If you are using TypeScript, JavaScript, or .NET, start with the official clients. They include helpers for authentication, JSON requests, templates, and signed image URLs.
+If you are using TypeScript, JavaScript, .NET, Python, or PHP, start with the official clients. They include helpers for authentication, JSON requests, templates, and signed image URLs.
 
 | Language | Recommended starting point |
 |:---------|:---------------------------|
 | TypeScript / JavaScript | [Official npm client](/example-code/typescript/#official-npm-client) |
 | C# / .NET | [Official NuGet package](/example-code/c/) |
+| Python | [Official PyPI client](/example-code/python/#official-pypi-client) |
+| PHP | [Official Composer client](/example-code/php/#official-composer-client) |
 
-The other examples stay close to each language's standard HTTP and JSON tools, adding a popular client library only when the language does not include one.
+The pages also include direct HTTP examples when you want to work with the API without an SDK.
 
 ---
 

example-code/php.md

@@ -6,10 +6,51 @@ parent: Example code
 permalink: /example-code/php/
 description: >-
   Convert HTML to an image (png, jpg or webp) with PHP + the HTML/CSS to Image
-  API. Renders exactly like Google Chrome.
+  API. Official Composer package for PHP 8.2+.
 ---
 {% include intro.md language="PHP" %}
 
+## Official Composer client
+
+For typed requests, responses, and signed URL helpers, use the official [`html-css-to-image/client`](https://packagist.org/packages/html-css-to-image/client) package.
+
+```bash
+composer require html-css-to-image/client
+```
+
+```php
+<?php
+
+use HtmlCssToImage\HtmlCssToImageClient;
+use HtmlCssToImage\Request\CreateHtmlCssImageRequest;
+use HtmlCssToImage\Response\CreateImageSuccessResponse;
+
+require __DIR__ . '/vendor/autoload.php';
+
+$client = new HtmlCssToImageClient(
+    apiId: 'your-api-id',
+    apiKey: 'your-api-key',
+);
+
+$result = $client->createImage(
+    new CreateHtmlCssImageRequest(
+        html: "<div class='box'>PHP ✅</div>",
+        css: '.box { border: 4px solid #03B875; padding: 20px; }',
+    ),
+);
+
+if ($result instanceof CreateImageSuccessResponse) {
+    echo $result->url;
+} else {
+    echo $result->error;
+}
+```
+
+The client also supports URL screenshots, templates, batches, image deletion, render options, and signed URLs. See the [PHP client repository](https://github.com/htmlcsstoimage/php-client) for complete usage and API documentation.
+
+<hr>
+
+## Direct HTTP example
 
 ```php
 {% include_snippet everything from snippets/plain_php.php %}

example-code/python.md

@@ -6,10 +6,41 @@ parent: Example code
 permalink: /example-code/python/
 description: >-
   Convert HTML to an image (png, jpg or webp) with Python + the HTML/CSS to Image
-  API. Renders images exactly like Google Chrome.
+  API. Official PyPI package for Python 3.10+.
 ---
 {% include intro.md language="Python" %}
 
+## Official PyPI client
+
+For typed requests, responses, and signed URL helpers, use the official [`html-css-to-image`](https://pypi.org/project/html-css-to-image/) package.
+
+```bash
+pip install html-css-to-image
+```
+
+```python
+from html_css_to_image import CreateHtmlCssImageRequest, HtmlCssToImageClient
+
+with HtmlCssToImageClient("your-api-id", "your-api-key") as client:
+    result = client.create_image(
+        CreateHtmlCssImageRequest(
+            html="<div class='box'>Python ✅</div>",
+            css=".box { border: 4px solid #03B875; padding: 20px; }",
+        )
+    )
+
+if result.success:
+    print(result.url)
+else:
+    print(result.status_code, result.error)
+```
+
+The client also supports URL screenshots, templates, batches, image deletion, render options, and signed URLs. See the [Python client repository](https://github.com/htmlcsstoimage/python-client) for complete usage and API documentation.
+
+<hr>
+
+## Direct HTTP example
+
 ```python
 # pip3 install requests
 import requests

getting-started/create-and-render.md

@@ -119,7 +119,7 @@ author=%7B%22name%22%3A%22Jeff%22%7D&title=%22Launch%22
 
 The `author` value decodes to `{"name":"Jeff"}`. The `title` value decodes to `"Launch"`.
 
-{% include hint.md title="Use an official client" text="The [TypeScript](/example-code/typescript/) and [.NET](/example-code/c/) clients include signed URL helpers (`generateTemplatedImageUrl` and `CreateTemplatedImageUrl`) so you do not need to hand-build the query string or HMAC token." %}
+{% include hint.md title="Use an official client" text="The [TypeScript](/example-code/typescript/), [.NET](/example-code/c/), [Python](/example-code/python/), and [PHP](/example-code/php/) clients include signed URL helpers so you do not need to hand-build the query string or HMAC token." %}
 
 <hr>
 
@@ -197,6 +197,37 @@ var imageUrl = client.CreateTemplatedImageUrl(
     });
 ```
 
+#### [Python Client](/example-code/python/#official-pypi-client)
+
+```python
+from html_css_to_image import HtmlCssToImageClient
+
+with HtmlCssToImageClient.from_env() as client:
+    image_url = client.generate_templated_image_url_from_values(
+        "t-b0354248-e7f6-4cca-81c6-2b4a70a16388",
+        {
+            "title": "Launch",
+            "author": {"name": "Avery"},
+        },
+    )
+```
+
+#### [PHP Client](/example-code/php/#official-composer-client)
+
+```php
+use HtmlCssToImage\HtmlCssToImageClient;
+
+$client = HtmlCssToImageClient::fromEnvironment();
+
+$imageUrl = $client->generateTemplatedImageUrlFromValues(
+    't-b0354248-e7f6-4cca-81c6-2b4a70a16388',
+    [
+        'title' => 'Launch',
+        'author' => ['name' => 'Avery'],
+    ],
+);
+```
+
 
 
 ### JavaScript example

llms-full.txt

@@ -379,6 +379,30 @@ Use the official npm package for typed requests and helper methods in Node.js/Ty
 
 ---
 
+## Official Python Client (PyPI)
+
+Use the official Python package for typed requests and responses, configurable HTTPX transport, and signed URL helpers.
+
+- **Package:** `html-css-to-image`
+- **Install:** `pip install html-css-to-image`
+- **Docs:** https://docs.htmlcsstoimage.com/example-code/python/
+- **PyPI:** https://pypi.org/project/html-css-to-image/
+- **GitHub:** https://github.com/htmlcsstoimage/python-client
+
+---
+
+## Official PHP Client (Packagist)
+
+Use the official Composer package for typed requests and responses, injectable PSR-18 transport, and signed URL helpers.
+
+- **Package:** `html-css-to-image/client`
+- **Install:** `composer require html-css-to-image/client`
+- **Docs:** https://docs.htmlcsstoimage.com/example-code/php/
+- **Packagist:** https://packagist.org/packages/html-css-to-image/client
+- **GitHub:** https://github.com/htmlcsstoimage/php-client
+
+---
+
 ## Code Examples
 
 ### Python

llms.txt

@@ -97,6 +97,9 @@ Use OG Image Configs for social cards tied to existing public pages. Use the sta
 - **MCP Server:** https://docs.htmlcsstoimage.com/integrations/mcp/
 - **n8n Integration:** https://docs.htmlcsstoimage.com/integrations/n8n/
 - **TypeScript Client (npm):** https://docs.htmlcsstoimage.com/example-code/typescript/
+- **Python Client (PyPI):** https://docs.htmlcsstoimage.com/example-code/python/
+- **PHP Client (Packagist):** https://docs.htmlcsstoimage.com/example-code/php/
+- **.NET Client (NuGet):** https://docs.htmlcsstoimage.com/example-code/c/
 - **HTTP Proxies:** https://docs.htmlcsstoimage.com/guides/advanced/proxies/
 - **Storage Destinations:** https://docs.htmlcsstoimage.com/guides/advanced/storage-destinations/ — Includes individual setup guides for Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, Wasabi, Google Cloud Storage, and other S3-compatible services.
 - **Jumbo Images:** https://docs.htmlcsstoimage.com/guides/advanced/jumbo-images/
@@ -115,6 +118,9 @@ Use OG Image Configs for social cards tied to existing public pages. Use the sta
 - **n8n:** https://docs.htmlcsstoimage.com/integrations/n8n/
 - **MCP Server:** https://docs.htmlcsstoimage.com/integrations/mcp/
 - **TypeScript Client (npm):** https://docs.htmlcsstoimage.com/example-code/typescript/
+- **Python Client (PyPI):** https://docs.htmlcsstoimage.com/example-code/python/
+- **PHP Client (Packagist):** https://docs.htmlcsstoimage.com/example-code/php/
+- **.NET Client (NuGet):** https://docs.htmlcsstoimage.com/example-code/c/
 
 ## Code Examples Available
 

parameters/format.md

@@ -140,6 +140,8 @@ See the [signed image URL guide](/getting-started/create-and-render/) for URL co
 | [.NET](/example-code/c/) | `0.12.0` | `Format = RenderImageFormat.PDF` |
 | [TypeScript](/example-code/typescript/) | `0.9.0` | `format: 'pdf'` |
 | [Ruby](/example-code/ruby/) | `0.3.0` | `format: "pdf"` |
+| [Python](/example-code/python/#official-pypi-client) | `0.2.0` | `format="pdf"` |
+| [PHP](/example-code/php/#official-composer-client) | `0.1.0` | `format: ImageFormat::PDF` |
 
 For choosing a format and retrieving an existing image with a different extension, see the [file formats guide](/guides/styling/file-formats/).