Argumentos PHP de funciones centrales; el manual dice referencia, sin embargo acepta valores

Question

He notado algunas inconsistencias en el manual de PHP; Se documenta una serie de firmas de función central para aceptar argumentos por referencia, sin embargo, aceptan argumentos por valor.

He publicado una más specific question anteriormente, y @cweiske proporciona una gran respuesta (con referencia a la fuente pertinente PHP), sin embargo estas inconsistencias parecen ser más desenfrenada.

Hay una serie de funciones que se ven afectados por esta (Voy a actualizar esta lista como órdenes; también la nota, estas pruebas se realizaron en un ambiente error_reporting(-1))

• http://www.php.net/manual/en/function.current.php
  • Esto ya se discutió en la cuestión vinculada
• http://www.php.net/manual/en/function.key.php
  • Esto ya se discutió en la cuestión vinculada
• http://www.php.net/manual/en/function.array-replace-recursive.php
  • array  array_replace_recursive  ( array  &$array  , array  &$array1  [, array  &$ ... ] )
  • acepta argumentos $array, $array1, etc., por valor. Esto ha sido corregido.
• http://www.php.net/manual/en/function.array-multisort.php
  • bool array_multisort ( array &$arr [, mixed $arg = SORT_ASC [, mixed $arg = SORT_REGULAR [, mixed $... ]]] )
  • acepta argumentos $arr, etc., por valor. Este debería arrojar un error, ya que no hará nada si el argumento no es una variable.

Ahora a mí respecta, no porque yo estoy siendo anal sobre la documentación, sino porque temo que los desarrolladores de PHP son en la valla de los detalles de implementación de estas funciones (o algo igualmente poco fiable)

Por ejemplo, uso array_replace_recursive(), para tomar un argumento de matriz y aplicarlo contra otra matriz que contenga los valores predeterminados. Algunos de mi base de código se ha aprovechado de esta incoherencia, hacer simplemente:

$values = array_replace_recursive(array(
    'setting_1' => array(
     'sub-setting_1' => '', 
     'sub-setting_2' => '', 
     'sub-setting_3' => '', 
    ), 
    'setting_2' => array(
     'sub-setting_1' => 0, 
     'sub-setting_2' => 0, 
    ), 
    'setting_3' => true, 
), $values); 

lo tanto la producción de una serie con formato correcto (de moverse gratuita isset() llamadas)

¿Debo preocuparme con esto? Estoy pensando en enviar una solicitud de error relacionada con la documentación, pero primero tengo curiosidad si alguien en SO (mirando en su dirección @cweiske) tiene información sobre por qué esto se ha hecho.

Answer 1

Quizás no estoy entendiendo su dilema, pero esas funciones no modifican directamente los datos en sus parámetros, por lo tanto, si aceptan por referencia o valor es un punto discutible, ¿no? De cualquier manera, necesitará asignar el valor de retorno si desea que la llamada a la función realmente haga cualquier cosa para usted.

En términos de conocimiento de por qué es posible que esté viendo la discrepancia. PHP 5 ha tenido muchos cambios en la forma en que funcionan las referencias. De hecho, creo que es PHP 5.3+ que ya no permite ciertos usos de & para asignar por referencia. Lo que puede estar viendo es la transición de algunas de las funciones básicas de PHP para cumplir con las nuevas reglas sobre asignación de referencia. Si la memoria me sirve, la rama de PHP 5.3 en realidad estaba destinada a ser PHP 6, pero se fusionó decididamente en el tronco como una rama en lugar de esperar a que se terminen varias funciones complejas. Esto explicaría por qué nunca antes has visto una confusión como esta en PHP.