[tomasr78]

Three examples call converters that the production API spec (https://v2.convertapi.com/info/openapi, 332 paths on 2026-11-09) does not list. Developers copy these examples and the how-to guides on convertapi.com reuse them, so they should call documented converters. This is the PHP part of what ConvertAPI/convertapi-library-dotnet#86 does for .NET.

Example	Before	After
convert_url_to_pdf.php	web -> pdf, comment links /web-to-pdf	html -> pdf (parameters), same Url and FileName; comment links https://www.convertapi.com/html-to-pdf
conversions_chaining.php	any -> zip	file -> zip (parameters), same Files
error_handling.php	docx -> svg, which the API rejects as an unsupported conversion	pdf -> split with files/test.docx, which the API rejects because the file is not a PDF (the .NET ExceptionHandling example does the same)

https://www.convertapi.com/web-to-pdf is not in the site's sitemap; https://www.convertapi.com/html-to-pdf is. The other examples already call documented converters; the pdf -> extract step of create_pdf_thumbnail.php goes away with #72.

Verified against production (2026-11-09)

PHP 8.4.27 in Docker (php:8.4-cli): php -l passes for the three files. Each example ran with php <name>.php from examples/, once on main (8874aff) and once on this branch, with the token in CONVERT_API_SECRET and TMPDIR=/out.

conversions_chaining.php, same output before and after:

Converting PDF to JPG and compressing result files with ZIP
Conversions done. Cost: 1. Total files created: 6
Conversions done. Cost: 1. Total files created: 1
File saved to
Array
(
    [0] => /out/test.zip
)

Both runs saved a 775,249-byte test.zip with test.jpg to test-6.jpg; the JPGs are byte-identical before and after.

convert_url_to_pdf.php, same output before and after:

The web page PDF saved to
Array
(
    [0] => /out/web-example.pdf
)

The PDF text: on this branch the PDF is the article (3 pages, 1,925 words, title "Data conversion"). On main, Wikimedia answered ConvertAPI's renderer with its "Too many requests" page (1 page, 62 words); that rate limiting comes and goes for both converters and is being looked at separately.

error_handling.php, before:

Got API error code: 4000
Parameter validation error. Code: 4000 {"SourceFormat, DestinationFormat":["Unsupported conversion docx -> svg"]}

after:

Got API error code: 4000
Parameter validation error. Code: 4000 {"File":["File must be a file with one of the following extensions: .pdf."]}

Seen, not changed: the library itself sends url as the source format when the parameters have a Url and no source format is given (lib/ConvertApi/Task.php, DEFAULT_URL_FORMAT); url is not in the spec. The URL example passes its source format, so it does not depend on it.

Same change in the other SDKs

• Go: Examples: use the converters the API spec documents convertapi-library-go#22
• Java: Examples: use the converters the API spec documents convertapi-library-java#58
• Node: Examples: use the converters the API spec documents convertapi-library-node#125
• Python: Examples: use the converters the API spec documents convertapi-library-python#62
• Ruby: Examples: use the converters the API spec documents convertapi-library-ruby#43
• .NET: Examples: use documented converters, read the production catalog, save SplitPDF to temp, hide account secrets convertapi-library-dotnet#86
• JS (browser): no change needed; its README calls only documented converters.

🤖 Generated with Claude Code

[Copilot]

🟢 Approval recommended

No active review issues were identified for the PHP example updates aligning converter usage with the production API specification.

No open issues 🎉

What changed in this PR

Updates three PHP examples to use converters listed in the production API specification, without changing library behavior.

Changes:

• Uses html -> pdf for URL conversion and updates the documentation link.
• Uses file -> zip to archive chained conversion results.
• Demonstrates error handling with a documented pdf -> split converter and an intentionally invalid DOCX input.

File	Description
examples/​error_handling.php	Triggers a file-validation error using PDF split with a DOCX input.
examples/​convert_url_to_pdf.php	Sets the source format to html and links to HTML-to-PDF documentation.
examples/​conversions_chaining.php	Sets the ZIP conversion source format to file.

_{Review effort: Balanced}