PHP

编程语言

PHP自二十多年来一直是许多Web应用程序的主要支柱。因此，处理Web通信细节（包括HTTP状态码）的方法和技术得以发展。

HTTP状态码的意义

在深入研究PHP之前，我们应该澄清HTTP状态码的目的和意义。它们对于Web服务器和浏览器之间的通信至关重要，因为它们提供了关于请求处理情况的信息。

有几类状态码：

  • 2xx（成功）：表示请求已成功处理。
  • 3xx（重定向）：指示需要采取进一步的行动来完成请求。
  • 4xx（客户端错误）：这些代码表示请求有问题，通常是由于用户错误。
  • 5xx（服务器错误）：表示服务器意识到它发生了错误或无法满足请求。

PHP和状态码：历史回顾

在PHP的早期，远在我们今天所熟知的框架和丰富的库之前，开发人员不得不依赖语言的最基本功能来设置HTTP状态码。其中，header()函数扮演了核心角色。

header()函数允许发送原始的HTTP头部。设置状态码看起来像这样：

header('HTTP/1.0 404 Not Found');

另一个常见手动设置的状态码是301重定向码，通常用于SEO目的：

header('HTTP/1.0 301 Moved Permanently');
header('Location: /new-url.php');

然而，这种方法有不同的缺点：

  • 容易出错：缺少空格、格式错误等。
  • 不易读：开发人员需要记住或查阅每个状态码的确切HTTP字符串。
  • 不一致性：不同的服务器或PHP配置在头部不正确格式化时可能会表现不同。

演变：http_response_code()函数的引入

随着时间的推移和PHP引擎的发展，PHP社区意识到需要简化并降低错误风险。这导致了http_response_code()函数的引入。

这个函数通过提供数值代码来简单地设置HTTP状态码：

http_response_code(404);

这种方法的优势很明显：

  • 简洁：更直观，对人为错误不那么敏感。
  • 灵活性：开发人员不需要关心精确的HTTP协议版本或状态消息的确切文本，PHP内部处理这些细节。
  • 可读性：代码更清晰，对于新加入项目或对HTTP状态码不太熟悉的开发人员更易理解。

现代PHP中的附加帮助

虽然http_response_code()是明显的改进，但许多现代PHP框架和库引入了它们自己的工具和方法来处理HTTP状态码。这些通常提供更高级的抽象层和额外的辅助功能。

例如，在Laravel框架中：

return response('Not Found', 404);

或在Symfony框架中：

return new Response('Not Found', 404);

这些现代框架及其方法提供更大的一致性，改进的测试能力以及与Web应用程序其他部分更紧密的集成。

总结来说，多年来，PHP经历了显著的发展：从容易出错且手动设置HTTP状态码的方法到如今更直观、更稳定的方法。

最佳实践

  • 保持逻辑清晰：确保用于发送状态码的逻辑清晰易懂。避免深层嵌套的条件语句，可能导致多种状态码的情况。
  • 避免魔法：除非完全理解框架或库自动设置状态码的方式和原因，否则不要依赖它们来自动设置状态码。
  • 文档：准备内部文档，解释何时以及为何发送特定的状态码。

常见问题和解决方案

  • 已发送头部：当尝试在发送输出内容后发送头部或状态码时会出现此错误。解决方案是确保所有的header()或http_response_code()调用在任何输出之前。
  • 错误的代码：特别是在使用没有http_response_code()函数的旧版PHP时，很容易设置不正确的状态码。了解每个状态码的确切语法和含义很重要。

创建自定义状态码

HTTP协议定义了一系列标准状态码，用于特定情况。但是，如果您认为没有一个状态码恰好表达您想要传达的信息，该怎么办呢？这时候就会考虑是否以及如何在PHP中创建自定义状态码。

如何做：

从技术上讲，您可以使用header()函数发送任何三位数的状态码，连同一条消息：

header('HTTP/1.1 599 Custom Status Message');

在这个例子中，状态码"599"连同消息"Custom Status Message"被发送。

但是，您应该这样做吗？

总的来说，不推荐创建自定义状态码。原因有几个：

  • 标准化：标准HTTP状态码设计用于覆盖广泛情况。它们在全球范围内被承认，并被许多工具、代理、爬虫和当然是浏览器理解。自定义状态码可能不会被这些工具正确识别或误解。
  • 混淆：自定义状态码可能会导致与与您的应用程序交互的其他开发人员或系统混淆。
  • 未来冲突：您定义的自定义状态码可能会在将来的HTTP规范中被标准化，但其含义可能不同。这可能导致意想不到的问题。
  • 缺乏支持：一些系统可能无法正确处理非标准化的状态码，而只是将其解释为"500 Internal Server Error"或显示其他意外行为。

如果您仍然认为现有状态码不能准确描述您的情况，应该考虑使用自定义标头或在响应主体中提供详细的错误消息。这样可以为您提供一种提供额外信息的方式，同时不会影响标准状态码的含义和清晰度。

虽然PHP允许您灵活地创建自定义状态码，但在大多数情况下，最好还是坚持使用已有的、标准化的代码。

总结

在PHP中正确处理HTTP状态码既是艺术也是科学。尽管正确的语法和函数使用相对简单，但在复杂应用程序中正确管理状态码需要深刻理解HTTP和特定应用程序要求。投入时间来理解和掌握状态码管理的微妙之处的开发人员将能够更好地构建稳健、用户友好的Web应用程序。

PHP: header 

header('HTTP/1.0 404 Not Found‘);     
header('HTTP/1.0 301 Moved Permanently‘);
header('Location: /new-url.php‘);

PHP: http_response_code 

http_response_code(404)
http_response_code(402)