Manual:Configuring file uploads/fr

MediaWiki supporte le téléversement et l'intégration de fichiers multimédia Cette page décrit les aspects techniques de cette propriété, voir et  pour les informations d'usage général.

Existant depuis MediaWiki version 1.1, le téléversement de fichiers est initialement désactivé par défaut, pour des questions de sécurité. Le téléversement de fichiers peut être activé via un paramètre de configuration, bien qu'il soit recommandé de vérifier d'abord certains pré-requis.

Vérifier que les téléversements sont activés en PHP
Les éléments suivants doivent être paramétrés dans le fichier :

Si cela n'est pas paramétré, les scripts PHP ne pourront pas utiliser les fonctions de téléversement, et les téléversements de MediaWiki ne seront pas activés.

Si la directive open_basedir est paramétrée, elle devra inclure à la fois le fichier de destination de téléversement de votre installation MediaWiki ("{$IP}/images") et le 'upload_tmp_dir' (dossier système par défaut si non paramétré). L'ajout du 'upload_tmp_dir' peut éviter les messages comme "Could not find file "/var/tmp/php31aWnF" (où dans cet exemple le upload_tmp_dir' est '/var/tmp') Apprenez-en davantage sur le téléversement de fichiers sur File upload basics et en particulier.

Note: La valeur formelle pour la variable est une expression booléenne. PHP traite chaque chaîne non reconnue comme la valeur 'False' comme étant 'true', par conséquent la valeur 'on', souvent utilisée, renvoie le même résultat.

Vérification pour utilisateurs de Windows et IIS
Paramétrez  pour donner au compte invité internet ( _MachineName, or   for IIS 7+): lecture, écriture et exécution;

Vérification de la sécurité du répertoire
Le répertoire de téléversement doit être configuré pour qu'il ne soit pas possible pour un utilisateur final de téléverser et exécuter d'autres types de scripts, qui pourraient alors s'octroyer un accès à votre répertoire web et endommager votre wiki ou votre site web.

Paramétrez le dossier  (ou le dossier   pour les précédentes versions)pour avoir la permission "755".
 * L'Utilisateur peut lire, écrire et exécuter;
 * Le Groupe peut lire et exécuter;
 * Les Autres peuvent lire et exécuter.

En cas d'utilisation du safe_mode, assurez-vous que le répertoire est la propriété de l'utilisateur qui exécute le script php (qui est l'utilisateur Apache, ou, dans le cas de suphp, le propriétaire du script).

En cas d'utilisation de CentOS 6 ou Mageia, les paramètres "owner:group" de la commande chown doivent être "apache:apache" au lieu de "www-data:www-data".

En cas d'utilisation de SELinux, vérifiez les paramètres ACLs (voir la documentation).

En cas d'utilisation de suphp, vérifiez que le umask a la valeur 0022 (ou moins) dans le fichier /etc/suphp.conf.

Si vous ne souhaitez pas qu'un utilisateur public puisse lister votre répertoire d'images, une option est de le paramétrer dans votre configuration apache:
 *  Restriction du listage de répertoire au dossier des images

Vérifier le fichier .htaccess
Le répertoire  du dossier d'installation MediaWiki contient un fichier .htaccess contenant des paramètres de configuration. Le but de ce fichier est de rendre le dossier de téléversement plus sécurisé, et si vous placez votre répertoire de téléversement ailleurs, il est recommandé de copier également le fichier .htaccess vers un autre endroit, ou d'appliquer cette configuration directement sur le serveur. Toutefois, certains de ces paramètres de configuration peuvent être à l'origine de conflits ou d'erreurs, selon la façon dont le serveur est configuré.

Quelques éléments à prendre en compte:

Avant MediaWiki 1.27, si vous avez un gestionnaire 404 personnalisé pour générer des miniatures avec le script, les règles de ré-écriture dans ce fichier .htaccess pourraient annuler les règles pré-existantes, parce qu'il ne dispose pas de l'option.
 * Si le serveur ne permet pas de modifier ou de retirer des paramètres des fichiers .htaccess, demander l'accès à un fichier placé dans ce dossier peut occasionner l'erreur générique "HTTP 500 error". Si tel est le cas, vous devrez décommenter les lignes, et appliquer ces instructions directement sur les fichiers de configuration du serveur. Les instructions qui ont le plus de chances de causer des problèmes sont  - qui empêche les fichiers HTML et PHP d'être renvoyés en HTML -, et   - qui empêche les fichiers PHP d'être parsés et exécutés en tant que tels sur le serveur.

Paramétrer le téléversement sur on/off
Dans MediaWiki version 1.5 et supérieures, l'attribut qui doit être paramétré est dans  et est fixé de la manière suivante:

Pour désactiver la fonctionalité de téléversement, initialisez l'attribut à 'false':

Dans les versions plus anciennes du logiciel, l'attribut à paramétrer se situe dans , mais il est placé plus haut, par exemple. La valeur par défaut est la suivante:

Inverser la valeur pour activer les téléversements:

Utilisation d'un répertoire central
InstantCommons est une caractéristique, activée par un changement dans la configuration, qui vous donne un accès immédiat aux millions de fichiers libres (dont la licence est libre) de Wikimedia Commons.

Permissions de téléversement
Par défaut, tous les utilisateurs enregistrés peuvent téléverser des fichiers. Pour limiter cela, vous devez modifier :


 * Pour empêcher les utilisateurs standards de téléverser des fichiers :


 * Pour créer un groupe spécial nommé « uploadaccess », et autoriser les membres de ce groupe à téléverser des fichiers :


 * Pour autoriser les utilisateurs « autoconfirmés » (non débutants) à téléverser des fichiers :

Le droit de remplacer des fichiers existants est géré par une permission spéciale, appelée :


 * Pour empêcher les utilisateurs standards d'effacer des fichiers existants :


 * Pour autoriser les utilisateurs « autoconfirmés » (non débutants) à remplacer des fichiers existants:

Si un fichier des dépôts extérieurs (ForeignFileRepo) est configuré, le droit de remplacer localement ces fichiers est géré par une permission spéciale, appelée :


 * Pour empêcher les utilisateurs standards d'effacer localement les fichiers de dépôt :


 * Pour autoriser les utilisateurs « autoconfirmés » (non débutants) de remplacer localement les fichiers de dépôts:

Voir Manual:User rights pour plus de détails sur les droits des utilisateurs, et Manual:Preventing access pour plus d'informations sur les limitations des droits.

Configuration des types de fichier
Vous pouvez ajouter $wgFileExtensions dans le fichier LocalSettings.php pour autoriser les téléversements des autres types de fichiers souhaités. Par exemple, vous pouvez changer la ligne de $wgFileExtensions pour obtenir quelque chose comme

ou

ou

Cependant, certaines extensions de fichier sont blacklistées ($wgFileBlacklist) et ne peuvent pas être téléversées, même si elles sont ajoutées à $wgFileExtensions. Pour téléverser les fichier dont les extensions sont blacklistées, vous devez modifier la blacklist. Par exemple, pour autoriser les utilisateurs à téléverser des exécutables:

De plus, $wgMimeTypeBlacklist empêche certains types de fichier basés sur des types MIME; les fichiers .zip, par exemple, sont interdits car basés sur des types MIME (MediaWiki version 1.14 à 1.17).

Vous pouvez aussi paramétrer

Pour autoriser les plupart des types de fichiers. Cependant, les types de fichiers blacklistés et les types MIME ne seront toujours pas permis.

Si vous recevez l'erreur "The file is corrupt or has an incorrect extension", assurez-vous que la détection des types MIME fonctionne correctement.

Si vous décidez d'autoriser n'importe quel type de fichier, assurez-vous que votre détection MIME fonctionne et pensez à.

Pour activer l'extension zip (testée avec MediaWiki v1.19.23) le paramétrage suivant sera nécessaire dans le fichier LocalSettings.php:

Connexion
Par defaut les téléversements anonymes ne sont pas autorisés. Vous devez vous enregistrer et vous connecter avant que le lien upload file (téléverser un fichier) n'apparaisse dans la boîte à outils.

Affichage des vignettes
For information about automatic rendering/thumbnailing of images, see . For problems with thumbnailing, see Image Thumbnails not working and/or appearing.

If the file is not visual (like an Image or Video) a fileicon is used instead. These are generated by the  function in the File class in the FileRepo group. Icons stored in " " in a " "-format.

Définir la taille maximale du fichier téléversé
Par défaut, le code de configuration dans limite la taille des fichiers à téléverser à 2 mégabytes (et la taille maximum pour une opération POST à 8 mégabytes). Pour permettre le téléversement de fichiers plus longs, modifiez ces paramètres dans php.ini:
 * , 8 megabytes large by default
 * , 2 megabytes de long par défaut

This may require root access to the server. (If you are on a shared host, contact your server administrator.)

The location of the php.ini file varies on the distribution you are using. (Try "locate php.ini" or "php -i" to find the location of your config file.)
 * Locating the php.ini file

It is important to change the php.ini file in the apache2 folder. For example, there may be a core default php.ini at  as well as one at. If you are using mod_php (most common), the most likely location for the correct php.ini file is in  or. For php-fastcgi, edit /etc/php5/cgi/php.ini.

If you have more than one website hosted on a server and want to change only for MediaWiki, insert into your /etc/apache2/sites-enabled/your_wiki_site.com inside :
 * Multiple websites hosted on a server

Both above settings also work in a .htaccess file if your site uses mod_php. If your site uses PHP >= 5.3 and allows it, you can place php.ini directives in .user.ini files instead.


 * web server limits

Votre serveur web peut imposer d'autres limites sur la taille des fichiers autorisés pour le téléversement. For Apache, one of the relevant settings is LimitRequestBody. For Nginx, client_max_body_size is the relevant setting. For Lighttpd, server.max-request-size is what may need modification.

Ubuntu 16.04:

(sudo /etc/init.d/php5-fpm restart in Linux, for example.)


 * avertissement de téléversement de fichiers trop volumineux

MediaWiki lui-même éméet un avertissement si vous essayez de téléverser des fichiers plus gros que ce qui spécifié par l'option. This is independent of the hard limit imposed by PHP.

Les modifications temporaires des limites de téléversement (quand vous utilisez de multiple wikis sur une ferme, par exemple) peuvent être modifiées en ajoutant les lignes :
 * limites de téléversement temporaire

to the MediaWiki LocalSettings.php configuration file for each wiki. In this example the PHP limit is set at 50 Mb. Note that these settings will not override the maximum settings set above (since the core php.ini and apache2 php.ini files set the absolute maximum). This method sets maximums that are less than the absolute maximum.


 * limite de téléversement IIS7

  

Avec la taille ci-dessus maxAllowedContentLength, les utilisateurs peuvent téléverser des fichiers qui ont une taille de 50.000.000 octets (50 MB). This setting will work immediately without restarting IIS services. The web.config file is located in the root directory of your web site.

Pour permettre le téléversement de fichiers jusqu'à 2 Giga:

add the following lines to LocalSettings.php:

Also, modify the following lines in :

In the IIS web.config file, override the value of maxRequestLength. Par exemple, l'entrée suivante dans web.config permet aux fichiers qui font 2 gigabytes (GB) ou moins, d'être téléversés :

Avec IIS 7, vous avez aussi besoin de le configurer pour autoriser les téléversements volumineux. This is found by clicking “Request Filtering > Edit Feature Settings” in the IIS section in the middle of the window. Set the ”Maximum allowed content length (Bytes)” field to 2147482624. If you don’t see "Request Filtering" in the IIS section, it needs enabled via Internet Information Services > World Wide Web Services > Security in the "Turn Windows features on or off" area in Control Panel.

Si le conseil ci-dessus ne permet pas de longs téléversements, alors ouvrez une fenêtre de commande et exécutez la commande suivante :

Permettre le téléversement des fichiers Java JAR
Par défaut, MediaWiki va analyser tous les téléversements qui semblent être des archives ZIP et rejeter ceux qui contiennent des fichiers Java .class. Ceci est une mesure de sécurité pour empêcher les utilisateurs de téléverser une applet Java malicieuse. For non-public sites only, use the following to disable this check:

This setting can be used as a work around for allowing mimetypes to be accepted indiscriminately. Par exemple, si cvous essayez de téléverser un fichier .doc créé par Word 2007, peu importe la quantité de texte que vous fournissez et que le type de contrôle de MIME que vous invoquez ou que vous banissez, vous recevrez le message :


 * The file is a corrupt or otherwise unreadable ZIP file. It cannot be properly checked for security.

.doc files saved by Word 2007 (and possibly later versions) contain a small embedded ZIP archive storing metadata that is not representable in the binary .doc format as used by earlier versions of Word. This embedded ZIP data confuses the Java archive scanner, causing the .doc file to be rejected. Les fichiers dans le nouveau format de fichier .docx sont des archives ZIP valided dans leur totalité, et peuvent être téléversées normalement sans initialiser.

Téléversement direct à partir d'une URL ("Sideloading")
Si vous voulez autoriser un utilisateur à téléverser directement des fichiers à partir d'une URL, au lieu d'utiliser un fichier se trouvant en local sur leur ordinateur, fixez.

Par défaut, les téléversement par URL ne sont possibles uniquement en utilisant l'API (ou des extensions telles que UploadWizard). Pour rendre l'option utilisable, dans Special:Upload, vous devez fixer à true également. Sur l'IHM de téléversement, vous verrez ensuite un champ supplémentaire pour l'URL, sous le champ usuel du nom de fichier. The URL field is greyed out per default, but can be activated by activating the radiobutton (checkbox) to the left of the field.

Pour utiliser cette fonctionalité, les utilisateurs doivent avoir le droit utilisateur. This right was granted to sysops by default until MediaWiki 1.20 but it now needs to be granted explicitly. To allow this to normal users, set Keep in mind that allowing uploads directly from an arbitrary location on the web makes it easier to upload random, unwanted material, and it might be misunderstood as an invitation to upload anything that people might come across on the web.

Restituer les images
Undeleting images is possible as an option since MediaWiki 1.8, and enabled by default since MediaWiki 1.11.

Prior to MediaWiki 1.11, you can enable undeletion of images by setting = true. Since version 1.11, the behavior is controlled by, and deleted files are per default stored in /deleted. Since version 1.17, $wgFileStore has been deprecated and should be used instead.

Téléversements en nombre
Un nombre d'outils sont disponibles pour téléverser des fichiers multiples en une seule fois plutôt que au coup par coup :

Répertoire de téléversement
Whenever an image is uploaded, several things are created:


 * 1) An article in the file namespace with the name of the file, e.g. File:MyPicture.png. This page is stored and can be edited like any other page.
 * 2) Le fichier lui-même est rangé dans le dossier du système de fichiers, qui est configuré dans  ou vers un de ses sous-répertoires (voir ci-dessous).
 * 3) If necessary and thumbnailing is available, thumbnailed versions of the file will be created when necessary (such as for the usage on the file description page. These are stored in the thumb directory of the image directory, in a separate directory for each main file.

If is enabled (by default), MediaWiki creates several subdirectories in the images directory.

If  is set to , uploaded files will be distributed into sub-directories of $wgUploadDirectory based on the first two characters of the md5 hash of the filename. (e.g. $IP/images/a/ab/foo.jpg) Creation of such subdirectories is handled automatically. This is used to avoid having too many files in one folder because some filesystems don't perform well with large numbers of files in one folder.

If you only maintain a small wiki with few uploaded images, you could turn this off by setting, all images are uploaded in $wgUploadDirectory itself. (e.g. $IP/images/foo.jpg)

Multiwiki sites
Ne pas faire ainsi va mystérieusement casser le téléversement des images.
 * Make sure you've changed the site location in LocalSettings.php from, e.g. /var/lib/mediawiki to wherever your installation is, and created a writeable images directory (most of the rest can be symlinked).

Configuring the upload form
The upload form message provided with the default MediWiki installation (which appears when you click "Upload file" link or go to Special:Upload link) may not go very well for you.

For that case you can edit MediaWiki:Uploadtext contents and provide your own text. If your wiki site is multilanguage don't forget to edit localized versions like MediaWiki:Uploadtext/de.

On the MediaWiki:Licenses page you can customize a drop-down list of licenses for uploads of your site.

Take into account that localized versions like MediaWiki:Licenses/de won't work by default. To enable them you must configure the variable.

Edit MediaWiki:Upload-default-description to add an initial text to the "Summary" field of your upload form (for example your wiki site has a universal template for upload summaries and you want everyone to use that template).

See also:

Known problems on Windows
Running MediaWiki on Windows server has some restrictions in allowed filenames, due to a PHP bug. PHP can't handle filenames with non-ascii characters on it correctly, and MediaWiki will refuse to upload files containing such characters to prevent broken uploads, with the message .

Since MediaWiki 1.31 MediaWiki can handle filenames with non-ascii characters if it's using PHP 7.1 or later.

Known problems with database names having non-alphanumeric characters
Si contient des caractères non alphanumériques, le téléversement peut échouer avec des erreurs comme Could not create directory « mwstore://local-backend/local-public/&lt;path&gt; ». . This is caused by an internal check for valid container name for file backend, but it's constructed using $wgDBname.

Depuis MediaWiki 1.26, les téléversements sont permis si $wgDBname contient des points.