View source for Manual:$wgTmpDirectory/de-formal

<languages/>
{{SettingSummary
|name=TmpDirectory
|version_min=pre 1.1.0
|section=Paths
|range=(<span lang="en" dir="ltr" class="mw-content-ltr">absolute path</span>)
|default=<span lang="en" dir="ltr" class="mw-content-ltr">The path to the directory for temporary files as determined by <code>wfTempDir()</code></span><ref>{{Git|99fdc6e838d4c7f6a7135a06b58d0bb232ca611c}}</ref> (1.20+)<br />
<code>"{<nowiki/>{{ll|Manual:$wgUploadDirectory|$wgUploadDirectory}}}/tmp"</code> (pre 1.1-1.19)<br />
{{DefaultExplanation}}
|summary=<span lang="en" dir="ltr" class="mw-content-ltr">The path of the temporary directory.</span>
}}
== Details ==
{{MW 1.20|and after}}
<span lang="en" dir="ltr" class="mw-content-ltr">The local filesystem path to a temporary directory. This is required to be writable.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">It shouldn't be accessible from the web, so try to place it outside of the document root (recommended) or at least deny any access from the web via .htaccess or webserver configuration.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Having files from this folder accessible from the web can be a security risk.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
$wgTmpDirectory is used by <code>wfTempDir()</code> to control where MediaWiki writes temporary files to, including:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Old and new tempfiles for external executable based external diff engines configured by {{$wg|ExternalDiffEngine}}
</div>
* {{class doclink|TempFSFile}} - <span lang="en" dir="ltr" class="mw-content-ltr">used for chunked uploading, some transformations, and various parts of the file backend code</span>
<div lang="en" dir="ltr" class="mw-content-ltr">
* UID Generator node and lock files.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* Upload from URL
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* The directory in which a [[Special:MyLanguage/Manual:$wgMainCacheType|'''CACHE_DBA''' cache]] places its DBA database file.
</div> <span lang="en" dir="ltr" class="mw-content-ltr">Can be overridden using <code>{{ll|Manual:$wgObjectCaches|$wgObjectCaches}}[CACHE_DBA]['dir']</code>.</span> {{removed-inline|1.23}}
<div lang="en" dir="ltr" class="mw-content-ltr">
* Importing uploads from XML dumps
</div>
* {{class doclink|SvgHandler}} - <span lang="en" dir="ltr" class="mw-content-ltr">used for SVG transformation</span>
* ...

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

<div lang="en" dir="ltr" class="mw-content-ltr">
If you are getting this error, an incorrect setting for $wgTmpDirectory often is the cause:
</div>

<pre>
Warning: rename(/tmp/l10n_cache-en.cdb.tmp.335721450,/tmp/l10n_cache-en.cdb): Operation not permitted in /.../vendor/wikimedia/cdb/src/Writer/DBA.php on line 59

Fatal exception of type MWException: Warning: dba_close(): supplied resource is not a valid DBA identifier resource in /.../vendor/wikimedia/cdb/src/Writer/DBA.php on line 54

Fatal error: Uncaught Cdb\Exception: Unable to move the new CDB file into place. in /.../vendor/wikimedia/cdb/src/Writer/DBA.php:60 
</pre>

<div lang="en" dir="ltr" class="mw-content-ltr">
The solution is to set $wgTmpDirectory to a folder, which actually is writable by the webserver user.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Sometimes it is useful to have separate directories for the web server and CLI user, if they require different permissions. For example:
</div>

<syntaxhighlight lang=php>$wgTmpDirectory = $IP . '/images/tmp-' . php_sapi_name();</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
See {{phabricator|T126736}} for more information!
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Usage in unsupported MediaWiki versions ==
</div>
{{-}}
{{MW 1.19|and before}}
<span lang="en" dir="ltr" class="mw-content-ltr">The path to the temporary directory.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">When using '''CACHE_DBA''' as your <code>{{ll|Manual:$wgMainCacheType|$wgMainCacheType}}</code>, this allows you to select which directory is used.</span>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
== See also ==
</div>
* {{ll|Manual:$wgCacheDirectory}} - <span lang="en" dir="ltr" class="mw-content-ltr">Directory for caching interface messages in the local filesystem.</span>