diff --git a/site/src/content/docs/es/middleware/basic-auth.md b/site/src/content/docs/es/middleware/basic-auth.md index 49dc36dc..0ce5538e 100644 --- a/site/src/content/docs/es/middleware/basic-auth.md +++ b/site/src/content/docs/es/middleware/basic-auth.md @@ -10,6 +10,12 @@ El middleware Basic Auth proporciona autenticación HTTP basic. - Para credenciales válidas llama al siguiente handler. - Para credenciales ausentes o inválidas, envía una response `401 Unauthorized`. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/body-dump.md b/site/src/content/docs/es/middleware/body-dump.md index d500f95a..5de4d32e 100644 --- a/site/src/content/docs/es/middleware/body-dump.md +++ b/site/src/content/docs/es/middleware/body-dump.md @@ -13,6 +13,12 @@ Evita Body Dump para payloads grandes, como uploads o downloads de archivos. Si en esas rutas, agrega una excepción en la función skipper. ::: +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/body-limit.md b/site/src/content/docs/es/middleware/body-limit.md index 128246e9..2a19b210 100644 --- a/site/src/content/docs/es/middleware/body-limit.md +++ b/site/src/content/docs/es/middleware/body-limit.md @@ -11,6 +11,12 @@ supera el límite configurado, envía una response `413 Request Entity Too Large El límite se aplica tanto al header de request `Content-Length` como al contenido real leído, lo que lo hace resistente a headers falsificados. El límite se especifica en bytes. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/context-timeout.md b/site/src/content/docs/es/middleware/context-timeout.md index e75ff5e1..e6754080 100644 --- a/site/src/content/docs/es/middleware/context-timeout.md +++ b/site/src/content/docs/es/middleware/context-timeout.md @@ -8,6 +8,12 @@ sidebar: El middleware Context Timeout aplica un timeout al contexto del request dentro de un periodo predefinido, para que los métodos conscientes del contexto puedan retornar antes cuando se supera el deadline. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/cors.md b/site/src/content/docs/es/middleware/cors.md index ce6c57b6..4349ee82 100644 --- a/site/src/content/docs/es/middleware/cors.md +++ b/site/src/content/docs/es/middleware/cors.md @@ -8,6 +8,12 @@ sidebar: El middleware CORS implementa la especificación [CORS](https://fetch.spec.whatwg.org/#http-cors-protocol). CORS da a los servidores web controles de acceso entre dominios, lo que permite transferencias de datos seguras entre dominios. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/csrf.md b/site/src/content/docs/es/middleware/csrf.md index 411e4863..787796dc 100644 --- a/site/src/content/docs/es/middleware/csrf.md +++ b/site/src/content/docs/es/middleware/csrf.md @@ -9,6 +9,12 @@ Cross-Site Request Forgery (CSRF, a veces pronunciado "sea-surf", o XSRF) es un exploit malicioso en el que se transmiten comandos no autorizados desde un usuario en el que un sitio web confía. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/decompress.md b/site/src/content/docs/es/middleware/decompress.md index f2ad7211..9381e08a 100644 --- a/site/src/content/docs/es/middleware/decompress.md +++ b/site/src/content/docs/es/middleware/decompress.md @@ -13,6 +13,12 @@ El body se descomprime en memoria y permanece allí durante la vida del request la garbage collection). ::: +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/gzip.md b/site/src/content/docs/es/middleware/gzip.md index 9ec16acf..25e40e07 100644 --- a/site/src/content/docs/es/middleware/gzip.md +++ b/site/src/content/docs/es/middleware/gzip.md @@ -7,6 +7,12 @@ sidebar: El middleware Gzip comprime la response HTTP usando el esquema de compresión gzip. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/key-auth.md b/site/src/content/docs/es/middleware/key-auth.md index 39d0beb2..6d2da984 100644 --- a/site/src/content/docs/es/middleware/key-auth.md +++ b/site/src/content/docs/es/middleware/key-auth.md @@ -11,6 +11,12 @@ El middleware Key Auth proporciona autenticación basada en clave. - Para una clave inválida, envía una response `401 Unauthorized`. - Para una clave ausente, envía una response `400 Bad Request`. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/logger.md b/site/src/content/docs/es/middleware/logger.md index 4858cb7f..25fb0640 100644 --- a/site/src/content/docs/es/middleware/logger.md +++ b/site/src/content/docs/es/middleware/logger.md @@ -79,6 +79,12 @@ type RequestLoggerConfig struct { } ``` +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Ejemplos ### fmt.Printf diff --git a/site/src/content/docs/es/middleware/method-override.md b/site/src/content/docs/es/middleware/method-override.md index 22fbaa4a..aac8c37c 100644 --- a/site/src/content/docs/es/middleware/method-override.md +++ b/site/src/content/docs/es/middleware/method-override.md @@ -12,6 +12,12 @@ en lugar del método original. Por razones de seguridad, solo se puede sobrescribir el método `POST`. ::: +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/proxy.md b/site/src/content/docs/es/middleware/proxy.md index 981fd079..44ec44b8 100644 --- a/site/src/content/docs/es/middleware/proxy.md +++ b/site/src/content/docs/es/middleware/proxy.md @@ -8,6 +8,12 @@ sidebar: Proxy proporciona un middleware de reverse proxy HTTP/WebSocket. Reenvía un request a un servidor upstream usando una técnica de load balancing configurada. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/rate-limiter.md b/site/src/content/docs/es/middleware/rate-limiter.md index f0b3c5d6..f815d41b 100644 --- a/site/src/content/docs/es/middleware/rate-limiter.md +++ b/site/src/content/docs/es/middleware/rate-limiter.md @@ -12,6 +12,12 @@ Por defecto, un store en memoria lleva la cuenta de los requests. La implementac defecto se centra en la corrección y puede no ser la mejor opción para un número alto de requests concurrentes o una gran cantidad de identificadores distintos (>16k). +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso Para agregar un rate limit a tu aplicación, agrega el middleware `RateLimiter`. El ejemplo siguiente diff --git a/site/src/content/docs/es/middleware/recover.md b/site/src/content/docs/es/middleware/recover.md index 82d94e3e..fee2951c 100644 --- a/site/src/content/docs/es/middleware/recover.md +++ b/site/src/content/docs/es/middleware/recover.md @@ -9,6 +9,12 @@ El middleware Recover se recupera de panics en cualquier punto de la cadena, imp pasa el control al [HTTPErrorHandler](/es/guide/customization/#http-error-handler) centralizado. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/redirect.md b/site/src/content/docs/es/middleware/redirect.md index 77a401d9..df641fc0 100644 --- a/site/src/content/docs/es/middleware/redirect.md +++ b/site/src/content/docs/es/middleware/redirect.md @@ -5,6 +5,12 @@ sidebar: order: 19 --- +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## HTTPS Redirect El middleware HTTPS redirect redirige requests HTTP a HTTPS. Por ejemplo, diff --git a/site/src/content/docs/es/middleware/request-id.md b/site/src/content/docs/es/middleware/request-id.md index 730297de..64b41732 100644 --- a/site/src/content/docs/es/middleware/request-id.md +++ b/site/src/content/docs/es/middleware/request-id.md @@ -7,6 +7,12 @@ sidebar: El middleware Request ID genera un ID único para un request. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/rewrite.md b/site/src/content/docs/es/middleware/rewrite.md index 88e7b773..dc3d86b4 100644 --- a/site/src/content/docs/es/middleware/rewrite.md +++ b/site/src/content/docs/es/middleware/rewrite.md @@ -8,6 +8,12 @@ sidebar: El middleware Rewrite reescribe el path de la URL según las reglas proporcionadas. Es útil para compatibilidad hacia atrás o para crear enlaces más limpios y descriptivos. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/secure.md b/site/src/content/docs/es/middleware/secure.md index 7bef8a6f..53a1a1b8 100644 --- a/site/src/content/docs/es/middleware/secure.md +++ b/site/src/content/docs/es/middleware/secure.md @@ -8,6 +8,12 @@ sidebar: El middleware Secure proporciona protección contra cross-site scripting (XSS), content type sniffing, clickjacking, conexiones inseguras y otros ataques de inyección de código. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/session.md b/site/src/content/docs/es/middleware/session.md index 6bd9bd17..88be42ce 100644 --- a/site/src/content/docs/es/middleware/session.md +++ b/site/src/content/docs/es/middleware/session.md @@ -127,7 +127,7 @@ func main() { Solicitar `/read-session` sin proporcionar una sesión muestra nil como valor de `foo`: ```bash -$ curl -v http://localhost:8080/read-session +curl -v http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -147,7 +147,7 @@ foo= Solicitar `/create-session` crea una nueva sesión: ```bash -$ curl -v -c cookies.txt http://localhost:8080/create-session +curl -v -c cookies.txt http://localhost:8080/create-session * processing: http://localhost:8080/create-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -169,7 +169,7 @@ Usando la cookie de sesión de la response anterior, solicitar `/read-session` m valor de `foo` desde la sesión: ```bash -$ curl -v -b cookies.txt http://localhost:8080/read-session +curl -v -b cookies.txt http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 diff --git a/site/src/content/docs/es/middleware/static.md b/site/src/content/docs/es/middleware/static.md index 8acc4f57..c06f6358 100644 --- a/site/src/content/docs/es/middleware/static.md +++ b/site/src/content/docs/es/middleware/static.md @@ -7,6 +7,12 @@ sidebar: El middleware Static sirve archivos estáticos desde el directorio raíz proporcionado. +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/es/middleware/trailing-slash.md b/site/src/content/docs/es/middleware/trailing-slash.md index c1f25d0a..828132b9 100644 --- a/site/src/content/docs/es/middleware/trailing-slash.md +++ b/site/src/content/docs/es/middleware/trailing-slash.md @@ -5,6 +5,12 @@ sidebar: order: 25 --- +Todo el middleware principal reside en el paquete `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Agregar trailing slash El middleware Add trailing slash agrega una trailing slash al URI del request. diff --git a/site/src/content/docs/ja/middleware/basic-auth.md b/site/src/content/docs/ja/middleware/basic-auth.md index 40173d18..751d3473 100644 --- a/site/src/content/docs/ja/middleware/basic-auth.md +++ b/site/src/content/docs/ja/middleware/basic-auth.md @@ -10,6 +10,12 @@ Basic Auth ミドルウェアは HTTP Basic 認証を提供します。 - 有効な認証情報の場合、次のハンドラを呼び出します。 - 認証情報がない、または無効な場合は `401 Unauthorized` レスポンスを送信します。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/body-dump.md b/site/src/content/docs/ja/middleware/body-dump.md index cc579a6f..248e218d 100644 --- a/site/src/content/docs/ja/middleware/body-dump.md +++ b/site/src/content/docs/ja/middleware/body-dump.md @@ -13,6 +13,12 @@ Body Dump ミドルウェアは、リクエストとレスポンスのペイロ そのようなルートで使う必要がある場合は、skipper 関数に例外を追加してください。 ::: +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/body-limit.md b/site/src/content/docs/ja/middleware/body-limit.md index ba377d6b..a9ac0ad8 100644 --- a/site/src/content/docs/ja/middleware/body-limit.md +++ b/site/src/content/docs/ja/middleware/body-limit.md @@ -11,6 +11,12 @@ Body Limit ミドルウェアはリクエストボディに許可される最大 この制限は `Content-Length` リクエスト header と実際に読み取られた内容の両方に適用されるため、 偽装された header に対しても耐性があります。制限値はバイト単位で指定します。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/context-timeout.md b/site/src/content/docs/ja/middleware/context-timeout.md index 9656a5ba..fb0dfc87 100644 --- a/site/src/content/docs/ja/middleware/context-timeout.md +++ b/site/src/content/docs/ja/middleware/context-timeout.md @@ -8,6 +8,12 @@ sidebar: Context Timeout ミドルウェアは、定義済みの期間内でリクエストコンテキストにタイムアウトを適用し、 期限を超えたらコンテキスト対応メソッドが早期に返れるようにします。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/cors.md b/site/src/content/docs/ja/middleware/cors.md index 65bbb97c..77a80afc 100644 --- a/site/src/content/docs/ja/middleware/cors.md +++ b/site/src/content/docs/ja/middleware/cors.md @@ -8,6 +8,12 @@ sidebar: CORS ミドルウェアは [CORS](https://fetch.spec.whatwg.org/#http-cors-protocol) 仕様を実装します。 CORS は Web サーバーにクロスドメインアクセス制御を提供し、安全なクロスドメインデータ転送を可能にします。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/csrf.md b/site/src/content/docs/ja/middleware/csrf.md index 25af2235..625653aa 100644 --- a/site/src/content/docs/ja/middleware/csrf.md +++ b/site/src/content/docs/ja/middleware/csrf.md @@ -8,6 +8,12 @@ sidebar: Cross-Site Request Forgery（CSRF、"sea-surf" と発音されることもある、または XSRF）は、 Web サイトが信頼するユーザーから未承認のコマンドが送信される悪意ある攻撃の一種です。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/decompress.md b/site/src/content/docs/ja/middleware/decompress.md index 1c8bfeb8..0a9824fc 100644 --- a/site/src/content/docs/ja/middleware/decompress.md +++ b/site/src/content/docs/ja/middleware/decompress.md @@ -12,6 +12,12 @@ HTTP リクエストボディを解凍します。 ボディはメモリ内で解凍され、リクエストのライフタイム中（およびガベージコレクションまで）保持されます。 ::: +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/gzip.md b/site/src/content/docs/ja/middleware/gzip.md index 2ab2ae44..df2e42b0 100644 --- a/site/src/content/docs/ja/middleware/gzip.md +++ b/site/src/content/docs/ja/middleware/gzip.md @@ -7,6 +7,12 @@ sidebar: Gzip ミドルウェアは gzip 圧縮方式を使って HTTP レスポンスを圧縮します。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/key-auth.md b/site/src/content/docs/ja/middleware/key-auth.md index 596625d4..df92940d 100644 --- a/site/src/content/docs/ja/middleware/key-auth.md +++ b/site/src/content/docs/ja/middleware/key-auth.md @@ -11,6 +11,12 @@ Key Auth ミドルウェアは key ベース認証を提供します。 - 無効な key の場合、`401 Unauthorized` レスポンスを送信します。 - key がない場合、`400 Bad Request` レスポンスを送信します。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/logger.md b/site/src/content/docs/ja/middleware/logger.md index 2c4656e7..8aebf46d 100644 --- a/site/src/content/docs/ja/middleware/logger.md +++ b/site/src/content/docs/ja/middleware/logger.md @@ -79,6 +79,12 @@ type RequestLoggerConfig struct { } ``` +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 例 ### fmt.Printf diff --git a/site/src/content/docs/ja/middleware/method-override.md b/site/src/content/docs/ja/middleware/method-override.md index f47fec0e..a85632d8 100644 --- a/site/src/content/docs/ja/middleware/method-override.md +++ b/site/src/content/docs/ja/middleware/method-override.md @@ -12,6 +12,12 @@ Method Override ミドルウェアは、リクエストから上書きされた セキュリティ上の理由により、上書きできるのは `POST` メソッドだけです。 ::: +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/proxy.md b/site/src/content/docs/ja/middleware/proxy.md index 163d4c28..a84f0632 100644 --- a/site/src/content/docs/ja/middleware/proxy.md +++ b/site/src/content/docs/ja/middleware/proxy.md @@ -8,6 +8,12 @@ sidebar: Proxy は HTTP/WebSocket リバースプロキシミドルウェアを提供します。設定された負荷分散方式を使って、 リクエストを上流サーバーへ転送します。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/rate-limiter.md b/site/src/content/docs/ja/middleware/rate-limiter.md index 584ed20a..13db5a0d 100644 --- a/site/src/content/docs/ja/middleware/rate-limiter.md +++ b/site/src/content/docs/ja/middleware/rate-limiter.md @@ -11,6 +11,12 @@ sidebar: デフォルトでは、インメモリ store がリクエストを追跡します。デフォルトのインメモリ実装は 正確性に重点を置いており、大量の同時リクエストや多数の異なる識別子（>16k）には最適ではない場合があります。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 アプリケーションにレート制限を追加するには、`RateLimiter` ミドルウェアを追加します。 diff --git a/site/src/content/docs/ja/middleware/recover.md b/site/src/content/docs/ja/middleware/recover.md index 08160d00..68663101 100644 --- a/site/src/content/docs/ja/middleware/recover.md +++ b/site/src/content/docs/ja/middleware/recover.md @@ -8,6 +8,12 @@ sidebar: Recover ミドルウェアは、チェーン内のどこで発生した panic からも復旧し、スタックトレースを出力して、 一元化された [HTTPErrorHandler](/ja/guide/customization/#http-error-handler) に制御を渡します。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/redirect.md b/site/src/content/docs/ja/middleware/redirect.md index 918c2dd8..4ebd693f 100644 --- a/site/src/content/docs/ja/middleware/redirect.md +++ b/site/src/content/docs/ja/middleware/redirect.md @@ -5,6 +5,12 @@ sidebar: order: 19 --- +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## HTTPS リダイレクト HTTPS redirect ミドルウェアは HTTP リクエストを HTTPS へリダイレクトします。 diff --git a/site/src/content/docs/ja/middleware/request-id.md b/site/src/content/docs/ja/middleware/request-id.md index 331fb759..0ae5fd1b 100644 --- a/site/src/content/docs/ja/middleware/request-id.md +++ b/site/src/content/docs/ja/middleware/request-id.md @@ -7,6 +7,12 @@ sidebar: Request ID ミドルウェアはリクエストに一意の ID を生成します。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/rewrite.md b/site/src/content/docs/ja/middleware/rewrite.md index 68ba1e1e..6034fb42 100644 --- a/site/src/content/docs/ja/middleware/rewrite.md +++ b/site/src/content/docs/ja/middleware/rewrite.md @@ -8,6 +8,12 @@ sidebar: Rewrite ミドルウェアは、指定されたルールに基づいて URL パスを書き換えます。 後方互換性を保つ場合や、より短く分かりやすいリンクを作る場合に役立ちます。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/secure.md b/site/src/content/docs/ja/middleware/secure.md index 12121cb7..72cc09b2 100644 --- a/site/src/content/docs/ja/middleware/secure.md +++ b/site/src/content/docs/ja/middleware/secure.md @@ -8,6 +8,12 @@ sidebar: Secure ミドルウェアは、クロスサイトスクリプティング（XSS）、コンテンツタイプスニッフィング、 クリックジャッキング、安全でない接続、その他のコードインジェクション攻撃への防御を提供します。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/session.md b/site/src/content/docs/ja/middleware/session.md index afcf404a..cb50837a 100644 --- a/site/src/content/docs/ja/middleware/session.md +++ b/site/src/content/docs/ja/middleware/session.md @@ -125,7 +125,7 @@ func main() { セッションを指定せずに `/read-session` をリクエストすると、`foo` の値は nil として出力されます。 ```bash -$ curl -v http://localhost:8080/read-session +curl -v http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -145,7 +145,7 @@ foo= `/create-session` をリクエストすると新しいセッションが作成されます。 ```bash -$ curl -v -c cookies.txt http://localhost:8080/create-session +curl -v -c cookies.txt http://localhost:8080/create-session * processing: http://localhost:8080/create-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -167,7 +167,7 @@ $ curl -v -c cookies.txt http://localhost:8080/create-session セッション内の `foo` 値が出力されます。 ```bash -$ curl -v -b cookies.txt http://localhost:8080/read-session +curl -v -b cookies.txt http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 diff --git a/site/src/content/docs/ja/middleware/static.md b/site/src/content/docs/ja/middleware/static.md index 33a16798..802bfd62 100644 --- a/site/src/content/docs/ja/middleware/static.md +++ b/site/src/content/docs/ja/middleware/static.md @@ -7,6 +7,12 @@ sidebar: Static ミドルウェアは、指定されたルートディレクトリから静的ファイルを配信します。 +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 使い方 ```go diff --git a/site/src/content/docs/ja/middleware/trailing-slash.md b/site/src/content/docs/ja/middleware/trailing-slash.md index ef21fa6c..89a979f5 100644 --- a/site/src/content/docs/ja/middleware/trailing-slash.md +++ b/site/src/content/docs/ja/middleware/trailing-slash.md @@ -5,6 +5,12 @@ sidebar: order: 25 --- +すべてのコアミドルウェアは `middleware` パッケージに含まれています： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 末尾スラッシュを追加する Add trailing slash ミドルウェアは、リクエスト URI に末尾スラッシュを追加します。 diff --git a/site/src/content/docs/middleware/basic-auth.md b/site/src/content/docs/middleware/basic-auth.md index cd93eebc..46b837ec 100644 --- a/site/src/content/docs/middleware/basic-auth.md +++ b/site/src/content/docs/middleware/basic-auth.md @@ -10,6 +10,12 @@ Basic Auth middleware provides HTTP basic authentication. - For valid credentials it calls the next handler. - For missing or invalid credentials, it sends a `401 Unauthorized` response. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/body-dump.md b/site/src/content/docs/middleware/body-dump.md index 129b2ccf..44ea3b9f 100644 --- a/site/src/content/docs/middleware/body-dump.md +++ b/site/src/content/docs/middleware/body-dump.md @@ -13,6 +13,12 @@ Avoid Body Dump for large payloads such as file uploads or downloads. If you mus on such routes, add an exception in the skipper function. ::: +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/body-limit.md b/site/src/content/docs/middleware/body-limit.md index 93eac3d0..474648ee 100644 --- a/site/src/content/docs/middleware/body-limit.md +++ b/site/src/content/docs/middleware/body-limit.md @@ -12,6 +12,12 @@ The limit is enforced against both the `Content-Length` request header and the a content read, which makes it resilient against spoofed headers. The limit is specified in bytes. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/context-timeout.md b/site/src/content/docs/middleware/context-timeout.md index 99524e9f..2683d1cb 100644 --- a/site/src/content/docs/middleware/context-timeout.md +++ b/site/src/content/docs/middleware/context-timeout.md @@ -8,6 +8,12 @@ sidebar: Context Timeout middleware applies a timeout to the request context within a predefined period, so context-aware methods can return early once the deadline is exceeded. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/cors.md b/site/src/content/docs/middleware/cors.md index 740ccfbe..9ad02467 100644 --- a/site/src/content/docs/middleware/cors.md +++ b/site/src/content/docs/middleware/cors.md @@ -8,6 +8,12 @@ sidebar: CORS middleware implements the [CORS](https://fetch.spec.whatwg.org/#http-cors-protocol) specification. CORS gives web servers cross-domain access controls, which enable secure cross-domain data transfers. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/csrf.md b/site/src/content/docs/middleware/csrf.md index 0583c308..0689fa3a 100644 --- a/site/src/content/docs/middleware/csrf.md +++ b/site/src/content/docs/middleware/csrf.md @@ -9,6 +9,12 @@ Cross-Site Request Forgery (CSRF, sometimes pronounced "sea-surf", or XSRF) is a malicious exploit where unauthorized commands are transmitted from a user that a website trusts. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/decompress.md b/site/src/content/docs/middleware/decompress.md index 4112fd09..bf5cf33d 100644 --- a/site/src/content/docs/middleware/decompress.md +++ b/site/src/content/docs/middleware/decompress.md @@ -13,6 +13,12 @@ The body is decompressed in memory and held there for the lifetime of the reques until garbage collection). ::: +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/gzip.md b/site/src/content/docs/middleware/gzip.md index 5af5520a..9942bb2d 100644 --- a/site/src/content/docs/middleware/gzip.md +++ b/site/src/content/docs/middleware/gzip.md @@ -7,6 +7,12 @@ sidebar: Gzip middleware compresses the HTTP response using the gzip compression scheme. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/key-auth.md b/site/src/content/docs/middleware/key-auth.md index be881c74..01514b60 100644 --- a/site/src/content/docs/middleware/key-auth.md +++ b/site/src/content/docs/middleware/key-auth.md @@ -11,6 +11,12 @@ Key Auth middleware provides key-based authentication. - For an invalid key, it sends a `401 Unauthorized` response. - For a missing key, it sends a `400 Bad Request` response. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/logger.md b/site/src/content/docs/middleware/logger.md index a3699705..de2b6dae 100644 --- a/site/src/content/docs/middleware/logger.md +++ b/site/src/content/docs/middleware/logger.md @@ -79,6 +79,12 @@ type RequestLoggerConfig struct { } ``` +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Examples ### fmt.Printf diff --git a/site/src/content/docs/middleware/method-override.md b/site/src/content/docs/middleware/method-override.md index e4cb01d1..02a19d89 100644 --- a/site/src/content/docs/middleware/method-override.md +++ b/site/src/content/docs/middleware/method-override.md @@ -12,6 +12,12 @@ instead of the original method. For security reasons, only the `POST` method can be overridden. ::: +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/proxy.md b/site/src/content/docs/middleware/proxy.md index f33c1756..5e1487b5 100644 --- a/site/src/content/docs/middleware/proxy.md +++ b/site/src/content/docs/middleware/proxy.md @@ -8,6 +8,12 @@ sidebar: Proxy provides an HTTP/WebSocket reverse proxy middleware. It forwards a request to an upstream server using a configured load balancing technique. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/rate-limiter.md b/site/src/content/docs/middleware/rate-limiter.md index 0c8dd335..d5eb338f 100644 --- a/site/src/content/docs/middleware/rate-limiter.md +++ b/site/src/content/docs/middleware/rate-limiter.md @@ -12,6 +12,12 @@ By default, an in-memory store keeps track of requests. The default in-memory im is focused on correctness and may not be the best option for a high number of concurrent requests or a large number of distinct identifiers (>16k). +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage To add a rate limit to your application, add the `RateLimiter` middleware. The example below diff --git a/site/src/content/docs/middleware/recover.md b/site/src/content/docs/middleware/recover.md index 0146171e..21cb539e 100644 --- a/site/src/content/docs/middleware/recover.md +++ b/site/src/content/docs/middleware/recover.md @@ -9,6 +9,12 @@ Recover middleware recovers from panics anywhere in the chain, prints the stack passes control to the centralized [HTTPErrorHandler](/guide/customization/#http-error-handler). +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/redirect.md b/site/src/content/docs/middleware/redirect.md index b071f0ec..886f305d 100644 --- a/site/src/content/docs/middleware/redirect.md +++ b/site/src/content/docs/middleware/redirect.md @@ -5,6 +5,12 @@ sidebar: order: 19 --- +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## HTTPS Redirect HTTPS redirect middleware redirects HTTP requests to HTTPS. For example, diff --git a/site/src/content/docs/middleware/request-id.md b/site/src/content/docs/middleware/request-id.md index 692f85d9..c2a5897f 100644 --- a/site/src/content/docs/middleware/request-id.md +++ b/site/src/content/docs/middleware/request-id.md @@ -7,6 +7,12 @@ sidebar: Request ID middleware generates a unique ID for a request. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/rewrite.md b/site/src/content/docs/middleware/rewrite.md index fd89bfaa..56d9ad35 100644 --- a/site/src/content/docs/middleware/rewrite.md +++ b/site/src/content/docs/middleware/rewrite.md @@ -8,6 +8,12 @@ sidebar: Rewrite middleware rewrites the URL path based on the provided rules. It is helpful for backward compatibility or for creating cleaner and more descriptive links. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/secure.md b/site/src/content/docs/middleware/secure.md index d7a3d3b5..c7d2ba67 100644 --- a/site/src/content/docs/middleware/secure.md +++ b/site/src/content/docs/middleware/secure.md @@ -8,6 +8,12 @@ sidebar: Secure middleware provides protection against cross-site scripting (XSS), content type sniffing, clickjacking, insecure connections, and other code injection attacks. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/session.md b/site/src/content/docs/middleware/session.md index 13451bac..09c73996 100644 --- a/site/src/content/docs/middleware/session.md +++ b/site/src/content/docs/middleware/session.md @@ -127,7 +127,7 @@ func main() { Requesting `/read-session` without providing a session outputs nil as the `foo` value: ```bash -$ curl -v http://localhost:8080/read-session +curl -v http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -147,7 +147,7 @@ foo= Requesting `/create-session` creates a new session: ```bash -$ curl -v -c cookies.txt http://localhost:8080/create-session +curl -v -c cookies.txt http://localhost:8080/create-session * processing: http://localhost:8080/create-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -169,7 +169,7 @@ Using the session cookie from the previous response, requesting `/read-session` `foo` value from the session: ```bash -$ curl -v -b cookies.txt http://localhost:8080/read-session +curl -v -b cookies.txt http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 diff --git a/site/src/content/docs/middleware/static.md b/site/src/content/docs/middleware/static.md index 6194ffba..9b822549 100644 --- a/site/src/content/docs/middleware/static.md +++ b/site/src/content/docs/middleware/static.md @@ -7,6 +7,12 @@ sidebar: Static middleware serves static files from the provided root directory. +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Usage ```go diff --git a/site/src/content/docs/middleware/trailing-slash.md b/site/src/content/docs/middleware/trailing-slash.md index 2f3f7cfe..5e6d1cd3 100644 --- a/site/src/content/docs/middleware/trailing-slash.md +++ b/site/src/content/docs/middleware/trailing-slash.md @@ -5,6 +5,12 @@ sidebar: order: 25 --- +All core middleware lives in the `middleware` package: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Add trailing slash Add trailing slash middleware adds a trailing slash to the request URI. diff --git a/site/src/content/docs/pt-br/middleware/basic-auth.md b/site/src/content/docs/pt-br/middleware/basic-auth.md index 83d8a7a4..3ccadd2f 100644 --- a/site/src/content/docs/pt-br/middleware/basic-auth.md +++ b/site/src/content/docs/pt-br/middleware/basic-auth.md @@ -10,6 +10,12 @@ O middleware Basic Auth fornece autenticação básica HTTP. - Para credenciais válidas, ele chama o próximo handler. - Para credenciais ausentes ou inválidas, ele envia uma response `401 Unauthorized`. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/body-dump.md b/site/src/content/docs/pt-br/middleware/body-dump.md index 58eb3a5e..7498c0b5 100644 --- a/site/src/content/docs/pt-br/middleware/body-dump.md +++ b/site/src/content/docs/pt-br/middleware/body-dump.md @@ -13,6 +13,12 @@ Evite Body Dump para payloads grandes, como uploads ou downloads de arquivos. Se nessas rotas, adicione uma exceção na função skipper. ::: +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/body-limit.md b/site/src/content/docs/pt-br/middleware/body-limit.md index e78c533a..1af2c1ce 100644 --- a/site/src/content/docs/pt-br/middleware/body-limit.md +++ b/site/src/content/docs/pt-br/middleware/body-limit.md @@ -12,6 +12,12 @@ O limite é aplicado tanto ao header de request `Content-Length` quanto ao conte lido, o que o torna resistente a headers falsificados. O limite é especificado em bytes. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/context-timeout.md b/site/src/content/docs/pt-br/middleware/context-timeout.md index 67c87c78..d11dbed2 100644 --- a/site/src/content/docs/pt-br/middleware/context-timeout.md +++ b/site/src/content/docs/pt-br/middleware/context-timeout.md @@ -8,6 +8,12 @@ sidebar: O middleware Context Timeout aplica um timeout ao contexto do request dentro de um período predefinido, para que métodos context-aware possam retornar mais cedo quando o prazo for excedido. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/cors.md b/site/src/content/docs/pt-br/middleware/cors.md index 4ecf8ae5..8f0c197f 100644 --- a/site/src/content/docs/pt-br/middleware/cors.md +++ b/site/src/content/docs/pt-br/middleware/cors.md @@ -8,6 +8,12 @@ sidebar: O middleware CORS implementa a especificação [CORS](https://fetch.spec.whatwg.org/#http-cors-protocol). CORS fornece controles de acesso entre domínios para servidores web, permitindo transferências de dados seguras entre domínios. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/csrf.md b/site/src/content/docs/pt-br/middleware/csrf.md index 1ca56e32..7ab857c3 100644 --- a/site/src/content/docs/pt-br/middleware/csrf.md +++ b/site/src/content/docs/pt-br/middleware/csrf.md @@ -9,6 +9,12 @@ Cross-Site Request Forgery (CSRF, às vezes pronunciado "sea-surf", ou XSRF) é exploit malicioso em que comandos não autorizados são transmitidos a partir de um usuário em que um site confia. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/decompress.md b/site/src/content/docs/pt-br/middleware/decompress.md index 25eeb757..9e604d80 100644 --- a/site/src/content/docs/pt-br/middleware/decompress.md +++ b/site/src/content/docs/pt-br/middleware/decompress.md @@ -13,6 +13,12 @@ O body é descomprimido em memória e mantido ali durante toda a vida do request até a garbage collection). ::: +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/gzip.md b/site/src/content/docs/pt-br/middleware/gzip.md index abf4f872..8c5ff10a 100644 --- a/site/src/content/docs/pt-br/middleware/gzip.md +++ b/site/src/content/docs/pt-br/middleware/gzip.md @@ -7,6 +7,12 @@ sidebar: O middleware Gzip comprime a response HTTP usando o esquema de compressão gzip. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/key-auth.md b/site/src/content/docs/pt-br/middleware/key-auth.md index 17922eb7..50afa731 100644 --- a/site/src/content/docs/pt-br/middleware/key-auth.md +++ b/site/src/content/docs/pt-br/middleware/key-auth.md @@ -11,6 +11,12 @@ O middleware Key Auth fornece autenticação baseada em chave. - Para uma chave inválida, ele envia uma response `401 Unauthorized`. - Para uma chave ausente, ele envia uma response `400 Bad Request`. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/logger.md b/site/src/content/docs/pt-br/middleware/logger.md index 6d343c8b..a9e55a6d 100644 --- a/site/src/content/docs/pt-br/middleware/logger.md +++ b/site/src/content/docs/pt-br/middleware/logger.md @@ -79,6 +79,12 @@ type RequestLoggerConfig struct { } ``` +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Exemplos ### fmt.Printf diff --git a/site/src/content/docs/pt-br/middleware/method-override.md b/site/src/content/docs/pt-br/middleware/method-override.md index 04273750..445c6779 100644 --- a/site/src/content/docs/pt-br/middleware/method-override.md +++ b/site/src/content/docs/pt-br/middleware/method-override.md @@ -12,6 +12,12 @@ no lugar do método original. Por motivos de segurança, apenas o método `POST` pode ser sobrescrito. ::: +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/proxy.md b/site/src/content/docs/pt-br/middleware/proxy.md index 9acc87b2..34ff2df3 100644 --- a/site/src/content/docs/pt-br/middleware/proxy.md +++ b/site/src/content/docs/pt-br/middleware/proxy.md @@ -8,6 +8,12 @@ sidebar: Proxy fornece um middleware de reverse proxy HTTP/WebSocket. Ele encaminha um request para um servidor upstream usando uma técnica de load balancing configurada. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/rate-limiter.md b/site/src/content/docs/pt-br/middleware/rate-limiter.md index d4038d33..31f24ed7 100644 --- a/site/src/content/docs/pt-br/middleware/rate-limiter.md +++ b/site/src/content/docs/pt-br/middleware/rate-limiter.md @@ -12,6 +12,12 @@ Por padrão, um store em memória acompanha os requests. A implementação em me é focada em correção e pode não ser a melhor opção para um alto número de requests concorrentes ou um grande número de identificadores distintos (>16k). +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso Para adicionar um limite de taxa à sua aplicação, adicione o middleware `RateLimiter`. O exemplo abaixo diff --git a/site/src/content/docs/pt-br/middleware/recover.md b/site/src/content/docs/pt-br/middleware/recover.md index ae03f386..3799386f 100644 --- a/site/src/content/docs/pt-br/middleware/recover.md +++ b/site/src/content/docs/pt-br/middleware/recover.md @@ -9,6 +9,12 @@ O middleware Recover recupera panics em qualquer ponto da cadeia, imprime a stac passa o controle para o [HTTPErrorHandler](/pt-br/guide/customization/#http-error-handler) centralizado. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/redirect.md b/site/src/content/docs/pt-br/middleware/redirect.md index 62e746e3..bb161fa4 100644 --- a/site/src/content/docs/pt-br/middleware/redirect.md +++ b/site/src/content/docs/pt-br/middleware/redirect.md @@ -5,6 +5,12 @@ sidebar: order: 19 --- +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## HTTPS Redirect O middleware HTTPS redirect redireciona requests HTTP para HTTPS. Por exemplo, diff --git a/site/src/content/docs/pt-br/middleware/request-id.md b/site/src/content/docs/pt-br/middleware/request-id.md index 112ca44a..d00c4d22 100644 --- a/site/src/content/docs/pt-br/middleware/request-id.md +++ b/site/src/content/docs/pt-br/middleware/request-id.md @@ -7,6 +7,12 @@ sidebar: O middleware Request ID gera um ID único para um request. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/rewrite.md b/site/src/content/docs/pt-br/middleware/rewrite.md index 77888bb1..de4d24dd 100644 --- a/site/src/content/docs/pt-br/middleware/rewrite.md +++ b/site/src/content/docs/pt-br/middleware/rewrite.md @@ -8,6 +8,12 @@ sidebar: O middleware Rewrite reescreve o caminho da URL com base nas regras fornecidas. Ele é útil para compatibilidade retroativa ou para criar links mais limpos e descritivos. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/secure.md b/site/src/content/docs/pt-br/middleware/secure.md index 65c1790b..013a650a 100644 --- a/site/src/content/docs/pt-br/middleware/secure.md +++ b/site/src/content/docs/pt-br/middleware/secure.md @@ -8,6 +8,12 @@ sidebar: O middleware Secure fornece proteção contra cross-site scripting (XSS), content type sniffing, clickjacking, conexões inseguras e outros ataques de injeção de código. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/session.md b/site/src/content/docs/pt-br/middleware/session.md index 163a6bdb..e2e79d5f 100644 --- a/site/src/content/docs/pt-br/middleware/session.md +++ b/site/src/content/docs/pt-br/middleware/session.md @@ -127,7 +127,7 @@ func main() { Solicitar `/read-session` sem fornecer uma sessão exibe nil como o valor de `foo`: ```bash -$ curl -v http://localhost:8080/read-session +curl -v http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -147,7 +147,7 @@ foo= Solicitar `/create-session` cria uma nova sessão: ```bash -$ curl -v -c cookies.txt http://localhost:8080/create-session +curl -v -c cookies.txt http://localhost:8080/create-session * processing: http://localhost:8080/create-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -169,7 +169,7 @@ Usando o cookie de sessão da response anterior, solicitar `/read-session` exibe valor `foo` da sessão: ```bash -$ curl -v -b cookies.txt http://localhost:8080/read-session +curl -v -b cookies.txt http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 diff --git a/site/src/content/docs/pt-br/middleware/static.md b/site/src/content/docs/pt-br/middleware/static.md index 72793a85..474b61a8 100644 --- a/site/src/content/docs/pt-br/middleware/static.md +++ b/site/src/content/docs/pt-br/middleware/static.md @@ -7,6 +7,12 @@ sidebar: O middleware Static serve arquivos estáticos a partir do diretório raiz fornecido. +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Uso ```go diff --git a/site/src/content/docs/pt-br/middleware/trailing-slash.md b/site/src/content/docs/pt-br/middleware/trailing-slash.md index a6be14ac..4db7c3ce 100644 --- a/site/src/content/docs/pt-br/middleware/trailing-slash.md +++ b/site/src/content/docs/pt-br/middleware/trailing-slash.md @@ -5,6 +5,12 @@ sidebar: order: 25 --- +Todo o middleware principal fica no pacote `middleware`: + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## Adicionar barra final O middleware Add trailing slash adiciona uma barra final à URI do request. diff --git a/site/src/content/docs/zh-cn/middleware/basic-auth.md b/site/src/content/docs/zh-cn/middleware/basic-auth.md index a4ae40c7..98147e5f 100644 --- a/site/src/content/docs/zh-cn/middleware/basic-auth.md +++ b/site/src/content/docs/zh-cn/middleware/basic-auth.md @@ -10,6 +10,12 @@ Basic Auth 中间件提供 HTTP Basic 认证。 - 对于有效凭据，它会调用下一个处理函数。 - 对于缺失或无效凭据，它会发送 `401 Unauthorized` 响应。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/body-dump.md b/site/src/content/docs/zh-cn/middleware/body-dump.md index d7ffbbb5..e39e6dda 100644 --- a/site/src/content/docs/zh-cn/middleware/body-dump.md +++ b/site/src/content/docs/zh-cn/middleware/body-dump.md @@ -11,6 +11,12 @@ Body Dump 中间件会捕获请求和响应负载，并传给已注册的处理 避免对文件上传或下载等大型负载使用 Body Dump。如果必须在这类路由上使用，请在 skipper 函数中添加例外。 ::: +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/body-limit.md b/site/src/content/docs/zh-cn/middleware/body-limit.md index a1879980..7ebfce7e 100644 --- a/site/src/content/docs/zh-cn/middleware/body-limit.md +++ b/site/src/content/docs/zh-cn/middleware/body-limit.md @@ -11,6 +11,12 @@ Body Limit 中间件会设置请求体允许的最大大小。如果大小超过 该限制会同时针对 `Content-Length` 请求 header 和实际读取内容执行，因此可抵御伪造 header。 限制值以字节为单位指定。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/context-timeout.md b/site/src/content/docs/zh-cn/middleware/context-timeout.md index 32fe7ac6..27184c35 100644 --- a/site/src/content/docs/zh-cn/middleware/context-timeout.md +++ b/site/src/content/docs/zh-cn/middleware/context-timeout.md @@ -8,6 +8,12 @@ sidebar: Context Timeout 中间件会在预定义时间内为请求上下文应用超时， 使支持上下文的方法在超过截止时间后可以提前返回。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/cors.md b/site/src/content/docs/zh-cn/middleware/cors.md index 9aeafb1d..8ae797f3 100644 --- a/site/src/content/docs/zh-cn/middleware/cors.md +++ b/site/src/content/docs/zh-cn/middleware/cors.md @@ -8,6 +8,12 @@ sidebar: CORS 中间件实现了 [CORS](https://fetch.spec.whatwg.org/#http-cors-protocol) 规范。 CORS 为 Web 服务器提供跨域访问控制，从而支持安全的跨域数据传输。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/csrf.md b/site/src/content/docs/zh-cn/middleware/csrf.md index c4644e4c..e3c04e78 100644 --- a/site/src/content/docs/zh-cn/middleware/csrf.md +++ b/site/src/content/docs/zh-cn/middleware/csrf.md @@ -8,6 +8,12 @@ sidebar: Cross-Site Request Forgery（CSRF，有时读作 "sea-surf"，也称 XSRF）是一类恶意利用， 攻击者会从网站信任的用户那里传递未授权命令。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/decompress.md b/site/src/content/docs/zh-cn/middleware/decompress.md index 5561aea1..7e2ec52f 100644 --- a/site/src/content/docs/zh-cn/middleware/decompress.md +++ b/site/src/content/docs/zh-cn/middleware/decompress.md @@ -11,6 +11,12 @@ sidebar: 请求体会在内存中解压，并在请求生命周期内（直到垃圾回收）保留在那里。 ::: +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/gzip.md b/site/src/content/docs/zh-cn/middleware/gzip.md index 0f0bacb9..7194eafd 100644 --- a/site/src/content/docs/zh-cn/middleware/gzip.md +++ b/site/src/content/docs/zh-cn/middleware/gzip.md @@ -7,6 +7,12 @@ sidebar: Gzip 中间件使用 gzip 压缩方案压缩 HTTP 响应。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/key-auth.md b/site/src/content/docs/zh-cn/middleware/key-auth.md index 64b47dd8..37fe77da 100644 --- a/site/src/content/docs/zh-cn/middleware/key-auth.md +++ b/site/src/content/docs/zh-cn/middleware/key-auth.md @@ -11,6 +11,12 @@ Key Auth 中间件提供基于 key 的认证。 - 对于无效 key，它会发送 `401 Unauthorized` 响应。 - 对于缺失 key，它会发送 `400 Bad Request` 响应。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/logger.md b/site/src/content/docs/zh-cn/middleware/logger.md index 32eb8108..4dc8ea98 100644 --- a/site/src/content/docs/zh-cn/middleware/logger.md +++ b/site/src/content/docs/zh-cn/middleware/logger.md @@ -78,6 +78,12 @@ type RequestLoggerConfig struct { } ``` +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 示例 ### fmt.Printf diff --git a/site/src/content/docs/zh-cn/middleware/method-override.md b/site/src/content/docs/zh-cn/middleware/method-override.md index ed9e67dc..321fc72b 100644 --- a/site/src/content/docs/zh-cn/middleware/method-override.md +++ b/site/src/content/docs/zh-cn/middleware/method-override.md @@ -11,6 +11,12 @@ Method Override 中间件会从请求中读取被覆盖的方法，并用它代 出于安全原因，只有 `POST` 方法可以被覆盖。 ::: +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/proxy.md b/site/src/content/docs/zh-cn/middleware/proxy.md index a5e81602..04c02530 100644 --- a/site/src/content/docs/zh-cn/middleware/proxy.md +++ b/site/src/content/docs/zh-cn/middleware/proxy.md @@ -7,6 +7,12 @@ sidebar: Proxy 提供 HTTP/WebSocket 反向代理中间件。它会使用配置的负载均衡技术将请求转发到上游服务器。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/rate-limiter.md b/site/src/content/docs/zh-cn/middleware/rate-limiter.md index 2214871a..f990c8c5 100644 --- a/site/src/content/docs/zh-cn/middleware/rate-limiter.md +++ b/site/src/content/docs/zh-cn/middleware/rate-limiter.md @@ -10,6 +10,12 @@ sidebar: 默认情况下，请求记录保存在内存 store 中。默认内存实现专注于正确性，对于大量并发请求或大量不同标识符 （>16k）可能不是最佳选择。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 要为应用添加速率限制，请添加 `RateLimiter` 中间件。下面的示例使用默认内存 store， diff --git a/site/src/content/docs/zh-cn/middleware/recover.md b/site/src/content/docs/zh-cn/middleware/recover.md index d81abe35..225f9500 100644 --- a/site/src/content/docs/zh-cn/middleware/recover.md +++ b/site/src/content/docs/zh-cn/middleware/recover.md @@ -8,6 +8,12 @@ sidebar: Recover 中间件会从链中任意位置的 panic 中恢复，打印堆栈跟踪，并把控制权传给集中式 [HTTPErrorHandler](/zh-cn/guide/customization/#http-error-handler)。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/redirect.md b/site/src/content/docs/zh-cn/middleware/redirect.md index 59dfd2e6..516a752c 100644 --- a/site/src/content/docs/zh-cn/middleware/redirect.md +++ b/site/src/content/docs/zh-cn/middleware/redirect.md @@ -5,6 +5,12 @@ sidebar: order: 19 --- +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## HTTPS 重定向 HTTPS redirect 中间件会把 HTTP 请求重定向到 HTTPS。例如，`http://labstack.com` diff --git a/site/src/content/docs/zh-cn/middleware/request-id.md b/site/src/content/docs/zh-cn/middleware/request-id.md index 166ec014..e6c61db3 100644 --- a/site/src/content/docs/zh-cn/middleware/request-id.md +++ b/site/src/content/docs/zh-cn/middleware/request-id.md @@ -7,6 +7,12 @@ sidebar: Request ID 中间件会为请求生成唯一 ID。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/rewrite.md b/site/src/content/docs/zh-cn/middleware/rewrite.md index 09e1dee5..eb877482 100644 --- a/site/src/content/docs/zh-cn/middleware/rewrite.md +++ b/site/src/content/docs/zh-cn/middleware/rewrite.md @@ -8,6 +8,12 @@ sidebar: Rewrite 中间件会根据提供的规则重写 URL 路径。它有助于保持向后兼容，或创建更简洁、 更具描述性的链接。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/secure.md b/site/src/content/docs/zh-cn/middleware/secure.md index da595c39..0f9285aa 100644 --- a/site/src/content/docs/zh-cn/middleware/secure.md +++ b/site/src/content/docs/zh-cn/middleware/secure.md @@ -7,6 +7,12 @@ sidebar: Secure 中间件提供对跨站脚本（XSS）、内容类型嗅探、点击劫持、不安全连接和其他代码注入攻击的防护。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/session.md b/site/src/content/docs/zh-cn/middleware/session.md index f370a845..f3c3e837 100644 --- a/site/src/content/docs/zh-cn/middleware/session.md +++ b/site/src/content/docs/zh-cn/middleware/session.md @@ -124,7 +124,7 @@ func main() { 在不提供会话的情况下请求 `/read-session`，输出的 `foo` 值为 nil： ```bash -$ curl -v http://localhost:8080/read-session +curl -v http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -144,7 +144,7 @@ foo= 请求 `/create-session` 会创建新会话： ```bash -$ curl -v -c cookies.txt http://localhost:8080/create-session +curl -v -c cookies.txt http://localhost:8080/create-session * processing: http://localhost:8080/create-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 @@ -165,7 +165,7 @@ $ curl -v -c cookies.txt http://localhost:8080/create-session 使用上一个响应中的会话 Cookie 请求 `/read-session`，会输出会话中的 `foo` 值： ```bash -$ curl -v -b cookies.txt http://localhost:8080/read-session +curl -v -b cookies.txt http://localhost:8080/read-session * processing: http://localhost:8080/read-session * Trying [::1]:8080... * Connected to localhost (::1) port 8080 diff --git a/site/src/content/docs/zh-cn/middleware/static.md b/site/src/content/docs/zh-cn/middleware/static.md index 380d13ce..d1346ade 100644 --- a/site/src/content/docs/zh-cn/middleware/static.md +++ b/site/src/content/docs/zh-cn/middleware/static.md @@ -7,6 +7,12 @@ sidebar: Static 中间件会从提供的根目录提供静态文件。 +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 用法 ```go diff --git a/site/src/content/docs/zh-cn/middleware/trailing-slash.md b/site/src/content/docs/zh-cn/middleware/trailing-slash.md index e1eed5e0..e8e7bb0d 100644 --- a/site/src/content/docs/zh-cn/middleware/trailing-slash.md +++ b/site/src/content/docs/zh-cn/middleware/trailing-slash.md @@ -5,6 +5,12 @@ sidebar: order: 25 --- +所有核心中间件都位于 `middleware` 包中： + +```go +import "github.com/labstack/echo/v5/middleware" +``` + ## 添加尾随斜杠 Add trailing slash 中间件会向请求 URI 添加尾随斜杠。