cvs: phpdoc-de /reference/filesystem/functions tempnam.xml

jaenecke Mon Jul 30 19:37:57 2007 UTC Modified files: /phpdoc-de/reference/filesystem/functions tempnam.xml Log: sync to en bugfix; cf http://bugs.php.net/bug.php?id=42124 http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/filesystem/functions/tempnam.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/filesystem/functions/tempnam.xml diff -u phpdoc-de/reference/filesystem/functions/tempnam.xml:1.6 phpdoc-de/reference/filesystem/functions/tempnam.xml:1.7 --- phpdoc-de/reference/filesystem/functions/tempnam.xml:1.6 Mon Jul 30 16:49:21 2007 +++ phpdoc-de/reference/filesystem/functions/tempnam.xml Mon Jul 30 19:37:57 2007 @@ -1,70 +1,78 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> - <refentry xml:id="function.tempnam" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>tempnam</refname> - <refpurpose>Erzeugt eine Datei mit eindeutigem Dateinamen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>tempnam</methodname> - <methodparam><type>string</type><parameter>dir</parameter></methodparam> - <methodparam><type>string</type><parameter>prefix</parameter></methodparam> - </methodsynopsis> - <para> - Erzeugt eine Datei mit einem eindeutigen Dateinamen in dem - spezifizierten Verzeichnis. Wenn das Verzeichnis nicht existiert, - erstellt <function>tempnam</function> eine Datei im temporären - Verzeichnis des Systems, und gibt den Dateinamen zurück. - </para> - <para> - Vor PHP 4.0.6 war das Verhalten von <function>tempnam</function> - systemabhängig. Unter Windows wird die TMP-Umgebungsvariable den - <parameter>dir</parameter> Parameter überschreiben, unter - Linux-Systemen hat die TMPDIR Umgebungsvariable Vorrang, während - SVR4 immer den spezifizierten Verzeichnisnamen benutzen wird, - wenn dieses existiert. Wenn Sie nicht genau wissen, wie Ihr - System <function>tempnam</function> behandelt, dann konsultieren - Sie bitte Ihre System-Dokumentation. - </para> - <para> - Gibt bei Erfolg den neuen temporären Dateinamen bei Erfolg, im - Fehlerfalle &false; zurück. - <example> - <title><function>tempnam</function></title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.14 Maintainer: tom Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.tempnam"> + <refnamediv> + <refname>tempnam</refname> + <refpurpose>Erzeugt eine Datei mit eindeutigem Dateinamen</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <methodsynopsis> + <type>string</type><methodname>tempnam</methodname> + <methodparam><type>string</type><parameter>dir</parameter></methodparam> + <methodparam><type>string</type><parameter>prefix</parameter></methodparam> + </methodsynopsis> + <para> + Erzeugt eine Datei mit einem eindeutigen Dateinamen in dem + angegebenen Verzeichnis. Wenn das Verzeichnis nicht existiert, + erstellt <function>tempnam</function> eine Datei im temporären + Verzeichnis des Systems und gibt den Dateinamen zurück. + </para> + <para> + Vor PHP 4.0.6 war das Verhalten von <function>tempnam</function> + systemabhängig. Unter Windows wird die TMP-Umgebungsvariable den + <parameter>dir</parameter> Parameter überschreiben, unter + Linux-Systemen hat die TMPDIR Umgebungsvariable Vorrang, während + SVR4 immer den spezifizierten Verzeichnisnamen benutzen wird, + wenn dieses existiert. Wenn Sie nicht genau wissen wie Ihr + System <function>tempnam</function> behandelt, dann konsultieren + Sie bitte die Dokumentation Ihres Betriebssystems. + </para> + <note> + <simpara> + Wenn PHP keine Datei im angegebenen Verzeichnis <parameter>dir</parameter> + erstellen kann benutzt es die Voreinstellung des Betriebssystems. + </simpara> + </note> + <para> + Gibt bei Erfolg den temporären Dateinamen zurück, andernfalls &false; + <example> + <title><function>tempnam</function> example</title> + <programlisting role="php"> <![CDATA[ -$tmpfname = tempnam ("/tmp", "FOO"); +<?php +$tmpfname = tempnam("/tmp", "FOO"); $handle = fopen($tmpfname, "w"); -fwrite($handle, "schreibe in Tämporärdatei"); +fwrite($handle, "writing to tempfile"); fclose($handle); -// tue hier etwas +// tue etwas unlink($tmpfname); +?> ]]> - </programlisting> - </example> - </para> - <note> - <simpara> - Diese Funktion hat ihr Verhalten seit PHP 4.0.3 geändert. - Die temporäre Datei wird ebenfalls angelegt um eine - "Hetzsituation" zu vermeiden, wo in der Zeit nach dem Generieren - des Strings, und bevor das Script dazukommt die Datei anzulegen, - die Datei im Dateisystem erscheinen könnte. Beachten Sie, dass - falls Sie die Datei nicht mehr benötigen, Sie diese wieder entfernen - müssen (dies geschieht nicht automatisch). - </simpara> - </note> - <para> - Siehe auch <function>tmpfile</function> und <function>unlink</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <note> + <simpara> + Diese Funktion hat ihr Verhalten seit PHP 4.0.3 geändert. Es wird nicht + nur ein Dateiname erzeugt, vielmehr wird die Datei auch direkt angelegt, + um eine Race Condition zu vermeiden. Diese tritt auf weil zwischen der + Rückgabe des Dateinamens und dem evtl. Anlegen der Datei Ändeurngen im + Dateisystem erfolgen können. + Bitte beachten Sie daß Sie die Datei löschen müssen, sollte sie nicht mehr + benötig werden. Die geschieht nicht automatisch. + </simpara> + </note> + <para> + Siehe auch <function>tmpfile</function>, <function>sys_get_temp_dir</function> + und <function>unlink</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: