<?php

return [
    'path'              => [
        'runtime' => '=<path>',
        'file'    => '<path>',
        'desc'    => 'Path to the WordPress files.',
    ],

    'url'               => [
        'runtime' => '=<url>',
        'file'    => '<url>',
        'desc'    => 'Pretend request came from given URL. In multisite, this argument is how the target site is specified.',
    ],

    'ssh'               => [
        'runtime' => '=[<scheme>:][<user>@]<host|container>[:<port>][<path>]',
        'file'    => '[<scheme>:][<user>@]<host|container>[:<port>][<path>]',
        'desc'    => 'Perform operation against a remote server over SSH (or a container using scheme of "docker", "docker-compose", "docker-compose-run", "vagrant").',
    ],

    'http'              => [
        'runtime' => '=<http>',
        'file'    => '<http>',
        'desc'    => 'Perform operation against a remote WordPress installation over HTTP.',
    ],

    'blog'              => [
        'deprecated' => 'Use --url instead.',
        'runtime'    => '=<url>',
    ],

    'user'              => [
        'runtime' => '=<id|login|email>',
        'file'    => '<id|login|email>',
        'desc'    => 'Set the WordPress user.',
    ],

    'skip-plugins'      => [
        'runtime' => '[=<plugins>]',
        'file'    => '<list>',
        'desc'    => 'Skip loading all plugins, or a comma-separated list of plugins. Note: mu-plugins are still loaded.',
        'default' => '',
    ],

    'skip-themes'       => [
        'runtime' => '[=<themes>]',
        'file'    => '<list>',
        'desc'    => 'Skip loading all themes, or a comma-separated list of themes.',
        'default' => '',
    ],

    'skip-packages'     => [
        'runtime' => '',
        'file'    => '<bool>',
        'desc'    => 'Skip loading all installed packages.',
        'default' => false,
    ],

    'require'           => [
        'runtime'  => '=<path>',
        'file'     => '<path>',
        'desc'     => 'Load PHP file before running the command (may be used more than once).',
        'multiple' => true,
        'default'  => [],
    ],

    'exec'              => [
        'runtime'  => '=<php-code>',
        'file'     => '<php-code>',
        'desc'     => 'Execute PHP code before running the command (may be used more than once).',
        'multiple' => true,
        'default'  => [],
    ],

    'context'           => [
        'runtime' => '=<context>',
        'file'    => '<context>',
        'default' => 'cli',
        'desc'    => 'Load WordPress in a given context.',
    ],

    'disabled_commands' => [
        'file'    => '<list>',
        'default' => [],
        'desc'    => '(Sub)commands to disable.',
    ],

    'color'             => [
        'runtime' => true,
        'file'    => '<bool>',
        'default' => 'auto',
        'desc'    => 'Whether to colorize the output.',
    ],

    'debug'             => [
        'runtime' => '[=<group>]',
        'file'    => '<group>',
        'default' => false,
        'desc'    => 'Show all PHP errors and add verbosity to WP-CLI output. Built-in groups include: bootstrap, commandfactory, and help.',
    ],

    'prompt'            => [
        'runtime' => '[=<assoc>]',
        'file'    => false,
        'default' => false,
        'desc'    => 'Prompt the user to enter values for all command arguments, or a subset specified as comma-separated values.',
    ],

    'quiet'             => [
        'runtime' => '',
        'file'    => '<bool>',
        'default' => false,
        'desc'    => 'Suppress informational messages.',
    ],

    'apache_modules'    => [
        'file'     => '<list>',
        'desc'     => 'List of Apache Modules that are to be reported as loaded.',
        'multiple' => true,
        'default'  => [],
    ],

    # --allow-root => (NOT RECOMMENDED) Allow wp-cli to run as root. This poses
    # a security risk, so you probably do not want to do this.
    'allow-root'        => [
        'file'    => false, # Explicit. Just in case the default changes.
        'runtime' => '',
        'hidden'  => true,
    ],

];