Switch WordPress Composer guides from WPackagist to WP Packages and roots/wordpress#5557
Open
retlehs wants to merge 2 commits into
Open
Switch WordPress Composer guides from WPackagist to WP Packages and roots/wordpress#5557retlehs wants to merge 2 commits into
retlehs wants to merge 2 commits into
Conversation
This was referenced May 4, 2026
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
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.
This PR updates Platform.sh's WordPress Composer guides to use WP Packages (instead of WPackagist) and
roots/wordpress(instead ofjohnpbloch/wordpress-core).Disclosure: I maintain WP Packages and Bedrock. The tables below try to be even-handed — flag anything that reads as biased and I'll fix it.
WPackagist vs WP Packages
metadata-urljohnpbloch/wordpress-corevsroots/wordpressjohnpbloch/wordpress-coreroots/wordpressroots/wordpress,-full,-no-contentroots/wordpress-full)johnpbloch/wordpress-core-installer ^2.0)roots/wordpress(no separate require needed)Files intentionally left alone
These reference Platform.sh's
platformsh-templates/wordpress-composertemplate (andupsun/snippets/wordpress-composer), which usejohnpblochinternally. I left them as-is to avoid documenting one stack while pointing readers at a different one — but worth flagging thatplatformsh-templates/wordpress-composeris now marked "no longer maintained" (same aswordpress-bedrock). If those templates are being sunset, these guides may want their own pass to either point at maintained alternatives or use upstream Bedrock directly (the approach the Upsun bedrock guide already takes):sites/platform/src/guides/wordpress/deploy/_index.md— heavily template-bound; explicitly documents thewordpress-composertemplate's structureshared/data/templates.yamlL602 — template metadatasites/upsun/src/get-started/stacks/wordpress/composer.md— references the upsun snippets WordPress Composer exampleBedrock-flavored guides already in sync
The Upsun bedrock guide (
sites/upsun/src/get-started/stacks/wordpress/bedrock.md) delegates to upstream Bedrock viacomposer create-project roots/bedrock, which already uses WP Packages and droppedroots/wp-password-bcrypt(current Bedrock removed it after WP 6.8 shipped native bcrypt). No changes needed there — flagging for completeness.Companion PRs
Even though the two template repos are marked "no longer maintained," I've also opened community-contribution PRs to refresh them — in case those templates aren't fully sunset and/or for the benefit of anyone forking them:
platformsh-templates/wordpress-composer#470— switches the template fromjohnpbloch/wordpress-coretoroots/wordpressand from WPackagist to WP Packagesplatformsh-templates/wordpress-bedrock#1010— syncs the template with current upstream Bedrock (dropswp-password-bcrypt, adopts WP Packages, modernizesconfig/application.php)Open to feedback on framing. Happy to close if it's not the direction you want.