REST API 在免费主机上无法使用 PUT/DELETE 方法的解决方案-php教程-PHP中文网

REST API 在免费主机上无法使用 PUT/DELETE 方法的解决方案

000webhost 等免费 Web 托管服务默认禁用 PUT、DELETE 等非标准 HTTP 方法，仅允许 GET 和 POST；本地运行正常但上线后报 ERR_HTTP2_PROTOCOL_ERROR 或 Socket hang up，本质是服务商主动拦截而非代码错误。

000webhost 等免费 web 托管服务默认禁用 put、delete 等非标准 http 方法，仅允许 get 和 post；本地运行正常但上线后报 `err_http2_protocol_error` 或 `socket hang up`，本质是服务商主动拦截而非代码错误。

在开发基于 CodeIgniter 4（或其他 PHP 框架）的 REST API 时，本地环境（如 XAMPP、Laravel Valet 或内置 PHP 服务器）通常完整支持所有 HTTP 方法（GET、POST、PUT、DELETE、PATCH）。但一旦部署到 000webhost 免费版，你会发现 DELETE 和 PUT 请求始终失败——前端报 Network Error、ERR_HTTP2_PROTOCOL_ERROR，Postman 显示 Socket hang up，而服务端甚至无日志可查。这不是你的控制器或模型有误（你提供的 delete() 方法逻辑合理，BarangModel 配置也无异常），而是底层 Web 服务器（如 Nginx/Apache）在免费套餐中直接拒绝处理这些方法。

? 根本原因：免费主机的 HTTP 方法限制

000webhost 明确声明其免费计划仅支持 GET 和 POST 方法。其他方法（PUT、DELETE、PATCH、HEAD 等）会被服务器在协议层直接终止连接，不转发至 PHP 应用，因此不会触发任何 PHP 错误、不写入 error_log，也不返回 HTTP 状态码——这正是 Socket hang up 和 net::ERR_HTTP2_PROTOCOL_ERROR 的典型表现。

✅ 官方佐证：000webhost 论坛帖 #61170 明确指出：“DELETE and PUT methods are not available with free hosting… You have to upgrade to the Premium plan.”

?️ 可行解决方案（按推荐顺序）

✅ 方案 1：改用支持全 HTTP 方法的免费/低成本替代平台（推荐）

Render.com（免费 Tier）：支持完整 HTTP 方法 + 自动 HTTPS + GitHub 部署，适合 API 项目。
Railway.app（$5 起免费额度）：一键部署 PHP/Node.js，原生支持所有方法。
Heroku（需绑定信用卡启用免费 dyno）：仍支持标准 HTTP 方法（注意其免费层已调整，建议确认当前策略）。
Cloudflare Pages + Workers（搭配 Serverless 函数）：适用于轻量 API，完全免费且无方法限制。

✅ 方案 2：客户端降级为 POST + _method 模拟（兼容旧环境）

若必须暂留 000webhost，可在前端强制使用 POST 并携带 _method=DELETE 参数，后端通过中间件或路由重写识别：

Wordpress REST API

OpenClaw技能，提供WordPress REST API命令行工具，支持通过原生HTTP处理文章、页面、分类、标签、用户及自定义请求。

下载

// Vue/Axios 示例：发送模拟 DELETE
axios.post('/api/index.php/barang/106', {
  _method: 'DELETE'
}, {
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
})

并在 CodeIgniter 4 中添加 App\Filters\MethodOverrideFilter（需手动实现），解析 _method 并覆盖 $this->request->getMethod()。⚠️ 注意：此方式需确保表单提交或 Axios 配置正确，且存在 CSRF 风险，仅作临时过渡。

❌ 不推荐方案：尝试 .htaccess 或 Nginx 重写

000webhost 免费版不开放 .htaccess 写权限或 Nginx 配置，RewriteCond %{REQUEST_METHOD} ^(DELETE|PUT)$ 类规则将被忽略。

? 开发者提醒：快速验证是否为托管限制

在服务器根目录新建 test_method.php：

<?php header('Content-Type: application/json');
echo json_encode([
    'method' => $_SERVER['REQUEST_METHOD'] ?? 'unknown',
    'headers' => getallheaders() ?? []
]);
?>

分别用 curl -X DELETE https://yoursite.000webhostapp.com/test_method.php 和 curl -X GET ... 测试。
→ 若 DELETE 返回空响应或超时，而 GET 正常，则 100% 确认为托管限制。

✅ 总结

你的 REST API 代码完全正确——问题不在 BarangModel 的软删除配置，也不在控制器的 respondDeleted() 调用。这是免费托管服务的商业限制，而非技术缺陷。 建议立即迁移至 Render、Railway 等现代无限制平台，或升级至 000webhost Premium（起价约 $2.99/月）。把调试时间花在真实 Bug 上，而非与服务商的协议层博弈。