La funzione esc_url()

Usare sempre esc_url per ripulire gli URL . Questa funzione rigetterà gli url che non hanno uno dei protocolli inseriti nella whitelisted di WP come HTTP, HTTPS, FTP, FTPS, mailto, news, IRC, Gopher, NNTP, mangimi, e telnet, ed elimina i caratteri non validi, e rimuove i caratteri pericolosi. Questa funzione inoltre codifica caratteri come entità HTML: Ossia Codifica commerciali (&) e virgolette singole ( ‘), sia riferimenti a entità numerici (& # 038, & # 039).

Se l’URL è uncollegamento assoluto antepone http://.
Mentre gli URL relativi (/ my-url / parametro2 /), così come ancore (#myanchor) e gli elementi di parametri (? Myparam = yes) vengono filtrati, senza anteporre il protocollo predefinito per l’URL.

Sostituisce il clean_url deprecato ().

Utilizzo

<?php esc_url( $url, $protocols, $_context ); ?>

parametri

• $ url ( Stringa ) ( richiesto ) L’URL da pulire. Predefinito: Nessuno
• $protocols ( Matrice ) ( opzionale ) Una serie di protocolli accettabili. Il valore predefinito è ‘ http ‘, ‘ https ‘, ‘ ftp ‘, ‘ ftps ‘, ‘ mailto ‘, ‘ Notizie ‘, ‘ IRC ‘, ‘ Gopher ‘, ‘ NNTP ‘, ‘ mangime ‘, ‘ telnet ‘, ‘ mm ‘, ‘ rtsp ‘, ‘ svn ‘, ‘ tel ‘, ‘ fax ‘, ‘ XMPP ‘ se non impostato.
• Predefinito: null

$ _context
( Stringa ) ( opzionale ) Come verrà utilizzato l’URL. Il valore predefinito è ‘ display ‘ che rappresenta anche il parametro più sicuro.

La pulizia $url dopo il ‘ esc_url viene applicato il filtro’. Una stringa vuota viene restituito se $ url specifica un protocollo diverso da quelli $protocols , o se $url contiene una stringa vuota.

Esempi
L’aggiunta di un link alla home

<a href="<?php eco esc_url( home_url('/') ); ?> "> Inizio </a>