#46258 [NEW]: fsockopen() missing/incorrect documentation

From: ltjackal at email dot cz Operating system: Linux PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: fsockopen() missing/incorrect documentation Description: ------------ if the host is unavailable then warning message is generated. documentation is silent about this behavior and function should return false, not false and generate warning. and making function silent by 'at' (@) is not what i have in mind. thank you. Reproduce code: --------------- you can use demo code in documentation. Expected result: ---------------- return false or an exception. do not generate warning message. Actual result: -------------- Warning: fsockopen() [function.fsockopen]: unable to connect to AA.BB.CC.DD:XY (Connection timed out) in /foo/bar/path.php on line 1234; -- Edit bug report at http://bugs.php.net/?id=46258&edit=1 -- Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=46258&r=trysnapshot52 Try a CVS snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=46258&r=trysnapshot53 Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=46258&r=trysnapshot60 Fixed in CVS: http://bugs.php.net/fix.php?id=46258&r=fixedcvs Fixed in release: http://bugs.php.net/fix.php?id=46258&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=46258&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=46258&r=needscript Try newer version: http://bugs.php.net/fix.php?id=46258&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=46258&r=support Expected behavior: http://bugs.php.net/fix.php?id=46258&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=46258&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=46258&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=46258&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=46258&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=46258&r=dst IIS Stability: http://bugs.php.net/fix.php?id=46258&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=46258&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=46258&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=46258&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=46258&r=mysqlcfg