[第十一章].api 新路由方法使用教程

.api 新路由使用教程

1. 什么是 .api 新路由

传统接口地址：

http://你的域名/api/ping/api.php

启用 .api 新路由后，可以使用：

http://你的域名/api/ping.api

.api 不是实际文件，而是通过伪静态规则将：

/api/ping.api

转换为：

/api/ping/api.php

接口代码和请求参数不需要修改。

2. 接口目录结构

假设接口目录名为 ping，文件名为 api.php：

/api/ping/api.php

旧地址：

/api/ping/api.php

新地址：

/api/ping.api

3. 后台添加接口

在后台添加接口时：

• 接口地址填写：ping.api
• 接口目录名填写：ping
• 请求方式、参数、返回格式按照原来的接口填写

最终接口地址为：

http://你的域名/api/ping.api

4. Nginx 伪静态配置

在网站 Nginx 配置中加入：

location ~ ^/api/([A-Za-z0-9_-]+)\.api$ {
    rewrite ^/api/([A-Za-z0-9_-]+)\.api$ /api/$1/api.php last;
}

如果接口目录名包含点号，可以使用：

location ~ ^/api/(([^/]+\.?)+)\.([^/]+)$ {
    rewrite ^/api/(([^/]+\.?)+)\.([^/]+)$ /api/$1/$3.php last;
}

保存配置后重载 Nginx。

5. Apache 伪静态配置

如果服务器使用 Apache，在网站根目录的 .htaccess 中加入：

RewriteEngine On

RewriteRule ^api/([A-Za-z0-9_-]+)\.api$ api/$1/api.php [L,QSA]

6. 请求示例

原来的请求：

http://你的域名/api/ping/api.php?apikey=你开通的apikey&url=example.com

新的请求：

http://你的域名/api/ping.api?apikey=你开通的apikey&url=example.com

请求参数、接口密钥都保持不变。

7. 常见问题

如果访问 .api 地址返回 404，通常是伪静态没有生效。

检查以下内容：

1. 伪静态规则是否保存成功。
2. Nginx 或 Apache 是否已经重载。
3. 接口文件是否真实存在：

/api/接口目录/api.php

4. 后台填写的接口地址是否为：

接口目录.api

不要填写：

接口目录/api.php

.api 新路由只是接口地址的简化写法，不会改变接口本身的运行逻辑。