PHP“php://输入”与 $_POST

Question

在与 JQuery 的 Ajax 请求交互时，我被指示使用 php://input 方法而不是 $_POST 。我不明白的是使用此方法与 $_POST 或 $_GET 的全局方法相比有何好处。

Answer 1

原因是 php://input 返回请求的 HTTP 标头之后的所有原始数据，无论内容类型如何。

PHP 超全局 $_POST，只有应该包装

• application/x-www-form-urlencoded 的数据（标准内容类型simple form-posts) 或
• multipart/form-data （主要用于文件上传）

这是因为这些是必须由用户代理支持。因此，服务器和 PHP 传统上不期望接收任何其他内容类型（这并不意味着它们不能）。

因此，如果您只是 POST 一个旧的 HTML form，请求看起来像这样：

POST /page.php HTTP/1.1

key1=value1&key2=value2&key3=value3

但是如果您经常使用 Ajax，这个可能还包括与类型（string、int）交换更复杂的数据，bool）和结构体（数组，对象），所以在大多数情况下 JSON 是最好的选择。但是带有 JSON 负载的请求看起来像这样：

POST /page.php HTTP/1.1

{"key1":"value1","key2":"value2","key3":"value3"}

内容现在是 application/json （或者至少不是上面提到的），所以 PHP 的 $_POST-wrapper 还不知道如何处理这个问题。

数据仍然存在，只是无法通过包装器访问它。因此，您需要使用 file_get_contents('php://input') 以原始格式自行获取它 (只要它不是 multipart/form-data 编码）。

这也是您访问 XML 数据或任何其他非标准内容类型的方式。

Answer 2

首先，了解有关 PHP 的基本事实。

PHP 的设计初衷并不是明确为您提供一个纯 REST（GET、POST、PUT、PATCH、DELETE）之类的接口来处理 HTTP 请求。

但是，$_SERVER、$_COOKIE、$_POST、$_GET 和 $_FILES< /code> superglobals 和函数 filter_input_array() 非常有用满足普通人/外行的需求。

$_POST（和 $_GET）的第一个隐藏优势是您的输入数据由 PHP 自动进行 URL 解码。您甚至从未想过必须这样做，特别是对于标准 GET 请求中的查询字符串参数，或通过 POST 请求提交的 HTTP 正文数据。

其他 HTTP 请求方法

研究 HTTP 底层协议及其各种请求方法的人都知道，HTTP 请求方法有很多种，包括经常引用的 PUT、PATCH（未使用过）在 Google 的 Apigee 中），以及DELETE。

在 PHP 中，当不使用 POST 时，没有超全局变量或输入过滤器函数用于获取 HTTP 请求正文数据。罗伊·菲尔丁的弟子们要做什么？ ;-)

但是，然后您会了解更多...

话虽这么说，当您提高 PHP 编程知识并想要使用 JavaScript 的 XmlHttpRequest 对象（对于某些人来说是 jQuery）时，您会看到局限性该计划的。

$_POST 限制您在 HTTP Content-Type 标头中使用两种媒体类型：

1. application/x-www-form-urlencoded，和
2. multipart/form-data

因此，如果您想将数据值发送到服务器上的 PHP，并让它显示在 $_POST 超级全局中，那么你必须urlencode 在客户端进行编码，并将所述数据作为键/值对发送 - 这是一个不方便的步骤对于新手（尤其是当试图弄清楚 URL 的不同部分是否需要不同形式的 urlencoding 时：正常、原始等）。

对于所有 jQuery 用户来说，$.ajax() 方法会将 JSON 转换为 URL 编码的键/值对，然后再将其传输到服务器。您可以通过设置 processData: false 来覆盖此行为。只需阅读 $.ajax() 文档，并且不要忘记发送正确的媒体输入 Content-Type 标头。

php://input，但是...

即使您使用 php://input 而不是 $_POST您的 HTTP POST 请求正文数据，它不会 使用 multipart/form-data 的 HTTP Content-Type 这是当您想要允许文件上传时在 HTML 表单上使用的内容类型！

<form enctype="multipart/form-data" accept-charset="utf-8" action="post">
    <input type="file" name="resume">
</form>

因此，在传统 PHP 中，要处理来自 HTTP POST 请求的多种内容类型，您将学习使用 $_POST 或 filter_input_array(POST)< /code>、$_FILES 和 php://input。在 PHP 中，无法仅使用一个通用输入源来处理 HTTP POST 请求。

无法通过$_POST、filter_input_array(POST)、php://input获取文件，也无法获取JSON/XML/YAML在 filter_input_array(POST) 或 $_POST 中。

PHP 手册：php://input

php://input 是一个只读流，允许您读取原始数据
来自请求正文...php://input不可用
enctype="multipart/form-data"。

PHP 框架来拯救？

像 Codeigniter 4 和 Laravel 这样的 PHP 框架使用 Facade 来为上述内容提供更清晰的接口（IncomingRequest 或 Request 对象）。这就是专业 PHP 开发人员使用框架而不是原始 PHP 的原因。

当然，如果您喜欢编程，您可以设计自己的外观对象来提供框架的功能。正是因为我花了时间研究这个问题，所以我才能写下这个答案。

网址编码？到底什么啊！？？？

通常，如果您使用 HTML 表单执行正常的同步（当整个页面重绘时）HTTP 请求，用户代理（Web 浏览器）将为您对表单数据进行 urlencode。如果您想使用 XmlHttpRequest 对象执行异步 HTTP 请求，那么您必须创建一个 urlencoded 字符串并发送它，如果您希望该数据显示在 $_POST 中 超全局。

您对 JavaScript 的了解程度如何？ :-)

从 JavaScript 数组或对象转换为 urlencoded 字符串困扰了许多开发人员（即使使用像 表单数据）。他们更愿意能够发送 JSON，并且客户端代码这样做会更高效。

请记住（眨眼，眨眼），普通 Web 开发人员不会像你我一样学习直接使用 XmlHttpRequest 对象、全局函数、字符串函数、数组函数和正则表达式;-)。 Urlencoding 对他们来说是一场噩梦。 ;-)

PHP，给出了什么？

PHP 缺乏直观的 XML 和 JSON 处理，这让很多人望而却步。您可能会认为它现在已经成为 PHP 的一部分了（叹气）。

如此多的媒体类型（过去的 MIME 类型）

XML、JSON 和 YAML 都具有可以放入 HTTP Content-Type 标头中的媒体类型。

• application/xml
• applicaiton/json
• application/yaml（尽管 IANA 没有列出官方指定）

看看有多少 媒体类型（以前称为 MIME 类型）由 IANA 定义。

查看有多少个 HTTP 标头。

php://input 或

使用 php://input流允许您绕过 PHP 强加给世界的“保姆/手持”抽象级别。 :-) 能力越大，责任越大！

现在，在处理通过 php://input 传输的数据值之前，您应该/必须做一些事情。

1. 确定是否指示了正确的 HTTP 方法（GET、POST、
   PUT、PATCH、DELETE...)
2. 确定 HTTP Content-Type 标头是否已传输。
3. 确定 Content-Type 的值是否是所需的媒体
   类型。
4. 确定发送的数据是否格式良好 XML / JSON / YAML /
   等等。
5. 如有必要，将数据转换为 PHP 数据类型：数组或
   目的。
6. 如果这些基本检查或转换中的任何一个失败，则抛出异常！

那么字符编码呢？

啊，哈！是的，您可能希望发送到应用程序的数据流采用 UTF-8 编码，但您如何知道它是否是 UTF-8 编码？

两个关键问题。

1. 您不知道有多少数据通过 php://input 传入。
2. 您不确定数据流的当前编码。

您是否打算在不知道流数据有多少的情况下尝试处理流数据？ 这是一个糟糕的主意。您不能完全依赖 HTTP Content-Length 标头来获取流输入大小的指导，因为它可能会被欺骗。

您将需要：

1. 流大小检测算法。
2. 应用程序定义的流大小限制（Apache / Nginx / PHP 限制可能太宽泛）。

您是否打算在不知道流的当前编码的情况下尝试将流数据转换为 UTF-8？如何？ iconv 流过滤器 (iconv 流过滤器示例）似乎想要一个开始和结束编码，就像这样。

'convert.iconv.ISO-8859-1/UTF-8'

因此，如果你有良心，你将需要：

1. 流编码检测算法。
2. 动态/运行时流过滤器定义算法（因为您无法先验地知道起始编码）。

（更新：'convert.iconv.UTF-8/UTF-8' 将强制所有内容为 UTF-8，但您仍然需要考虑 iconv 库中的字符换句话说，您必须定义当无法翻译字符时要采取的操作：1）插入虚拟字符，2）失败/抛出和异常）。

您不能完全依赖 HTTP Content-Encoding 标头，因为这可能表示类似压缩的内容，如下所示。这不是您想要对 iconv 做出决定的原因。

Content-Encoding: gzip

因此，一般步骤可能是...

第一部分：HTTP 请求相关

1. 确定是否已指示正确的HTTP 方法（GET、POST、
   PUT、PATCH、DELETE...)
2. 确定 HTTP Content-Type 标头是否已传输。
3. 确定 Content-Type 的值是否是所需的媒体
   类型。

第二部分：流数据相关

4. 确定输入流的大小（可选，但推荐）。
5. 确定输入流的编码。
6. 如果需要，将输入流转换为所需的字符
   编码（UTF-8）。
7. 如有必要，反转任何应用程序级压缩或加密，然后重复步骤 4、5 和 6。

第三部分：相关数据类型

8. 确定发送的数据是否格式正确 XML / JSON / YMAL /
   等等

（请记住，数据仍然可以是 URL 编码的字符串，然后您必须对其进行解析和 URL 解码）。

9. 如有必要，将数据转换为 PHP 数据类型：数组或
   目的。

第四部分：数据值相关

10. 过滤输入数据。

11. 验证输入数据。

现在你明白了吗？

$_POST 超全局以及用于限制输入的 php.ini 设置对于外行来说更简单。然而，使用流时处理字符编码更加直观和高效，因为不需要循环遍历超全局（或通常是数组）来检查输入值是否正确编码。

Answer 3

php://input 可以为您提供数据的原始字节。如果 POST 数据是 JSON 编码结构（AJAX POST 请求经常出现这种情况），则这非常有用。

这里有一个函数可以做到这一点：

  /**
   * Returns the JSON encoded POST data, if any, as an object.
   * 
   * @return Object|null
   */
  private function retrieveJsonPostData()
  {
    // get the raw POST data
    $rawData = file_get_contents("php://input");

    // this returns null if not valid json
    return json_decode($rawData);
  }

当您处理由传统 POST 提交的表单中的键值数据时，$_POST 数组更有用。仅当 POSTed 数据采用可识别格式时才有效，通常是 application/x-www-form-urlencoded （请参阅 http://www.w3.org/TR/html4/interact/forms.html#h-17.13.4 了解详细信息）。

Answer 4

如果发布数据格式错误，$_POST 将不包含任何内容。然而， php://input 将具有格式错误的字符串。

例如，有一些ajax应用程序，没有形成正确的post键值序列来上传文件，并且只是将所有文件转储为post数据，没有变量名称或任何内容。
$_POST 将为空，$_FILES 也为空，并且 php://input 将包含精确的文件，以字符串形式写入。

Answer 5

if (strtoupper($_SERVER['REQUEST_METHOD']) != 'POST') {
  throw new Exception('Only POST requests are allowed');
}

// Make sure Content-Type is application/json 
$content_type = isset($_SERVER['CONTENT_TYPE']) ? $_SERVER['CONTENT_TYPE'] : '';
if (stripos($content_type, 'application/json') === false) {
  throw new Exception('Content-Type must be application/json');
}

// Read the input stream
$body = file_get_contents("php://input");
 
// Decode the JSON object
$object = json_decode($body, true);

Answer 6

如何使用它的简单示例

 <?php  
     if(!isset($_POST) || empty($_POST)) { 
     ?> 
        <form name="form1" method="post" action=""> 
          <input type="text" name="textfield"><br /> 
          <input type="submit" name="Submit" value="submit"> 
        </form> 
   <?php  
        } else { 
        $example = file_get_contents("php://input");
        echo $example;  }  
   ?>