WordPress版微信小程序开发系列(一)：WordPress REST API
2021-07-25 10:06:36

自动我发布开源程序WordPress版微信小程序以来，很多WordPress站长在搭建微信小程序的过程中会碰到各种问题来咨询我，有些问题其实很简单，只要仔细看看我写的文章，就可以自己解决。不过这些文章里无法涵盖所有的技术点，因为涉及Wordpress和微信小程序两套程序系统，有些技术点对于小白用户来说确实有些难度，因此我考虑写一个系列文章介绍WordPress版微信小程序开发的相关技术要点。

今天介绍第一个技术要点：WordPress REST API。WordPress REST API无法访问是被问到的最多的问题。这个技术点在《利用WordPress REST API 开发微信小程序从入门到放弃》就初步介绍过，更为详细使用方法将在后续文章介绍，这里重点关注，如何才可以让WordPress REST API正常访问。

最常见的问题就是访问WordPress  REST API 的链接的时候显示404错误无法找到该页。 REST API是WordPress4.4版本开始提供的功能，不过是以插件的方式提供的，WordPress  4.7版本后才内置到系统里，如果你的WordPress站是4.7以前的版本，需要下载api插件：https://wordpress.org/plugins/rest-api/。

如果是WordPress 4.7 或更高版本，要想正常访问 api,需要调整满足两个条件：

1.设置WordPress 的固定链接(permalink).

2、URL重写（url rewrite），也就是设置WordPress的伪静态。

一、设置WordPress 的固定链接(permalink)

打开Wordpress后台设置，如下图所示：

选择除了“朴素”以外的其他选项都可以。不过注意一点：最好在固定链接的最后加上html的为后缀，虽然不加并不影响json api的使用，但考虑到小程序里的站内链接目前是通过判断html的后缀来获取文章slug值，如果不加html后缀会导致小程序的站内链接无法跳转，后续我会考虑完善兼容不带html后缀的固定链接的方式。

一、URL重写

设置完固定链接后，就可以可以通过以下的链接方式来访问REST API 了，比如查看文章列表的json：

https://www.watch-life.net/index.php/wp-json/wp/v2/posts

但是这种方式看上去并不是那么优雅，中间还夹杂这index.php,如果去掉就是就感觉完美一些，这就需要通过URL 重写来实现，具体重写的原理就不详细阐述了，下面给出在不同的web服务器下URL重写代码。

1.IIS 7服务器

需要安装URL Rewrite Module。在web.config 文件 加入 URL重写代码：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="WordPress Rule" stopProcessing="true">
<match url=".*" />
<conditions>
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
</conditions>
<action type="Rewrite" url="index.php" />
</rule>
</rules>
</rewrite>
</system.webServer>
</configuration>

2.Apache服务器

在WordPress网站根目录下增加.htaccess文件，加入 URL重写代码：

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

3.nginx服务器

增加一个conf文件比如wordpress.conf,加入 URL重写代码：

location / {

try_files $uri $uri/ /index.php?$args;

}

经过URL重写后，REST API访问的链接的地址就变成这样了：

https://www.watch-life.net/wp-json/wp/v2/posts。是不是要优雅很多。

特别注意：

1.如果WordPress网站安装了水煮鱼的WPJAM Basic插件，在该插件的设置项里有个选项：

如果你的博客没有客户端，建议屏蔽 REST API 功能。

不要勾选这个选项，如果勾选了，json将无法访问。

如果你通过其他的方式屏蔽了json的访问，也要取消。

2.如果你担心开放Wordpress的json访问可能对网站的安全带来影响。可以参考Jeff的一个解决方法，考虑到微信小程序是通过手机访问的，那么就只允许手机来访问这个api，做一定范围的防范，如果你是nginx服务器，可以在config文件里加如下代码：

location /wp-json {
if ($http_user_agent !~ '(iPhone|Android)'){
return 403;
}
try_files $uri $uri/ /index.php?$args;
}

不过这方法只是权宜之计，只要开放一个功能必然会打来隐患，有得必有失，看你的选择了。