[tomasr78]

Problem

The example cut page 1 out of the PDF with the extract converter and PageRange 1, then converted that page to JPG. pdf -> extract is now the AI data-extraction converter: it returns JSON and has no PageRange parameter (spec), so the second step gets a JSON file instead of page 1.

The Python example makes the same two calls and fails on production like this:

$ python create_pdf_thumbnail.py        # examples/ on main d653b60, production API, 2026-11-06
Traceback (most recent call last):
  ...
requests.exceptions.HTTPError: 400 Client Error: Bad Request for url: https://v2.convertapi.com/convert/json/to/jpg
  ...
convertapi.exceptions.ApiError: Parameter validation error. Code: 4000. {'SourceFormat, DestinationFormat': ['Unsupported conversion json -> jpg']}

Change

• One pdf -> jpg call with PageRange 1 makes the thumbnail: one conversion instead of two.
• ScaleImage and ScaleProportions are dropped. They are not pdf -> jpg parameters (spec) and the API ignores them: with or without them, ImageHeight 300 + ImageWidth 300 returns a 300x388 image for test.pdf (US Letter), byte for byte the same. FitToSize keeps the thumbnail inside 300x300 with its aspect ratio: 231x300.
• The comment links only https://www.convertapi.com/pdf-to-jpg.

Verification

Run from examples/ against the production API on 2026-11-06, in the php:8.4-cli Docker image (PHP 8.4.27) with TMPDIR=/out:

$ php create_pdf_thumbnail.php
The thumbnail saved to
Array
(
    [0] => /out/test.jpg
)

test.jpg is 231x300 px, 8,858 bytes. php -l examples/create_pdf_thumbnail.php: no syntax errors.

Only the example changes, not the library, so there is no CHANGELOG entry.

The thumbnail examples of the other SDKs are fixed in ConvertAPI/convertapi-library-python#61, ConvertAPI/convertapi-library-ruby#42, ConvertAPI/convertapi-library-java#56, ConvertAPI/convertapi-library-dotnet#82, ConvertAPI/convertapi-library-node#123.

🤖 Generated with Claude Code

[Copilot]

🟢 Approval recommended

No active review issues are reported for the PHP thumbnail example update.

No open issues 🎉

What changed in this PR

Fixes the PHP thumbnail example by converting the first PDF page directly to JPG, avoiding the extraction converter’s JSON output.

Changes:

• Replaces two chained conversions with one PDF-to-JPG call using PageRange 1.
• Replaces unsupported scaling options with FitToSize to preserve aspect ratio within 300×300 pixels.
• Updates the example comment and removes the extraction documentation link.

File	Description
examples/​create_pdf_thumbnail.php	Converts page 1 directly to a proportionally sized JPG thumbnail.

_{Review effort: Balanced}