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

## 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](https://github.com/php/frankenphp/actions/runs/25736017574/job/75573140561)).
- 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.

Author: dunglas

docs/cn/config.md

@@ -17,7 +17,7 @@ php_server
 
 一个更高级的 `Caddyfile`，支持更多功能并提供方便的环境变量，可以在 [FrankenPHP 仓库中](https://github.com/php/frankenphp/blob/main/caddy/frankenphp/Caddyfile)找到，并随 Docker 镜像提供。
 
-PHP 本身可以[使用 `php.ini` 文件](https://www.php.net/manual/en/configuration.file.php)进行配置。
+PHP 本身可以[使用 `php.ini` 文件](https://www.php.net/manual/configuration.file.php)进行配置。
 
 根据你的安装方法，FrankenPHP 和 PHP 解释器将在以下位置查找配置文件。
 
@@ -275,7 +275,7 @@ Workers 可以通过 `watch` 指令在文件更改时重新启动。
 
 ## PHP 配置
 
-为了加载[附加的 PHP 配置文件](https://www.php.net/manual/en/configuration.file.php#configuration.file.scan)，可以使用 `PHP_INI_SCAN_DIR` 环境变量。设置后，PHP 将加载给定目录中所有带有 `.ini` 扩展名的文件。
+为了加载[附加的 PHP 配置文件](https://www.php.net/manual/configuration.file.php#configuration.file.scan)，可以使用 `PHP_INI_SCAN_DIR` 环境变量。设置后，PHP 将加载给定目录中所有带有 `.ini` 扩展名的文件。
 
 您还可以通过在 `Caddyfile` 中使用 `php_ini` 指令来更改 PHP 配置：
 

docs/cn/known-issues.md

@@ -6,7 +6,7 @@
 
 | 名称                                                                                                        | 原因         | 替代方案                                                                                                             |
 | ----------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------- |
-| [imap](https://www.php.net/manual/en/imap.installation.php)                                                 | 不安全的线程 | [javanile/php-imap2](https://github.com/javanile/php-imap2), [webklex/php-imap](https://github.com/Webklex/php-imap) |
+| [imap](https://www.php.net/manual/imap.installation.php)                                                 | 不安全的线程 | [javanile/php-imap2](https://github.com/javanile/php-imap2), [webklex/php-imap](https://github.com/Webklex/php-imap) |
 | [newrelic](https://docs.newrelic.com/docs/apm/agents/php-agent/getting-started/introduction-new-relic-php/) | 不安全的线程 | -                                                                                                                    |
 
 ## 有缺陷的 PHP 扩展
@@ -15,15 +15,15 @@
 
 | 名称                                                          | 问题                                                                                                                                                                                                                                      |
 | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [ext-openssl](https://www.php.net/manual/en/book.openssl.php) | 在使用静态构建的 FrankenPHP（使用 musl libc 构建）时，在重负载下 OpenSSL 扩展可能会崩溃。一个解决方法是使用动态链接的构建（如 Docker 镜像中使用的版本）。此错误正在由 PHP 跟踪。[查看问题](https://github.com/php/php-src/issues/13648)。 |
+| [ext-openssl](https://www.php.net/manual/book.openssl.php) | 在使用静态构建的 FrankenPHP（使用 musl libc 构建）时，在重负载下 OpenSSL 扩展可能会崩溃。一个解决方法是使用动态链接的构建（如 Docker 镜像中使用的版本）。此错误正在由 PHP 跟踪。[查看问题](https://github.com/php/php-src/issues/13648)。 |
 
 ## get_browser
 
-[get_browser()](https://www.php.net/manual/en/function.get-browser.php) 函数在一段时间后似乎表现不佳。解决方法是缓存（例如使用 [APCu](https://www.php.net/manual/zh/book.apcu.php)）每个 User-Agent，因为它们是不变的。
+[get_browser()](https://www.php.net/manual/function.get-browser.php) 函数在一段时间后似乎表现不佳。解决方法是缓存（例如使用 [APCu](https://www.php.net/manual/book.apcu.php)）每个 User-Agent，因为它们是不变的。
 
 ## 独立的二进制和基于 Alpine 的 Docker 镜像
 
-独立的二进制文件和基于 Alpine 的 Docker 镜像 (`dunglas/frankenphp:*-alpine`) 使用的是 [musl libc](https://musl.libc.org/) 而不是 [glibc and friends](https://www.etalabs.net/compare_libcs.html)，为的是保持较小的二进制大小。这可能会导致一些兼容性问题。特别是，glob 标志 `GLOB_BRACE` [不可用](https://www.php.net/manual/en/function.glob.php)。
+独立的二进制文件和基于 Alpine 的 Docker 镜像 (`dunglas/frankenphp:*-alpine`) 使用的是 [musl libc](https://musl.libc.org/) 而不是 [glibc and friends](https://www.etalabs.net/compare_libcs.html)，为的是保持较小的二进制大小。这可能会导致一些兼容性问题。特别是，glob 标志 `GLOB_BRACE` [不可用](https://www.php.net/manual/function.glob.php)。
 
 ## 在 Docker 中使用 `https://127.0.0.1`
 
@@ -122,7 +122,7 @@ error:0A000086:SSL routines::certificate verify failed
 
 由于静态二进制不捆绑 TLS 证书，因此您需要将 OpenSSL 指向本地 CA 证书安装。
 
-检查 [`openssl_get_cert_locations()`](https://www.php.net/manual/en/function.openssl-get-cert-locations.php) 的输出，
+检查 [`openssl_get_cert_locations()`](https://www.php.net/manual/function.openssl-get-cert-locations.php) 的输出，
 以找到 CA 证书必须安装的位置，并将它们存储在该位置。
 
 > [!WARNING]

docs/cn/performance.md

@@ -23,7 +23,7 @@
 `max_threads` 可以帮助你确定需要多少线程来处理你的流量，并可以使服务器对延迟峰值更具弹性。
 如果设置为 `auto`，限制将基于你的 `php.ini` 中的 `memory_limit` 进行估算。如果无法这样做，
 `auto` 将默认为 2x `num_threads`。请记住，`auto` 可能会严重低估所需的线程数。
-`max_threads` 类似于 PHP FPM 的 [pm.max_children](https://www.php.net/manual/en/install.fpm.configuration.php#pm.max-children)。主要区别是 FrankenPHP 使用线程而不是
+`max_threads` 类似于 PHP FPM 的 [pm.max_children](https://www.php.net/manual/install.fpm.configuration.php#pm.max-children)。主要区别是 FrankenPHP 使用线程而不是
 进程，并根据需要自动在不同的 worker 脚本和"经典模式"之间委派它们。
 
 ## Worker 模式
@@ -160,10 +160,10 @@ FrankenPHP 使用官方 PHP 解释器。
 
 特别是：
 
-- 检查 [OPcache](https://www.php.net/manual/zh/book.opcache.php) 是否已安装、启用并正确配置
+- 检查 [OPcache](https://www.php.net/manual/book.opcache.php) 是否已安装、启用并正确配置
 - 启用 [Composer 自动加载器优化](https://getcomposer.org/doc/articles/autoloader-optimization.md)
 - 确保 `realpath` 缓存对于你的应用程序需求足够大
-- 使用[预加载](https://www.php.net/manual/zh/opcache.preloading.php)
+- 使用[预加载](https://www.php.net/manual/opcache.preloading.php)
 
 有关更多详细信息，请阅读[专门的 Symfony 文档条目](https://symfony.com/doc/current/performance.html)
 （即使你不使用 Symfony，大多数提示也很有用）。

docs/cn/worker.md

@@ -165,7 +165,7 @@ frankenphp {
 
 ## 超全局变量行为
 
-[PHP 超全局变量](https://www.php.net/manual/zh/language.variables.superglobals.php)（`$_SERVER`、`$_ENV`、`$_GET`...）
+[PHP 超全局变量](https://www.php.net/manual/language.variables.superglobals.php)（`$_SERVER`、`$_ENV`、`$_GET`...）
 行为如下：
 
 - 在第一次调用 `frankenphp_handle_request()` 之前，超全局变量包含绑定到 worker 脚本本身的值

docs/compile.md

@@ -12,7 +12,7 @@ Alternatively, [fully and mostly static builds](static.md) can also be created.
 
 ## Install PHP
 
-FrankenPHP is compatible with PHP 8.2 and superior.
+FrankenPHP is compatible with PHP 8.2 and higher.
 
 ### With Homebrew (Linux and Mac)
 
@@ -97,7 +97,7 @@ You can now build the final binary.
 ### Using xcaddy
 
 The recommended way is to use [xcaddy](https://github.com/caddyserver/xcaddy) to compile FrankenPHP.
-`xcaddy` also allows to easily add [custom Caddy modules](https://caddyserver.com/docs/modules/) and FrankenPHP extensions:
+`xcaddy` also makes it easy to add [custom Caddy modules](https://caddyserver.com/docs/modules/) and FrankenPHP extensions:
 
 ```console
 CGO_ENABLED=1 \

docs/config.md

@@ -5,7 +5,7 @@ description: Configure FrankenPHP and Caddy via Caddyfile, JSON, or environment
 
 # Configuration
 
-FrankenPHP, Caddy as well as the [Mercure](mercure.md) and [Vulcain](https://vulcain.rocks) modules can be configured using [the formats supported by Caddy](https://caddyserver.com/docs/getting-started#your-first-config).
+FrankenPHP, Caddy, as well as the [Mercure](mercure.md) and [Vulcain](https://vulcain.rocks) modules, can be configured using [the formats supported by Caddy](https://caddyserver.com/docs/getting-started#your-first-config).
 
 The most common format is the `Caddyfile`, which is a simple, human-readable text format.
 By default, FrankenPHP will look for a `Caddyfile` in the current directory.
@@ -25,7 +25,7 @@ php_server
 A more advanced `Caddyfile` enabling more features and providing convenient environment variables is provided [in the FrankenPHP repository](https://github.com/php/frankenphp/blob/main/caddy/frankenphp/Caddyfile),
 and with Docker images.
 
-PHP itself can be configured [using a `php.ini` file](https://www.php.net/manual/en/configuration.file.php).
+PHP itself can be configured [using a `php.ini` file](https://www.php.net/manual/configuration.file.php).
 
 Depending on your installation method, FrankenPHP and the PHP interpreter will look for configuration files in locations described below.
 
@@ -301,11 +301,11 @@ The following environment variables can be used to inject Caddy directives in th
 
 As for FPM and CLI SAPIs, environment variables are exposed by default in the `$_SERVER` superglobal.
 
-The `S` value of [the `variables_order` PHP directive](https://www.php.net/manual/en/ini.core.php#ini.variables-order) is always equivalent to `ES` regardless of the placement of `E` elsewhere in this directive.
+The `S` value of [the `variables_order` PHP directive](https://www.php.net/manual/ini.core.php#ini.variables-order) is always equivalent to `ES` regardless of the placement of `E` elsewhere in this directive.
 
 ## PHP config
 
-To load [additional PHP configuration files](https://www.php.net/manual/en/configuration.file.php#configuration.file.scan),
+To load [additional PHP configuration files](https://www.php.net/manual/configuration.file.php#configuration.file.scan),
 the `PHP_INI_SCAN_DIR` environment variable can be used.
 When set, PHP will load all the files with the `.ini` extension present in the given directories.
 
@@ -338,7 +338,7 @@ If you want to use HTTPS with the `127.0.0.1` IP address instead of the `localho
 ### Full duplex (HTTP/1)
 
 When using HTTP/1.x, it may be desirable to enable full-duplex mode to allow writing a response before the entire body
-has been read. (for example: [Mercure](mercure.md), WebSocket, Server-Sent Events, etc.)
+has been read (for example: [Mercure](mercure.md), WebSocket, Server-Sent Events, etc.).
 
 This is an opt-in configuration that needs to be added to the global options in the `Caddyfile`:
 

docs/docker.md

@@ -92,7 +92,7 @@ COPY --from=builder /usr/local/bin/frankenphp /usr/local/bin/frankenphp
 ```
 
 The `builder` image provided by FrankenPHP contains a compiled version of `libphp`.
-[Builders images](https://hub.docker.com/r/dunglas/frankenphp/tags?name=builder) are provided for all versions of FrankenPHP and PHP, both for Debian and Alpine.
+[Builder images](https://hub.docker.com/r/dunglas/frankenphp/tags?name=builder) are provided for all versions of FrankenPHP and PHP, both for Debian and Alpine.
 
 > [!TIP]
 >
@@ -121,7 +121,7 @@ docker run -v $PWD:/app/public -p 80:80 -p 443:443 -p 443:443/udp --tty my-php-a
 
 > [!TIP]
 >
-> The `--tty` option allows to have nice human-readable logs instead of JSON logs.
+> The `--tty` option provides nice human-readable logs instead of JSON logs.
 
 With Docker Compose:
 
@@ -143,7 +143,7 @@ services:
       - ./:/app/public
       - caddy_data:/data
       - caddy_config:/config
-    # comment the following line in production, it allows to have nice human-readable logs in dev
+    # comment the following line in production, it provides nice human-readable logs in dev
     tty: true
 
 # Volumes needed for Caddy certificates and configuration

docs/embed.md

@@ -146,5 +146,5 @@ To customize the extensions, use the `PHP_EXTENSIONS` environment variable.
 
 On Linux, the created binary is compressed using [UPX](https://upx.github.io).
 
-On Mac, to reduce the size of the file before sending it, you can compress it.
+On macOS, to reduce the size of the file before sending it, you can compress it.
 We recommend `xz`.

docs/es/classic.md

@@ -1,4 +1,4 @@
-# Usando el Modo Clásico
+# Usando el modo clásico
 
 Sin ninguna configuración adicional, FrankenPHP opera en modo clásico. En este modo, FrankenPHP funciona como un servidor PHP tradicional, sirviendo directamente archivos PHP. Esto lo convierte en un reemplazo directo para PHP-FPM o Apache con mod_php.
 

docs/es/config.md

@@ -20,7 +20,7 @@ php_server
 Un `Caddyfile` más avanzado que habilita más características y proporciona variables de entorno convenientes está disponible [en el repositorio de FrankenPHP](https://github.com/php/frankenphp/blob/main/caddy/frankenphp/Caddyfile),
 y con las imágenes de Docker.
 
-PHP en sí puede configurarse [usando un archivo `php.ini`](https://www.php.net/manual/es/configuration.file.php).
+PHP en sí puede configurarse [usando un archivo `php.ini`](https://www.php.net/manual/configuration.file.php).
 
 Dependiendo de su método de instalación, FrankenPHP y el intérprete de PHP buscarán archivos de configuración en las ubicaciones descritas a continuación.
 
@@ -275,11 +275,11 @@ Las siguientes variables de entorno pueden usarse para inyectar directivas de Ca
 
 Al igual que en FPM y SAPIs CLI, las variables de entorno se exponen por defecto en la superglobal `$_SERVER`.
 
-El valor `S` de [la directiva `variables_order` de PHP](https://www.php.net/manual/en/ini.core.php#ini.variables-order) siempre es equivalente a `ES` independientemente de la ubicación de `E` en otro lugar de esta directiva.
+El valor `S` de [la directiva `variables_order` de PHP](https://www.php.net/manual/ini.core.php#ini.variables-order) siempre es equivalente a `ES` independientemente de la ubicación de `E` en otro lugar de esta directiva.
 
 ## Configuración de PHP
 
-Para cargar [archivos de configuración adicionales de PHP](https://www.php.net/manual/en/configuration.file.php#configuration.file.scan),
+Para cargar [archivos de configuración adicionales de PHP](https://www.php.net/manual/configuration.file.php#configuration.file.scan),
 puede usarse la variable de entorno `PHP_INI_SCAN_DIR`.
 Cuando se establece, PHP cargará todos los archivos con la extensión `.ini` presentes en los directorios dados.