Skip to content

docs: WP-CLI subcommand names and dependency injection #49

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ogorzalka merged 1 commit into from
Oct 13, 2026
Merged

docs: WP-CLI subcommand names and dependency injection #49

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions wp-cli-commands.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ class UserCreateCommand

## Command Suites (Subcommands)

WP-CLI automatically registers all **public methods** as subcommands. Method names are converted to kebab-case.
WP-CLI automatically registers all **public methods** as subcommands, under the method name as written: `listUsers()` answers to `listUsers`. For a kebab-case name, put `#[Command]` on the method: with no argument it derives `list-users` from the method name (see [Custom Subcommand Names](#custom-subcommand-names-with-command)).

```php
<?php
Expand Down Expand Up @@ -137,7 +137,7 @@ class UserManagementCommand
```bash
wp user-management create
wp user-management delete
wp user-management list-users
wp user-management listUsers
```

### Custom Subcommand Names with #[Command]
Expand Down Expand Up @@ -205,6 +205,8 @@ The "Command" suffix is automatically removed:

### Method Name → Subcommand Slug

With `#[Command]` and no argument, the slug is derived from the method name; without `#[Command]`, WP-CLI uses the method name as written.

| Method Name | Generated Slug |
|-------------|----------------|
| `createUser()` | `create-user` |
Expand Down Expand Up @@ -521,6 +523,8 @@ public function __invoke(array $arguments, array $options): void

### Service Injection

The command class is built with its constructor dependencies, and that instance runs the command and every subcommand. This needs `pollora/wp-cli` 0.1.1 or later (Pollora 13.36): before it, WP-CLI built the class itself, without arguments.

```php
class MyCommand
{
Expand Down