#48308 [Opn->Csd]: Strongly suggest updating doc page for flock()

ID: 48308 Updated by: vrana@php.net Reported By: gutza at moongate dot ro -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: irrelevant PHP Version: Irrelevant New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: ------------------------------------------------------------------------ [2009-11-19 10:37:00] svn@php.net Automatic comment from SVN on behalf of vrana Revision: http://svn.php.net/viewvc/?view=revision&revision=290972 Log: Overwriting handle would release the log (bug #48308) ------------------------------------------------------------------------ [2009-05-17 13:51:25] bjori@php.net Reclassified as documentation problem ------------------------------------------------------------------------ [2009-05-16 23:48:13] gutza at moongate dot ro Also, the explanation for parameter $operation should NOT read "operation is one of the following", because that's not true (LOCK_NB should be used with LOCK_SH or LOCK_EX, it doesn't make much sense on its own -- I never bothered to test what it does on its own because that's pretty much absurd). ------------------------------------------------------------------------ [2009-05-16 23:25:07] gutza at moongate dot ro 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 this bug report at http://bugs.php.net/?id=48308&edit=1