Skip to content

chore(gateway): Log PCRE upgrade breaking change in 3.7 #4972

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lena-larionova merged 2 commits into from
Apr 22, 2026
+12 −1
Merged

chore(gateway): Log PCRE upgrade breaking change in 3.7 #4972

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e2db168
document pcre breaking change in 3.7
lena-larionova Apr 22, 2026
ae18fa3
Apply suggestions from code review
lena-larionova Apr 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion app/_includes/upgrade/lts-changes-34-310.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -187,7 +187,12 @@ rows:
While the `+` character represents the correct encoding of space in query strings, Kong uses `%20` in many other APIs, which is inherited from Nginx/OpenResty.
action: |
No

- category: Dependencies
description: |
PCRE was upgraded from `libpcre` 8.45 to `libpcre2` 10.43.
This upgrade changes the expected regex syntax, and any incompatible regular expressions will prevent {{site.base_gateway}} from applying configuration.
Comment thread
lena-larionova marked this conversation as resolved.
Outdated
action: |
Review any regexes in your entity configuration and adjust based on the [PCRE2 syntax reference](https://www.pcre.org/current/doc/html/pcre2syntax.html).
Comment thread
lena-larionova marked this conversation as resolved.
Outdated
{% endtable %}


Expand Down
6 changes: 6 additions & 0 deletions app/gateway/breaking-changes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -819,6 +819,12 @@ entity when using the AppRole authentication method.
[**AI Proxy**](/plugins/ai-proxy/) (`ai-proxy`): To support the new messages API of `Anthropic`, the upstream
path of the `anthropic` setting for the `llm/v1/chat` Route type has changed from `/v1/complete` to `/v1/messages`.

#### PCRE version bump

{{site.base_gateway}} 3.7 upgrades PCRE from `libpcre` 8.45 to `libpcre2` 10.43.
This upgrade changes the expected regex syntax, and any incompatible regular expressions will prevent {{site.base_gateway}} from applying configuration.
Comment thread
lena-larionova marked this conversation as resolved.
Outdated
See the [PCRE2 syntax reference](https://www.pcre.org/current/doc/html/pcre2syntax.html) for more information on how to adjust your regexes.

#### Known issues in 3.7.0.0

The following is a list of known issues in 3.7.x that may be fixed in a future release.
Expand Down
Loading