File tree Expand file tree Collapse file tree 2 files changed +38
-1
lines changed
Expand file tree Collapse file tree 2 files changed +38
-1
lines changed Original file line number Diff line number Diff line change 11# Changelog
22
3+ ## v5.0.0 - 2026-01-18
4+
5+ Echo ` v5 ` is maintenance release with ** major breaking changes**
6+ - ` Context ` is now struct instead of interface and we can add method to it in the future in minor versions.
7+ - Adds new ` Router ` interface for possible new routing implementations.
8+ - Drops old logging interface and uses moderm ` log/slog ` instead.
9+ - Rearranges alot of methods/function signatures to make them more consistent.
10+
11+ Upgrade notes and ` v4 ` support:
12+ - Echo ` v4 ` is supported with ** security*** updates and ** bug** fixes until ** 2026-12-31**
13+ - If you are using Echo in a production environment, it is recommended to wait until after 2026-03-31 before upgrading.
14+ - Until 2026-03-31, any critical issues requiring breaking ` v5 ` API changes will be addressed, even if this violates semantic versioning.
15+
16+ See [ API_CHANGES_V5.md] ( ./API_CHANGES_V5.md ) for public API changes between ` v4 ` and ` v5 ` , notes on ** upgrading** .
17+
18+ Upgrading TLDR:
19+
20+ If you are using Linux you can migrate easier parts like that:
21+ ``` bash
22+ find . -type f -name " *.go" -exec sed -i ' s/ echo.Context/ *echo.Context/g' {} +
23+ find . -type f -name " *.go" -exec sed -i ' s/echo\/v4/echo\/v5/g' {} +
24+ ```
25+ macOS
26+ ``` bash
27+ find . -type f -name " *.go" -exec sed -i ' ' ' s/ echo.Context/ *echo.Context/g' {} +
28+ find . -type f -name " *.go" -exec sed -i ' ' ' s/echo\/v4/echo\/v5/g' {} +
29+ ```
30+
31+ or in your favorite IDE
32+
33+ Replace all:
34+ 1 . ` echo.Context ` -> ` *echo.Context `
35+ 2 . ` echo/v4 ` -> ` echo/v5 `
36+
37+ This should solve most of the issues. Probably the hardest part is updating all the tests.
38+
39+
340## v4.15.0 - 2026-01-01
441
542
Original file line number Diff line number Diff line change @@ -5,5 +5,5 @@ package echo
55
66const (
77 // Version of Echo
8- Version = "5.0.0-alpha "
8+ Version = "5.0.0"
99)
You can’t perform that action at this time.
0 commit comments