Support installing plugins from single PHP file URLs

[Copilot]

Implementation Plan for Single PHP Plugin File Installation

• Understand current implementation and test structure
• Add detection for single PHP file URLs in CommandWithUpgrade.php
• Add logic to download and save single PHP files to plugins directory
• Handle plugin naming from single PHP files
• Add Behat tests for single PHP plugin file installation
• Add test for --force flag with PHP files
• Update documentation in Plugin_Command
• Address code review feedback (extract helper method, sanitize URLs, validate extension)
• Add security validations (path traversal protection, early filename validation)
• Improve UX (show download message before downloading)
• Fix security issues (proper path validation, require valid plugin headers)
• Ensure plugin directory exists before validation
• All static analysis checks pass
• Add support for GitHub Gist page URLs (gist.github.com format)
  • Detect gist.github.com URLs and extract gist ID
  • Fetch gist metadata from GitHub API
  • Find first PHP file in the gist
  • Convert to raw URL and proceed with installation
  • Add test for gist page URL format
• Improve error handling and validation
  • Add specific error handling for HTTP codes (401, 500, 503)
  • Add null check before calling build_rate_limiting_error_message()
  • Verify directory creation after wp_mkdir_p()
  • Fix regex to properly match uppercase hex digits in gist IDs
• Support anonymous gists
  • Make username optional in gist URL regex to support anonymous gists
• Case-insensitive extension checks
  • Convert extensions to lowercase in all PHP extension validations
• Ready for final review

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Links to single plugin PHP file should work with plugin install</issue_title>
<issue_description>When using wp plugin install <URL>, WP-CLI currently assumes that the URL is pointing to a ZIP file of a plugin.

This command should also work with a URL to a single PHP plugin file, so that it can for example directly install plugins from GitHub Gists:

Example of such a command that should just work:

wp plugin install --activate https://gist.githubusercontent.com/westonruter/dec7d190060732e29a09751ab99cc549/raw/d55866c2fc82ab16f8909ce73fc89986ab28d727/pwa-manifest-short-name.php

/cc @westonruter (whose numerous Gist plugins make me want to implement the above)</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Links to single plugin PHP file should work with plugin install #233

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[codecov]

Codecov Report

❌ Patch coverage is 60.80000% with 49 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/WP_CLI/CommandWithUpgrade.php	60.80%	49 Missing ⚠️

📢 Thoughts on this report? Let us know!