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.