[Aporte] Mostrar parámetros de funciones al "estilo WordPress"

[metacortex]

Hay una diferencia entre esto

Código PHP:

<?php mi_funcion($alto = 95 , $ancho = 120 , $profundidad = 40 , $color = 'blanco') ?>
 

y esto

Código PHP:

<?php mi_funcion('alto=95¬ancho=120&profundidad=40&color=blanco') ?>
 

La diferencia es que el segundo ejemplo tiene más facilidad de uso para eventuales usuarios finales que no saben mucho de programación (por ejemplo diseñadores web).

Si desarrollamos un proyecto que nos exige orientar la programación hacia la reutilización por parte de terceros del código que generamos, ésta es una propuesta viable. Podemos construir una "semi-API" sencilla y generar etiquetas tipo WordPress listas para usar.

Lo primero que haremos será quitar prestada cierta función nativa de WordPress que trabaja sin problemas de forma independiente:

Código php:

function wp_parse_args( $args, $defaults = '' ) {
    if ( is_object( $args ) )
        $r = get_object_vars( $args );
    elseif ( is_array( $args ) )
        $r =& $args;
    else
        parse_str( $args, $r );
 
    if ( is_array( $defaults ) )
        return array_merge( $defaults, $r );
    return $r;
}
 

Ahora construiremos nuestra función como siempre, pero con algunas ligeras diferencias. Desde luego todos los parámetros serán parte de un array inicial, al cual podemos asignar valores por defecto. Aprovecharé de colocar el código completo para ser probado de una vez:

Código php:

<?php
function wp_parse_args( $args, $defaults = '' ) { // La función de WordPress
    if ( is_object( $args ) )
        $r = get_object_vars( $args );
    elseif ( is_array( $args ) )
        $r =& $args;
    else
        parse_str( $args, $r );
 
    if ( is_array( $defaults ) )
        return array_merge( $defaults, $r );
    return $r;
}
 
function mi_funcion($a = null) { // Nuestra función
    $params = array(
        'alto' => 95,
        'ancho' => 120,
        'profundidad' => 40,
        'color' => 'blanco'
    );
    $r = wp_parse_args($a, $params); // Usamos la función de WP justo aquí
    extract( $r , EXTR_SKIP );
 
    //Ya hemos convertido las claves en variables y trabajamos a nuestro antojo
    $html = '<p>Ancho: '. $ancho .' - Alto: '. $alto .' - Profundidad: '. $profundidad .' - Color: '. $color .'</p>' . "\n";
return $html;
}
 
echo mi_funcion('alto=200&color=Gris Perlado'); // Probando
?>
 

Personalmente prefiero aplicar este método hasta para usarlo yo mismo, debido a lo cómodo que resulta anotar los parámetros.

El método no impide expresar la función de la forma tradicional, cuyo resultado es el mismo si escribimos:

Código php:

echo mi_funcion(array(
    'alto' => 200,
    'color' => 'Gris Perlado'
));
 

Referencia: Ubicación exacta de la función en el sistema de archivos WordPress