* Update dependencies and build to go1.22 * Fix api changes wrt to dependencies * Update golangci config
25 KiB
Changelog
v4.12.0 - 2024-04-15
Security
- Update golang.org/x/net dep because of GO-2024-2687 by @aldas in https://github.com/labstack/echo/pull/2625
Enhancements
- binder: make binding to Map work better with string destinations by @aldas in https://github.com/labstack/echo/pull/2554
- README.md: add Encore as sponsor by @marcuskohlberg in https://github.com/labstack/echo/pull/2579
- Reorder paragraphs in README.md by @aldas in https://github.com/labstack/echo/pull/2581
- CI: upgrade actions/checkout to v4 by @aldas in https://github.com/labstack/echo/pull/2584
- Remove default charset from 'application/json' Content-Type header by @doortts in https://github.com/labstack/echo/pull/2568
- CI: Use Go 1.22 by @aldas in https://github.com/labstack/echo/pull/2588
- binder: allow binding to a nil map by @georgmu in https://github.com/labstack/echo/pull/2574
- Add Skipper Unit Test In BasicBasicAuthConfig and Add More Detail Explanation regarding BasicAuthValidator by @RyoKusnadi in https://github.com/labstack/echo/pull/2461
- fix some typos by @teslaedison in https://github.com/labstack/echo/pull/2603
- fix: some typos by @pomadev in https://github.com/labstack/echo/pull/2596
- Allow ResponseWriters to unwrap writers when flushing/hijacking by @aldas in https://github.com/labstack/echo/pull/2595
- Add SPDX licence comments to files. by @aldas in https://github.com/labstack/echo/pull/2604
- Upgrade deps by @aldas in https://github.com/labstack/echo/pull/2605
- Change type definition blocks to single declarations. This helps copy… by @aldas in https://github.com/labstack/echo/pull/2606
- Fix Real IP logic by @cl-bvl in https://github.com/labstack/echo/pull/2550
- Default binder can use
UnmarshalParams(params []string) error
inter… by @aldas in https://github.com/labstack/echo/pull/2607 - Default binder can bind pointer to slice as struct field. For example
*[]string
by @aldas in https://github.com/labstack/echo/pull/2608 - Remove maxparam dependence from Context by @aldas in https://github.com/labstack/echo/pull/2611
- When route is registered with empty path it is normalized to
/
. by @aldas in https://github.com/labstack/echo/pull/2616 - proxy middleware should use httputil.ReverseProxy for SSE requests by @aldas in https://github.com/labstack/echo/pull/2624
v4.11.4 - 2023-12-20
Security
Enhancements
- Update deps and mark Go version to 1.18 as this is what golang.org/x/* use #2563
- Request logger: add example for Slog https://pkg.go.dev/log/slog #2543
v4.11.3 - 2023-11-07
Security
- 'c.Attachment' and 'c.Inline' should escape filename in 'Content-Disposition' header to avoid 'Reflect File Download' vulnerability. #2541
Enhancements
- Tests: refactor context tests to be separate functions #2540
- Proxy middleware: reuse echo request context #2537
- Mark unmarshallable yaml struct tags as ignored #2536
v4.11.2 - 2023-10-11
Security
- Bump golang.org/x/net to prevent CVE-2023-39325 / CVE-2023-44487 HTTP/2 Rapid Reset Attack #2527
- fix(sec): randomString bias introduced by #2490 #2492
- CSRF/RequestID mw: switch math/random usage to crypto/random #2490
Enhancements
- Delete unused context in body_limit.go #2483
- Use Go 1.21 in CI #2505
- Fix some typos #2511
- Allow CORS middleware to send Access-Control-Max-Age: 0 #2518
- Bump dependancies #2522
v4.11.1 - 2023-07-16
Fixes
- Fix
Gzip
middleware not sending response code for no content responses (404, 301/302 redirects etc) #2481
v4.11.0 - 2023-07-14
Fixes
- Fixes the proxy middleware concurrency issue of calling the Next() proxy target on Round Robin Balancer #2409
- Fix
group.RouteNotFound
not working when group has attached middlewares #2411 - Fix global error handler return error message when message is an error #2456
- Do not use global timeNow variables #2477
Enhancements
- Added a optional config variable to disable centralized error handler in recovery middleware #2410
- refactor: use
strings.ReplaceAll
directly #2424 - Add support for Go1.20
http.rwUnwrapper
to Response struct #2425 - Check whether is nil before invoking centralized error handling #2429
- Proper colon support in
echo.Reverse
method #2416 - Fix misuses of a vs an in documentation comments #2436
- Add link to slog.Handler library for Echo logging into README.md #2444
- In proxy middleware Support retries of failed proxy requests #2414
- gofmt fixes to comments #2452
- gzip response only if it exceeds a minimal length #2267
- Upgrade packages #2475
v4.10.2 - 2023-02-22
Security
filepath.Clean
behaviour has changed in Go 1.20 - adapt to it #2406- Add
middleware.CORSConfig.UnsafeWildcardOriginWithAllowCredentials
to make UNSAFE usages of wildcard origin + allow cretentials less likely #2405
Enhancements
- Add more HTTP error values #2277
v4.10.1 - 2023-02-19
Security
- Upgrade deps due to the latest golang.org/x/net vulnerability #2402
Enhancements
- Add new JWT repository to the README #2377
- Return an empty string for ctx.path if there is no registered path #2385
- Add context timeout middleware #2380
- Update link to jaegertracing #2394
v4.10.0 - 2022-12-27
Security
-
We are deprecating JWT middleware in this repository. Please use https://github.com/labstack/echo-jwt instead.
JWT middleware is moved to separate repository to allow us to bump/upgrade version of JWT implementation (
github.com/golang-jwt/jwt
) we are using which we can not do in Echo core because this would break backwards compatibility guarantees we try to maintain. -
This minor version bumps minimum Go version to 1.17 (from 1.16) due
golang.org/x/
packages we depend on. There are several vulnerabilities fixed in these libraries.Echo still tries to support last 4 Go versions but there are occasions we can not guarantee this promise.
Enhancements
- Bump x/text to 0.3.8 #2305
- Bump dependencies and add notes about Go releases we support #2336
- Add helper interface for ProxyBalancer interface #2316
- Expose
middleware.CreateExtractors
function so we can use it from echo-contrib repository #2338 - Refactor func(Context) error to HandlerFunc #2315
- Improve function comments #2329
- Add new method HTTPError.WithInternal #2340
- Replace io/ioutil package usages #2342
- Add staticcheck to CI flow #2343
- Replace relative path determination from proprietary to std #2345
- Remove square brackets from ipv6 addresses in XFF (X-Forwarded-For header) #2182
- Add testcases for some BodyLimit middleware configuration options #2350
- Additional configuration options for RequestLogger and Logger middleware #2341
- Add route to request log #2162
- GitHub Workflows security hardening #2358
- Add govulncheck to CI and bump dependencies #2362
- Fix rate limiter docs #2366
- Refactor how
e.Routes()
work and introducee.OnAddRouteHandler
callback #2337
v4.9.1 - 2022-10-12
Fixes
- Fix logger panicing (when template is set to empty) by bumping dependency version #2295
Enhancements
- Improve CORS documentation #2272
- Update readme about supported Go versions #2291
- Tests: improve error handling on closing body #2254
- Tests: refactor some of the assertions in tests #2275
- Tests: refactor assertions #2301
v4.9.0 - 2022-09-04
Security
- Fix open redirect vulnerability in handlers serving static directories (e.Static, e.StaticFs, echo.StaticDirectoryHandler) #2260
Enhancements
- Allow configuring ErrorHandler in CSRF middleware #2257
- Replace HTTP method constants in tests with stdlib constants #2247
v4.8.0 - 2022-08-10
Most notable things
You can now add any arbitrary HTTP method type as a route #2237
e.Add("COPY", "/*", func(c echo.Context) error
return c.String(http.StatusOK, "OK COPY")
})
You can add custom 404 handler for specific paths #2217
e.RouteNotFound("/*", func(c echo.Context) error { return c.NoContent(http.StatusNotFound) })
g := e.Group("/images")
g.RouteNotFound("/*", func(c echo.Context) error { return c.NoContent(http.StatusNotFound) })
Enhancements
- Add new value binding methods (UnixTimeMilli,TextUnmarshaler,JSONUnmarshaler) to Valuebinder #2127
- Refactor: body_limit middleware unit test #2145
- Refactor: Timeout mw: rework how test waits for timeout. #2187
- BasicAuth middleware returns 500 InternalServerError on invalid base64 strings but should return 400 #2191
- Refactor: duplicated findStaticChild process at findChildWithLabel #2176
- Allow different param names in different methods with same path scheme #2209
- Add support for registering handlers for different 404 routes #2217
- Middlewares should use errors.As() instead of type assertion on HTTPError #2227
- Allow arbitrary HTTP method types to be added as routes #2237
v4.7.2 - 2022-03-16
Fixes
- Fix nil pointer exception when calling Start again after address binding error #2131
- Fix CSRF middleware not being able to extract token from multipart/form-data form #2136
- Fix Timeout middleware write race #2126
Enhancements
- Recover middleware should not log panic for aborted handler #2134
v4.7.1 - 2022-03-13
Fixes
- Fix
e.Static
,.File()
,c.Attachment()
being picky with paths starting with./
,../
and/
after 4.7.0 introduced echo.Filesystem support (Go1.16+) #2123
Enhancements
- Remove some unused code #2116
v4.7.0 - 2022-03-01
Enhancements
- Add JWT, KeyAuth, CSRF multivalue extractors #2060
- Add LogErrorFunc to recover middleware #2072
- Add support for HEAD method query params binding #2027
- Improve filesystem support with echo.FileFS, echo.StaticFS, group.FileFS, group.StaticFS #2064
Fixes
General
- Add cache-control and connection headers #2103
- Add Retry-After header constant #2078
- Upgrade
go
directive ingo.mod
to 1.17 #2049 - Add Pagoda #2077 and Souin #2069 to 3rd-party middlewares in README
v4.6.3 - 2022-01-10
Fixes
- Fixed Echo version number in greeting message which was not incremented to
4.6.2
#2066
v4.6.2 - 2022-01-08
Fixes
- Fixed route containing escaped colon should be matchable but is not matched to request path #2047
- Fixed a problem that returned wrong content-encoding when the gzip compressed content was empty. #1921
- Update (test) dependencies #2021
Enhancements
- Add support for configurable target header for the request_id middleware #2040
- Change decompress middleware to use stream decompression instead of buffering #2018
- Documentation updates
v4.6.1 - 2021-09-26
Enhancements
- Add start time to request logger middleware values #1991
v4.6.0 - 2021-09-20
Introduced a new request logger middleware to help with cases when you want to use some other logging library in your application.
Fixes
- fix timeout middleware warning: superfluous response.WriteHeader #1905
Enhancements
- Add Cookie to KeyAuth middleware's KeyLookup #1929
- JWT middleware should ignore case of auth scheme in request header #1951
- Refactor default error handler to return first if response is already committed #1956
- Added request logger middleware which helps to use custom logger library for logging requests. #1980
- Allow escaping of colon in route path so Google Cloud API "custom methods" could be implemented #1988
v4.5.0 - 2021-08-01
Important notes
A BREAKING CHANGE is introduced for JWT middleware users. The JWT library used for the JWT middleware had to be changed from github.com/dgrijalva/jwt-go to github.com/golang-jwt/jwt due former library being unmaintained and affected by security issues. The github.com/golang-jwt/jwt project is a drop-in replacement, but supports only the latest 2 Go versions. So for JWT middleware users Go 1.15+ is required. For detailed information please read #1940
To change the library imports in all .go files in your project replace all occurrences of dgrijalva/jwt-go
with golang-jwt/jwt
.
For Linux CLI you can use:
find -type f -name "*.go" -exec sed -i "s/dgrijalva\/jwt-go/golang-jwt\/jwt/g" {} \;
go mod tidy
Fixes
- Change JWT library to
github.com/golang-jwt/jwt
#1946
v4.4.0 - 2021-07-12
Fixes
- Split HeaderXForwardedFor header only by comma #1878
- Fix Timeout middleware Context propagation #1910
Enhancements
- Bind data using headers as source #1866
- Adds JWTConfig.ParseTokenFunc to JWT middleware to allow different libraries implementing JWT parsing. #1887
- Adding tests for Echo#Host #1895
- Adds RequestIDHandler function to RequestID middleware #1898
- Allow for custom JSON encoding implementations #1880
v4.3.0 - 2021-05-08
Important notes
- Route matching has improvements for following cases:
- Correctly match routes with parameter part as last part of route (with trailing backslash)
- Considering handlers when resolving routes and search for matching http method handler
- Echo minimal Go version is now 1.13.
Fixes
- When url ends with slash first param route is the match #1804
- Router should check if node is suitable as matching route by path+method and if not then continue search in tree #1808
- Fix timeout middleware not writing response correctly when handler panics #1864
- Fix binder not working with embedded pointer structs #1861
- Add Go 1.16 to CI and drop 1.12 specific code #1850
Enhancements
- Make KeyFunc public in JWT middleware #1756
- Add support for optional filesystem to the static middleware #1797
- Add a custom error handler to key-auth middleware #1847
- Allow JWT token to be looked up from multiple sources #1845
v4.2.2 - 2021-04-07
Fixes
- Allow proxy middleware to use query part in rewrite (#1802)
- Fix timeout middleware not sending status code when handler returns an error (#1805)
- Fix Bind() when target is array/slice and path/query params complains bind target not being struct (#1835)
- Fix panic in redirect middleware on short host name (#1813)
- Fix timeout middleware docs (#1836)
v4.2.1 - 2021-03-08
Important notes
Due to a datarace the config parameters for the newly added timeout middleware required a change. See the docs. A performance regression has been fixed, even bringing better performance than before for some routing scenarios.
Fixes
- Fix performance regression caused by path escaping (#1777, #1798, #1799, aldas)
- Avoid context canceled errors (#1789, clwluvw)
- Improve router to use on stack backtracking (#1791, aldas, stffabi)
- Fix panic in timeout middleware not being not recovered and cause application crash (#1794, aldas)
- Fix Echo.Serve() not serving on HTTP port correctly when TLSListener is used (#1785, #1793, aldas)
- Apply go fmt (#1788, Le0tk0k)
- Uses strings.Equalfold (#1790, rkilingr)
- Improve code quality (#1792, withshubh)
This release was made possible by our contributors: aldas, clwluvw, lammel, Le0tk0k, maciej-jezierski, rkilingr, stffabi, withshubh
v4.2.0 - 2021-02-11
Important notes
The behaviour for binding data has been reworked for compatibility with echo before v4.1.11 by
enforcing explicit tagging
for processing parameters. This may break your code if you
expect combined handling of query/path/form params.
Please see the updated documentation for request and binding
The handling for rewrite rules has been slightly adjusted to expand *
to a non-greedy (.*?)
capture group. This is only relevant if multiple asterisks are used in your rules.
Please see rewrite and proxy for details.
Security
- Fix directory traversal vulnerability for Windows (#1718, little-cui)
- Fix open redirect vulnerability with trailing slash (#1771,#1775 aldas,GeoffreyFrogeye)
Enhancements
- Add Echo#ListenerNetwork as configuration (#1667, pafuent)
- Add ability to change the status code using response beforeFuncs (#1706, RashadAnsari)
- Echo server startup to allow data race free access to listener address
- Binder: Restore pre v4.1.11 behaviour for c.Bind() to use query params only for GET or DELETE methods (#1727, aldas)
- Binder: Add separate methods to bind only query params, path params or request body (#1681, aldas)
- Binder: New fluent binder for query/path/form parameter binding (#1717, #1736, aldas)
- Router: Performance improvements for missed routes (#1689, pafuent)
- Router: Improve performance for Real-IP detection using IndexByte instead of Split (#1640, imxyb)
- Middleware: Support real regex rules for rewrite and proxy middleware (#1767)
- Middleware: New rate limiting middleware (#1724, iambenkay)
- Middleware: New timeout middleware implementation for go1.13+ (#1743, )
- Middleware: Allow regex pattern for CORS middleware (#1623, KlotzAndrew)
- Middleware: Add IgnoreBase parameter to static middleware (#1701, lnenad, iambenkay)
- Middleware: Add an optional custom function to CORS middleware to validate origin (#1651, curvegrid)
- Middleware: Support form fields in JWT middleware (#1704, rkfg)
- Middleware: Use sync.Pool for (de)compress middleware to improve performance (#1699, #1672, pafuent)
- Middleware: Add decompress middleware to support gzip compressed requests (#1687, arun0009)
- Middleware: Add ErrJWTInvalid for JWT middleware (#1627, juanbelieni)
- Middleware: Add SameSite mode for CSRF cookies to support iframes (#1524, pr0head)
Fixes
- Fix handling of special trailing slash case for partial prefix (#1741, stffabi)
- Fix handling of static routes with trailing slash (#1747)
- Fix Static files route not working (#1671, pwli0755, lammel)
- Fix use of caret(^) in regex for rewrite middleware (#1588, chotow)
- Fix Echo#Reverse for Any type routes (#1695, pafuent)
- Fix Router#Find panic with infinite loop (#1661, pafuent)
- Fix Router#Find panic fails on Param paths (#1659, pafuent)
- Fix DefaultHTTPErrorHandler with Debug=true (#1477, lammel)
- Fix incorrect CORS headers (#1669, ulasakdeniz)
- Fix proxy middleware rewritePath to use url with updated tests (#1630, arun0009)
- Fix rewritePath for proxy middleware to use escaped path in (#1628, arun0009)
- Remove unless defer (#1656, imxyb)
General
- New maintainers for Echo: Roland Lammel (@lammel) and Pablo Andres Fuente (@pafuent)
- Add GitHub action to compare benchmarks (#1702, pafuent)
- Binding query/path params and form fields to struct only works for explicit tags (#1729,#1734, aldas)
- Add support for Go 1.15 in CI (#1683, asahasrabuddhe)
- Add test for request id to remain unchanged if provided (#1719, iambenkay)
- Refactor echo instance listener access and startup to speed up testing (#1735, aldas)
- Refactor and improve various tests for binding and routing
- Run test workflow only for relevant changes (#1637, #1636, pofl)
- Update .travis.yml (#1662, santosh653)
- Update README.md with an recents framework benchmark (#1679, pafuent)
This release was made possible by over 100 commits from more than 20 contributors: asahasrabuddhe, aldas, AndrewKlotz, arun0009, chotow, curvegrid, iambenkay, imxyb, juanbelieni, lammel, little-cui, lnenad, pafuent, pofl, pr0head, pwli, RashadAnsari, rkfg, santosh653, segfiner, stffabi, ulasakdeniz