Manuel:$wgUrlProtocols
| Analyseur syntaxique: $wgUrlProtocols | |
|---|---|
| Définit les protocoles supportés et traduits en HTML par l'analyseur MediaWiki. |
|
| Introduit dans la version : | 1.5.0 (r10229) |
| Retiré dans la version : | Encore utilisé |
| Valeurs autorisées : | (tableau de chaînes) (1.6+) (chaînes contenant une expression régulière) (1.5) |
| Valeur par défaut : | voir ci-dessous |
| Autres paramètres : Alphabétique | Par fonction | |
Détails
Définit les protocoles d'URL que MediaWiki reconnaîtra comme valides dans UrlUtils::parse().
Ceci est utilisé à de nombreux endroits.
L'effet le plus visible est qu'il détermine les protocoles permis pour les liens externes : les protocoles non reconnus sont ignorés, aucun lien n'est généré.
Toutefois, il est aussi utilisé à de nombreux autres endroits, y compris le code pour Special:LinkSearch, et des fonctions utilitaires comme UrlUtils::parse() utilisées à un grand nombre d'endroits différents.
Ces exemples ne fonctionnent pas (parce que "test://" n'est pas défini comme un protocole valide):
- test://www.example.com
- [test://www.example.com]
- [test://www.example.com texte du lien]
- Certains navigateurs, comme Mozilla Firefox, ne suivront pas les URLs de fichiers sur les pages qui ont été chargées via HTTP. C'est une mesure de sécurité. Voyez cet article de mozillaZine pour plus d'information, y compris certains trucs sur la manière de contourner cette restriction.
- La plupart des navigateurs ne supportent pas les URLs defichiers distants comme
file://host/share(seul Internet Explorer les gère par défaut. Pour Firefox, un module complémentaire est requis, ou bien utilisez exactement 5 barres obliques commefile://///host/share, voir [1])
 Avertissement : | En MediaWiki 1.20.2+, l'ajout de "file:" sans les barres obliques de fin à $wgUrlProtocols va casser l'insertion de l'image si on utilise la syntaxe [[File:Image.jpg]].
C'est un bogue connu lié à une modification rendant le protocole de l'URL insensible à la casse. Comme solution de contournement, utilisez "file://" au lieu de "file:" comme indiqué ci-dessous. |
Pour permettre d'avoir des liens vers les fichiers locaux (ce qui peut avoir un sens dans le contexte d'un intranet), placez ceci dans votre LocalSettings.php :
$wgUrlProtocols[] = "file://";
En général, vous ne voudrez ajouter que des protocoles à ce tableau.
Valeurs par défaut
| Version de MediaWiki : | ≥ 1.38 Gerrit change 876412 |
| Version de MediaWiki : | 1.35 Gerrit change 876392 |
$wgUrlProtocols = [
'bitcoin:', 'ftp://', 'ftps://', 'geo:', 'git://', 'gopher://', 'http://',
'https://', 'irc://', 'ircs://', 'magnet:', 'mailto:', 'matrix:', 'mms://',
'news:', 'nntp://', 'redis://', 'sftp://', 'sip:', 'sips:', 'sms:',
'ssh://', 'svn://', 'tel:', 'telnet://', 'urn:', 'worldwind://', 'xmpp:',
'//',
];
| Versions de MediaWiki : | 1.24 – 1.37 |
$wgUrlProtocols = [
'bitcoin:', 'ftp://', 'ftps://', 'geo:', 'git://', 'gopher://', 'http://',
'https://', 'irc://', 'ircs://', 'magnet:', 'mailto:', 'mms://', 'news:',
'nntp://', 'redis://', 'sftp://', 'sip:', 'sips:', 'sms:', 'ssh://',
'svn://', 'tel:', 'telnet://', 'urn:', 'worldwind://', 'xmpp:','slack://', '//',
];
| Versions de MediaWiki : | 1.22 – 1.23 |
$wgUrlProtocols = array(
'http://',
'https://',
'ftp://',
'ftps://', // si ftp:// est autorisé, la version sécurisée doit l'être aussi.
'ssh://',
'sftp://', // SFTP > FTP
'irc://',
'ircs://', // @bug 28503
'xmpp:', // autre protocole de communication ouvert
'sip:',
'sips:',
'gopher://',
'telnet://', // si nous voulons soutenir ce qui précède...
'nntp://', // @bug 3808 RFC 1738
'worldwind://',
'mailto:',
'tel:', // si nous voulons des courriels cliquables, pourquoi pas les numéros de téléphone ?
'sms:', // de même, ceci est également standardisé
'news:',
'svn://',
'git://',
'mms://',
'bitcoin:', // même registerProtocolHandler met en liste blanche ceci avec mailto:
'magnet:', // pas de raison pour rejeter les torrents sur magnet: quand ils sont autorisés sur http://
'urn:', // permettre l'utilisation des URN dans les Microdata/RDFa <link ... href="urn:...">
'geo:', // Les URL définissent les géolocalisations, elles sont utiles dans Microdata/RDFa et pour les coordonnées
'//', // pour les URL relatives au protocole
);
| Versions de MediaWiki : | 1.18 – 1.21 |
$wgUrlProtocols = array(
'http://',
'https://',
'ftp://',
'irc://',
'ircs://', // @bug 28503
'gopher://',
'telnet://', // si nous voulons soutenir ce qui précède...
'nntp://', // @bug 3808 RFC 1738
'worldwind://',
'mailto:',
'news:',
'svn://',
'git://',
'mms://',
'//', // pour les URL relatives au protocole
);
| Version de MediaWiki : | 1.17 |
$wgUrlProtocols = array(
'http://',
'https://',
'ftp://',
'irc://',
'gopher://',
'telnet://', // si nous voulons soutenir ce qui précède...
'nntp://', // @bug 3808 RFC 1738
'worldwind://',
'mailto:',
'news:',
'svn://',
'git://',
'mms://',
);
| Versions de MediaWiki : | 1.15 – 1.16 |
$wgUrlProtocols = array(
'http://',
'https://',
'ftp://',
'irc://',
'gopher://',
'telnet://', // si nous voulons soutenir ce qui précède...
'nntp://', // @bug 3808 RFC 1738
'worldwind://',
'mailto:',
'news:',
'svn://',
);
| Versions de MediaWiki : | 1.6 – 1.14 |
$wgUrlProtocols = array(
'http://',
'https://',
'ftp://',
'irc://',
'gopher://',
'telnet://', // si nous voulons soutenir ce qui précède...
'nntp://', // @bug 3808 RFC 1738
'worldwind://',
'mailto:',
'news:'
);
| Version de MediaWiki : | 1.5 |
$wgUrlProtocols = 'http:\/\/|https:\/\/|ftp:\/\/|irc:\/\/|gopher:\/\/|news:|mailto:';
Modification avancée
Les protocoles par défaut doivent tous être sûrs en cliquant dessus (sans effet de bord pervers), et supprimer un protocole de la liste fera que les URLs utilisant ces protocoles ne seront plus reconnues à de nombreux endroits du logiciel. En particulier, supprimer 'http://' ou d'autres protocoles courants provoquera certainement de nombreux soucis. Néanmoins, si vous devez le faire (par exemple, quand l'espace de noms News: existe déjà), vous pouvez faire quelque chose comme ceci :
$wgUrlProtocols = array_diff($wgUrlProtocols, array('news:'));
Voir aussi
- Schémas d'URI (historique)
- Liens UNC