title: "wp option list" post_status: publish comment_status: open taxonomy: category: - wp-cli-handbook post_tag: - Option - Commands - Repos

wp option list

列出选项及其值。

选项

有关所用语法约定的详细说明，请参阅 参数语法 参考。

[--search=<pattern>] : 使用通配符（ * 和 ? ）来匹配选项名称。

[--exclude=<pattern>] : 要排除的模式。使用通配符（ * 和 ? ）来匹配选项名称。

[--autoload=<value>] : 当值为 on 时仅匹配自动加载选项，当值为 off 时仅匹配非自动加载选项。

[--transients] : 仅列出瞬态选项。使用 --no-transients 忽略所有瞬态选项。

[--unserialize] : 在输出中反序列化选项值。

[--field=<field>] : 打印单个字段的值。

[--fields=<fields>] : 将输出限制为特定的对象字段。

[--format=<format>] : 值的序列化格式。total_bytes 显示匹配选项的总大小（字节）。 --- 默认值: table 选项: - table - json - csv - count - yaml - total_bytes ---

[--orderby=<fields>] : 设置按哪个字段排序。 --- 默认值: option_id 选项: - option_id - option_name - option_value ---

[--order=<order>] : 设置升序或降序。 --- 默认值: asc 选项: - asc - desc ---

可用字段

默认情况下，每个匹配的选项将显示以下字段：

• option_name
• option_value

以下字段可选显示：

• autoload
• size_bytes

示例

# 获取所有自动加载选项的总大小。
$ wp option list --autoload=on --format=total_bytes
33198

# 查找最大的瞬态选项。
$ wp option list --search="*_transient_*" --fields=option_name,size_bytes | sort -n -k 2 | tail
option_name size_bytes
_site_transient_timeout_theme_roots 10
_site_transient_theme_roots 76
_site_transient_update_themes   181
_site_transient_update_core 808
_site_transient_update_plugins  6645

# 列出所有以 "i2f_" 开头的选项。
$ wp option list --search="i2f_*"
+-------------+--------------+
| option_name | option_value |
+-------------+--------------+
| i2f_version | 0.1.0        |
+-------------+--------------+

# 删除所有以 "theme_mods_" 开头的选项。
$ wp option list --search="theme_mods_*" --field=option_name | xargs -I % wp option delete %
Success: Deleted 'theme_mods_twentysixteen' option.
Success: Deleted 'theme_mods_twentyfifteen' option.
Success: Deleted 'theme_mods_twentyfourteen' option.

GLOBAL PARAMETERS

These global parameters have the same behavior across all commands and affect how WP-CLI interacts with WordPress.