diff --git a/appendices/wrappers.xml b/appendices/wrappers.xml index fa0283b769..cc400455e9 100644 --- a/appendices/wrappers.xml +++ b/appendices/wrappers.xml @@ -428,16 +428,26 @@ X-MyCustomHeader: Foo print and echo. - php://input allows you to read raw POST data. - It is a less memory intensive alternative to - $HTTP_RAW_POST_DATA and does not need any - special &php.ini; directives. + php://input allows you to read raw data + from the request body. + In case of POST requests, it preferrable to + $HTTP_RAW_POST_DATA as it does not depend on + special &php.ini; directives. Moreover, for those cases where + $HTTP_RAW_POST_DATA is not populated by + default, it is a potentially less memory intensive alternative + than activating allways_populate_raw_post_data. php://input is not available with enctype="multipart/form-data". - php://input can only be read once. + A stream opened with php://input can only be read + once; the stream does not support seek operations. However, depending + on the SAPI implementation, it may be possible to open another + php://input stream and restart reading. This is + only possible if the request body data has been saved. Typically, this + is the case for POST requests, but not other request methods, such as + PUT or PROPFIND.