如何配置Apache加载index.html与index.php并解决API接口无法访问问题

API 探路者

2026-7-12

解决方案

一、先确认Apache基础配置

必须开启mod_rewrite模块：Ubuntu/Debian系统用sudo a2enmod rewrite命令开启；CentOS/RHEL系统需编辑httpd.conf，去掉mod_rewrite模块前的注释符号。
确保网站根目录的AllowOverride设为All，比如在虚拟主机配置中添加：
```
<Directory /path/to/your/root>
    AllowOverride All
    Require all granted
</Directory>
```
修改完成后重启Apache服务。

二、在项目根目录创建.htaccess文件

直接在root文件夹下新建.htaccess文件，写入以下规则：

RewriteEngine On

# 将所有/api/开头的请求转发到api/index.php
RewriteRule ^api/(.*)$ api/index.php [QSA,L]

# 根路径请求直接返回index.html
RewriteRule ^$ index.html [L]

QSA参数会保留原请求的查询字符串，比如/api/uri?id=1会把id=1传递给index.php
L表示匹配到该规则后不再执行后续规则

三、调整API入口逻辑

你的api/index.php需要能识别具体请求路径，可通过$_SERVER['REQUEST_URI']提取/api后的部分，示例代码如下：

// 提取/api后的请求路径
$requestPath = trim(str_replace('/api/', '', $_SERVER['REQUEST_URI']), '/');

// 根据路径处理不同接口逻辑
switch ($requestPath) {
    case 'uri':
        echo json_encode(['status' => 'success', 'data' => '接口响应数据']);
        break;
    default:
        http_response_code(404);
        echo json_encode(['status' => 'error', 'msg' => '接口不存在']);
}