WP CLI说明文档

命令概述

生成一个或多个包含作者、分类、文章、评论和附件的 WXR 文件。WXR 文件不包含站点配置(选项)或附件文件本身。

适用于需要按条件(如作者、日期、文章类型)导出 WordPress 内容进行迁移或备份的场景。

参数列表

参数 说明
--dir= WXR 导出文件应存储的目录的完整路径。默认为当前工作目录。
--stdout 通过标准输出输出整个 XML(与 –dir 不兼容)。
--skip_comments 不在 WXR 导出文件中包含注释。
--max_file_size= 单个导出文件的最大大小(MB)。-1 表示无限制。默认:15。
--filename_format= 导出文件名的自定义格式。默认为 ‘{site}.wordpress.{date}.{n}.xml’。
--include_once= 仅在第一个导出文件中包含指定的导出部分。有效选项:categories, tags, nav_menu_items, custom_taxonomies_terms。多个部分用逗号分隔。默认为 none。
--allow_orphan_terms 导出父级为 0 的孤立术语,而不是抛出异常。
--start_date= 仅导出此日期之后发布的文章,格式为 YYYY-MM-DD。
--end_date= 仅导出此日期之前发布的文章,格式为 YYYY-MM-DD。
--post_type= 仅导出此文章类型的文章。多个类型用逗号分隔。默认:any。
--post_type__not_in= 导出除指定外的所有文章类型。多个类型用逗号分隔。默认为 none。
--post__in= 导出指定 ID 的文章(逗号或空格分隔)。除非指定 –with_attachments,否则不导出附件。
--with_attachments 在指定 –post__in 时强制包含附件。
--start_id= 仅导出 ID 大于或等于此值的文章。
--max_num_posts= 最多导出的文章数量(不包括附件)。
--author= 仅导出此作者的文章。可以是用户登录名或用户 ID。
--category= 仅导出此分类下的文章。
--post_status= 仅导出具有此状态的文章。

常用示例

按日期和作者导出文章

$ wp export --dir=/tmp/ --user=admin --post_type=post --start_date=2011-01-01 --end_date=2011-12-31

按 ID 导出文章

$ wp export --dir=/tmp/ --post__in=123,124,125

导出随机子集

$ wp export --post__in="$(wp post list --post_type=post --orderby=rand --posts_per_page=8 --format=ids)"