3 /***************************************************************************\
4 * SPIP, Systeme de publication pour l'internet *
6 * Copyright (c) 2001-2019 *
7 * Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James *
9 * Ce programme est un logiciel libre distribue sous licence GNU/GPL. *
10 * Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne. *
11 \***************************************************************************/
14 * Filtres d'URL et de liens
16 * @package SPIP\Core\Filtres\Liens
19 if (!defined('_ECRIRE_INC_VERSION')) {
25 * Nettoyer une URL contenant des `../`
27 * Inspiré (de loin) par PEAR:NetURL:resolvePath
31 * resolve_path('/.././/truc/chose/machin/./.././.././hopla/..');
34 * @param string $url URL
35 * @return string URL nettoyée
37 function resolve_path($url) {
38 list($url, $query) = array_pad(explode('?', $url, 2), 2, null);
39 while (preg_match(',/\.?/,', $url, $regs) # supprime // et /./
40 or preg_match(',/[^/]*/\.\./,S', $url, $regs) # supprime /toto/../
41 or preg_match(',^/\.\./,S', $url, $regs) # supprime les /../ du haut
43 $url = str_replace($regs[0], '/', $url);
50 return '/' . preg_replace(',^/,S', '', $url);
55 * Suivre un lien depuis une URL donnée vers une nouvelle URL
57 * @uses resolve_path()
61 * 'http://rezo.net/sous/dir/../ect/ory/fi.html..s#toto',
62 * 'a/../../titi.coco.html/tata#titi');
65 * @param string $url URL de base
66 * @param string $lien Lien ajouté à l'URL
67 * @return string URL complète.
69 function suivre_lien($url, $lien) {
71 if (preg_match(',^(mailto|javascript|data|tel|callto|file|ftp):,iS', $lien)) {
74 if (preg_match(';^((?:[a-z]{3,33}:)?//.*?)(/.*)?$;iS', $lien, $r)) {
75 $r = array_pad($r, 3, null);
77 return $r[1] . resolve_path($r[2]);
80 # L'url site spip est un lien absolu aussi
81 if (isset($GLOBALS['meta']['adresse_site']) and $lien == $GLOBALS['meta']['adresse_site']) {
85 # lien relatif, il faut verifier l'url de base
86 # commencer par virer la chaine de get de l'url de base
87 if (preg_match(';^((?:[a-z]{3,7}:)?//[^/]+)(/.*?/?)?([^/#?]*)([?][^#]*)?(#.*)?$;S', $url, $regs)) {
89 $dir = !strlen($regs[2]) ?
'/' : $regs[2];
91 $get = isset($regs[4]) ?
$regs[4] : '';
92 $hash = isset($regs[5]) ?
$regs[5] : '';
94 switch (substr($lien, 0, 1)) {
96 return $debut . resolve_path($lien);
98 return $debut . resolve_path($dir . $mot . $get . $lien);
100 return $debut . resolve_path($dir . $mot . $get . $hash);
102 return $debut . resolve_path($dir . $lien);
108 * Transforme une URL relative en URL absolue
110 * S'applique sur une balise SPIP d'URL.
113 * @link http://www.spip.net/4127
114 * @uses suivre_lien()
117 * [(#URL_ARTICLE|url_absolue)]
118 * [(#CHEMIN{css/theme.css}|url_absolue)]
121 * @param string $url URL
122 * @param string $base URL de base de destination (par défaut ce sera l'URL de notre site)
123 * @return string Texte ou URL (en absolus)
125 function url_absolue($url, $base = '') {
126 if (strlen($url = trim($url)) == 0) {
130 $base = url_de_base() . (_DIR_RACINE ? _DIR_RESTREINT_ABS
: '');
133 return suivre_lien($base, $url);
137 * Supprimer le protocole d'une url absolue
138 * pour le rendre implicite (URL commencant par "//")
140 * @param string $url_absolue
143 function protocole_implicite($url_absolue) {
144 return preg_replace(';^[a-z]{3,7}://;i', '//', $url_absolue);
148 * Verifier qu'une url est absolue et que son protocole est bien parmi une liste autorisee
149 * @param string $url_absolue
150 * @param array $protocoles_autorises
153 function protocole_verifier($url_absolue, $protocoles_autorises = array('http','https')) {
155 if (preg_match(';^([a-z]{3,7})://;i', $url_absolue, $m)) {
157 if (in_array($protocole, $protocoles_autorises)
158 or in_array(strtolower($protocole), array_map('strtolower', $protocoles_autorises))) {
166 * Transforme les URLs relatives en URLs absolues
168 * Ne s'applique qu'aux textes contenant des liens
171 * @uses url_absolue()
172 * @link http://www.spip.net/4126
174 * @param string $texte Texte
175 * @param string $base URL de base de destination (par défaut ce sera l'URL de notre site)
176 * @return string Texte avec des URLs absolues
178 function liens_absolus($texte, $base = '') {
179 if (preg_match_all(',(<(a|link|image|img|script)\s[^<>]*(href|src)=[^<>]*>),imsS', $texte, $liens, PREG_SET_ORDER
)) {
180 if (!function_exists('extraire_attribut')) {
181 include_spip('inc/filtres');
183 foreach ($liens as $lien) {
184 foreach (array('href', 'src') as $attr) {
185 $href = extraire_attribut($lien[0], $attr);
186 if (strlen($href) > 0) {
187 if (!preg_match(';^((?:[a-z]{3,7}:)?//);iS', $href)) {
188 $abs = url_absolue($href, $base);
189 if (rtrim($href, '/') !== rtrim($abs, '/') and !preg_match('/^#/', $href)) {
190 $texte_lien = inserer_attribut($lien[0], $attr, $abs);
191 $texte = str_replace($lien[0], $texte_lien, $texte);
204 * Transforme une URL ou des liens en URL ou liens absolus
207 * @link http://www.spip.net/4128
208 * @global mode_abs_url Pour connaître le mode (url ou texte)
210 * @param string $texte Texte ou URL
211 * @param string $base URL de base de destination (par défaut ce sera l'URL de notre site)
212 * @return string Texte ou URL (en absolus)
214 function abs_url($texte, $base = '') {
215 if ($GLOBALS['mode_abs_url'] == 'url') {
216 return url_absolue($texte, $base);
218 return liens_absolus($texte, $base);
223 * htmlspecialchars wrapper (PHP >= 5.4 compat issue)
225 * @param string $string
227 * @param string $encoding
228 * @param bool $double_encode
231 function spip_htmlspecialchars($string, $flags = null, $encoding = 'ISO-8859-1', $double_encode = true) {
232 if (is_null($flags)) {
234 if (defined('ENT_HTML401')) {
235 $flags |
= ENT_HTML401
;
239 return htmlspecialchars($string, $flags, $encoding, $double_encode);
243 * htmlentities wrapper (PHP >= 5.4 compat issue)
245 * @param string $string
247 * @param string $encoding
248 * @param bool $double_encode
251 function spip_htmlentities($string, $flags = null, $encoding = 'ISO-8859-1', $double_encode = true) {
252 if (is_null($flags)) {
254 if (defined('ENT_HTML401')) {
255 $flags |
= ENT_HTML401
;
259 return htmlentities($string, $flags, $encoding, $double_encode);