php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #78048 Weakref extension and PHP 7.4 weak references might cause confusion
Submitted: 2019-05-21 18:11 UTC Modified: 2019-05-23 08:18 UTC
From: petk@php.net Assigned: cmb (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Anyone can comment on a bug. Have a simpler test case? Does it work for you on a different platform? Let us know!
Just going to say 'Me too!'? Don't clutter the database with that please !
Your email address:
MUST BE VALID
Solve the problem:
40 - 2 = ?
Subscribe to this entry?

 
 [2019-05-21 18:11 UTC] petk@php.net 
Description:
------------
Probably we've missed this one, because it is quite a possibility for a confusion in the near future when weak references will be documented in the manual. The two sound completely the same on the first glance and should be made somehow clear what they are about. If the weakref extension is perhaps abandoned in favour of the new core feature it should be then removed from the manual and PHP should pick namings a bit more ecosystem friendly in the future... The so called weak references chapter is also missing atm with some minor examples.

Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2019-05-23 08:17 UTC] cmb@php.net 
Automatic comment from SVN on behalf of cmb
Revision: http://svn.php.net/viewvc/?view=revision&revision=347473
Log: Fix #78048: Weakref extension and PHP 7.4 weak references might cause confusion
 [2019-05-23 08:18 UTC] cmb@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: cmb
 [2019-05-23 08:18 UTC] cmb@php.net 
> Probably we've missed this one, because it is quite a
> possibility for a confusion in the near future when weak
> references will be documented in the manual.

This topic had been discussed, and we choose to go with
WeakReference since the name is very appropriate[1].  Also,
PECL/weakref is rendered unusable by PHP 7.3[2], so users are
supposed to deal with this slightly confusion naming.

Anyhow, the new WeakReference class is now documented, so I'm
closing this ticket.

[1] <https://externals.io/message/104014#104068>
[2] <https://wiki.php.net/rfc/weakrefs#introduction>
 [2019-05-23 08:20 UTC] salathe@php.net 
Automatic comment on behalf of cmb
Revision: http://git.php.net/?p=doc/en.git;a=commit;h=e37c83105c4a8c4085d13dd7709076d59ac35928
Log: Fix #78048: Weakref extension and PHP 7.4 weak references might cause confusion
 [2020-02-07 06:05 UTC] phpdocbot@php.net 
Automatic comment on behalf of cmb
Revision: http://git.php.net/?p=doc/en.git;a=commit;h=faabf4e74accd1a5791a9144353c91a06f8af154
Log: Fix #78048: Weakref extension and PHP 7.4 weak references might cause confusion
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved. 		Last updated: Thu Apr 25 11:01:30 2024 UTC