View source for Manual:Configuring file uploads/ko

<languages />
<span lang="en" dir="ltr" class="mw-content-ltr">MediaWiki supports uploading and integration of media files.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">This page describes the technical aspects of this feature, see {{ll|Manual:Image administration}} and {{ll|Help:Images}} for general usage information.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">Starting from MediaWiki version 1.1, uploads are initially disabled by default, due to security considerations.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">Uploads can be enabled via a configuration setting, although it is recommended that you check certain prerequisites first.</span>

<span id="Prerequisites"></span>
== 전제 조건 ==

<span id="Make_sure_uploads_are_enabled_in_PHP"></span>
=== PHP에서 업로드 허용 ===

<div lang="en" dir="ltr" class="mw-content-ltr">
The following needs to be set in {{ll|Manual:Php.ini|php.ini}}:
</div>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
If this is not set, PHP scripts cannot use the upload functions, and MediaWiki's uploads will not be enabled.
</div>

<span lang="en" dir="ltr" class="mw-content-ltr">If the ''open_basedir'' directive is set, it must include both the destination upload folder in your MediaWiki installation ("{$IP}/images") and the 'upload_tmp_dir' folder (default system folder if not set).</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">The addition of the 'upload_tmp_dir' can avoid messages like ''"Could not find file "/var/tmp/php31aWnF"'' (where in this example the 'upload_tmp_dir' is '/var/tmp').</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">Read more about PHP file uploads at [https://php.net/features.file-upload File upload basics] and in particular {{php|move_uploaded_file}}.</span>

{{note|1=<span lang="en" dir="ltr" class="mw-content-ltr">The formal value for the variable is a [[wikipedia:Boolean_algebra | boolean]] expression.</span> <span lang="en" dir="ltr" class="mw-content-ltr">PHP treats each string not recognized as a False value as true, hence the often used "on" value yields the same result.</span>}}


<span id="Check_for_Windows_and_IIS_users"></span>
=== 윈도우 IIS 유저 체크 ===

<div lang="en" dir="ltr" class="mw-content-ltr">
Set <code>%SystemRoot%\TEMP</code> to have permissions for the Internet Guest Account (<code>IUSR</code>_MachineName, or <code>IUSR</code> for IIS 7+): Read, write and execute;
</div>

<span id="Check_directory_security"></span>
=== 디렉토리 보안 체크 ===

<div lang="en" dir="ltr" class="mw-content-ltr">
The upload directory needs to be configured so that it is not possible for an [[Talk:Configuring_file_uploads#End_User|end user]] to upload and execute other scripts, which could then exploit access to your web directory and damage your wiki or web site.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Set the <code>/images</code> folder (or the <code>/uploads</code> folder in previous versions) to have permission "755":
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*''User'' can read, write and execute;
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
*''Group'' can read and execute;
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
*''World'' can read and execute.
</div>

{{Note|1=폴더에만 실행 권한이 있어야 합니다. 파일에는 실행 권한이 없어야 합니다. <span lang="en" dir="ltr" class="mw-content-ltr">In Linux, to remove executable permissions from all files in a folder, and to add executable permissions to the folder and all sub folders:</span> ''chmod -x+X uploads_folder -R''}}

<div lang="en" dir="ltr" class="mw-content-ltr">
If using {{ll|SELinux}}, make sure to adjust the ACLs accordingly (see there).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Check webserver security ===
</div>
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.

<div lang="en" dir="ltr" class="mw-content-ltr">
* '''Restrict directory listing on images folder'''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you don't want a public user to list your images folder, an option is to set this up in your apache configuration:
</div>

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


<span id="Check_.htaccess_file"></span>
=== .htaccess 파일 체크 ===
<span lang="en" dir="ltr" class="mw-content-ltr">The <code>images</code> directory in the MediaWiki installation folder contains an .htaccess file with some configurations on it.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The goal of this file is to make the upload folder more secure, and if you place your upload directory somewhere else, it's recommended to also copy the .htaccess file to the new location, or apply that configuration on the server directly.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">However, some of those configurations may cause conflicts or errors, depending on how the server is configured.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
Some things to take into account:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* If the server doesn't allow to set or override directives in .htaccess files, accessing any file under that folder may result in a generic "HTTP 500 error".
</div> <span lang="en" dir="ltr" class="mw-content-ltr">If that's the case, you should comment-out the lines, and apply those directives directly on the server configuration files.</span> <span lang="en" dir="ltr" class="mw-content-ltr">The directives that are most likely causing the problems are <code>AddType</code> —which prevents HTML and PHP files from being served as HTML—, and <code>php_admin_flag</code> —which would prevent PHP files from being parsed and executed on the server as such.</span>

<span id="Setting_uploads_on/off"></span>
== 업로드 on/off 설정 ==
{{MW 1.5|and after}}
{{clear}}
<div lang="en" dir="ltr" class="mw-content-ltr">
In MediaWiki version 1.5 and later, the attribute to be set resides in ''{{ll|Manual:LocalSettings.php|LocalSettings.php}}'' and {{wg|EnableUploads}} is set as follows:
</div>

<syntaxhighlight lang="php">
$wgEnableUploads = true; # Enable uploads
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
To disable upload functionality, set the attribute to false:
</div>

<syntaxhighlight lang="php">
$wgEnableUploads = false; # Disable uploads
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Using a central repository==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
[[InstantCommons]] is a feature, enabled with a configuration change, which gives you immediate access to the millions of free (freely licensed) files in Wikimedia Commons.
</div>

<span id="Upload_permissions"></span>
== 업로드 권한 ==
<span lang="en" dir="ltr" class="mw-content-ltr">Per default, all registered users can upload files.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">To restrict this, you have to change {{ll|Manual:$wgGroupPermissions|$wgGroupPermissions}}:</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
* To prevent normal users from uploading files:
</div> <br />{{phpi|1=$wgGroupPermissions['user']['upload'] = false;}}
<div lang="en" dir="ltr" class="mw-content-ltr">
* To create a special group called "uploadaccess", and allow members of that group to upload files:
</div> <br />{{phpi|1=$wgGroupPermissions['uploadaccess']['upload'] = true;}}
<div lang="en" dir="ltr" class="mw-content-ltr">
* To allow "autoconfirmed" (non-newbie) users to upload files:
</div> <br />{{phpi|1=$wgGroupPermissions['autoconfirmed']['upload'] = true;}}

<div lang="en" dir="ltr" class="mw-content-ltr">
The right to replace existing files is handled by an extra permission, called <code>reupload</code>:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* To prevent normal users from overriding existing files:
</div> <br />{{phpi|1=$wgGroupPermissions['user']['reupload'] = false;}}
<div lang="en" dir="ltr" class="mw-content-ltr">
* To allow "autoconfirmed" (non-newbie) users to replace existing files:
</div> <br />{{phpi|1=$wgGroupPermissions['autoconfirmed']['reupload'] = true;}}

<div lang="en" dir="ltr" class="mw-content-ltr">
If a ForeignFileRepo is set, the right to replace those files locally is handled by an special permission, called <code>reupload-shared</code>:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* To prevent normal users from overriding filerepo files locally:
</div> <br />{{phpi|1=$wgGroupPermissions['user']['reupload-shared'] = false;}}
<div lang="en" dir="ltr" class="mw-content-ltr">
* To allow "autoconfirmed" (non-newbie) users to replace filerepo files locally:
</div> <br />{{phpi|1=$wgGroupPermissions['autoconfirmed']['reupload-shared'] = true;}}

<div lang="en" dir="ltr" class="mw-content-ltr">
See '''[[Special:MyLanguage/Manual:User rights|Manual:User rights]]''' for details on user rights, and [[Special:MyLanguage/Manual:Preventing access|Manual:Preventing access]] for more information about restricting access.
</div>

<span id="Configuring_file_types"></span>
== 파일 유형 설정하기 ==
<span lang="en" dir="ltr" class="mw-content-ltr">You can add {{ll|Manual:$wgFileExtensions|$wgFileExtensions}} in {{ll|Manual:LocalSettings.php|LocalSettings.php}} to allow uploads of other desired file types.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">For example, you can change the $wgFileExtensions line to look something like</span>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
or
</div>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
or
</div>

<syntaxhighlight lang="php">
# Add new types to the existing list from DefaultSettings.php
$wgFileExtensions[] = 'docx';
$wgFileExtensions[] = 'xls';
$wgFileExtensions[] = 'pdf';
$wgFileExtensions[] = 'mpp';
$wgFileExtensions[] = 'odt';
$wgFileExtensions[] = 'ods';
</syntaxhighlight>

<span lang="en" dir="ltr" class="mw-content-ltr">However, certain file extensions are prohibited ({{ll|Manual:$wgProhibitedFileExtensions|$wgProhibitedFileExtensions}}, formerly {{ll|Manual:$wgFileBlacklist|$wgFileBlacklist}} for MediaWiki 1.36 and earlier) and cannot be uploaded even if added to $wgFileExtensions.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">To upload files with prohibited extensions, you must modify {{ll|Manual:$wgProhibitedFileExtensions|$wgProhibitedFileExtensions}}.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">For instance, to allow users to upload Windows executables:</span>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
In addition, {{ll|Manual:$wgMimeTypeExclusions|$wgMimeTypeExclusions}} (formerly {{ll|Manual:$wgMimeTypeBlacklist|$wgMimeTypeBlacklist}}) prevents certain file types based on [[Special:MyLanguage/Manual:MIME type detection|MIME type]]; .zip files, for example, are prohibited based on MIME type (MediaWiki version 1.14 up to 1.17).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can also set {{ll|Manual:$wgStrictFileExtensions|$wgStrictFileExtensions}}
</div>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
to allow most types of file to be uploaded. However, prohibited file types and MIME types will still not be permitted.
</div>

{{warning|1=<span lang="en" dir="ltr" class="mw-content-ltr">Setting $wgStrictFileExtensions to false, or altering $wgProhibitedFileExtensions could result in either you or your users being exposed to security risks.</span>}}

<div lang="en" dir="ltr" class="mw-content-ltr">
If you are getting the error "The file is corrupt or has an incorrect extension", make sure [[Special:MyLanguage/Manual:MIME type detection|MIME type detection]] is working properly.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you decide to allow any kind of file, make sure your mime detection is working and think about {{ll|Manual:$wgAntivirusSetup|enabling virus scans for uploads}}.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To enable '''zip''' extension (tested in MediaWiki v1.19.23) the following will be necessary in the {{ll|Manual:LocalSettings.php|LocalSettings.php}} file:
</div>

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


<span id="Log_in"></span>
== 로그인 ==
기본적으로 비유저 업로드는 허용되지 않습니다. 
"파일 업로드" 링크를 도구 상자에 표시하려면 그 전에 가입 후 로그인해야 합니다.

<span id="Thumbnailing"></span>
== 썸네일링 ==
이미지의 자동 렌더링/썸네일에 대해서는 ''{{ll|Manual:Image_administration#Image_thumbnailing|Image thumbnailing}}''을 참조하십시오. 
썸네일 중 문제에 대해서는, ''[[Special:MyLanguage/Manual:Errors and Symptoms#Image Thumbnails not working and/or appearing|Image Thumbnails not working and/or appearing]]''을 참조하십시오.

{{MW 1.11|and after}}
<span lang="en" dir="ltr" class="mw-content-ltr">If the file is not visual (like an Image or Video) a fileicon is used instead.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">These are generated by the <code>iconThumb()</code> function in the File class in the FileRepo group.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">Icons stored in "<code>$wgStyleDirectory/common/images/icons/</code>" in a "<code>fileicon-$extension.png</code>"-format.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Set maximum size for file uploads ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Browsers tell the server the size of the file to be uploaded before it actually sends the file.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If the upload is too big, it is rejected by the target (server) and the upload fails providing multiple errors depending at which layer the limit was imposed:
</div> 

<div lang="en" dir="ltr" class="mw-content-ltr">
* If it's a server limit (nginx, Apache) on the maximum amount of transmitted data, it may simply fail with a HTTP 500 error or HTTP 413 – Request entity too large.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* If the limit it's at the PHP level, if post_max_size is hit, you may get a generic HTTP 500 error (or simply a blank page) otherwise, MediaWiki should give a more meaningful error message.
</div>

[[File:Post max size and upload max filesize.jpg|{{dir|{{pagelang}}|left|right}}|100px|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">post_max_size and upload_max_filesize in php.ini</span>]]

<span lang="en" dir="ltr" class="mw-content-ltr">By default, the configuration code in {{ll|Manual:Php.ini|php.ini}} limits the size of files to be uploaded to 2 megabytes (and the maximum size of a post operation to 8 megabytes).</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">To allow uploading of larger files, edit these parameters in php.ini:</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
* {{php-ini|post_max_size}}, 8 megabytes large by default
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* {{php-ini|upload_max_filesize}}, 2 megabytes large by default
</div>

<span lang="en" dir="ltr" class="mw-content-ltr">This may require root access to the server.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">(If you are on a shared host, contact your server administrator.)</span>

{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">If you are increasing the maximum upload filesize to a value greater than 100MB, you will need to add {{ll|Manual:$wgMaxUploadSize|$wgMaxUploadSize}} with the new upload filesize value to {{ll|Manual:LocalSettings.php|LocalSettings.php}}.</span>}}

; <span lang="en" dir="ltr" class="mw-content-ltr">Locating the php.ini file</span>:
<span lang="en" dir="ltr" class="mw-content-ltr">The location of the php.ini file varies on the distribution you are using.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">See {{ll|Manual:php.ini}} for instructions for locating the correct php.ini used by your web server (as opposed to the php.ini used by the command line binary).</span> 

;<span lang="en" dir="ltr" class="mw-content-ltr">Multiple websites hosted on a server</span>:
<div lang="en" dir="ltr" class="mw-content-ltr">
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 &lt;Virtual Host&gt;:
</div>

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

<span lang="en" dir="ltr" class="mw-content-ltr">Both above settings also work in a '''.htaccess''' file if your site uses mod_php.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">If your site uses PHP >= 5.3 and allows it, you can place php.ini directives in [https://php.net/configuration.file.per-user .user.ini files] instead.</span>

;<span lang="en" dir="ltr" class="mw-content-ltr">web server limits</span>:

<span lang="en" dir="ltr" class="mw-content-ltr">Your web server may impose further limits on the size of files allowed for upload.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">For Apache, one of the relevant settings is ''LimitRequestBody''.</span>
<span lang="en" dir="ltr" class="mw-content-ltr"><ref name="limitrequestbody">[http://httpd.apache.org/docs/current/mod/core.html#limitrequestbody core - Apache HTTP Server Version 2.4 - LimitRequestBody Directive], Apache manual</ref> For Nginx, ''client_max_body_size'' is the relevant setting.<ref name="client_max_body_size">[http://wiki.nginx.org/NginxHttpCoreModule#client_max_body_size client_max_body_size], Nginx manual</ref> For Lighttpd, ''server.max-request-size'' is what may need modification.<ref name="server.max-request-size">[http://redmine.lighttpd.net/wiki/lighttpd/server.max-request-sizeDetails server.max-request-size], Lighthttpd manual</ref></span>

{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">After editing your php.ini or web server configuration, you will need to restart Apache or IIS.</span>}}

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

{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">You may also need to restart '''php5-fpm''' after altering your PHP (or nginx server) configuration.</span>}}

<div lang="en" dir="ltr" class="mw-content-ltr">
(sudo /etc/init.d/php5-fpm restart in Linux, for example.)
</div>

;<span lang="en" dir="ltr" class="mw-content-ltr">uploading too large of files warning</span>:

<span lang="en" dir="ltr" class="mw-content-ltr">MediaWiki itself issues a warning if you try to upload files larger than what is specified by {{ll|Manual:$wgUploadSizeWarning|$wgUploadSizeWarning}} option.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">This is independent of the hard limit imposed by PHP.</span>

; <span lang="en" dir="ltr" class="mw-content-ltr">temporary upload limits</span>:

<div lang="en" dir="ltr" class="mw-content-ltr">
Temporary changes to upload limits (when using multiple wikis on a farm, for example) can be altered by adding the lines:
</div>

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

<span lang="en" dir="ltr" class="mw-content-ltr">to the MediaWiki LocalSettings.php configuration file for each wiki.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">In this example the PHP limit is set at 50 Mb.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">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).</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">This method sets maximums that are less than the absolute maximum.</span>

;<span lang="en" dir="ltr" class="mw-content-ltr">IIS7  upload limit</span>

{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">By default, '''IIS7'''<ref>IIS7 is a new revision (version 7.0) of the [[wikipedia:Internet Information Services|Internet Information Services]] that is part of Windows Vista and the next Windows Server version.</ref> on Windows 2008 allows only 30MB to be uploaded via a web application.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Larger files will return a 404 error after the upload.</span> <span lang="en" dir="ltr" class="mw-content-ltr">If you have this problem, you can solve it by increasing the maximum file size by adding the following code to {{tag|system.webServer|open}} in the web.config file:</span>}}

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

<span lang="en" dir="ltr" class="mw-content-ltr">With the above maxAllowedContentLength, users can upload files that are 50,000,000 bytes (50 MB) in size.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">This setting will work immediately without restarting IIS services.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The web.config file is located in the root directory of your web site.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''To allow uploading files up to 2G''':
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''add''' the following lines to LocalSettings.php:
</div>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
Also, '''modify''' the following lines in {{ll|Manual:Php.ini|php.ini}}:
</div>

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

<span lang="en" dir="ltr" class="mw-content-ltr">In the IIS web.config file, override the value of maxRequestLength.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">For example, the following entry in web.config allows files that are less than or equal to 2 gigabytes (GB) to be uploaded:</span>

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

<span lang="en" dir="ltr" class="mw-content-ltr">With IIS 7, you also need to configure it to allow large uploads.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">This is found by clicking “Request Filtering > Edit Feature Settings” in the IIS section in the middle of the window.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">Set the ”Maximum allowed content length (Bytes)” field to 2147482624.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">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.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
If the above tip does not enable large uploads, then open a command prompt and execute this command as well:
</div>

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


<div lang="en" dir="ltr" class="mw-content-ltr">
== Allowing Java JAR Uploads ==
</div>
{{note|1=The details described in this section may no longer work. $wgAllowJavaUploads variable has been removed in MW 1.39.0.}}
<span lang="en" dir="ltr" class="mw-content-ltr">By default, MediaWiki will scan all uploads that appear to be ZIP archives and reject any that contain Java .class files.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">This is a security measure to prevent users uploading a malicious Java applet.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">'''For non-public sites only''', use the following to disable this check:</span>

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

<span lang="en" dir="ltr" class="mw-content-ltr">This setting can be used as a work around for allowing MIME types to be accepted indiscriminately.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">For example, if you attempt to upload a .doc file created by Word 2007, no matter the text list you provide and MIME type checking you invoke or prohibit, you will receive the message:</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
:''The file is a corrupt or otherwise unreadable ZIP file. It cannot be properly checked for security.''
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">.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.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">This embedded ZIP data confuses the Java archive scanner, causing the .doc file to be rejected.</span>  
<span lang="en" dir="ltr" class="mw-content-ltr">Files in the newer .docx file format are valid ZIP archives in their entirety, and can be uploaded successfully without setting {{ll|Manual:$wgAllowJavaUploads|$wgAllowJavaUploads}}.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Uploading directly from a URL ("Sideloading") ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you want to allow a user to directly upload files from a URL, instead of from a file on their local computer, set <code class="mw-highlight">{{ll|Manual:$wgAllowCopyUploads|$wgAllowCopyUploads}} = {{#tag:span|true|class=k}}</code>.
</div>

<span lang="en" dir="ltr" class="mw-content-ltr">By default, upload by URL are only possible using the [[Special:MyLanguage/API:Upload|API]] (or extensions such as {{ll|Extension:UploadWizard|UploadWizard}}).</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">To make the option usable from Special:Upload, you need to set {{ll|Manual:$wgCopyUploadsFromSpecialUpload|$wgCopyUploadsFromSpecialUpload}} to {{phpi|true}} as well.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">On the upload form, you will then see an additional field for the URL, below the usual filename field.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">The URL field is greyed out per default, but can be activated by activating the radiobutton (checkbox) to the left of the field.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">In order to use this feature, users must have the [[Special:MyLanguage/Manual:$wgGroupPermissions|user right]] <code>upload_by_url</code>.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">This right was granted to sysops by default until MediaWiki 1.20 but it now needs to be granted explicitly.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">To allow this to normal users, set</span> 
<syntaxhighlight lang="PHP">
 $wgGroupPermissions['user']['upload_by_url'] = true;
</syntaxhighlight>
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">PHP's cURL support must be enabled to support this feature.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Configure your PHP when installing using the ''--with-curl'' option.</span>}}
{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">If your server is accessing internet through a proxy then <code>{{ll|Manual:$wgHTTPProxy|$wgHTTPProxy}}</code> needs to be set accordingly.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Either you supply it directly or, if your server supplies the environment variable "http_proxy" see your phpinfo(), then you could use the following code in your LocalSettings.php:</span>}}

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

<div lang="en" dir="ltr" class="mw-content-ltr">
==Mass uploading==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
A number of tools are available for uploading multiple files in one go rather than each file separately:
</div>

{{Bulk Uploading}}

<span id="Upload_directory"></span>
== 업로드 디렉토리 ==

<div lang="en" dir="ltr" class="mw-content-ltr">
Whenever an image is uploaded, several things are created:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# An article in the file namespace with the name of the file, e.g. File:MyPicture.png.
</div> <span lang="en" dir="ltr" class="mw-content-ltr">This page is stored and can be edited like any other page.</span>
<div lang="en" dir="ltr" class="mw-content-ltr">
# The file itself is stored into the folder on the file system, which is configured in {{wg|UploadDirectory}} or into one if its subfolders (see below).
</div> 
<div lang="en" dir="ltr" class="mw-content-ltr">
# If thumbnailing is available, thumbnailed versions of the file will be created when necessary (such as for the usage on the file description page.
</div> <span lang="en" dir="ltr" class="mw-content-ltr">These are stored in the thumb directory of the image directory, in a separate directory for each main file.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
If {{ll|Manual:$wgHashedUploadDirectory|$wgHashedUploadDirectory}} is enabled (by default), MediaWiki creates several subdirectories in the images directory.
</div>

<span lang="en" dir="ltr" class="mw-content-ltr">If <code>$wgHashedUploadDirectory</code> is set to <code>true</code>, 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)</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">Creation of such subdirectories is handled automatically.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">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.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you only maintain a small wiki with few uploaded images, you could turn this off by setting <syntaxhighlight lang=php inline>$wgHashedUploadDirectory = false</syntaxhighlight>, all images are uploaded in $wgUploadDirectory itself. (e.g. $IP/images/foo.jpg)
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Multiwiki sites ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* 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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Not doing so will mysteriously break image uploads.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Configuring the upload form ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The upload form message provided with the default MediaWiki installation (which appears when you click "Upload file" link or go to [[Special:Upload]] link) may not go very well for you.
</div>

<span lang="en" dir="ltr" class="mw-content-ltr">For that case you can edit [[MediaWiki:Uploadtext]] contents and provide your own text.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">If your wiki site is multilanguage don't forget to edit localized versions like [[MediaWiki:Uploadtext/de]].</span>

<span lang="en" dir="ltr" class="mw-content-ltr">On the [[MediaWiki:Licenses]] page you can customize a drop-down list of licenses for uploads of your site.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">See the [[Special:MyLanguage/Manual:Image_administration#Licensing|documentation of this feature]].</span>

<span lang="en" dir="ltr" class="mw-content-ltr">Take into account that localized versions like [[MediaWiki:Licenses/de]] won't work by default.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">To enable them you must configure the {{wg|ForceUIMsgAsContentMsg}} variable.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<span id="Known_problems_on_Windows"></span>
== 윈도우에서 알려진 문제 ==
<span lang="en" dir="ltr" class="mw-content-ltr">Running MediaWiki on Windows server has some restrictions in allowed filenames, due to a PHP bug.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">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 ({{phabricator|T3780}}), with the message ''{{int|windows-nonascii-filename}}''.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
Since MediaWiki 1.31 MediaWiki can handle filenames with non-ascii characters if it's using PHP 7.1 or later.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Known problems with database names having non-alphanumeric characters ==
</div>

{{tracked|T46066}}
<span lang="en" dir="ltr" class="mw-content-ltr">If <code>{{ll|Manual:$wgDBname|$wgDBname}}</code> contains non-alphanumeric characters, uploads may fail with errors like <samp>Could not create directory "mwstore://local-backend/local-public/&lt;path&gt;".</samp>.</span> 
<span lang="en" dir="ltr" class="mw-content-ltr">This is caused by an internal check for valid container name for file backend, but it's constructed using {{phpi|$wgDBname}}.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
Since MediaWiki 1.26, it allows uploads when {{phpi|$wgDBname}} contains dots.
</div>

<span id="See_also"></span>
== 같이 보기 ==

<div lang="en" dir="ltr" class="mw-content-ltr">
* [[Special:MyLanguage/Manual:Security#Upload_security|Security section Upload security]]
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* [[Special:MyLanguage/Manual:Configuration settings#Uploads|Manual:Configuration settings#Uploads]] for a list of all configuration variables related to file uploads
</div>
* {{ll|Category:Upload variables}} - <span lang="en" dir="ltr" class="mw-content-ltr">similar list as a category (ordered alphabetically)</span>
<div lang="en" dir="ltr" class="mw-content-ltr">
* [[Special:MyLanguage/Blank_page#You_see_a_Blank_Page|You see a blank page]] when trying to upload a file
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* [[Manual:Adding support for new filetypes|Adding support for new filetypes]]
</div>

<span id="References"></span>
== 각주 ==
<references />

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