php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
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
Welcome! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
Package:
Bug Type:
Summary:
From: petk@php.net
New email:
PHP Version: OS:

 

 [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
 
PHP Copyright © 2001-2019 The PHP Group
All rights reserved.
Last updated: Sun Sep 15 10:01:26 2019 UTC