rfc:directory-opaque-object

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
rfc:directory-opaque-object [2024/10/01 16:28] – Add some details girgiasrfc:directory-opaque-object [2024/10/03 15:03] (current) – Open vote girgias
Line 4: Line 4:
   * Date: 2024-09-14   * Date: 2024-09-14
   * Author: Gina Peter Banyard <girgias@php.net>   * Author: Gina Peter Banyard <girgias@php.net>
-  * Status: Under Discussion+  * Status: In voting
   * Target Version: PHP 8.5   * Target Version: PHP 8.5
   * Implementation: https://github.com/php/php-src/pull/15886   * Implementation: https://github.com/php/php-src/pull/15886
Line 14: Line 14:
 (and in its stricter sense an "opaque object"). (and in its stricter sense an "opaque object").
 Resource/Opaque objects are usually the result of converting resources to objects, Resource/Opaque objects are usually the result of converting resources to objects,
-which in general implies, being <php>final</php>, being not serializable, +which in general implies, being <php>final</php>, not serializable, 
-not constructible via <php>new</php>, cannot be cast, and to not implement any methods.+not constructible via <php>new</php>, cannot be cast, and does not implement any methods.
 However, as this class has existed since PHP 4 none of these things are formally implemented. However, as this class has existed since PHP 4 none of these things are formally implemented.
  
Line 22: Line 22:
 which is visible if one tries to call one of its methods. which is visible if one tries to call one of its methods.
  
-As it seems likely that we will repurpose this class when converting directory resources to objects;+As it seems likely that we will repurpose this class when converting directory resources to objects,
 we think it makes sense to already convert this class to behave like a resource object. we think it makes sense to already convert this class to behave like a resource object.
  
Line 46: Line 46:
  
 As this class is a wrapper around an internal stream resource, As this class is a wrapper around an internal stream resource,
-and cannot be properly initialized without it being returned by <php>dir()</php>. +and cannot be properly initialized without it being returned by <php>dir()</php>, extending it doesn't make any sense.
-Extending it doesn't make any sense.+
  
 ==== Preventing cloning ==== ==== Preventing cloning ====
Line 78: Line 77:
 As per the voting RFC a yes/no vote with a 2/3 majority is needed for this proposal to be accepted. As per the voting RFC a yes/no vote with a 2/3 majority is needed for this proposal to be accepted.
  
-Voting started on 2024-XX-XX and will end on 2024-XX-XX.+Voting started on 2024-10-03 and will end on 2024-10-17.
    
-<doodle title="Accept Change Directory class to behave like a resource object RFC?" auth="girgias" voteType="single" closed="true">+<doodle title="Accept Change Directory class to behave like a resource object RFC?" auth="girgias" voteType="single" closed="false">
    * Yes    * Yes
    * No    * No
rfc/directory-opaque-object.1727800129.txt.gz · Last modified: 2024/10/01 16:28 by girgias

Page Tools