Skip to content

Commit a69693c

Browse files
github-actions[bot]henderkesalexandre-daubois
authored
docs: update translations (#2285)
Translation updates for: config.md . --------- Signed-off-by: Alexandre Daubois <2144837+alexandre-daubois@users.noreply.github.com> Co-authored-by: henderkes <7896469+henderkes@users.noreply.github.com> Co-authored-by: Alexandre Daubois <2144837+alexandre-daubois@users.noreply.github.com>
1 parent 9cfa7b3 commit a69693c

File tree

10 files changed

+417
-39
lines changed

10 files changed

+417
-39
lines changed

docs/cn/config.md

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -339,3 +339,79 @@ docker run -v $PWD:/app/public \
339339
-e CADDY_GLOBAL_OPTIONS=debug \
340340
-p 80:80 -p 443:443 -p 443:443/udp \
341341
dunglas/frankenphp
342+
```
343+
344+
## Shell 补全
345+
346+
FrankenPHP 提供对 Bash、Zsh、Fish 和 PowerShell 的内置 shell 补全支持。这为所有命令(包括 `php-server``php-cli``extension-init` 等自定义命令)及其标志启用了自动补全。
347+
348+
### Bash
349+
350+
要在当前 shell 会话中加载补全:
351+
352+
```console
353+
source <(frankenphp completion bash)
354+
```
355+
356+
要为每个新会话加载补全,运行:
357+
358+
**Linux:**
359+
360+
```console
361+
frankenphp completion bash > /usr/share/bash-completion/completions/frankenphp
362+
```
363+
364+
**macOS:**
365+
366+
```console
367+
frankenphp completion bash > $(brew --prefix)/share/bash-completion/completions/frankenphp
368+
```
369+
370+
### Zsh
371+
372+
如果您的环境中尚未启用 shell 补全,您将需要启用它。您可以执行以下命令一次:
373+
374+
```console
375+
echo "autoload -U compinit; compinit" >> ~/.zshrc
376+
```
377+
378+
要为每个会话加载补全,请执行一次:
379+
380+
```console
381+
frankenphp completion zsh > "${fpath[1]}/_frankenphp"
382+
```
383+
384+
您需要启动一个新的 shell 会话才能使此设置生效。
385+
386+
### Fish
387+
388+
要在当前 shell 会话中加载补全:
389+
390+
```console
391+
frankenphp completion fish | source
392+
```
393+
394+
要为每个新会话加载补全,请执行一次:
395+
396+
```console
397+
frankenphp completion fish > ~/.config/fish/completions/frankenphp.fish
398+
```
399+
400+
### PowerShell
401+
402+
要在当前 shell 会话中加载补全:
403+
404+
```powershell
405+
frankenphp completion powershell | Out-String | Invoke-Expression
406+
```
407+
408+
要为每个新会话加载补全,请执行一次:
409+
410+
```powershell
411+
frankenphp completion powershell | Out-File -FilePath (Join-Path (Split-Path $PROFILE) "frankenphp.ps1")
412+
Add-Content -Path $PROFILE -Value '. (Join-Path (Split-Path $PROFILE) "frankenphp.ps1")'
413+
```
414+
415+
您需要启动一个新的 shell 会话才能使此设置生效。
416+
417+
您需要启动一个新的 shell 会话才能使此设置生效。

docs/cn/hot-reload.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -139,11 +139,11 @@ php_server {
139139

140140
## 工作原理
141141

142-
1. **监控**:FrankenPHP 使用底层 [e-dant/watcher 库](https://github.com/e-dant/watcher)(我们贡献了 Go 绑定)监控文件系统中的修改。
143-
2. **重启 (Worker 模式)**:如果 worker 配置中启用了 `watch`,PHP worker 将重新启动以加载新代码。
144-
3. **推送**:包含更改文件列表的 JSON 有效载荷被发送到内置的 [Mercure hub](https://mercure.rocks)
145-
4. **接收**:浏览器通过 JavaScript 库监听,接收 Mercure 事件。
146-
5. **更新**
142+
1. **监控**:FrankenPHP 使用底层 [e-dant/watcher 库](https://github.com/e-dant/watcher)(我们贡献了 Go 绑定)监控文件系统中的修改。
143+
2. **重启 (Worker 模式)**:如果 worker 配置中启用了 `watch`,PHP worker 将重新启动以加载新代码。
144+
3. **推送**:包含更改文件列表的 JSON 有效载荷被发送到内置的 [Mercure hub](https://mercure.rocks)
145+
4. **接收**:浏览器通过 JavaScript 库监听,接收 Mercure 事件。
146+
5. **更新**
147147

148148
- 如果检测到 **Idiomorph**,它会获取更新的内容并修改当前的 HTML 以匹配新状态,即时应用更改而不会丢失状态。
149149
- 否则,将调用 `window.location.reload()` 来刷新页面。

docs/fr/config.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -184,7 +184,7 @@ php_server [<matcher>] {
184184
file_server off # Désactive la directive file_server intégrée.
185185
worker { # Crée un worker spécifique à ce serveur. Peut être spécifié plusieurs fois pour plusieurs workers.
186186
file <path> # Définit le chemin vers le script worker, peut être relatif à la racine du php_server
187-
num <num> # Définit le nombre de threads PHP à démarrer, par défaut 2x le nombre de CPU disponibles
187+
num <num> # Définit le nombre de threads PHP à démarrer, par défaut 2x le nombre de CPUs disponibles
188188
name <name> # Définit le nom du worker, utilisé dans les journaux et les métriques. Par défaut : chemin absolu du fichier du worker. Commence toujours par m# lorsqu'il est défini dans un bloc php_server.
189189
watch <path> # Définit le chemin d'accès à surveiller pour les modifications de fichiers. Peut être spécifié plusieurs fois pour plusieurs chemins.
190190
env <key> <value> # Définit une variable d'environnement supplémentaire avec la valeur donnée. Peut être spécifié plusieurs fois pour plusieurs variables d'environnement. Les variables d'environnement pour ce worker sont également héritées du parent php_server, mais peuvent être écrasées ici.
@@ -245,7 +245,8 @@ La surveillance des fichiers est basée sur [e-dant/watcher](https://github.com/
245245

246246
Dans les applications PHP traditionnelles, les scripts sont toujours placés dans le répertoire public. C'est également vrai pour les scripts worker, qui sont traités comme n'importe quel autre script PHP. Si vous souhaitez plutôt placer le script worker en dehors du répertoire public, vous pouvez le faire via la directive `match`.
247247

248-
La directive `match` est une alternative optimisée à `try_files` disponible uniquement à l'intérieur de `php_server` et `php`. L'exemple suivant servira toujours un fichier dans le répertoire public s'il est présent et transmettra sinon la requête au worker correspondant au modèle de chemin.
248+
La directive `match` est une alternative optimisée à `try_files` disponible uniquement à l'intérieur de `php_server` et `php`. L'exemple suivant servira toujours un fichier dans le répertoire public s'il est présent
249+
et transmettra sinon la requête au worker correspondant au modèle de chemin.
249250

250251
```caddyfile
251252
{

docs/ja/config.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -347,3 +347,78 @@ docker run -v $PWD:/app/public \
347347
-p 80:80 -p 443:443 -p 443:443/udp \
348348
dunglas/frankenphp
349349
```
350+
351+
## Shell Completion
352+
353+
FrankenPHPはBash、Zsh、Fish、およびPowerShell用のシェル補完機能を内蔵しています。これにより、すべてのコマンド(`php-server``php-cli``extension-init`などのカスタムコマンドを含む)とそのフラグのオートコンプリートが可能になります。
354+
355+
### Bash
356+
357+
現在のシェルセッションで補完を読み込むには:
358+
359+
```console
360+
source <(frankenphp completion bash)
361+
```
362+
363+
新しいセッションごとに補完を読み込むには、以下を実行してください:
364+
365+
**Linux:**
366+
367+
```console
368+
frankenphp completion bash > /usr/share/bash-completion/completions/frankenphp
369+
```
370+
371+
**macOS:**
372+
373+
```console
374+
frankenphp completion bash > $(brew --prefix)/share/bash-completion/completions/frankenphp
375+
```
376+
377+
### Zsh
378+
379+
シェル補完がまだ環境で有効になっていない場合は、有効にする必要があります。以下のコマンドを一度実行してください:
380+
381+
```console
382+
echo "autoload -U compinit; compinit" >> ~/.zshrc
383+
```
384+
385+
各セッションで補完を読み込むには、一度実行してください:
386+
387+
```console
388+
frankenphp completion zsh > "${fpath[1]}/_frankenphp"
389+
```
390+
391+
この設定を有効にするには、新しいシェルを起動する必要があります。
392+
393+
### Fish
394+
395+
現在のシェルセッションで補完を読み込むには:
396+
397+
```console
398+
frankenphp completion fish | source
399+
```
400+
401+
新しいセッションごとに補完を読み込むには、一度実行してください:
402+
403+
```console
404+
frankenphp completion fish > ~/.config/fish/completions/frankenphp.fish
405+
```
406+
407+
### PowerShell
408+
409+
現在のシェルセッションで補完を読み込むには:
410+
411+
```powershell
412+
frankenphp completion powershell | Out-String | Invoke-Expression
413+
```
414+
415+
新しいセッションごとに補完を読み込むには、一度実行してください:
416+
417+
```powershell
418+
frankenphp completion powershell | Out-File -FilePath (Join-Path (Split-Path $PROFILE) "frankenphp.ps1")
419+
Add-Content -Path $PROFILE -Value '. (Join-Path (Split-Path $PROFILE) "frankenphp.ps1")'
420+
```
421+
422+
この設定を有効にするには、新しいシェルを起動する必要があります。
423+
424+
この設定を有効にするには、新しいシェルを起動する必要があります。

docs/ja/hot-reload.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -139,11 +139,11 @@ php_server {
139139

140140
## 仕組み
141141

142-
1. **監視**: FrankenPHPは、内部で[`e-dant/watcher`ライブラリ](https://github.com/e-dant/watcher)を使用してファイルシステムの変更を監視します(私たちはGoバインディングに貢献しました)。
143-
2. **再起動 (ワーカーモード)**: ワーカー設定で`watch`が有効になっている場合、新しいコードをロードするためにPHPワーカーが再起動されます。
144-
3. **プッシュ**: 変更されたファイルのリストを含むJSONペイロードが、組み込みの[Mercureハブ](https://mercure.rocks)に送信されます。
145-
4. **受信**: JavaScriptライブラリを介してリッスンしているブラウザがMercureイベントを受信します。
146-
5. **更新**:
147-
148-
- **Idiomorph**が検出された場合、更新されたコンテンツをフェッチし、現在のHTMLを新しい状態に合わせてモーフィングし、状態を失うことなく即座に変更を適用します。
149-
- それ以外の場合、`window.location.reload()`が呼び出されてページがリフレッシュされます。
142+
1. **監視**: FrankenPHPは、内部で[`e-dant/watcher`ライブラリ](https://github.com/e-dant/watcher)を使用してファイルシステムの変更を監視します(私たちはGoバインディングに貢献しました)。
143+
2. **再起動 (ワーカーモード)**: ワーカー設定で`watch`が有効になっている場合、新しいコードをロードするためにPHPワーカーが再起動されます。
144+
3. **プッシュ**: 変更されたファイルのリストを含むJSONペイロードが、組み込みの[Mercureハブ](https://mercure.rocks)に送信されます。
145+
4. **受信**: JavaScriptライブラリを介してリッスンしているブラウザがMercureイベントを受信します。
146+
5. **更新**:
147+
148+
- **Idiomorph**が検出された場合、更新されたコンテンツをフェッチし、現在のHTMLを新しい状態に合わせてモーフィングし、状態を失うことなく即座に変更を適用します。
149+
- それ以外の場合、`window.location.reload()`が呼び出されてページがリフレッシュされます。

docs/pt-br/config.md

Lines changed: 82 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,10 @@ Você pode especificar um caminho personalizado com a opção `-c` ou `--config`
99
Um `Caddyfile` mínimo para servir uma aplicação PHP é mostrado abaixo:
1010

1111
```caddyfile
12-
# The hostname to respond to
12+
# O nome do host para responder
1313
localhost
1414
15-
# Optionally, the directory to serve files from, otherwise defaults to the current directory
15+
# Opcionalmente, o diretório para servir arquivos, caso contrário, o padrão é o diretório atual
1616
#root public/
1717
php_server
1818
```
@@ -96,15 +96,15 @@ Você também pode configurar explicitamente o FrankenPHP usando a [opção glob
9696
num_threads <num_threads> # Define o número de threads PHP a serem iniciadas. Padrão: 2x o número de CPUs disponíveis.
9797
max_threads <num_threads> # Limita o número de threads PHP adicionais que podem ser iniciadas em tempo de execução. Padrão: num_threads. Pode ser definido como 'auto'.
9898
max_wait_time <duration> # Define o tempo máximo que uma requisição pode esperar por uma thread PHP livre antes de atingir o tempo limite. Padrão: desabilitado.
99-
max_idle_time <duration> # Define o tempo máximo que uma thread autoscaled pode ficar ociosa antes de ser desativada. Padrão: 5s.
99+
max_idle_time <duration> # Define o tempo máximo que uma thread autoescalada pode ficar ociosa antes de ser desativada. Padrão: 5s.
100100
php_ini <key> <value> # Define uma diretiva php.ini. Pode ser usada várias vezes para definir múltiplas diretivas.
101101
worker {
102-
file <path> # Define o caminho para o worker script.
102+
file <path> # Define o caminho para o script do worker.
103103
num <num> # Define o número de threads PHP a serem iniciadas, o padrão é 2x o número de CPUs disponíveis.
104104
env <key> <value> # Define uma variável de ambiente extra para o valor fornecido. Pode ser especificada mais de uma vez para múltiplas variáveis de ambiente.
105105
watch <path> # Define o caminho para monitorar alterações em arquivos. Pode ser especificada mais de uma vez para múltiplos caminhos.
106106
name <name> # Define o nome do worker, usado em logs e métricas. Padrão: caminho absoluto do arquivo do worker
107-
max_consecutive_failures <num> # Define o número máximo de falhas consecutivas antes do worker ser considerado não saudável. -1 significa que o worker sempre reiniciará. Padrão: 6.
107+
max_consecutive_failures <num> # Define o número máximo de falhas consecutivas antes que o worker seja considerado não saudável. -1 significa que o worker sempre reiniciará. Padrão: 6.
108108
}
109109
}
110110
}
@@ -182,9 +182,9 @@ php_server [<matcher>] {
182182
split_path <delim...> # Define as substrings para dividir o URI em duas partes. A primeira substring correspondente será usada para separar as "informações de caminho" do caminho. A primeira parte é sufixada com a substring correspondente e será assumida como o nome real do recurso (script CGI). A segunda parte será definida como PATH_INFO para o script usar. Padrão: `.php`
183183
resolve_root_symlink false # Desabilita a resolução do diretório `root` para seu valor real avaliando um link simbólico, se houver (habilitado por padrão).
184184
env <key> <value> # Define uma variável de ambiente extra para o valor fornecido. Pode ser especificada mais de uma vez para múltiplas variáveis de ambiente.
185-
file_server off # Desabilita a diretiva interna file_server.
185+
file_server off # Desabilita a diretiva integrada file_server.
186186
worker { # Cria um worker específico para este servidor. Pode ser especificada mais de uma vez para múltiplos workers.
187-
file <path> # Define o caminho para o worker script, pode ser relativo à raiz do php_server
187+
file <path> # Define o caminho para o script do worker, pode ser relativo à raiz do php_server
188188
num <num> # Define o número de threads PHP a serem iniciadas, o padrão é 2x o número de CPUs disponíveis.
189189
name <name> # Define o nome para o worker, usado em logs e métricas. Padrão: caminho absoluto do arquivo do worker. Sempre começa com m# quando definido em um bloco php_server.
190190
watch <path> # Define o caminho para monitorar alterações em arquivos. Pode ser especificada mais de uma vez para múltiplos caminhos.
@@ -348,3 +348,78 @@ docker run -v $PWD:/app/public \
348348
-p 80:80 -p 443:443 -p 443:443/udp \
349349
dunglas/frankenphp
350350
```
351+
352+
## Autocompletar do Shell
353+
354+
FrankenPHP oferece suporte integrado de autocompletar do shell para Bash, Zsh, Fish e PowerShell. Isso permite o preenchimento automático para todos os comandos (incluindo comandos personalizados como `php-server`, `php-cli` e `extension-init`) e suas flags.
355+
356+
### Bash
357+
358+
Para carregar o autocompletar na sua sessão atual do shell:
359+
360+
```console
361+
source <(frankenphp completion bash)
362+
```
363+
364+
Para carregar o autocompletar para cada nova sessão, execute:
365+
366+
**Linux:**
367+
368+
```console
369+
frankenphp completion bash > /usr/share/bash-completion/completions/frankenphp
370+
```
371+
372+
**macOS:**
373+
374+
```console
375+
frankenphp completion bash > $(brew --prefix)/share/bash-completion/completions/frankenphp
376+
```
377+
378+
### Zsh
379+
380+
Se o autocompletar do shell ainda não estiver habilitado em seu ambiente, você precisará ativá-lo. Você pode executar o seguinte uma vez:
381+
382+
```console
383+
echo "autoload -U compinit; compinit" >> ~/.zshrc
384+
```
385+
386+
Para carregar o autocompletar para cada sessão, execute uma vez:
387+
388+
```console
389+
frankenphp completion zsh > "${fpath[1]}/_frankenphp"
390+
```
391+
392+
Você precisará iniciar um novo shell para que esta configuração tenha efeito.
393+
394+
### Fish
395+
396+
Para carregar o autocompletar na sua sessão atual do shell:
397+
398+
```console
399+
frankenphp completion fish | source
400+
```
401+
402+
Para carregar o autocompletar para cada nova sessão, execute uma vez:
403+
404+
```console
405+
frankenphp completion fish > ~/.config/fish/completions/frankenphp.fish
406+
```
407+
408+
### PowerShell
409+
410+
Para carregar o autocompletar na sua sessão atual do shell:
411+
412+
```powershell
413+
frankenphp completion powershell | Out-String | Invoke-Expression
414+
```
415+
416+
Para carregar o autocompletar para cada nova sessão, execute uma vez:
417+
418+
```powershell
419+
frankenphp completion powershell | Out-File -FilePath (Join-Path (Split-Path $PROFILE) "frankenphp.ps1")
420+
Add-Content -Path $PROFILE -Value '. (Join-Path (Split-Path $PROFILE) "frankenphp.ps1")'
421+
```
422+
423+
Você precisará iniciar um novo shell para que esta configuração tenha efeito.
424+
425+
Você precisará iniciar um novo shell para que esta configuração tenha efeito.

0 commit comments

Comments
 (0)