You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[i18n] Adding cli flags to Portuguese and Spanish (#2829)
## Motivation for the change, related issues
This pull request updates the documentation for the Playground CLI in
Spanish and Portuguese, enhancing the descriptions of command-line
arguments for clarity and completeness. It adds several new options,
improves the explanation of existing ones, and introduces important
cautions about security implications.
**Documentation improvements and new options:**
* Added documentation for new CLI flags: `--version`, `--site-url`,
`--php`, `--auto-mount[=<path>]`, `--follow-symlinks`,
`--internal-cookie-store`, `--xdebug`, `--experimental-devtools`, and
`--experimental-multi-worker=<number>`, with clear explanations and
defaults in both Spanish and Portuguese files.
[[1]](diffhunk://#diff-c6e3b1ddd984502ddbd2dacd1aaa0d301242ea8881ab42eb148b1f035248453aR172-R177)
[[2]](diffhunk://#diff-20436eab017eaff67b9f1b471e09761def8b5a1c69eef3fb964ebaa7db970497L274-R280)
* Improved the description of the `--verbosity` flag to specify the
accepted values and default, using a more consistent format.
[[1]](diffhunk://#diff-c6e3b1ddd984502ddbd2dacd1aaa0d301242ea8881ab42eb148b1f035248453aL184-R197)
[[2]](diffhunk://#diff-20436eab017eaff67b9f1b471e09761def8b5a1c69eef3fb964ebaa7db970497L303-R300)
**Security and usage cautions:**
* Added caution blocks warning that enabling `--follow-symlinks` may
expose files outside mounted directories, highlighting potential
security risks.
[[1]](diffhunk://#diff-c6e3b1ddd984502ddbd2dacd1aaa0d301242ea8881ab42eb148b1f035248453aL184-R197)
[[2]](diffhunk://#diff-20436eab017eaff67b9f1b471e09761def8b5a1c69eef3fb964ebaa7db970497L303-R300)
These changes ensure users have up-to-date and accurate information
about the Playground CLI's capabilities and potential security
considerations.
Copy file name to clipboardExpand all lines: packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/05-local-development/04-wp-playground-cli.md
+14-2Lines changed: 14 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -169,9 +169,12 @@ a tu configuración única de WordPress. Con el Playground CLI, puedes usar los
169
169
El comando `server` soporta los siguientes argumentos opcionales:
170
170
171
171
-`--port=<port>`: El número de puerto para que el servidor escuche. Por defecto es 9400.
172
+
-`--version`: Mostrar número de versión.
172
173
-`--outfile`: Al construir, escribir en este archivo de salida.
174
+
-`--site-url=<url>`: URL del sitio a usar para WordPress. Por defecto es `http://127.0.0.1:{port}`.
173
175
-`--wp=<version>`: La versión de WordPress a usar. Por defecto es la última.
174
-
-`--auto-mount`: Montar automáticamente el directorio actual (plugin, tema, wp-content, etc.).
176
+
-`--php=<version>`: Versión de PHP a usar. Opciones: `8.4`, `8.3`, `8.2`, `8.1`, `8.0`, `7.4`, `7.3`, `7.2`. Por defecto es `8.3`.
177
+
-`--auto-mount[=<path>]`: Montar automáticamente un directorio. Si no se proporciona una ruta, monta el directorio de trabajo actual. Puedes montar un directorio WordPress, un directorio de plugin, un directorio de tema, un directorio wp-content, o cualquier directorio que contenga archivos PHP y HTML.
-`--mount-before-install`: Montar un directorio al runtime PHP antes de la instalación de WordPress (puede usarse múltiples veces). Formato: `"/host/path:/vfs/path"`.
177
180
-`--mount-dir`: Montar un directorio al runtime PHP (puede usarse múltiples veces). Formato: `"/host/path"``"/vfs/path"`.
@@ -181,8 +184,17 @@ El comando `server` soporta los siguientes argumentos opcionales:
181
184
-`--login`: Iniciar sesión automáticamente del usuario como administrador.
182
185
-`--skip-wordpress-setup`: No descargar ni instalar WordPress. Útil si estás montando un directorio WordPress completo.
183
186
-`--skip-sqlite-setup`: No configurar la integración de base de datos SQLite.
184
-
-`--verbosity`: Salida de logs y mensajes de progreso. Las opciones son "quiet", "normal" o "debug". Por defecto es "normal".
187
+
-`--verbosity=<level>`: Salida de logs y mensajes de progreso. Opciones: `quiet`, `normal`, `debug`. Por defecto es `normal`.
185
188
-`--debug`: Imprimir el log de errores de PHP si ocurre un error durante el arranque.
189
+
-`--follow-symlinks`: Permitir que Playground siga enlaces simbólicos montando automáticamente directorios y archivos vinculados simbólicamente encontrados en directorios montados.
190
+
-`--internal-cookie-store`: Habilitar manejo interno de cookies. Cuando está habilitado, Playground administrará cookies internamente usando un HttpCookieStore que persiste cookies entre solicitudes. Cuando está deshabilitado, las cookies se manejan externamente (por ejemplo, por un navegador en entornos Node.js). Por defecto es false.
191
+
-`--xdebug`: Habilitar Xdebug. Por defecto es false.
192
+
-`--experimental-devtools`: Habilitar herramientas de desarrollo experimentales del navegador. Por defecto es false.
193
+
-`--experimental-multi-worker=<number>`: Habilitar soporte experimental multi-worker que requiere un directorio `/wordpress` respaldado por un sistema de archivos real. Pasa un número positivo para especificar el número de workers a usar. De lo contrario, por defecto es el número de CPUs menos 1.
194
+
195
+
:::caution
196
+
Con la bandera `--follow-symlinks`, los siguientes enlaces simbólicos expondrán archivos fuera de los directorios montados a Playground y podrían ser un riesgo de seguridad.
Copy file name to clipboardExpand all lines: packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/05-local-development/04-wp-playground-cli.md
+14-18Lines changed: 14 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -271,26 +271,13 @@ com sua configuração WordPress única. Com o Playground CLI, você pode usar o
271
271
272
272
O comando `server` suporta os seguintes argumentos opcionais:
273
273
274
-
<!-- - `--port=<port>`: The port number for the server to listen on. Defaults to 9400. -->
275
-
<!-- - `--outfile`: When building, write to this output file. -->
276
-
<!-- - `--wp=<version>`: The version of WordPress to use. Defaults to the latest. -->
277
-
<!-- - `--auto-mount`: Automatically mount the current directory (plugin, theme, wp-content, etc.). -->
278
-
<!-- - `--mount=<mapping>`: Manually mount a directory (can be used multiple times). Format: `"/host/path:/vfs/path"`. -->
279
-
<!-- - `--mount-before-install`: Mount a directory to the PHP runtime before WordPress installation (can be used multiple times). Format: `"/host/path:/vfs/path"`. -->
280
-
<!-- - `--mount-dir`: Mount a directory to the PHP runtime (can be used multiple times). Format: `"/host/path"` `"/vfs/path"`. -->
281
-
<!-- - `--mount-dir-before-install`: Mount a directory before WordPress installation (can be used multiple times). Format: `"/host/path"` `"/vfs/path"` -->
282
-
<!-- - `--blueprint=<path>`: The path to a JSON Blueprint file to execute. -->
283
-
<!-- - `--blueprint-may-read-adjacent-files`: Consent flag: Allow "bundled" resources in a local blueprint to read files in the same directory as the blueprint file. -->
284
-
<!-- - `--login`: Automatically log the user in as an administrator. -->
285
-
<!-- - `--skip-wordpress-setup`: Do not download or install WordPress. Useful if you are mounting a full WordPress directory. -->
286
-
<!-- - `--skip-sqlite-setup`: Do not set up the SQLite database integration. -->
287
-
<!-- - `--verbosity`: Output logs and progress messages. Choices are "quiet", "normal" or "debug". Defaults to "normal". -->
288
-
<!-- - `--debug`: Print the PHP error log if an error occurs during boot. -->
289
-
290
274
-`--port=<port>`: O número da porta para o servidor escutar. Padrão é 9400.
275
+
-`--version`: Mostrar número da versão.
291
276
-`--outfile`: Ao construir, escrever neste arquivo de saída.
277
+
-`--site-url=<url>`: URL do site a usar para WordPress. Padrão é `http://127.0.0.1:{port}`.
292
278
-`--wp=<version>`: A versão do WordPress a usar. Padrão é a mais recente.
293
-
-`--auto-mount`: Montar automaticamente o diretório atual (plugin, tema, wp-content, etc.).
279
+
-`--php=<version>`: Versão do PHP a usar. Opções: `8.4`, `8.3`, `8.2`, `8.1`, `8.0`, `7.4`, `7.3`, `7.2`. Padrão é `8.3`.
280
+
-`--auto-mount[=<path>]`: Montar automaticamente um diretório. Se nenhum caminho for fornecido, monta o diretório de trabalho atual. Você pode montar um diretório WordPress, um diretório de plugin, um diretório de tema, um diretório wp-content, ou qualquer diretório contendo arquivos PHP e HTML.
294
281
-`--mount=<mapping>`: Montar manualmente um diretório (pode ser usado múltiplas vezes). Formato: `"/host/path:/vfs/path"`.
295
282
-`--mount-before-install`: Montar um diretório no runtime PHP antes da instalação do WordPress (pode ser usado múltiplas vezes). Formato: `"/host/path:/vfs/path"`.
296
283
-`--mount-dir`: Montar um diretório no runtime PHP (pode ser usado múltiplas vezes). Formato: `"/host/path"``"/vfs/path"`.
@@ -300,8 +287,17 @@ O comando `server` suporta os seguintes argumentos opcionais:
300
287
-`--login`: Fazer login automaticamente do usuário como administrador.
301
288
-`--skip-wordpress-setup`: Não baixar ou instalar WordPress. Útil se você está montando um diretório WordPress completo.
302
289
-`--skip-sqlite-setup`: Não configurar a integração do banco de dados SQLite.
303
-
-`--verbosity`: Saída de logs e mensagens de progresso. Opções são "quiet", "normal" ou "debug". Padrão é "normal".
290
+
-`--verbosity=<level>`: Saída de logs e mensagens de progresso. Opções: `quiet`, `normal`, `debug`. Padrão é `normal`.
304
291
-`--debug`: Imprimir o log de erro do PHP se um erro ocorrer durante a inicialização.
292
+
-`--follow-symlinks`: Permitir que o Playground siga links simbólicos montando automaticamente diretórios e arquivos vinculados simbolicamente encontrados em diretórios montados.
293
+
-`--internal-cookie-store`: Habilitar tratamento interno de cookies. Quando habilitado, o Playground gerenciará cookies internamente usando um HttpCookieStore que persiste cookies entre requisições. Quando desabilitado, cookies são tratados externamente (por exemplo, por um navegador em ambientes Node.js). Padrão é false.
294
+
-`--xdebug`: Habilitar Xdebug. Padrão é false.
295
+
-`--experimental-devtools`: Habilitar ferramentas de desenvolvimento experimentais do navegador. Padrão é false.
296
+
-`--experimental-multi-worker=<number>`: Habilitar suporte experimental multi-worker que requer um diretório `/wordpress` apoiado por um sistema de arquivos real. Passe um número positivo para especificar o número de workers a usar. Caso contrário, padrão é o número de CPUs menos 1.
297
+
298
+
:::caution
299
+
Com a flag `--follow-symlinks`, os seguintes links simbólicos irão expor arquivos fora dos diretórios montados ao Playground e podem ser um risco de segurança.
0 commit comments