Skip to content

frankenphp: build the Mercure hub with its 0.x compatibility tags - #1240

Merged
henderkes merged 1 commit into
crazywhalecc:v3from
dunglas:frankenphp-mercure-compat-tags
Sep 8, 2026
Merged

frankenphp: build the Mercure hub with its 0.x compatibility tags#1240
henderkes merged 1 commit into
crazywhalecc:v3from
dunglas:frankenphp-mercure-compat-tags

Conversation

@dunglas

@dunglas dunglas commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Mercure 1.0 (https://github.com/dunglas/mercure/releases/tag/v1.0.0-alpha.3) gates its 0.x behaviors behind two build tags, deprecated_topic and deprecated_claim, and only honors them when the Caddyfile sets protocol_version_compatibility 8. Without the tags, a hub in compatibility mode rejects 0.x tokens and topic= selectors outright.

FrankenPHP is adopting the 1.0 hub in php/frankenphp#2611 and ships both tags in its Docker images and CI builds, like the official Mercure binaries, so users can migrate progressively. Static binaries take their -tags list from here, and GOFLAGS cannot add to a -tags given on the command line, hence this change.

Go ignores unknown build tags, so FrankenPHP versions still on Mercure 0.24 build unchanged.

Mercure 1.0 gates its 0.x behaviors (legacy mercure claim, topic= selectors)
behind the deprecated_topic and deprecated_claim build tags, only honored
when the Caddyfile sets protocol_version_compatibility 8. FrankenPHP ships
them in its Docker images and CI builds so users can migrate progressively;
static binaries get their tags from here.

Go ignores unknown tags, so FrankenPHP versions still on Mercure 0.x build
unchanged.
@henderkes

Copy link
Copy Markdown
Collaborator

For this to take any effect, we need to switch to spc v3 which is still open because I don't have a mac to fix x86.

@henderkes
henderkes merged commit c81da11 into crazywhalecc:v3 Sep 8, 2026
8 checks passed
henderkes added a commit that referenced this pull request Sep 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants