v0.20.0
版本发布时间: 2023-12-10 21:24:06
pocketbase/pocketbase最新发布版本:v0.22.21(2024-09-18 11:56:49)
To update the prebuilt executable you can run
./pocketbase update
.
-
Added
expand
,filter
,fields
, custom query and headers parameters support for the realtime subscriptions. Requires JS SDK v0.20.0+ or Dart SDK v0.17.0+.// JS SDK v0.20.0 pb.collection("example").subscribe("*", (e) => { ... }, { expand: "someRelField", filter: "status = 'active'", fields: "id,expand.someRelField.*:excerpt(100)", })
// Dart SDK v0.17.0 pb.collection("example").subscribe("*", (e) { ... }, expand: "someRelField", filter: "status = 'active'", fields: "id,expand.someRelField.*:excerpt(100)", )
-
Generalized the logs to allow any kind of application logs, not just requests.
The new
app.Logger()
implements the standardlog/slog
interfaces available with Go 1.21.// Go: https://pocketbase.io/docs/go-logging/ app.Logger().Info("Example message", "total", 123, "details", "lorem ipsum...") // JS: https://pocketbase.io/docs/js-logging/ $app.logger().info("Example message", "total", 123, "details", "lorem ipsum...")
For better performance and to minimize blocking on hot paths, logs are currently written with debounce and on batches:
- 3 seconds after the last debounced log write - when the batch threshold is reached (currently 200) - right before app termination to attempt saving everything from the existing logs queue
Some notable log related changes:
-
⚠️ Bumped the minimum required Go version to 1.21.
-
⚠️ Removed
_requests
table in favor of the generalized_logs
. Note that existing logs will be deleted! -
⚠️ Renamed the following
Dao
log methods:Dao.RequestQuery(...) -> Dao.LogQuery(...) Dao.FindRequestById(...) -> Dao.FindLogById(...) Dao.RequestsStats(...) -> Dao.LogsStats(...) Dao.DeleteOldRequests(...) -> Dao.DeleteOldLogs(...) Dao.SaveRequest(...) -> Dao.SaveLog(...)
-
⚠️ Removed
app.IsDebug()
and the--debug
flag. This was done to avoid the confusion with the new logger and its debug severity level. If you want to store debug logs you can set-4
as min log level from the Admin UI. -
Refactored Admin UI Logs:
- Added new logs table listing.
- Added log settings option to toggle the IP logging for the activity logger.
- Added log settings option to specify a minimum log level.
- Added controls to export individual or bulk selected logs as json.
- Other minor improvements and fixes.
-
-
Added new
filesystem/System.Copy(src, dest)
method to copy existing files from one location to another. This is usually useful when duplicating records withfile
field(s) programmatically. -
Added
filesystem.NewFileFromUrl(ctx, url)
helper method to construct a*filesystem.BytesReader
file from the specified url. -
OAuth2 related additions:
-
Added new
PKCE()
andSetPKCE(enable)
OAuth2 methods to indicate whether the PKCE flow is supported or not. The PKCE value is currently configurable from the UI only for the OIDC providers. This was added to accommodate OIDC providers that may throw an error if unsupported PKCE params are submitted with the auth request (eg. LinkedIn; see #3799). -
Added new
displayName
field for eachlistAuthMethods()
OAuth2 provider item. The value of thedisplayName
property is currently configurable from the UI only for the OIDC providers. -
Added
expiry
field to the OAuth2 user response containing the optional expiration time of the OAuth2 access token (#3617). -
Allow a single OAuth2 user to be used for authentication in multiple auth collection. ⚠️ Because now you can have more than one external provider with
collectionId-provider-providerId
pair,Dao.FindExternalAuthByProvider(provider, providerId)
method was removed in favour of the more genericDao.FindFirstExternalAuthByExpr(expr)
.
-
-
Added
onlyVerified
auth collection option to globally disallow authentication requests for unverified users. -
Added support for single line comments (ex.
// your comment
) in the API rules and filter expressions. -
Added support for specifying a collection alias in
@collection.someCollection:alias.*
. -
Soft-deprecated and renamed
app.Cache()
withapp.Store()
. -
Minor JSVM updates and fixes:
-
Updated
$security.parseUnverifiedJWT(token)
and$security.parseJWT(token, key)
to return the token payload result as plain object. -
Added
$apis.requireGuestOnly()
middleware JSVM binding (#3896).
-
-
Use
IS NOT
instead of!=
as not-equal SQL query operator to handle the cases when comparing with nullable columns or expressions (eg.json_extract
overjson
field). Based on my local dataset I wasn't able to find a significant difference in the performance between the 2 operators, but if you stumble on a query that you think may be affected negatively by this, please report it and I'll test it further. -
Added
MaxSize
json
field option to prevent storing large json data in the db (#3790). Existingjson
fields are updated with a system migration to have a ~2MB size limit (it can be adjusted from the Admin UI). -
Fixed negative string number normalization support for the
json
field type. -
Trigger the
app.OnTerminate()
hook onapp.Restart()
call. A new boolIsRestart
field was also added to thecore.TerminateEvent
event. -
Fixed graceful shutdown handling and speed up a little the app termination time.
-
Limit the concurrent thumbs generation to avoid high CPU and memory usage in spiky scenarios (#3794; thanks @t-muehlberger). Currently the max concurrent thumbs generation processes are limited to "total of logical process CPUs + 1". This is arbitrary chosen and may change in the future depending on the users feedback and usage patterns. If you are experiencing OOM errors during large image thumb generations, especially in container environment, you can try defining the
GOMEMLIMIT=500MiB
env variable before starting the executable. -
Slightly speed up (~10%) the thumbs generation by changing from cubic (
CatmullRom
) to bilinear (Linear
) resampling filter (the quality difference is very little). -
Added a default red colored Stderr output in case of a console command error. You can now also silence individually custom commands errors using the
cobra.Command.SilenceErrors
field. -
Fixed links formatting in the autogenerated html->text mail body.
-
Removed incorrectly imported empty
local('')
font-face declarations.
1、 checksums.txt 706B
2、 pocketbase_0.20.0_darwin_amd64.zip 15.25MB
3、 pocketbase_0.20.0_darwin_arm64.zip 14.89MB
4、 pocketbase_0.20.0_linux_amd64.zip 14.65MB
5、 pocketbase_0.20.0_linux_arm64.zip 13.69MB
6、 pocketbase_0.20.0_linux_armv7.zip 13.99MB
7、 pocketbase_0.20.0_windows_amd64.zip 15MB
8、 pocketbase_0.20.0_windows_arm64.zip 13.79MB