Doc #71638 [NEW]: [minor clarification] return value on fail of stream_filter_append()

From: vike2000 at gmail dot com Operating system: MacOS 10.6.8 PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:[minor clarification] return value on fail of stream_filter_append() Description: ------------ --- From manual page: http://www.php.net/function.stream-filter-append --- Page should include that the function only returns a resource on success and returns false on error (still - regarding v5.2 change). Regarding section "Return Values Returns a resource which can be used to refer to this filter instance during a call to stream_filter_remove()." (I'm trying to follow instructions around documentation user notes.) Test script: --------------- var_dump(stream_filter_append(fopen('/dev/null','rb'),'null')); /* Same for all my versions: PHP 5.3.29 with Suhosin-Patch (cli) (built: Oct 3 2015 20:34:12) (DEBUG) PHP 5.4.32 (cli) (built: Oct 3 2015 20:40:05) PHP 5.5.16 (cli) (built: Oct 3 2015 20:49:43) PHP 5.6.0 (cli) (built: Jan 10 2016 22:08:51) */ // My real example was via mod_php v5.6 @ Apache v2.2 appending zlib.deflate to an https stream, giving E_WARNING: stream_filter_append(): Filter failed to process pre-buffered data Expected result: ---------------- false or resource Actual result: -------------- false -- Edit bug report at https://bugs.php.net/bug.php?id=71638&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=71638&r=trysnapshot54 Try a snapshot (PHP 5.5): https://bugs.php.net/fix.php?id=71638&r=trysnapshot55 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=71638&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=71638&r=fixed Fixed in release: https://bugs.php.net/fix.php?id=71638&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=71638&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=71638&r=needscript Try newer version: https://bugs.php.net/fix.php?id=71638&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=71638&r=support Expected behavior: https://bugs.php.net/fix.php?id=71638&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=71638&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=71638&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=71638&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=71638&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=71638&r=dst IIS Stability: https://bugs.php.net/fix.php?id=71638&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=71638&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=71638&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=71638&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=71638&r=mysqlcfg