Understanding the "kitchen sink" PHP extension

[flexseth]

• [ ] Update docs: Pending PR (mentioned)
• [ ] How to limit the kitchen sink - disabling PHP extensions or enabling one-by-one...?

Getting started with Blueprints

Blueprint sample

{
    "$schema": "https://playground.wordpress.net/blueprint-schema.json",
    "landingPage": "/wp-admin/",
    "preferredVersions": {
        "php": "8.0",
        "wp": "latest"
    },
    "phpExtensionBundles": ["kitchen-sink"],
    "steps": [
        {
            "step": "login",
            "username": "admin",
            "password": "password"
        }
    ]
}

[flexseth]

https://wordpress.github.io/wordpress-playground/query-api/

gd, mbstring, iconv, openssl, libxml, xml, dom, simplexml, xmlreader, xmlwriter

• [ ] Clarify: Is this all of the extensions included?
• [ ] Discuss: Providing a brief explanation and linking out to extension info pages
• [ ] Drill-down: Common functionality these extension libraries provide for WordPress
• [ ] Common errors: What happens if you don't include a necessary extension? Show codes

Package explanations

Existing packages that need docs

• gd
  • https://github.com/WordPress/wordpress-playground/issues/1190#issuecomment-2034932366
• mbstring
• iconv
• openssl
• libxml, xml, simplexml, xmlreader, xmlwriter
• dom

To document (new)

fileInfo

• https://github.com/WordPress/wordpress-playground/pull/1179

[flexseth]

@adamziel wonders if the kitchen-sink "light" option should be by default

• https://github.com/WordPress/wordpress-playground/pull/1191#issuecomment-2035817797

[flexseth]

• [x] Add links to libraries
• [x] Show a couple of examples of what the libraries do with WordPress - unnecessary
• [x] How to limit the kitchen sink - mentioned in top-level issue
• [x] Turn off the kitchen sink - disabled by default

Kitchen sink discussion https://github.com/WordPress/wordpress-playground/pull/1191#issuecomment-2080230179

[adamziel]

Let’s contain the docs discussion in this issue.

Are there more utilities? In lieu of digging through the repo and trying to figure it out, figured I'd ask here :)

Just those

Also, are these good representations what the libraries do?

No, these extensions offer many features and can be used in various ways. There’s no need to explain beyond listing them and linking out to php.net. People who need those extensions already know, and there’s no need to rewrite php docs for people who don’t need those extensions yet.

Are they all PHP extensions?

Yes