WP-CLI 命令行手册

title: "wp user import-csv" post_status: publish comment_status: open taxonomy: category: - wp-cli-handbook post_tag: - User - Commands - Repos


wp user import-csv

从 CSV 文件导入用户。

如果用户已存在(匹配邮箱地址或登录名),除非使用 --skip-update 标志,否则将更新该用户。

选项

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

<file> : 要导入的用户本地或远程 CSV 文件。如果为 '-',则从 STDIN 读取。

[--send-email] : 向新用户发送包含其账户详情的电子邮件。

[--skip-update] : 不更新已存在的用户。

示例

# 从本地 CSV 文件导入用户
$ wp user import-csv /path/to/users.csv
Success: bobjones created.
Success: newuser1 created.
Success: existinguser created.

# 从远程 CSV 文件导入用户
$ wp user import-csv http://example.com/users.csv

示例 users.csv 文件:

user_login,user_email,display_name,role
bobjones,bobjones@example.com,Bob Jones,contributor
newuser1,newuser1@example.com,New User,author
existinguser,existinguser@example.com,Existing User,administrator

全局参数

这些全局参数在所有命令中行为一致,并影响 WP-CLI 与 WordPress 的交互方式。

参数 描述
--path=<path> WordPress 文件的路径。
--url=<url> 假定请求来自给定 URL。在多站点中,此参数用于指定目标站点。
--ssh=[<scheme>:][<user>@]<host\|container>[:<port>][<path>] 通过 SSH 对远程服务器执行操作(或使用 "docker"、"docker-compose"、"docker-compose-run"、"vagrant" 方案对容器执行操作)。
--http=<http> 通过 HTTP 对远程 WordPress 安装执行操作。
--user=<id\|login\|email> 设置 WordPress 用户。
--skip-plugins[=<plugins>] 跳过加载所有插件,或逗号分隔的插件列表。注意:mu-plugins 仍会被加载。
--skip-themes[=<themes>] 跳过加载所有主题,或逗号分隔的主题列表。
--skip-packages 跳过加载所有已安装的包。
--require=<path> 运行命令前加载 PHP 文件(可多次使用)。
--exec=<php-code> 运行命令前执行 PHP 代码(可多次使用)。
--context=<context> 在给定上下文中加载 WordPress。
--[no-]color 是否对输出着色。
--debug[=<group>] 显示所有 PHP 错误并增加 WP-CLI 输出的详细程度。内置组包括:bootstrap、commandfactory 和 help。
--prompt[=<assoc>] 提示用户输入所有命令参数的值,或指定为逗号分隔值的子集。
--quiet 抑制信息性消息。