#48308 [NEW]: Stronly suggest updating doc page for flock()
| From: | gutza at moongate dot ro | Date: | Sat, 16 May 2009 23:25:07 +0000 |
| Subject: | #48308 [NEW]: Stronly suggest updating doc page for flock() | ||
| Groups: | php.webmaster | ||
| Request: | Send a blank email to php-webmaster+get-4789@lists.php.net to get a copy of this message | ||
From: gutza at moongate dot ro
Operating system: irrelevant
PHP version: Irrelevant
PHP Bug Type: Website problem
Bug description: Stronly suggest updating doc page for flock()
Description:
------------
The documentation page for flock() should clearly state that $handle is
symbolically linked.
Reproduce code:
---------------
<?php
$fo = fopen('lockfile.txt','a');
flock($fo,LOCK_EX);
$fo = '';
// Lock is disable
?>
(This is a copy of mallory dot dessaintes at gmail dot com's User
Contributed Note on that page)
Expected result:
----------------
Given PHP's usual behavior related to variables, one would expect either
that (1) flock() wasn't affected by any subsequent change of $handler, or
(2) that this peculiarity would be explicitly documented.
Actual result:
--------------
Neither of the above. If (1) isn't an option, (2) should be implemented --
that is, the documentation should mention this explicitly.
--
Edit bug report at http://bugs.php.net/?id=48308&edit=1
--
Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=48308&r=trysnapshot52
Try a CVS snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=48308&r=trysnapshot53
Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=48308&r=trysnapshot60
Fixed in CVS: http://bugs.php.net/fix.php?id=48308&r=fixedcvs
Fixed in CVS and need be documented: http://bugs.php.net/fix.php?id=48308&r=needdocs
Fixed in release: http://bugs.php.net/fix.php?id=48308&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=48308&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=48308&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=48308&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=48308&r=support
Expected behavior: http://bugs.php.net/fix.php?id=48308&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=48308&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=48308&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=48308&r=globals
PHP 4 support discontinued: http://bugs.php.net/fix.php?id=48308&r=php4
Daylight Savings: http://bugs.php.net/fix.php?id=48308&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=48308&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=48308&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=48308&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=48308&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=48308&r=mysqlcfg