搜索选定表中的所有行,并用第二个字符串替换第一个字符串的外观。默认情况下,该命令使用注册到$wpdb
对象。在多站点上,这只是当前站点的表,除非--网络
已指定。搜索/替换智能地处理PHP序列化数据,并且不会更改主键值。
- <旧>
- 要在数据库中搜索的字符串。
- <新>
- 用这个新字符串替换第一个字符串的实例。
- [<表格>…]
- 将替换限制为的数据库表列表。支持通配符,例如。
'wp_*选项'
或'wp_post*'
.
- [--干式运行]
- 运行整个搜索/替换操作并显示报告,但不要将更改保存到数据库。
- [--网络]
- 搜索/替换注册到的所有表$水处理数据库在多站点安装中。
- [--所有表格-带前缀]
- 在任何与表前缀匹配的表上启用替换,即使未在上注册$水处理数据库.
- [--所有表格]
- 在数据库中的所有表上启用替换,而不考虑前缀,即使没有在上注册$水处理数据库覆盖–网络和–所有表格–带前缀。
- [--导出[=<文件>]]
- 将转换后的数据写入SQL文件,而不是将替换内容保存到数据库中。如果未提供<file>,将输出到STDOUT。
- [--导出插入大小=<行>]
- 在执行SQL导出时,在单个INSERT语句中定义行数。您可能希望根据您的数据库配置进行更改(例如,如果您需要执行较少的查询)。默认值:50
- [-跳过表格=<tables>]
- 不要在特定表上执行替换。使用逗号指定多个表。支持通配符,例如。
'wp_*选项'
或'wp_post*'
.
- [--跳过列=<列>]
- 不要对特定列执行替换。使用逗号指定多个列。
- [--包括列=<列>]
- 对特定列进行更换。使用逗号指定多列。
- [--精确]
- 强制使用PHP(而不是SQL),这更彻底,但速度较慢。
- [--递归对象]
- 启用递归到对象以替换字符串。默认为true;pass–无要禁用的对象。
- [--详细]
- 在更新行时将其打印到控制台。
- [--正则表达式]
- 使用正则表达式(不带分隔符)运行搜索。警告:使用–regex时,搜索-替换将花费大约15-20倍的时间。
- [--regex-flags=<regex-flass>]
- 将PCRE修饰符传递给regex search-replace(例如,“i”表示区分大小写)。
- [--正则分隔符=<正则分隔符>]
- 用于正则表达式的分隔符。如果它出现在搜索字符串中,则必须对其进行转义。默认值是
chr(1)
.
- [--正则极限=<正则极限>]
- 每行正则表达式(或每行未序列化数据位)的最大可能替换数。默认为-1(无限制)。
- [--格式=<格式>]
- 以特定格式渲染输出。-–默认值:表格选项:–表格–计数-——
- [--报告]
- 生成报告。默认为true。
- [--仅报告更改]
- 仅报告更改的字段。默认为true时,除非记录,否则默认为false。
- [--日志[=<文件>]]
- 记录更改的项目。如果未提供<file>或<file>为“-”,则将输出到STDOUT。警告:会导致显著减慢速度,与启用–precise或–regex类似或更糟。
- [--before_context=<num>]
- 对于日志记录,在旧匹配项和新替换项之前显示的字符数。默认值40。如果不记录,则忽略。
- [--after_context=<num>]
- 对于日志记录,在旧匹配项和新替换项之后显示的字符数。默认值40。如果不记录,则忽略。
#搜索和替换,但跳过一列$wp search-replace'http://example.test(示例测试)' 'http://example.com'--跳过列=guid#运行搜索/替换操作,但不保存在数据库中$wp search-replace“foo”“bar”wp_posts wp_phostmeta wp_terms--dry-run#运行区分大小写的正则表达式搜索/替换操作(速度较慢)$wp search-replace'\[foo id=“([0-9]+)”''[bar id=“\1”'--regex--regex-flags='i'#将生产多站点数据库转换为本地开发数据库$wp search-replace--url=example.com example.com.example.test“wp_*options”wp_blogs wp_site--network#搜索/替换为SQL文件而不转换数据库$wp search-replace foo bar--导出=数据库.sql#Bash脚本:将生产搜索/替换为开发url(多站点兼容)#!/垃圾桶/垃圾桶if$(wp--url=http://example.com核心已安装——网络);然后wp search-replace--url=http://example.com 'http://example.com' 'http://example.test(示例测试)'--递归对象--网络--跳过列=guid--跳过表=wp_users其他的wp搜索替换'http://example.com' 'http://example.test(示例测试)'--递归对象--skip-columns=guid--skip-tables=wp_usersfi(菲涅耳)
这些全局参数在所有命令中具有相同的行为,并影响WP-CLI与WordPress的交互方式。
参数 |
描述 |
--路径=<路径> |
WordPress文件的路径。 |
--url=<url> |
假装请求来自给定的URL。在多站点中,此参数是如何指定目标站点的。 |
--ssh=[<方案>:][<用户>@]<主机\|容器>[:<端口>][<路径>] |
通过SSH对远程服务器(或使用“docker”、“docker-compose”、“docker-compose run”、“流浪者”方案的容器)执行操作。 |
--http=<http> |
通过HTTP对远程WordPress安装执行操作。 |
--user=<id\|login\|email> |
设置WordPress用户。 |
--skip-plugins[=<插件>] |
跳过加载所有插件或以逗号分隔的插件列表。注意:mu-plugins仍在加载。 |
--跳过主题[=<主题>] |
跳过加载所有主题或以逗号分隔的主题列表。 |
--跳过程序包 |
跳过加载所有已安装的包。 |
--require=<路径> |
在运行命令之前加载PHP文件(可以多次使用)。 |
--exec=<php代码> |
在运行命令之前执行PHP代码(可以多次使用)。 |
--上下文=<context> |
在给定上下文中加载WordPress。 |
--[no-]颜色 |
是否对输出进行着色。 |
--调试[=<组>] |
显示所有PHP错误并向WP-CLI输出添加详细信息。内置组包括:bootstrap、commandfactory和help。 |
--提示[=<assoc>] |
提示用户输入所有命令参数的值,或指定为逗号分隔值的子集。 |
--安静 |
禁止显示信息性消息。 |