Add global --ssh-args argument for SSH/Docker/Vagrant execution

[Copilot]

WP-CLI's --ssh flag only accepts connection strings, preventing users from passing tool-specific arguments like SSH options (-F config_file, -o ConnectTimeout=5), Docker flags (--env), or Vagrant parameters.

Changes

Config & Types

• Added ssh-args to global config spec with multiple: true
• Updated PHPStan GlobalConfig type definition
• Added ssh-args to alias specification

Command Generation

• Modified generate_ssh_command() to inject escaped args into all scheme commands (ssh, docker, docker-compose, docker-compose-run, vagrant)
• Filter --ssh-args from remote WP-CLI invocation to prevent double-processing

Tests

• Added scenarios for SSH, Docker, and multiple argument cases

Usage

# SSH with custom config (Lima, etc.)
wp --ssh=server --ssh-args="-F /path/to/config" core version

# Multiple args
wp --ssh=server --ssh-args="-o ConnectTimeout=5" --ssh-args="-o ServerAliveInterval=10" core version

# Docker with environment variables
wp --ssh=docker:wordpress --ssh-args="--env MY_VAR=value" core version

# In aliases
@prod:
  ssh: user@prod.example.com
  ssh-args:
    - "-F /path/to/config"
    - "-o ProxyJump=bastion"

All arguments are shell-escaped via escapeshellarg().

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Support for ssh -F another_ssh_config server-alias/path</issue_title>
<issue_description>## Feature Request

• Yes, I reviewed the contribution guidelines.

Describe your use case and the problem you are facing

The way to connect to a Lima (Linux on macOS) guest is:

ssh -F config_file host_alias

Describe the solution you'd like

It might be helpful (if possible) to add a new alias such as ssh-config or ssh_config_file, to the --ssh option, allowing users to specify the SSH config file directly.</issue_description>

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

• Fixes Support for ssh -F another_ssh_config server-alias/path #6080

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[codecov]

Codecov Report

❌ Patch coverage is 24.13793% with 22 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
php/WP_CLI/Runner.php	0.00%	22 Missing ⚠️

📢 Thoughts on this report? Let us know!