wp_parse_args( string|array|object $args, array $defaults = array() )

Description

Cette fonction est utilisée à travers WordPress pour permettre à une chaîne ou à un tableau d'être fusionnés dans un autre tableau.

$args peut aussi être de type requête URL qui sera convertie en tableau et stockée dans $array.

Paramètres

$args

(string | array | object) (Requis) Valeur à fusionner avec $defaults.

$defaults

(array) (Optionnel) Tableau par défaut.

Valeur par défaut : array()

Retourne

(array) Valeurs définies par l'utilisateur fusionnées à celles par défaut.

Structure de la fonction wp_parse_args()

Définie dans le fichier wp-includes/functions.php à la ligne 4419 :

function wp_parse_args( $args, $defaults = array() ) {
    if ( is_object( $args ) ) {
        $parsed_args = get_object_vars( $args );
    } elseif ( is_array( $args ) ) {
        $parsed_args =& $args;
    } else {
        wp_parse_str( $args, $parsed_args );
    }

    if ( is_array( $defaults ) && $defaults ) {
        return array_merge( $defaults, $parsed_args );
    }
    return $parsed_args;
}

Fonction utilisée par wp_parse_args()

wp_parse_str()

Parse une chaîne en variables pour être stockée dans un tableau.

Où trouver la fonction wp_parse_args() dans le CMS Wordpress

Rechercher

Exemple

function wpdocs_ma_function( $args ) {
 
  $defaults = array(
    'name' => 'Mr. nobody',
    'favorite_color' => 'inconnue',
    'age' => 'inconnu',
  );
 
  $args = wp_parse_args( $args, $defaults );
 
  print_r( $args );
}
 
$args = array( 'age' => 36 );
wpdocs_ma_function( $args );
// Affiche : Array(
//   'name' => 'Mr. nobody',
//   'favorite_color' => 'inconnue',
//   'age' => 36,
// )

Sources

Codex Wordpress : wp_parse_args()

Autres fonctions dans le même fichier : wp-includes/functions.php