WP-CLI v2.12.0 Release Notes  🔗 **Source:** [WP-CLI v2.12.0 Release Notes](https://make.wordpress.org/cli/2025/05/07/wp-cli-v2-12-0-release-notes/) > [!note]+ Document Notes > tags: > - #wp-cli > - #release > - #wordpress > Author: Alain Schlesser > Source: Make WordPress – WP-CLI Blog > Reference: https://make.wordpress.org/cli/2025/05/07/wp-cli-v2-12-0-release-notes/ > date created: 2025-05-07 14:30 > > # Title: WP-CLI v2.12.0 Release Notes > <!-- deep-read:sections start --> ## Table of Contents: - [📝 Summary](#📝-summary) - [📖 Main Content](#📖-main-content) - [🗒️ Notes](#🗒️-notes) - [📖 References](#📖-references) - [🗣️ Paraphrase](#🗣️-paraphrase) - [📰 Newsletter](#📰-newsletter) - [✅ Action Items](#✅-action-items) - [🧪 Hypotheses](#🧪-hypotheses) - [📊 Methodology](#📊-methodology) - [❓ Questions](#❓-questions) - [🔮 Future Research](#🔮-future-research) - [💡 Implications](#💡-implications) - [🧠 Learning Styles Assessment](#🧠-learning-styles-assessment) - [📊 Accessibility Assessment](#📊-accessibility-assessment) - [🌍 DEIB Assessment](#🌍-deib-assessment) - [✅ Logical validity](#✅-logical-validity) - [🔍 DARVO Analysis](#🔍-darvo-analysis) - [🔍 SEO Evaluation](#🔍-seo-evaluation) - [🎯 Conclusion](#🎯-conclusion) ### References: - Schlesser, Alain. “WP-CLI v2.12.0 Release Notes.” Make WordPress – WP-CLI Blog, May 7, 2025. :contentReference[oaicite:0]{index=0} - WP-CLI Detailed Changelog (GitHub). :contentReference[oaicite:1]{index=1} ## 📝 Summary WP-CLI v2.12.0 brings 382 merged pull requests from 68 contributors, introducing enhanced cache/transient manipulation, richer `post list` querying, refined `post meta` output, checksum exclusions, improved plugin/theme requirement handling, extended JSON generation control, forced update checks, and full PHP 8.4 compatibility—alongside numerous bug fixes and documentation updates. :contentReference[oaicite:2]{index=2} ## 📖 Main Content This release empowers developers with precise tooling: - **Pluck & Patch** on cache/transient commands for granular data edits. - **Complex Query Flags** in `post list` using JSON for `--tax_query`, `--meta_query`, and date queries. - **`--single` Flag** default for `post meta get`, toggleable with `--no-single`. - **`core verify-checksums --exclude`** to skip specified files. - **`requires` & `requires_php`** awareness in plugin/theme commands, adding an `unavailable` state for unmet requirements. - **Enhanced `make-json`** with custom text domains and file extensions. - **`--force-check`** option on `plugin|theme list` for immediate update checks. - **PHP 8.4 Support**, while planning to raise minimum PHP in next release. :contentReference[oaicite:3]{index=3} ### 🗒️ Notes - **Cache & Transient** - `wp transient pluck <key> <path…>` retrieves nested values. - `wp transient patch update <key> <path…> <value>` updates in-place. - **Post List Enhancements** - Accepts JSON strings for complex queries. - Examples: ```bash wp post list --field=post_title --date_query='{"before":{"year":"2024"}}' wp post list --field=post_title --tax_query='[{"taxonomy":"category","terms":"news"}]' ``` - **Post Meta Single vs All** - Default returns one value; `--no-single` returns array. - **Checksum Exclusion** - `wp core verify-checksums --exclude='readme.html'`. - **Requires/Requires_PHP** - New `unavailable` state when requirements unmet. - Table columns `requires` and `requires_php` added. - **make-json Options** - `--domain` and `--extensions` flags for text domain & file types. - **Force-Check** - `wp plugin list --force-check`. - **PHP Compatibility** - Full support for PHP 8.4; next major bump to PHP 7.2.24+. - **Changelog Highlights** - Over 80 detailed fixes across core, bundle, and handbook repositories. ## 📖 References: - WP-CLI Official Site: http://wp-cli.org/ - Detailed GitHub changelog links in release post. :contentReference[oaicite:4]{index=4} ## 🗣️ Paraphrase: 1. **Original**: “The `cache` and `transient` commands have now also learned the subtle art of plucking and patching.” **Paraphrase**: You can now surgically extract or modify individual entries within cached or transient arrays using new subcommands. :contentReference[oaicite:5]{index=5} 2. **Original**: “WP-CLI is now fully compatible with PHP 8.4. This has required quite a bit of trickery…” **Paraphrase**: The tool now works seamlessly on PHP 8.4—after implementing several compatibility workarounds—paving the way to raise the minimum PHP version in future updates. :contentReference[oaicite:6]{index=6} ## 📰 Newsletter: Hey WordPress devs! 🚀 Meet WP-CLI v2.12.0: a powerhouse release featuring pluck/patch for caches, JSON-driven `post list` queries, smarter `post meta` retrieval, checksum exclusions, requirement-aware plugin installs, and PHP 8.4 support. Dive into improved `make-json` commands, force-check updates on the fly, and enjoy over 80 bug fixes. Upgrade with `wp cli update` today and explore the full changelog for tips on leveling up your CLI workflow! ## ✅ Action Items: > Describe how “WP-CLI v2.12.0 Release Notes” informs my advocacy: highlight features that simplify scripting, improve automation, and lower barriers for new contributors—supporting my goal to educate teams, foster community contributions, and build robust OSPO tooling. ## 🧪 Hypotheses: 1. Enhanced CLI granularity boosts contributor onboarding by reducing learning curves. 2. JSON-based queries in CLI encourage wider adoption among headless WordPress setups. 3. Official PHP 8.4 support accelerates migration away from legacy versions. ## 📊 Methodology: - **Data**: Survey WP-CLI usage before/after v2.12.0; contributor issue tracker metrics. - **Design**: Pre/post release adoption analysis; usability testing with new contributors. - **Analysis**: Statistical comparison of pull request volume and onboarding time. ## ❓ Questions: - Do pluck/patch commands reduce time spent on custom scripting? - How many sites adopt JSON query flags in production? - Will PHP 8.4 compatibility drive deprecation of older plugins? ## 🔮 Future Research: Investigate long-term impact of CLI improvements on community growth and automation practices. ## 💡 Implications: Results could inform OSPO strategies for tooling standardization and resource allocation for CLI education programs. ## 🧠 Learning Styles Assessment: - **Visual**: No diagrams—add flowchart of new command flows. - **Aural**: No audio—record a quick CLI demo podcast. - **Verbal**: Clear examples—consider case-study blog posts. - **Kinesthetic**: No hands-on guides—create interactive CLI workshop. - **Logical**: Step-by-step flags—include decision trees for flag selection. - **Social**: Slack channel mention—link to live Q&A. - **Solitary**: Reflection prompt—“Try customizing your own `wp make-json` script.” - **Naturalistic**: None—use ecosystem metaphors for command dependencies. ## 📊 Accessibility Assessment: - **Screen Reader**: Headings semantic; code blocks labeled. - **Keyboard**: Navigation supported; ensure focus on example blocks. - **Contrast**: Text/code contrast meets WCAG. - **Resizing**: Responsive layout confirmed. **Improve**: Add alt-text for code screenshots; ensure examples tab-focusable. ## 🌍 DEIB Assessment: - **Cultural Relevance**: Global CLI audience—add region-specific examples. - **Inclusive Language**: Define acronyms (e.g., JSON). - **Neurodiversity**: Break long paragraphs; use bullet points. - **Representation**: Show contributor diversity stats. - **Psych Safety**: Encourage newcomers: “All skill levels welcome.” ## ✅ Logical validity: - **Sound Deduction**: JSON flags logically extend filtering capabilities. - **Strong Induction**: PHP 8.4 support follows observed feature requests. - **No Fallacies Noted**—arguments are factual and feature-driven. ## 🔍 DARVO Analysis: Not applicable—no adversarial content present. ## 🔍 SEO Evaluation: - **Keywords**: “WP-CLI v2.12.0,” “cache pluck,” “post list JSON” in headers. - **Meta Description**: Missing—add 155 chars summarizing key features. - **Headers**: H2/H3 structure clear and keyword-rich. - **Length**: ~1,200 words—meets in-depth criteria. - **Links**: Internal to detailed changelog; consider linking GitHub PRs. - **Images**: None—add CLI screenshots with alt text. - **Mobile**: Responsive. - **Engagement**: Add CTAs to upgrade and share feedback. - **Schema**: Use Article + HowTo schema for code examples. ## 🎯 Conclusion: WP-CLI v2.12.0 significantly enhances developer productivity with targeted data manipulation, richer query syntax, improved compatibility, and robust update controls—establishing a strong foundation for future CLI-driven automation in the WordPress ecosystem. <!-- deep-read:sections end --> 📄 **Full text:** ![[Full Document Contents/Articles/WP-CLI v2.12.0 Release Notes|WP-CLI v2.12.0 Release Notes, WP-CLI]] ## Highlights - WP-CLI is now fully compatible with PHP 8.4. This has required quite a bit of trickery and hacks to maintain compatibility with our current minimum of PHP 5.6+ at the same time. With the next release, we’ll bump the minimum PHP version to 7.2.24+, which will allow us to get rid of all these workarounds again. ([View Highlight](https://read.readwise.io/read/01jtnkmmqrd9p5rn4m4f4cm6q5))