Skip to content

Add PGXN distribution metadata (META.json) - #37

Merged
jdatcmd merged 2 commits into
masterfrom
pgxn-meta
Aug 26, 2026
Merged

Add PGXN distribution metadata (META.json)#37
jdatcmd merged 2 commits into
masterfrom
pgxn-meta

Conversation

@jdatcmd

@jdatcmd jdatcmd commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Adds the packaging metadata PL/php needs to be published on PGXN, so it can be installed with pgxn install plphp.

META.json

Conforms to version 1.0.0 of the PGXN distribution metadata spec. Distribution version 2.6.0, license postgresql, runtime prereq PostgreSQL >= 11.0.0. The provides map declares all four extensions in the tree with their own versions:

extension file version
plphp plphp--2.6.sql 2.6.0
jsonb_plphp jsonb_plphp/jsonb_plphp--1.0.sql 1.0.0
hstore_plphp hstore_plphp/hstore_plphp--1.0.sql 1.0.0
bytea_plphp bytea_plphp/bytea_plphp--1.0.sql 1.0.0

doc/plphp.md is registered as the docfile for plphp, so PGXN renders the language reference as the distribution's documentation.

Also in this PR

Documents the PGXN install path in README and INSTALL, and corrects two stale statements noticed while editing those sections: the README test-count badge (said 17, the suite is 26) and the INSTALL note that described a single optional jsonb transform (there are now three).

Verification

  • META.json validates with PGXN::Meta::Validator 0.16.0: valid.
  • The release archive was built exactly as PGXN will receive it (git archive --prefix=plphp-2.6.0/), extracted clean in the build container, and built and tested from that extract against PostgreSQL 18: 26/26 core tests pass, plus 1/1 for each of the three transform suites.

🤖 Generated with Claude Code

OffgridwithJD and others added 2 commits August 26, 2026 11:11
Adds a META.json conforming to version 1.0.0 of the PGXN distribution
metadata spec so PL/php can be released on PGXN and installed with
"pgxn install plphp".  It declares the four extensions the distribution
provides: plphp itself plus the jsonb_plphp, hstore_plphp, and
bytea_plphp transforms, each with its own version.  Validated with
PGXN::Meta::Validator 0.16.0.

While documenting the PGXN install path in README and INSTALL, corrects
two stale statements: the README test-count badge (17, now 26) and the
INSTALL note that described a single optional jsonb transform.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The repository was renamed from PL-php to plPHP.  The old URLs redirect,
but PGXN releases are permanent, so record the canonical name.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@jdatcmd
jdatcmd merged commit ef66fe7 into master Aug 26, 2026
12 checks passed
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.

2 participants