esc_url_raw( string $url, string[] $protocols = null )

Exécute la fonction esc_url() pour un usage en base de donnée.

Paramètres

$url(string)requis

L'URL à nettoyer.

$protocols(string[])optionnel

Un tableau de protocoles acceptables. Par défaut, la valeur retournée de wp_allowed_protocols().

Valeur par défaut : null

Description / Informations supplémentaires

Contrairement à la fonction esc_url(), la fonction esc_url_raw() ne remplace pas les entités HTML pour l'affichage. L'Url résultante est saine pour utiliser en requêtes de base de donnée, redirections et requêtes HTTPS.

Cette fonction n'est pas sûr pour afficher l'url, utiliser plutôt esc_url().

Retourne

(string) L'URL nettoyée après l'exécution de la fonction esc_url() avec le contexte 'db'.

Déclaration et structure de la fonction esc_url_raw()

function esc_url_raw( $url, $protocols = null ) {
    return sanitize_url( $url, $protocols );
}
esc_url()

Vérifie et nettoie une URL.

Où est utilisée la fonction esc_url_raw() dans le CMS WordPress

Exemples

Bon usage :
$url = 'http://wordpress.org';
$response = wp_remote_get( esc_url_raw( $url ) ); // no need to escape entities
 
if ( ! is_wp_error( $response ) ) {
    echo wp_remote_retrieve_body( $response );
}
Mauvais usage :
<img src="<?php echo esc_url_raw( $url ); ?>" />
<a href="<?php echo esc_url_raw( $url ); ?>">WordPress</a>

Sources

Codex WordPress : esc_url_raw()

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

Retour