docs(pie): INSTALL-PIE.md + Packagist API update in publish-release#562
Merged
Conversation
…485) - Add docs/packaging/INSTALL-PIE.md with PIE install instructions for both satwareag/php-firebird and satwareag/pdo-fbird - Add Packagist API update step to publish-release.yml (replaces broken webhooks that return 403 'Invalid github signature') - Requires PACKAGIST_API_TOKEN GitHub secret (from packagist.org/profile) Relates: #485
9 tasks
Per Packagist docs: payload must be {"repository":{"url":"PACKAGE_URL"}}
not {"url":"REPO_URL"}. Also use query-param auth (username+apiToken)
instead of Bearer auth, and reference the Packagist package URL (not the
GitHub repo URL).
Added PACKAGIST_USERNAME secret (also set on GitHub).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Completes the remaining acceptance criteria of #485 (Packagist PIE discovery).
Changes
docs/packaging/INSTALL-PIE.md (new)
Full PIE installation guide covering:
satwareag/php-firebird+satwareag/pdo-fbird.github/workflows/publish-release.yml
Added Packagist API update step after release publication.
Why: The GitHub webhooks to Packagist return
403 "Invalid github signature"on every push. Packagist explicitly says: "Delete this webhook and recreate it using the manual account sync trigger." Instead of relying on webhooks, this step calls the Packagist API directly to trigger a package update after each release. The broken webhooks have been deleted.Requires:
PACKAGIST_API_TOKENGitHub secret (from https://packagist.org/profile). The step is conditional (if: env.PACKAGIST_API_TOKEN != '') so it silently skips if the secret is not set.Current Packagist Status
satwareag/php-firebirdsatwareag/pdo-fbirddev-mainBoth packages are registered and indexed. The missing versions (v13.0.1, v13.0.1-rc.1, v13.0.2) are because the webhook was broken. Once
PACKAGIST_API_TOKENis set and this PR merges, the next release will automatically trigger a Packagist update.Acceptance Criteria Status (#485)
composer.jsonhasphp-extsectionpdo_fbird/composer.jsonexistssplit-stubs.ymlcreatessatwareAG/pdo-fbirdreposatwareag/php-firebirdsubmitted to Packagistsatwareag/pdo-fbirdsubmitted to PackagistPACKAGIST_API_TOKENGitHub secret needs to be set by repo adminpie install satwareag/php-firebirdon clean machine (post-merge)pie install satwareag/pdo-fbirdon clean machine (post-merge)docs/packaging/INSTALL-PIE.mdWhat needs to happen after merge
PACKAGIST_API_TOKENsecret: Repo admin goes to https://packagist.org/profile, copies their API token, and adds it as a GitHub secret namedPACKAGIST_API_TOKENpie install satwareag/php-firebirdon a clean machine