[Website] IDE-like PHP playground #2699
Merged
Conversation
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
…t more CLI commands, compute the current edited file path
adamziel
added a commit
that referenced
this pull request
Sep 30, 2025
Introduced sandboxedSpawnHandlerFactory support for `ls` and `pwd` commands. This will help Playground provide a useful terminal. A part of #2699 ## Testing instructions CI – this PR comes with a unit test.
adamziel
added a commit
that referenced
this pull request
Sep 30, 2025
## Motivation for the change, related issues Pre-requisite for #2699. Empowers developers to create terminal-enabled apps by exporting the `splitShellCommand()` utility that was internal before. ```ts import { splitShellCommand } from "@php-wasm/util"; splitShellCommand('wp create post --title="Great post title!"'); ['wp', 'create', 'post', '--title=Great post title!'] ```
adamziel
added
[Type] Enhancement
akirk
reviewed
Oct 1, 2025
Comment on lines
+4
to
+5
| export const DEFAULT_WP_REMOTE = 'http://127.0.0.1:5400/remote.html'; | ||
| // export const DEFAULT_WP_REMOTE = 'https://playground.wordpress.net/remote.html'; |
There was a problem hiding this comment.
I think this is the reason for the error on https://playground.wordpress.net/beta-php-playground.html
There was a problem hiding this comment.
yup, I'm adjusting this at #2717. We'll need some e2e tests, too, to make sure it keeps working
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.
Motivation for the change, related issues
Introduces a beta version of PHP Playground that has a file explorer and a built-in terminal with
php,wp, andcomposercommands available:It does not replace the existing PHP Playground, only introduces a new beta version. We won't replace the existing one until a few people confirm the new one is useful and stable.
After merging and deploying, it will be available at https://playground.wordpress.net/beta-php-playground.html
This PR supersedes #2694
Implementation details
This PR ships mostly new code and updates code unused anywhere else. The few changes it makes to the shared configuration are non-destructive and mostly don't affect the existing packages.
FilePickerTree component
Ships a substantial update to the FilePickerTree component to:
It seems like it breaks the "type to focus" interaction. That's fine, we'll fix it in a follow-up. That component isn't used anywhere else at the moment so we're not breaking any other page.
It also ships a few e2e tests to be expanded
New package
This PR ships an additional
website-extraspackage with the beta version of PHP Playground. Why a new package? Because thewebsitepackages is built offline-first. We have manifest.json automations in place for PWAs so browsers can download and cache most of the built files. Maintaining a clear separation between required and optional files is a substantial burden. Hence, this PR takes another approach entirely and clearly separates the offline-first parts from the parts we don't need to ask the client to download pre-emptively.The nx build pipeline will build the
remotepackage, thewebsitepackage, build the list of assets required for offline mode, prepare the website deployment, and only then it will merge thewebsite-extrasinto that deployment directory.Testing Instructions (or ideally a Blueprint)
Go to http://127.0.0.1:5400/website-extras/beta-php-playground.html and play with the beta PHP Playground.