# PHP API 开发：从网页到 REST API

现代 PHP 项目越来越多地通过 JSON API 给前端、App 或其他服务提供数据。

## JSON 响应

```php
header("Content-Type: application/json; charset=utf-8");

echo json_encode([
    "success" => true,
    "data" => []
]);
```

## HTTP 状态码

常见状态码：

```text
200 成功
201 创建成功
400 参数错误
401 未认证
403 无权限
404 不存在
422 验证失败
500 服务端错误
```

不要所有请求都返回 200。

## 读取 JSON

```php
$data = json_decode(
    file_get_contents("php://input"),
    true
);
```

然后验证字段是否存在、类型是否正确、长度是否合理。

## REST

例如：

```text
GET    /users
GET    /users/123
POST   /users
PATCH  /users/123
DELETE /users/123
```

核心是围绕资源和 HTTP 方法设计，而不是单纯把 URL 叫 API。

## 统一响应

成功：

```json
{"success":true,"data":{}}
```

失败：

```json
{"success":false,"message":"参数错误"}
```

统一格式会让客户端更容易处理。

## 小结

API 开发需要同时理解 PHP、HTTP、JSON、验证、认证和状态码。