View source for Manual:Configuring file uploads/nl

<languages />
MediaWiki ondersteunt het uploaden en de integratie van media-bestanden. 
Op deze pagina worden de technische aspecten van deze functie beschreven, zie {{ll|Manual:Image administration}} en {{ll|Help:Images}} voor algemene gebruiksinformatie.

Vanaf MediaWiki versie 1.1 worden uploads vanwege veiligheidsgerelateerde redenen standaard uitgeschakeld. 
Uploaden kan via een configuratieinstelling worden ingeschakeld, hoewel het wordt aanbevolen dat u eerst bepaalde voorwaarden controleert.

<span id="Prerequisites"></span>
==Voorwaarden==

<span id="Make_sure_uploads_are_enabled_in_PHP"></span>
=== Zorg ervoor dat uploads in PHP zijn ingeschakeld ===

De volgende gegevens moeten worden ingesteld in {{ll|Manual:Php.ini|php.ini}}:

<syntaxhighlight lang="bash">
file_uploads = On
</syntaxhighlight>

Als dit niet is ingesteld, kunnen PHP-scripts de uploadfuncties niet gebruiken en kan het uploaden in MediaWiki niet worden ingeschakeld.

Als de ''open_basedir'' instructie is ingesteld, moet deze zowel de doel-uploadmap in uw MediaWiki-installatie ("{$IP}/images") als de map 'upload_tmp_dir' (standaard systeemmap indien niet ingesteld) bevatten. 
De toevoeging van de 'upload_tmp_dir' kan berichten als ''"Could not find file"/var/tmp/php31aWnF"'' (waarbij in dit voorbeeld de 'upload_tmp_dir' '/var/tmp' is, voorkomen). 
Lees meer over het uploaden van PHP-bestanden op [https://php.net/features.file-upload Basisprincipes van het uploaden van bestanden] en in het bijzonder {{php|move_uploaded_file}}.

{{note|1=De formele waarde voor de variabele is een [[wikipedia:Boolean_algebra|boolean]] expressie. PHP behandelt elke string die niet als de waarde False wordt erkend als waar, dus de vaak gebruikte waarde "on" geeft hetzelfde resultaat.}}


<span id="Check_for_Windows_and_IIS_users"></span>
===Controle voor Windows en IIS users===

Stel <code>%SystemRoot%\TEMP</code> in om toestemming te hebben voor het Internet Guest Account (<code>IUSR</code>_MachineName of <code>IUSR</code> voor IIS 7+): Lezen, schrijven en uitvoeren;

<span id="Check_directory_security"></span>
===Controleer beveiliging map===

De uploadmap moet zo worden geconfigureerd dat het niet mogelijk is voor een [[Talk:Configuring_file_uploads#End_User|eindgebruiker]] om andere scripts te uploaden en uit te voeren, die vervolgens de toegang tot uw webmap kunnen misbruiken en uw wiki of website kunnen beschadigen.

Stel de map <code>/images</code> (of in eerdere versies de map <code>/uploads</code>) in om toestemming te krijgen "755":

*''User'' kan lezen, schrijven en uitvoeren;
*''Group'' kan lezen en uitvoeren;
*''World'' kan lezen en uitvoeren.

{{Note|1=Alleen op de mappen moeten uitvoerbare toestemmingen zijn. Op de bestanden mogen geen uitvoerbare toestemmingen zijn. In Linux, om uitvoerbare toestemmingen te verwijderen van alle bestanden in een map, en om uitvoerbare autorisaties toe te voegen aan de map en alle submappen: ''chmod -x+X uploads_folder -R''}}

Als u {{ll|SELinux}} gebruikt, moet u de ACL's dienovereenkomstig aanpassen (zie hier).

<span id="Check_webserver_security"></span>
===Controleer beveiliging webserver===
See [[Manual:Security#Upload security]] for changes to make to your webserver configuration to prevent uploaded files from executing code or having browsers execute malicious files.

* '''Beperk de mappenlijst in de map met afbeeldingen'''

Als u niet wilt dat een publieke gebruiker uw afbeeldingenmap ziet (als lijst), er is een optie om dit in de Apache-configuratie te zetten:

<syntaxhighlight lang="apache">
        <Directory /var/www/wiki/images>
                Options -Indexes
        </Directory>
</syntaxhighlight>


<span id="Check_.htaccess_file"></span>
=== Bestand .htaccess controleren ===
De map <code>images</code> in de MediaWiki installatie-map bevat een bestand .htaccess met enkele configuraties.
Het doel van dit bestand is om de uploadmap veiliger te maken, en als u de uploadmap ergens anders plaatst, wordt het aanbevolen om het bestand .htaccess ook te kopiëren naar de nieuwe locatie, of die configuratie direct op de server toe te passen.
Sommige van deze configuraties kunnen echter conflicten of fouten veroorzaken, afhankelijk van de configuratie van de server.

Er zijn enkele zaken waaraan u moet denken:

* Als de server niet toestaat of instructies overschrijft in htaccess bestanden, kan toegang tot een bestand onder die map leiden tot een algemene "HTTP 500 fout". Als dat het geval is, moet u de regels op commentaar zetten en die directives direct toepassen op de server configuratiebestanden. De directives die het meest waarschijnlijk de problemen veroorzaken zijn <code>AddType</code> - dat voorkomt dat HTML- en PHP-bestanden als HTML worden geserveerd - en <code>php_admin_flag</code> - die voorkomt dat PHP-bestanden als zodanig worden geanalyseerd en uitgevoerd op de server.

<span id="Setting_uploads_on/off"></span>
== Uploads aan/uit zetten ==
{{MW 1.5|and after}}
{{clear}}
Vanaf MediaWiki versie 1.5 staat het in te stellen attribuut in ''{{ll|Manual:LocalSettings.php|LocalSettings.php}}'' en wordt {{wg|EnableUploads}} als volgt ingesteld:

<syntaxhighlight lang="php">
$wgEnableUploads = true; # Uploaden inschakelen
</syntaxhighlight>

Om de functie uploaden uit te schakelen, zet het attribuut op false:

<syntaxhighlight lang="php">
$wgEnableUploads = false; # Uploaden uitschakelen
</syntaxhighlight>

<span id="Using_a_central_repository"></span>
==Centrale repository gebruiken==

[[InstantCommons]] is een functie, mogelijk gemaakt met een configuratiewijziging, die u direct toegang geeft tot de miljoenen gratis (vrij gelicentieerde) bestanden in Wikimedia Commons.

<span id="Upload_permissions"></span>
== Recht Uploaden ==
Standaard kunnen alle geregistreerde gebruikers bestanden uploaden. 
Om dit te beperken, moet u {{ll|Manual:$wgGroupPermissions|$wgGroupPermissions}} aanpassen:

* Om te voorkomen dat normale gebruikers bestanden kunnen uploaden: <br />{{phpi|1=$wgGroupPermissions['user']['upload'] = false;}}
* Om een speciale groep te maken die "uploadadaccess" heet en leden van die groep toestaan om bestanden te uploaden: <br />{{phpi|1=$wgGroupPermissions['uploadaccess']['upload'] = true;}}
* Om "autobevestigde" (niet-nieuwe) gebruikers toe te staan om bestanden te uploaden: <br />{{phpi|1=$wgGroupPermissions['autoconfirmed']['upload'] = true;}}

Het recht om bestaande bestanden te vervangen wordt als een apart recht gezien, <code>reupload</code>:

* Om te voorkomen dat normale gebruikers bestaande bestanden overschrijven: <br />{{phpi|1=$wgGroupPermissions['user']['reupload'] = false;}}
* Om "autobevestigde" (niet-nieuwe) gebruikers bestaande bestanden te laten vervangen: <br />{{phpi|1=$wgGroupPermissions['autoconfirmed']['reupload'] = true;}}

Als er een ForeignFileRepo is ingesteld, wordt het recht om die bestanden lokaal te vervangen, <code>reupload-shared</code> genoemd:

* Om te voorkomen dat normale gebruikers lokaal filerepo-bestanden kunnen overschrijven: <br />{{phpi|1=$wgGroupPermissions['user']['reupload-shared'] = false;}}
* Om "autobevestigde" (niet-nieuwe) gebruikers lokaal filerepo-bestanden te laten vervangen: <br />{{phpi|1=$wgGroupPermissions['autoconfirmed']['reupload-shared'] = true;}}

Zie '''[[Special:MyLanguage/Manual:User rights|Handleiding Gebruikersrechten]]''' voor details over gebruikersrechten, en [[Special:MyLanguage/Manual:Preventing access|deze pagina]] voor meer informatie over het beperken van toegang.

<span id="Configuring_file_types"></span>
== Bestandstypes configureren ==
U kunt {{ll|Manual:$wgFileExtensions|$wgFileExtensions}} in {{ll|Manual:LocalSettings.php|LocalSettings.php}} toevoegen om uploaden van andere gewenste bestandstypen mogelijk te maken.  
U kunt bijvoorbeeld de regel $wgFileExtensions veranderen in iets als dit

<syntaxhighlight lang="php">
$wgFileExtensions = [ 'png', 'gif', 'jpg', 'jpeg', 'doc',
	'xls', 'mpp', 'pdf', 'ppt', 'tiff', 'bmp', 'docx', 'xlsx',
	'pptx', 'ps', 'odt', 'ods', 'odp', 'odg'
];
</syntaxhighlight>

of

<syntaxhighlight lang="php">
$wgFileExtensions = array_merge( $wgFileExtensions, [
	'doc', 'xls', 'mpp', 'pdf', 'ppt', 'xlsx', 'jpg', 
	'tiff', 'odt', 'odg', 'ods', 'odp'
] );
</syntaxhighlight>

of

<syntaxhighlight lang="php">
# Voeg nieuwe types toe aan de bestaande lijst
$wgFileExtensions[] = 'docx';
$wgFileExtensions[] = 'xls';
$wgFileExtensions[] = 'pdf';
$wgFileExtensions[] = 'mpp';
$wgFileExtensions[] = 'odt';
$wgFileExtensions[] = 'ods';
</syntaxhighlight>

Bepaalde bestandstypes zijn echter verboden ({{ll|Manual:$wgProhibitedFileExtensions|$wgProhibitedFileExtensions}}, voorheen {{ll|Manual:$wgFileBlacklist|$wgFileBlacklist}} voor MediaWiki 1.36 en ouder) en kunnen niet worden geüpload, zelfs als ze worden toegevoegd aan $wgFileExtensions.  
Om die bestanden te uploaden, moet u {{ll|Manual:$wgProhibitedFileExtensions|$wgProhibitedFileExtensions}} wijzigen.  
Om bijvoorbeeld gebruikers in Windows uitvoerbare programma's te laten uploaden:

<syntaxhighlight lang="php">
$wgFileExtensions[] = 'exe';
$wgProhibitedFileExtensions = array_diff( $wgProhibitedFileExtensions, [ 'exe' ] );
</syntaxhighlight>

Bovendien voorkomt {{ll|Manual:$wgMimeTypeExclusions|$wgMimeTypeExclusions}} (voorheen {{ll|Manual:$wgMimeTypeBlacklist|$wgMimeTypeBlacklist}}) bepaalde bestandstypes op basis van [[Special:MyLanguage/Manual:MIME type detection|MIME-type]]; zip bestanden zijn bijvoorbeeld verboden op basis van MIME-type (MediaWiki versie 1.14 tot 1.17).

U kunt ook {{ll|Manual:$wgStrictFileExtensions|$wgStrictFileExtensions}} instellen

<syntaxhighlight lang="php">
$wgStrictFileExtensions = false;
</syntaxhighlight>

om de meeste typen bestanden te laten uploaden. Toch zijn verboden bestandstypes en MIME-types nog steeds niet toegestaan.

{{warning|1=Als u $wgStrictFileExtensions op false zet of $wgProhibitedFileExtension wijzigt, lopen u en uw gebruikers wat risico met de beveiliging.}}

Als u de foutmelding "The file is corrupt or has an incorrect extension" krijgt, zorg dan dat de [[Special:MyLanguage/Manual:MIME type detection|MIME-type detectie]] goed werkt.

Als u besluit om elk bestandstype toe te staan, zorg er dan voor dat uw mimedetectie werkt en denk na over {{ll|Manual:$wgAntivirusSetup|virusscans inschakelen voor uploads}}.

Om de extensie  '''zip''' in te schakelen (getest in MediaWiki v1.19.23) is het volgende nodig in het bestand {{ll|Manual:LocalSettings.php|LocalSettings.php}}:

<syntaxhighlight lang="php">
$wgFileExtensions[] = 'zip';
// $wgTrustedMediaFormats[] = 'ARCHIVE';
$wgTrustedMediaFormats[] = 'application/zip';
</syntaxhighlight>


<span id="Log_in"></span>
== Inloggen/Aanmelden ==
Uploads door anonieme gebruikers zijn standaard niet toegestaan. 
U moet eerst inloggen voordat de link ''Bestand uploaden'' in het vak Hulpmiddelen verschijnt.

<span id="Thumbnailing"></span>
== Miniaturen ==
Voor informatie over het automatisch renderen/thumbnailen van afbeeldingen, zie ''{{ll|Manual:Image_administration#Image_thumbnailing|Miniatuur van afbeelding}}''. 
Voor problemen met het maken van miniaturen, zie ''[[Special:MyLanguage/Manual:Errors and Symptoms#Image Thumbnails not working and/or appearing|Miniaturen van afbeeldingen werken niet of worden niet getoond]]''.

{{MW 1.11|and after}}
Als het bestand niet visueel is (zoals een Afbeelding of Video) wordt er in plaats daarvan een pictogram bestand gebruikt. 
Deze worden gegenereerd door de <code>iconThumb()</code> () functie in de class File in de FileRepo-groep. 
Pictogrammen/iconen worden opgeslagen in "<code>$wgStyleDirectory/common/images/icons/</code>" in een formaat "<code>fileicon-$extension.png</code>".

<span id="Set_maximum_size_for_file_uploads"></span>
== De maximale grootte bij het uploaden van het bestand instellen ==

Browsers vertellen de server de grootte van het bestand dat moet worden geüpload voordat het het bestand daadwerkelijk wordt verstuurd.

Als de upload te groot is, wordt deze geweigerd door de doelserver en mislukt de upload, waardoor meerdere fouten ontstaan, afhankelijk van op welke laag de limiet is opgelegd: 

* Als het een serverlimiet (nginx, Apache) is op de maximale hoeveelheid overgedragen gegevens, kan het gewoon falen met een HTTP 500 fout of HTTP 413 - Request entity too large.
* Als de limiet op PHP-niveau is, als post_max_size wordt overschreden, krijgt u mogelijk een algemene HTTP 500-fout (of gewoon een lege pagina) anders zou MediaWiki een meer betekenisvol foutbericht moeten geven.

[[File:Post max size and upload max filesize.jpg|{{dir|{{pagelang}}|left|right}}|100px|thumb|post_max_size en upload_max_filesize in php.ini]]

De configuratiecode in {{ll|Manual:Php.ini|php.ini}} beperkt standaard de omvang van de uploadbare bestanden tot 2 megabytes (en de maximale omvang van een post-operatie tot 8 megabytes). 
Om grotere bestanden te uploaden, moet u deze parameters in php.ini bewerken:

* {{php-ini|post_max_size}}, standaard 8 megabytes
* {{php-ini|upload_max_filesize}}, standaard 2 megabytes

Hiervoor kan root-toegang tot de server nodig zijn. 
(Als u op een gedeelde host werkt, neem dan contact op met uw serverbeheerder.)

{{Note|1=Als u de maximale upload-bestandsgrootte verhoogt tot een waarde van meer dan 100 MB, moet u {{ll|Manual:$wgMaxUploadSize|$wgMaxUploadSize}} toevoegen met de nieuwe upload-bestandgrootte waarde naar {{ll|Manual:LocalSettings.php|LocalSettings.php}}.}}

; Het vinden van het bestand php.ini:
De locatie van het bestand php.ini varieert afhankelijk van de distributie die u gebruikt. 
Zie {{ll|Manual:php.ini}} voor instructies voor het vinden van php.ini dat door uw server wordt gebruikt. (in tegenstelling tot de php.ini die wordt gebruikt door het binaire bestand van de opdrachtregel). 

;Meerdere websites gehost op een server:
Als u meer dan één website heeft die op een server wordt gehost en u wilt deze alleen voor MediaWiki wijzigen, voeg dan in uw '''/etc/apache2/sites-enabled/your_wiki_site.com''' het volgende toe:

<syntaxhighlight lang="apache">
php_value upload_max_filesize 100M
php_value post_max_size 100M
</syntaxhighlight>

Beide bovenstaande instellingen werken ook in een bestand '''.htaccess''' als uw site mod_php gebruikt.  
Als uw site PHP &gt;= 5.3 gebruikt en dit toestaat, kunt u in plaats daarvan php.ini directives plaatsen in [https://php.net/configuration.file.per-user .user.ini bestanden].

;webserver limieten:

Uw webserver kan verdere limieten opleggen op de omvang van de bestanden die worden geüpload.
Voor Apache is een van de relevante instellingen ''LimitRequestBody''.
<ref name="limitrequestbody">[http://httpd.apache.org/docs/current/mod/core.html#limitrequestbody core - Apache HTTP Server Version 2.4 - LimitRequestBody Directive], Apache handleiding</ref> Voor Nginx is ''client_max_body_size'' de relevante instelling.<ref name="client_max_body_size">[http://wiki.nginx.org/NginxHttpCoreModule#client_max_body_size client_max_body_size], Nginx handleiding</ref> Voor Lighttpd is ''server.max-request-size'' de instelling die mogelijk gewijzigd moet worden.<ref name="server.max-request-size">[http://redmine.lighttpd.net/wiki/lighttpd/server.max-request-sizeDetails server.max-request-size], Lighthttpd handleiding</ref>

{{Note|1=Na het wijzigen van uw php.ini of webserver configuratie, moet u Apache of IIS opnieuw starten.}}

Ubuntu 16.04: <code>sudo service apache2 restart</code>

{{Note|1=Het kan ook zijn dat u '''php5-fpm''' opnieuw moet opstarten na het wijzigen van de PHP (of nginx server) configuratie.}}

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

;Waarschuwing voor het uploaden van te grote bestanden:

MediaWiki geeft zelf een waarschuwing als u bestanden probeert te uploaden die groter zijn dan wat is gespecificeerd met de {{ll|Manual:$wgUploadSizeWarning|$wgUploadSizeWarning}} optie. 
Dit staat los van de harde limiet die PHP oplegt.

; Tijdelijke uploadlimieten:

Tijdelijke wijzigingen in uploadlimieten (bijvoorbeeld bij het gebruik van meerdere wiki's op een farm) kunnen worden gewijzigd door regels toe te voegen:

<syntaxhighlight lang="php">
ini_set( 'post_max_size', '50M' );
ini_set( 'upload_max_filesize', '50M' );
</syntaxhighlight>

aan het MediaWiki LocalSettings.php configuratiebestand voor elke wiki. 
In dit voorbeeld wordt de PHP-limiet ingesteld op 50 Mb. 
Merk op dat deze instellingen de hierboven ingestelde maximuminstellingen niet overschrijven (aangezien de core php.ini en apache2 php.ini-bestanden het absolute maximum instellen). 
Deze methode stelt maxima vast die lager zijn dan het absolute maximum.

;IIS7 uploadlimiet

{{Note|1=Standaard is '''IIS7'''<ref>IIS7 een nieuwe revisie (versie 7.0) van de [[wikipedia:Internet Information Services|Internet Information Services]] die deel uitmaakt van Windows Vista en de volgende Windows Server-versie.</ref> op Windows 2008 kan slechts 30 MB worden geüpload via een webtoepassing. Grotere bestanden geven na het uploaden een fout 404. Als u dit probleem heeft, kunt u het oplossen door de maximale bestandsgrootte te verhogen door de volgende code toe te voegen aan {{tag|system.webServer|open}} in het bestand web.config:}}

 <security>
   <requestFiltering>
     <requestLimits maxAllowedContentLength="50000000" />
   </requestFiltering>
 </security>

Met de bovenstaande maxAllowedContentLength kunnen gebruikers bestanden uploaden die 50.000.000 bytes (50 MB) groot zijn. 
Deze instelling zal onmiddellijk werken zonder dat de IIS-services opnieuw moeten worden gestart.
Het bestand web.config bevindt zich in de root map van uw website.

'''Om het uploaden van bestanden tot 2G toe te staan''':

'''voeg''' de volgende regels toe aan LocalSettings.php:

<syntaxhighlight lang="php">
$wgUploadSizeWarning = 2147483647;
$wgMaxUploadSize = 2147483647;
</syntaxhighlight>

'''wijzig''' ook de volgende regels in {{ll|Manual:Php.ini|php.ini}}:

<syntaxhighlight lang="php">
memory_limit = 2048M (this line may not be necessary)
post_max_size = 2048M
upload_max_filesize = 2048M
</syntaxhighlight>

In het bestand IIS web.config wordt de waarde van maxRequestLength overschreven. 
Bijvoorbeeld, de volgende regel in web.config maakt het mogelijk om bestanden die minder dan of gelijk zijn aan 2 gigabytes (GB) te uploaden:

<syntaxhighlight lang=html>
<httpRuntime maxRequestLength="2097151" executionTimeout="18000"/>
</syntaxhighlight>

Met IIS 7 moet u het ook instellen om grote uploads toe te staan.  
Dit kunt u vinden door te klikken op "Aanvraag filteren > functie-instellingen bewerken" in het IIS-gedeelte in het midden van het venster.  
Stel het veld "Maximum toegestane inhoudslengte (byte)" in op 2147482624.  
Als u niet de optie voor het filteren van de aanvraag ziet, moet deze worden ingeschakeld via Internet-informatiediensten &gt; World Wide Web-diensten &gt; Beveiliging in het gebied "Schakel Windows-functies aan/uit" in het besturingspaneel.

Als de bovenstaande tip grote uploads niet mogelijk maakt, open dan een commando-prompt en voer dit commando uit:

<code>%windir%\system32\inetsrv\appcmd set config -section:requestFiltering -requestLimits.maxAllowedContentLength: 2147482624</code>


<span id="Allowing_Java_JAR_Uploads"></span>
== Java JAR uploads toestaan ==
{{note|1=The details described in this section may no longer work. $wgAllowJavaUploads variable has been removed in MW 1.39.0.}}
Standaard scant MediaWiki alle uploads die ZIP-archieven lijken te zijn en weigert alle uploads die Java bestanden .class bevatten.  
Dit is een beveiligingsmaatregel om te voorkomen dat gebruikers een kwaadaardige Java-applet uploaden.
'''Alleen voor niet-openbare sites''', gebruik het volgende om deze controle uit te schakelen:

<syntaxhighlight lang="php">$wgAllowJavaUploads = true;</syntaxhighlight>

Deze instelling kan worden gebruikt als een middel om MIME-types zonder onderscheid te accepteren. 
Als u bijvoorbeeld een .doc-bestand uploadt dat is gemaakt door Word 2007, ongeacht de tekstlijst die u verstrekt en het MIME-type dat u invoert of verbiedt, ontvangt u het bericht:

:''The file is a corrupt or otherwise unreadable ZIP file. It cannot be properly checked for security.''
doc-bestanden die worden opgeslagen in Word 2007 (en mogelijk latere versies) bevatten een klein ingebed ZIP-archief dat metadata opslaat en niet kan worden weergegeven in het binaire doc-formaat zoals gebruikt door eerdere versies van Word.  
Deze ingebedde ZIP-gegevens verwarren de Java-archiefscanner, waardoor het doc-bestand wordt afgewezen.  
De bestanden in het nieuwere docx-bestandsformaat zijn in hun geheel een geldig ZIP-archief en kunnen met succes worden geüpload zonder {{ll|Manual:$wgAllowJavaUploads|$wgAllowJavaUploads}} in te stellen.

<span id="Uploading_directly_from_a_URL_(&quot;Sideloading&quot;)"></span>
== Rechtstreeks uploaden vanaf een URL ("Sideloading") ==

Als u een gebruiker toestaat om bestanden direct te uploaden vanaf een URL, in plaats van van van een bestand op zijn lokale computer, stel <code class="mw-highlight">{{ll|Manual:$wgAllowCopyUploads|$wgAllowCopyUploads}} = {{#tag:span|true|class=k}}</code> in.

Standaard is uploaden via URL alleen mogelijk met de optie [[Special:MyLanguage/API:Upload|API]] (of met extensies zoals {{ll|Extension:UploadWizard|UploadWizard}}). 
Om de optie bruikbaar te maken die vanaf Special:Upload kan worden gebruikt, moet u ook {{ll|Manual:$wgCopyUploadsFromSpecialUpload|$wgCopyUploadsFromSpecialUpload}} op {{phpi|true}} instellen. 
Op het uploadformulier ziet u dan een extra veld voor de URL, onder het gebruikelijke veld voor de bestandsnaam. 
Het URL-veld wordt standaard grijs weergegeven, maar kan worden geactiveerd door de radio-knop (checkbox) links van het veld te activeren.

Om deze functie te kunnen gebruiken, moeten gebruikers het [[Special:MyLanguage/Manual:$wgGroupPermissions|gebruikersrecht]] <code>upload_by_url</code> hebben. 
Dit recht werd tot MediaWiki 1.20 standaard toegekend aan beheerders, maar moet nu expliciet worden toegekend. 
Om dit voor normale gebruikers mogelijk te maken, 
<syntaxhighlight lang="PHP">
 $wgGroupPermissions['user']['upload_by_url'] = true;
</syntaxhighlight>
Houd er rekening mee dat het toestaan van rechtstreeks uploaden vanaf een willekeurige locatie op het web het gemakkelijker maakt om willekeurig, ongewenste materiaal te uploaden, en het kan verkeerd worden begrepen als een uitnodiging om alles te uploaden dat mensen op het web tegen komen.

{{Note|1=De cURL-ondersteuning van PHP moet worden ingeschakeld om deze functie te kunnen ondersteunen. Configureer uw PHP bij het installeren met behulp van de optie ''--with-curl''}}
{{Note|1=Als uw server internettoegang heeft via een proxy, moet <code>{{ll|Manual:$wgHTTPProxy|$wgHTTPProxy}}</code> dienovereenkomstig worden ingesteld. Of u levert het rechtstreeks of, als uw server de omgevingsvariabele "http_proxy" geeft, zie uw phpinfo (), dan kunt u de volgende code gebruiken in de LocalSettings.php:}}

<syntaxhighlight lang="PHP">
/*
 * Proxy to use for CURL requests.
 */
if ( isset( $_ENV['http_proxy'] )) $wgHTTPProxy = $_ENV['http_proxy'];
</syntaxhighlight>

<span id="Mass_uploading"></span>
==Meerdere bestanden uploaden==

Er zijn hulpmiddelen beschikbaar om meerdere bestanden tegelijk te uploaden in plaats van elk bestand apart:

{{Bulk Uploading}}

<span id="Upload_directory"></span>
== Map upload ==

Bij het uploaden van een bestand worden er verschillende dingen gedaan:

# Een artikel in het bestand namespace met de naam van het bestand, bijvoorbeeld File:MyPicture.png. Deze pagina wordt opgeslagen en kan als elke pagina worden bewerkt.
# Het bestand zelf wordt opgeslagen in de map in het bestandssysteem, dat is geconfigureerd in {{wg|UploadDirectory}} of in een van zijn submappen (zie hieronder). 
# Als miniaturen maken beschikbaar is, worden er miniatuurversies van het bestand gemaakt wanneer nodig (zoals voor gebruik op de pagina met de bestandsbeschrijving). De miniaturen worden opgeslagen in een map thumb in de map image, een map thumb voor elke originele afbeelding.

Als {{ll|Manual:$wgHashedUploadDirectory|$wgHashedUploadDirectory}} is ingeschakeld (standaard), creëert MediaWiki verschillende submappen in de map images.

Als <code>$wgHashedUploadDirectory</code> is ingesteld op <code>true</code>, worden de geüploade bestanden verdeeld in submappen van $wgUploadDirectory op basis van de eerste twee tekens van de md5-hash van de bestandsnaam.  (bijvoorbeeld $IP/images/a/ab/foo.jpg) 
Het aanmaken van dergelijke submappen wordt automatisch gedaan. 
Dit wordt gedaan om te voorkomen dat te veel bestanden in één map zitten omdat sommige bestandssystemen niet goed werken met een groot aantal bestanden in een map.

Als u maar een kleine wiki met een paar geüploade afbeeldingen heeft, kunt u dit uitschakelen door <syntaxhighlight lang=php inline>$wgHashedUploadDirectory = false</syntaxhighlight> in te stellen, alle afbeeldingen worden in $wgUploadDirectory zelf geüpload.  (bijv. $IP/images/foo.jpg)

== Multiwiki sites ==

* Zorg ervoor dat u de locatie van de site in LocalSettings.php heeft gewijzigd van bijvoorbeeld /var/lib/mediawiki naar waar de installatie ook is, en dat u een map met schrijfbare afbeeldingen heeft gemaakt (de meeste van de overige kunnen worden gelinkt met een symlink).

Als u dat niet doet, mislukt het uploaden van afbeeldingen op een mysterieuze manier.

<span id="Configuring_the_upload_form"></span>
== Het uploadformulier configureren ==

Het bericht op het uploadformulier dat bij de standaard MediaWiki-installatie wordt geleverd (dat verschijnt wanneer u op de link "Bestand uploaden" klikt of naar de link [[Special:Upload]] gaat) is mogelijk niet zoals u dat wil.

In dat geval kunt u de inhoud van [[MediaWiki:Uploadtext]] bewerken en uw eigen tekst gebruiken.
Als uw wikisite meertalig is, vergeet dan niet om gelokaliseerde versies zoals [[MediaWiki:Uploadtext/de]] te bewerken.

Op de pagina [[MediaWiki:Licenses]] kunt u een dropdown lijst met licenties aanpassen voor uploaden van uw site.
[[Special:MyLanguage/Manual:Image_administration#Licensing|De documentatie van deze functie]]

Houd er rekening mee dat gelokaliseerde versies zoals [[MediaWiki:Licenses/de]] standaard niet werken.
Om deze in te schakelen moet u de variabele {{wg|ForceUIMsgAsContentMsg}} configureren.

Bewerk [[MediaWiki:Upload-default-description]] om een eerste tekst toe te voegen aan het veld "Opschrijving" van het uploadformulier (bijvoorbeeld uw wiki-site heeft een universeel sjabloon voor uploads van samenvattingen en u wilt dat iedereen dat sjabloon gebruikt).

<span id="Known_problems_on_Windows"></span>
== Bekende problemen op Windows ==
MediaWiki op de Windows-server laten lopen heeft vanwege een PHP-fout enkele beperkingen op de toegestane bestandsnamen. 
PHP kan niet op het juiste manier omgaan met bestandsnamen met niet-ascii-tekens, en MediaWiki weigert bestanden met dergelijke tekens te uploaden om gebroken uploads te voorkomen ({{phabricator|T3780}}), met het bericht ''{{int|windows-nonascii-filename}}''.

MediaWiki kan bestandsnamen met niet-ascii-tekens omgaan als het PHP 7.1 of later gebruikt.

<span id="Known_problems_with_database_names_having_non-alphanumeric_characters"></span>
== Bekende problemen met databasenamen met niet-alfanumerieke tekens ==

{{tracked|T46066}}
Als <code>{{ll|Manual:$wgDBname|$wgDBname}}</code> niet-alfanumerieke tekens bevat, kan de upload mislukken met fouten zoals <samp>Could not create directory "mwstore://local-backend/local-public/&lt;path&gt;".</samp> 
Dit wordt veroorzaakt door een interne controle op geldige containernaam voor de backend van het bestand, maar het is opgebouwd met {{phpi|$wgDBname}}.

Sinds MediaWiki 1.26, staat het uploads toe wanneer {{phpi|$wgDBname}} punten bevat.

<span id="See_also"></span>
== Zie ook ==

* [[Special:MyLanguage/Manual:Security#Upload_security|Beveiliging sectie Upload security]]
* [[Special:MyLanguage/Manual:Configuration settings#Uploads|Configuratie instellingen Bestanden en uploads]]
* {{ll|Category:Upload variables}} - een gelijke lijst maar dan via een categorie (op alfabet)
* [[Special:MyLanguage/Blank_page#You_see_a_Blank_Page|U ziet een lege pagina]] bij het proberen een bestand te uploaden
* [[Manual:Adding support for new filetypes|Ondersteuning voor bestandstypes toevoegen]]

<span id="References"></span>
== Referenties ==
<references />

[[Category:MediaWiki configuration{{#translation:}}|{{PAGENAME}}]]
[[Category:Upload{{#translation:}}|{{PAGENAME}}]]