怎么加PHP标签才能在接口中返回状态码-php教程-PHP中文网

php接口返回http状态码需用http_response_code()或header()函数设置响应头，不能靠html标签；二者均须在任何输出前调用，推荐优先使用http_response_code()，并配合content-type头返回json。

怎么加php标签才能在接口中返回状态码

在 PHP 接口中返回 HTTP 状态码，**不是靠“加标签”实现的**，而是通过 http_response_code() 函数或 header() 函数手动设置响应头中的状态行。HTML 标签（如 <?php ?>）只是用来嵌入 PHP 代码，本身不参与状态码控制。

用 http_response_code() 设置状态码

这是最直接、推荐的方式，专用于设置 HTTP 状态码：

它会自动更新响应的状态行（如 HTTP/1.1 404 Not Found），且不影响后续输出
支持常见状态码，也支持自定义（如 http_response_code(422)）
必须在任何输出（包括空格、换行、echo、HTML）之前调用，否则会报 “headers already sent” 错误

示例：

php
// 返回 400 错误
http_response_code(400);
echo json_encode(['error' => 'Invalid request']);
?>

用 header() 手动发送状态行

更底层的方式，适合需要精确控制协议版本或自定义短语的场景：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

语法：header('HTTP/1.1 401 Unauthorized');
注意：PHP 默认使用 HTTP/1.1；若运行在 CGI/FastCGI 环境下，可能需用 STATUS: 头（如 header('Status: 401 Unauthorized');）
同样要求在任何输出前调用

示例（兼容性更强写法）：

if (empty($_GET['token'])) {
  header('HTTP/1.1 401 Unauthorized');
  echo json_encode(['msg' => 'Missing token']);
  exit;
}
?>

配合 JSON 接口的常见实践

现代 API 通常返回 JSON，并明确状态码，建议组合使用：

先设状态码，再设 Content-Type，最后输出 JSON
避免因错误输出（如 BOM、空行）导致 header 失效
可封装成简单响应函数提升可维护性

示例函数：

function api_response($data, $code = 200) {
  http_response_code($code);
  header('Content-Type: application/json; charset=utf-8');
  echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
}

// 使用
api_response(['user' => 'admin'], 200); // OK
api_response(['error' => 'Not found'], 404); // Not Found
?>