fix: translate.php Gemini payload + drop /<lang>/ from php.net URLs

[dunglas]

Summary

• docs/translate.php: rebuild the Gemini request payload to match the v1beta API contract — use top-level systemInstruction and make parts an array of objects. The previous shape (role: "model" first + parts as a single object) returned HTTP 400 (see run 25736017574).
• Refresh the system and user prompts in translate.php
• Drop the /en/, /es/, /fr/, /zh/ language segments from every php.net/manual/... URL across docs/**/*.md so links resolve to the visitor's preferred language.

[Copilot]

Pull request overview

Updates the docs translation helper to send a Gemini v1beta-compatible request payload, and normalizes php.net manual links across the documentation by removing language-specific URL segments so links resolve in the visitor’s preferred language.

Changes:

• Rebuild docs/translate.php Gemini request payload using top-level systemInstruction and parts arrays.
• Refresh/clarify system + user prompts used for translation, including a rule to rewrite php.net URLs to language-agnostic form.
• Replace https://www.php.net/manual/<lang>/... links with https://www.php.net/manual/... across English + translated docs.

Reviewed changes

Copilot reviewed 30 out of 30 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
docs/translate.php	Updates Gemini request payload shape and refines translation prompts/rules.
docs/worker.md	Removes language segment from php.net superglobals manual link.
docs/performance.md	Removes language segment from php.net OPcache/preloading/FPM config links.
docs/known-issues.md	Removes language segment from php.net extension/function links.
docs/config.md	Removes language segment from php.net ini/config documentation links.
docs/cn/worker.md	Normalizes php.net superglobals manual link to language-agnostic form.
docs/cn/performance.md	Normalizes php.net performance-related manual links.
docs/cn/known-issues.md	Normalizes php.net known-issues-related manual links.
docs/cn/config.md	Normalizes php.net ini/config documentation links.
docs/es/worker.md	Normalizes php.net superglobals manual link to language-agnostic form.
docs/es/performance.md	Normalizes php.net performance-related manual links.
docs/es/known-issues.md	Normalizes php.net known-issues-related manual links.
docs/es/config.md	Normalizes php.net ini/config documentation links.
docs/fr/worker.md	Normalizes php.net superglobals manual link to language-agnostic form.
docs/fr/performance.md	Normalizes php.net performance-related manual links.
docs/fr/known-issues.md	Normalizes php.net known-issues-related manual links.
docs/fr/config.md	Normalizes php.net ini/config documentation links.
docs/ja/worker.md	Normalizes php.net superglobals manual link to language-agnostic form.
docs/ja/performance.md	Normalizes php.net performance-related manual links.
docs/ja/known-issues.md	Normalizes php.net known-issues-related manual links.
docs/ja/config.md	Normalizes php.net ini/config documentation links.
docs/pt-br/config.md	Normalizes php.net ini/config documentation links.
docs/ru/worker.md	Normalizes php.net superglobals manual link to language-agnostic form.
docs/ru/performance.md	Normalizes php.net performance-related manual links.
docs/ru/known-issues.md	Normalizes php.net known-issues-related manual links.
docs/ru/config.md	Normalizes php.net ini/config documentation links.
docs/tr/worker.md	Normalizes php.net superglobals manual link to language-agnostic form.
docs/tr/performance.md	Normalizes php.net performance-related manual links.
docs/tr/known-issues.md	Normalizes php.net known-issues-related manual links.
docs/tr/config.md	Normalizes php.net ini/config documentation links.

Comments suppressed due to low confidence (1)

docs/translate.php:50

• json_encode() can return false (e.g., on invalid UTF-8 in the prompt/files). In that case strlen($body) will throw a TypeError in PHP 8+, and the request will never be sent. Handle JSON encoding errors explicitly (e.g., JSON_THROW_ON_ERROR + try/catch, or check for false and abort with a clear error) before computing Content-Length/POSTing.

    $body = json_encode([
        "systemInstruction" => ["parts" => [["text" => $systemPrompt]]],
        "contents" => [
            ["role" => "user", "parts" => [["text" => $userPrompt]]],
        ],
    ]);

    $response = @file_get_contents($url, false, stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => "Content-Type: application/json\r\nX-Goog-Api-Key: $apiKey\r\nContent-Length: " . strlen($body) . "\r\n",
            'content' => $body,

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.