Doc #78048 [Opn->Csd]: Weakref extension and PHP 7.4 weak references might cause confusion

From: Date: Thu, 23 May 2019 08:18:57 +0000
Subject: Doc #78048 [Opn->Csd]: Weakref extension and PHP 7.4 weak references might cause confusion
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-16677@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=78048&edit=1 ID: 78048 Updated by: cmb@php.net Reported by: petk@php.net Summary: Weakref extension and PHP 7.4 weak references might cause confusion -Status: Open +Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant -Assigned To: +Assigned To: cmb Block user comment: N Private report: N New Comment: > 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> Previous Comments: ------------------------------------------------------------------------ [2019-05-23 08:17:27] cmb@php.net Automatic comment from SVN on behalf of cmb Revision: http://svn.php.net/viewvc/?view=revision&amp;revision=347473 Log: Fix #78048: Weakref extension and PHP 7.4 weak references might cause confusion ------------------------------------------------------------------------ [2019-05-21 18:11:33] 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. ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=78048&edit=1

« previous php.doc.bugs (#16677) next »