rfc:autofunc

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
rfc:autofunc [2011/08/05 00:24]
tyrael proposal
rfc:autofunc [2017/09/22 13:28] (current)
Line 3: Line 3:
   * Date: 2011-08-05   * Date: 2011-08-05
   * Author: Ferenc Kovacs <​tyra3l@gmail.com>​   * Author: Ferenc Kovacs <​tyra3l@gmail.com>​
-  * Status: ​Draftz+  * Status: ​Inactive
   * First Published at: https://​wiki.php.net/​rfc/​autofunc   * First Published at: https://​wiki.php.net/​rfc/​autofunc
  
Line 9: Line 9:
 ===== Introduction ===== ===== Introduction =====
  
-The topic of supporting function autoloading was brought up many times in the past, this RFC tries to introduce ​a potential implementation which would be consistent with what we have for autoloading classes. ​+The topic of supporting function autoloading was brought up many times in the past, this RFC introduces ​a potential implementation which would be consistent with what we have for autoloading classes. ​
  
 ===== Proposal ===== ===== Proposal =====
  
-The suggested change would be pretty ​straigtforward ​and BC compatible:​ +The suggested change would be pretty ​straightforward ​and BC compatible:​ 
-  * add a fourth optional parameter for spl_autoload_register called $types with the default value of T_CLASS(this would keep the BC) +  * Add two new constants to spl: SPL_AUTOLOAD_CLASS,​ SPL_AUTOLOAD_FUNCTION.  
-    * as you would guess, this would work the same way as the $error_types parameter works for set_error_handler:​ you can specify for which type(s) of missing tokens should be the autoloader ​called. +  * Add a fourth optional parameter for spl_autoload_register called $types with the default value of SPL_AUTOLOAD_CLASS ​(this would keep the BC), supported values would be any combination of SPL_AUTOLOAD_CLASS and SPL_AUTOLOAD_FUNCTION for now. 
-  * the type for the missing token should ​be also passed to the $autoload_function callback as a second param. +    * As you would guess, this would work the same way as the $error_types parameter works for set_error_handler:​ you can specify for which type(s) of missing tokens ​the autoloader ​should be called. 
-    * this is needed to be able to handle multiple types of tokens with a common callback. +  * The type for the missing token should also be passed to the $autoload_function callback as a second param. 
-    * Note that passing more parameter ​to a function than it has in it'​s ​definition is valid, this would be also backward compatible change.+    * This is needed to be able to handle multiple types of tokens with a common callback. 
 +    * Note that passing more parameters ​to a function than it has in its definition is valid, this would also be a backward compatible change. 
 +  * Change the current class autoloading to only call the autoloaders which match with the SPL_AUTOLOAD_CLASS types. 
 +  * Add the function autoloading to only call the autoloaders which match with the SPL_AUTOLOAD_FUNCTION types. 
 + 
 +==== Future improvements ==== 
 + 
 +Notice that currently only functions are proposed, but we could implement autoloading other tokens (SPL_AUTOLOAD_CONSTANT,​ etc.) with this interface. 
 + 
 +==== Examples ==== 
 +<code php> 
 + <?​php 
 + // old behavior 
 + ​spl_autoload_register( 
 +  function ($name) { 
 +   // include the class definition 
 +   /* ... */ 
 +  } 
 + ); 
 + 
 + // autoload functions 
 + ​spl_autoload_register( 
 +  function ($name) { 
 +   // include the function definition 
 +   /* ... */ 
 +  }, 
 +  true, 
 +  false, 
 +  SPL_AUTOLOAD_FUNCTION 
 + ); 
 + 
 + // autoload mixed 
 + ​spl_autoload_register( 
 +  function ($name, $type) { 
 +   ​switch($type){ 
 +    case SPL_AUTOLOAD_CLASS:​ 
 +     /* ... */ 
 +     ​break;​ 
 +    case SPL_AUTOLOAD_FUNCTION:​ 
 +     /* ... */ 
 +     ​break; ​      
 +   } 
 +  }, 
 +  true, 
 +  false, 
 +  SPL_AUTOLOAD_CLASS|SPL_AUTOLOAD_FUNCTION 
 + ); 
 +</​code>​ 
  
 ==== Patch ==== ==== Patch ====
  
-Non yet, but shouldn'​t be too hard to implement.+Patches welcome! :)
  
 ==== Related RFCs ==== ==== Related RFCs ====
Line 33: Line 81:
   * [[http://​www.mail-archive.com/​internals@lists.php.net/​msg48820.html]]   * [[http://​www.mail-archive.com/​internals@lists.php.net/​msg48820.html]]
  
 +==== Changelog ====
 + * 2011.08.17 - replace the T_* constants with SPL_AUTOLOAD_*
  
rfc/autofunc.1312503851.txt.gz · Last modified: 2017/09/22 13:28 (external edit)