README

列出或刷新网站的Rewrite规则，更新永久链接结构。

使用

此包实现了以下命令

wp rewrite

列出或刷新网站的Rewrite规则，更新永久链接结构。

wp rewrite

参见WordPress Rewrite API 和 WP Rewrite 类参考。

示例

# Flush rewrite rules
$ wp rewrite flush
Success: Rewrite rules flushed.

# Update permalink structure
$ wp rewrite structure '/%year%/%monthnum%/%postname%'
Success: Rewrite structure set.

# List rewrite rules
$ wp rewrite list --format=csv
match,query,source
^wp-json/?$,index.php?rest_route=/,other
^wp-json/(.*)?,index.php?rest_route=/$matches[1],other
category/(.+?)/feed/(feed|rdf|rss|rss2|atom)/?$,index.php?category_name=$matches[1]&feed=$matches[2],category
category/(.+?)/(feed|rdf|rss|rss2|atom)/?$,index.php?category_name=$matches[1]&feed=$matches[2],category
category/(.+?)/embed/?$,index.php?category_name=$matches[1]&embed=true,category

wp rewrite flush

刷新Rewrite规则。

wp rewrite flush [--hard]

根据已注册的帖子类型等重置WordPress的Rewrite规则。

要使用WP-CLI重新生成 .htaccess 文件，您需要在 wp-cli.yml 或 config.yml 中添加 mod_rewrite 模块。例如

apache_modules:
  - mod_rewrite

选项

[--hard]
	Perform a hard flush - update `.htaccess` rules as well as rewrite rules in database. Works only on single site installs.

示例

$ wp rewrite flush
Success: Rewrite rules flushed.

wp rewrite list

获取当前Rewrite规则列表。

wp rewrite list [--match=<url>] [--source=<source>] [--fields=<fields>] [--format=<format>]

选项

[--match=<url>]
	Show rewrite rules matching a particular URL.

[--source=<source>]
	Show rewrite rules from a particular source.

[--fields=<fields>]
	Limit the output to specific fields. Defaults to match,query,source.

[--format=<format>]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - json
	  - count
	  - yaml
	---

示例

$ wp rewrite list --format=csv
match,query,source
^wp-json/?$,index.php?rest_route=/,other
^wp-json/(.*)?,index.php?rest_route=/$matches[1],other
category/(.+?)/feed/(feed|rdf|rss|rss2|atom)/?$,index.php?category_name=$matches[1]&feed=$matches[2],category
category/(.+?)/(feed|rdf|rss|rss2|atom)/?$,index.php?category_name=$matches[1]&feed=$matches[2],category
category/(.+?)/embed/?$,index.php?category_name=$matches[1]&embed=true,category

wp rewrite structure

更新永久链接结构。

wp rewrite structure <permastruct> [--category-base=<base>] [--tag-base=<base>] [--hard]

将帖子永久链接结构设置为指定的模式。

要使用WP-CLI重新生成 .htaccess 文件，您需要在 WP-CLI 配置中添加 mod_rewrite 模块。例如

apache_modules:
  - mod_rewrite

选项

<permastruct>
	The new permalink structure to apply.

[--category-base=<base>]
	Set the base for category permalinks, i.e. '/category/'.

[--tag-base=<base>]
	Set the base for tag permalinks, i.e. '/tag/'.

[--hard]
	Perform a hard flush - update `.htaccess` rules as well as rewrite rules in database.

示例

$ wp rewrite structure '/%year%/%monthnum%/%postname%/'
Success: Rewrite structure set.

安装

此包包含在WP-CLI本身中，无需额外安装。

要安装此包的最新版本（超过WP-CLI中包含的版本），请运行

wp package install [email protected]:wp-cli/rewrite-command.git

贡献

我们感谢您主动为此项目做出贡献。

贡献不仅限于代码。我们鼓励您以最适合您能力的方式做出贡献，例如编写教程、在当地聚会中演示、帮助其他用户解答支持问题或修订我们的文档。

要获得更全面的介绍，请查看WP-CLI贡献指南。此包遵循那些政策和指南。

报告错误

认为您发现了一个错误？我们希望您能帮助我们修复它。

在创建新问题之前，您应该搜索现有问题，以查看是否已存在对此问题的解决方案，或者它是否已在较新版本中修复。

一旦您进行了一些搜索，发现没有为您的错误打开或修复的问题，请创建新问题。尽可能提供详细信息，并提供尽可能清晰的复现步骤。有关更多指导，请查看我们的错误报告文档。

创建拉取请求

想要贡献一个新功能？请首先打开新问题，讨论该功能是否适合此项目。

一旦您决定投入时间来完成您的拉取请求，请遵循我们创建拉取请求的指南，以确保这是一个愉快的体验。有关在本地工作于此包的详细信息，请参阅"设置"。

支持

GitHub问题不适合一般支持问题，但您可以尝试其他途径：https://wp-cli.org/#support

此README.md是由项目的代码库使用wp scaffold package-readme（文档）动态生成的。要建议更改，请向代码库的相应部分提交拉取请求。

wp-cli / rewrite-command

维护者

详细信息