add Italian translation of docs#2405
Open
garak wants to merge 1 commit into
Open
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds an Italian translation set for FrankenPHP documentation under docs/it/, addressing #2400.
Changes:
- Added Italian versions of the main docs pages (usage, config, Docker, worker mode, Symfony/Laravel integration, etc.).
- Added translated contribution guidelines and extension/extension-worker documentation.
- Added translated “index” README for Italian docs.
Reviewed changes
Copilot reviewed 22 out of 22 changed files in this pull request and generated 21 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/it/README.md | Italian landing page for the docs set (contains some relative links). |
| docs/it/classic.md | Italian translation of classic mode docs. |
| docs/it/worker.md | Italian translation of worker mode docs (includes cross-links). |
| docs/it/config.md | Italian translation of configuration docs (includes anchors/build-tag references). |
| docs/it/docker.md | Italian translation of Docker image/build docs. |
| docs/it/production.md | Italian translation of production deployment guide. |
| docs/it/performance.md | Italian translation of performance tuning guide. |
| docs/it/metrics.md | Italian translation of metrics page. |
| docs/it/mercure.md | Italian translation of Mercure/real-time guide. |
| docs/it/hot-reload.md | Italian translation of hot reload guide. |
| docs/it/x-sendfile.md | Italian translation of X-Sendfile / X-Accel-Redirect guide. |
| docs/it/symfony.md | Italian translation of Symfony integration docs (includes X-Sendfile section). |
| docs/it/laravel.md | Italian translation of Laravel integration docs. |
| docs/it/embed.md | Italian translation of embedding/standalone binaries guide. |
| docs/it/static.md | Italian translation of static build guide. |
| docs/it/compile.md | Italian translation of “compile from sources” guide (mentions build tags). |
| docs/it/known-issues.md | Italian translation of known issues. |
| docs/it/github-actions.md | Italian translation of GitHub Actions docs. |
| docs/it/extensions.md | Italian translation of Go extensions guide (large doc). |
| docs/it/extension-workers.md | Italian translation of extension workers guide (code samples). |
| docs/it/early-hints.md | Italian translation of Early Hints page. |
| docs/it/CONTRIBUTING.md | Italian translation of contributing/debugging guide. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| FrankenPHP può servire in modo efficiente [grandi file statici](x-sendfile.md) dopo l'esecuzione di codice PHP (per controllo di accessi, statistiche, eccetera). | ||
|
|
||
| Symfony HttpFoundation supporta nativamente la [funzionalità](https://symfony.com/doc/current/components/http_foundation.html#serving-files). | ||
| Dopo aver configurato [Caddyfile`](x-sendfile.md#configuring-x-accel-redirect-in-the-frankenphp-caddyfile), troverà automaticamente il valore corretto dell'header `X-Accel-Redirect` da aggiungere alla risposta: |
|
|
||
| ## Progetti che utilizzano il componente Symfony HttpFoundation (Symfony, Laravel, Drupal...) | ||
|
|
||
| Vedere la [documentazione di Symfony](symfony.md#serving-large-static-files-x-sendfile) per i dettagli sull'uso di questa funzionalità con Symfony HttpFoundation. |
| FrankenPHP consente di delegare l'invio di file statici al server web | ||
| **dopo** l'esecuzione del codice PHP personalizzato. | ||
|
|
||
| Per porterlo fare, l'applicazione PHP deve semplicemente definire un'intestazione HTTP personalizzata |
Comment on lines
+30
to
+42
| + # Necessario for Symfony, Laravel e altri progetti che usano il componente HttpFoundation | ||
| + request_header X-Sendfile-Type x-accel-redirect | ||
| + request_header X-Accel-Mapping ../private-files=/private-files | ||
| + | ||
| + intercept { | ||
| + @accel header X-Accel-Redirect * | ||
| + handle_response @accel { | ||
| + root private-files/ | ||
| + rewrite * {resp.header.X-Accel-Redirect} | ||
| + method * GET | ||
| + | ||
| + # Rimove l'header X-Accel-Redirect impostato da PHP, per maggior sicurezza | ||
| + header -X-Accel-Redirect |
|
|
||
| ## Come funziona la ricarica a caldo di FrankenPHP | ||
|
|
||
| 1. **Guarda**: FrankenPHP monitora il filesystem per eventuali modifiche utilizzando [la libreria `e-dant/watcher`](https://github.com/e-dant/watcher) dietro le quinte (abbiamo contribuito con il collegamento Go).'); |
| WORKDIR /go/src/app/dist/app | ||
| COPY . . | ||
|
|
||
| # Rimuove i test e altri file supeflui, per risparmiare spazio |
Comment on lines
+155
to
+168
| Se necessario, sostituisre `<your-IPs>` con gli intervalli IP effettivi del proxy. | ||
|
|
||
| Inoltre, anche il framework PHP usato deve essere configurato per fidarsi del proxy. | ||
| Ad esempio, impostare la [variabile d'ambiente `TRUSTED_PROXIES`](https://symfony.com/doc/current/deployment/proxies.html) per Symfony, | ||
| o il [middleware `trustedproxies`](https://laravel.com/docs/trustedproxy) per Laravel. | ||
|
|
||
| Senza entrambe le configurazioni, header come `X-Forwarded-For` e `X-Forwarded-Proto` verranno ignorati, | ||
| il che che potrebbe causare problemi come rilevamento HTTPS errato o indirizzi IP client errati. | ||
|
|
||
| ## Deploy su più nodi | ||
|
|
||
| In caso di deploy su un cluster di macchine, si pèuò utilizzare [Docker Swarm](https://docs.docker.com/engine/swarm/stack-deploy/), | ||
| che è compatibile con i file Compose forniti. | ||
| Per il deploy su Kubernetes, dare un'occhiata al [tabella Helm fornita con API Platform](https://api-platform.com/docs/deployment/kubernetes/), che utilizza FrankenPHP. |
|
|
||
| ### Integrazione dell'estensione generata in FrankenPHP | ||
|
|
||
| La nostra estensione è ora pronta per essere compilata e integrata in FrankenPHP. Per fare ciò, fare riferimento alla [documentazione di compilazione] di FrankenPHP(compile.md) per sapere come compilare FrankenPHP. Aggiungi il modulo utilizzando il flag `--with`, che punta al percorso del modulo: |
|
|
||
| ### Integrazione dell'estensione in FrankenPHP | ||
|
|
||
| La nostra estensione è ora pronta per essere compilata e integrata in FrankenPHP. Per fare ciò, fare riferimento alla [documentazione di compilazione] di FrankenPHP(compile.md) per sapere come compilare FrankenPHP. Aggiungi il modulo utilizzando il flag `--with`, che punta al percorso del modulo: |
Comment on lines
+160
to
+161
| func init() { | ||
| workerHandle = frankenphpCaddy.RegisterWorkers( |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fix #2400