svn: /phpdoc/de/trunk/reference/filesystem/functions/ fstat.xml lstat.xml mkdir.xml stat.xml symlink.xml tempnam.xml tmpfile.xml touch.xml umask.xml unlink.xml
[email protected] (Mark Wiesemann)
| Newsgroups | php.doc.de |
|---|---|
| Message-ID | <[email protected]> |
wiesemann Mon, 04 Jan 2010 22:04:12 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=293118
Log:
take over some unmaintained files
Changed paths:
U phpdoc/de/trunk/reference/filesystem/functions/fstat.xml
U phpdoc/de/trunk/reference/filesystem/functions/lstat.xml
U phpdoc/de/trunk/reference/filesystem/functions/mkdir.xml
U phpdoc/de/trunk/reference/filesystem/functions/stat.xml
U phpdoc/de/trunk/reference/filesystem/functions/symlink.xml
U phpdoc/de/trunk/reference/filesystem/functions/tempnam.xml
U phpdoc/de/trunk/reference/filesystem/functions/tmpfile.xml
U phpdoc/de/trunk/reference/filesystem/functions/touch.xml
U phpdoc/de/trunk/reference/filesystem/functions/umask.xml
U phpdoc/de/trunk/reference/filesystem/functions/unlink.xml
svn-diffs-293118.txt
(text/x-diff, 56.7 KB)
Modified: phpdoc/de/trunk/reference/filesystem/functions/fstat.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/fstat.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/fstat.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,39 +1,106 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
- <refentry xml:id="function.fstat" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>fstat</refname>
- <refpurpose>
- Liefert Informationen über eine Datei mit offenem Dateizeiger
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>array</type><methodname>fstat</methodname>
- <methodparam><type>resource</type><parameter>handle</parameter></methodparam>
- </methodsynopsis>
- <para>
- Trägt die Statistiken der mittel des Dateizeigers
- <parameter>handle</parameter> geöffneten Datei zusammen. Diese
- Funktion ist ähnlich der Funktion <function>stat</function>,
- außer dass sie mit einem offenen Dateizeiger anstatt eines
- Dateinamens arbeitet.
- </para>
- <para>
- Gibt die Statistiken einer Datei in Form eines Arrays zurück. Das Format
- des zurückgegebenen Arrays wird in <function>stat</function> im Detail
- beschrieben.
- </para>
+<!-- EN-Revision: 288721 Maintainer: wiesemann Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fstat">
+ <refnamediv>
+ <refname>fstat</refname>
+ <refpurpose>
+ Sammelt Informationen über eine Datei mittels eines offenen Dateizeigers
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>fstat</methodname>
+ <methodparam><type>resource</type><parameter>handle</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sammelt die Statistiken der Datei, die durch den Dateizeiger
+ <parameter>handle</parameter> geöffnet wurde. Diese Funktion ist ähnlich
+ zur Funktion <function>stat</function>, mit dem Unterschied, dass sie mit
+ einem offenen Dateizeiger anstatt eines Dateinamens arbeitet.
+ </para>
+ </refsect1>
- ¬e.clearstatcache;
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>handle</parameter></term>
+ <listitem>
+ &fs.file.pointer;
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
- ¬e.no-remote;
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Gibt ein Array mit den Statistiken der Datei zurück. Das Format des Arrays
+ wird auf der <function>stat</function>-Handbuchseite im Detail beschrieben.
+ </para>
+ </refsect1>
- </refsect1>
- </refentry>
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>fstat</function>-Beispiel</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// öffne eine Datei
+$fp = fopen("/etc/passwd", "r");
+
+// sammle Statistiken
+$fstat = fstat($fp);
+
+// schlieÃe die Datei
+fclose($fp);
+
+// gebe nur den assoziativen Teil aus
+print_r(array_slice($fstat, 13));
+
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
+Array
+(
+ [dev] => 771
+ [ino] => 488704
+ [mode] => 33188
+ [nlink] => 1
+ [uid] => 0
+ [gid] => 0
+ [rdev] => 0
+ [size] => 1114
+ [atime] => 1061067181
+ [mtime] => 1056136526
+ [ctime] => 1056136526
+ [blksize] => 4096
+ [blocks] => 8
+)
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ ¬e.no-remote;
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -45,7 +112,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
Modified: phpdoc/de/trunk/reference/filesystem/functions/lstat.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/lstat.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/lstat.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,87 +1,109 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 -->
-<!-- last change to 'lstat' in en/ tree in rev 1.2 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.142/EN.1.2 -->
- <refentry xml:id="function.lstat" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>lstat</refname>
- <refpurpose>
- Liefert Informationen über eine Datei oder einen symbolischen Link.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>array</type><methodname>lstat</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- </methodsynopsis>
+<!-- EN-Revision: 288721 Maintainer: wiesemann Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.lstat">
+ <refnamediv>
+ <refname>lstat</refname>
+ <refpurpose>
+ Sammelt Informationen über eine Datei oder einen symbolischen Link
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>lstat</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sammelt Statistiken über die Datei oder den symbolischen Link, die bzw.
+ der in <parameter>filename</parameter> angegeben ist.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ Pfad zur Datei oder zum symbolischen Link.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Bitte lesen Sie die Handbuchseite zu <function>stat</function> für
+ Informationen über die Struktur des Arrays, das <function>lstat</function>
+ zurückgibt. Diese Funktion ist identisch zur
+ <function>stat</function>-Funktion, mit dem Unterschied, dass, falls
+ <parameter>filename</parameter> ein symbolischer Link ist, dessen
+ Statistik zurückgegeben wird und nicht der Status der Datei, auf die
+ der symbolische Link zeigt.
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>Vergleich von <function>stat</function> und <function>lstat</function></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+symlink('uploads.php', 'uploads');
+
+// Vergleiche die Informationen von uploads.php und uploads
+array_diff(stat('uploads'), lstat('uploads'));
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
<para>
- Ermittelt statistische Informationen über eine Datei oder
- symbolischen Link, spezifiziert in <parameter>filename</parameter>.
- Diese Funktion ist identisch mit der Funktion
- <function>stat</function>, außer dass wenn der Parameter
- <parameter>filename</parameter> ein symbolischer Link ist, dessen
- Status zurückgegeben wird und nicht der Status der Datei, auf die
- der symbolische Link zeigt.
+ Unterschiede in den Informationen beider Dateien.
</para>
- <para>
- Gibt einen Array mit statistischen Informationen über die Datei
- als Array-Elemente zurück:
- <orderedlist>
- <listitem>
- <simpara>Laufwerk</simpara>
- </listitem>
- <listitem>
- <simpara>inode</simpara>
- </listitem>
- <listitem>
- <simpara>Anzahl der Links</simpara>
- </listitem>
- <listitem>
- <simpara>Benutzer ID des Inhabers</simpara>
- </listitem>
- <listitem>
- <simpara>Gruppen ID des Inhabers</simpara>
- </listitem>
- <listitem>
- <simpara>Laufwerkstyp wenn inode Laufwerk *</simpara>
- </listitem>
- <listitem>
- <simpara>Größe in Bytes</simpara>
- </listitem>
- <listitem>
- <simpara>Zeitpunkt des letzten Zugriffs</simpara>
- </listitem>
- <listitem>
- <simpara>Zeitpunkt der letzten Modifikation</simpara>
- </listitem>
- <listitem>
- <simpara>Zeitpunkt der letzen Änderung</simpara>
- </listitem>
- <listitem>
- <simpara>Blockgröße für das Dateisystem I/O *</simpara>
- </listitem>
- <listitem>
- <simpara>Anzahl der zugewiesenen Blöcke</simpara>
- </listitem>
- </orderedlist>
- * - nur gültig auf Systemen, die st_blksize unterstützen. Andere
- Systeme (z.B. Windows) geben '-1' zurück.
- </para>
- <para>
- <function>lstat</function> ist nicht für <link
- linkend="features.remote-files">remote Dateien</link> geeignet.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe auch <function>clearstatcache</function> für weitere
- Einzelheiten.
- </para>
- </refsect1>
- </refentry>
+ <screen>
+<![CDATA[
+Array
+(
+ [ino] => 97236376
+ [mode] => 33188
+ [size] => 34
+ [atime] => 1223580003
+ [mtime] => 1223581848
+ [ctime] => 1223581848
+ [blocks] => 8
+)
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ ¬e.clearstatcache;
+ &tip.fopen-wrapper.stat;
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>stat</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -93,7 +115,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
Modified: phpdoc/de/trunk/reference/filesystem/functions/mkdir.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/mkdir.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/mkdir.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,57 +1,155 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
- <refentry xml:id="function.mkdir" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>mkdir</refname>
- <refpurpose>Erstellt ein Verzeichnis</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>int</type><methodname>mkdir</methodname>
- <methodparam><type>string</type><parameter>pathname</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
- </methodsynopsis>
- <para>
- Versucht ein Verzeichnis mit dem spezifiziertem Namen zu
- erstellen.
- </para>
- <para>
- Bedenken Sie, dass sie wahrscheinlich den Mode als oktalen
- Wert spezifizieren wollen, was bedeutet, dass er eine
- voranstehende Null haben sollte. Der Mode wird ebenfalls mit
- der aktuellen umask modifiziert, welchen Sie mittels
- <function>umask</function> ändern können.
- </para>
- <para>
- <note>
+<!-- EN-Revision: 288721 Maintainer: wiesemann Status: ready -->
+<refentry xml:id="function.mkdir" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>mkdir</refname>
+ <refpurpose>Erstellt ein Verzeichnis</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>mkdir</methodname>
+ <methodparam><type>string</type><parameter>pathname</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0777</initializer></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>recursive</parameter><initializer>false</initializer></methodparam>
+ <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Versucht ein Verzeichnis mit dem angegebenen Namen zu erstellen.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>pathname</parameter></term>
+ <listitem>
<para>
- Mode wird unter Windows ignoriert, und wurde in PHP 4.2.0 optional.
+ Der Verzeichnispfad.
</para>
- </note>
- </para>
- <para>
- Mode ist standardmäßig 0777 was den weitestmöglichen Zugriff
- bedeutet. Weitere Informationen zu den Modi finden Sie auf der
- Seite <function>chmod</function>.
- <informalexample>
- <programlisting role="php">
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>mode</parameter></term>
+ <listitem>
+ <para>
+ Der Modus ist standardmäÃig 0777, was den gröÃtmöglichen Zugang
+ umfasst. Für weitere Informationen lesen Sie bitte die Details
+ auf der <function>chmod</function>-Seite.
+ </para>
+ <note>
+ <para>
+ <parameter>mode</parameter> wird unter Windows ignoriert.
+ </para>
+ </note>
+ <para>
+ Beachten Sie, dass Sie den Modus als oktalen Wert angeben sollten,
+ d.h., dass er eine führende Null haben sollte. Der Modus wird auch
+ durch die aktuelle umask geändert, die Sie mit
+ <function>umask</function> ändern können.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>recursive</parameter></term>
+ <listitem>
+ <para>
+ StandardmäÃig &false;.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>context</parameter></term>
+ <listitem>
+ ¬e.context-support;
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.0.0</entry>
+ <entry>
+ Der <parameter>recursive</parameter>-Parameter wurde hinzugefügt.
+ </entry>
+ </row>
+ <row>
+ <entry>5.0.0</entry>
+ <entry>
+ Seit PHP 5.0.0 kann <function>mkdir</function> auch mit
+ <emphasis>einigen</emphasis> URL-Wrappern genutzt werden.
+ In der <xref linkend="wrappers"/> finden Sie eine Liste aller
+ Wrapper, die <function>mkdir</function> unterstützen.
+ </entry>
+ </row>
+ <row>
+ <entry>4.2.0</entry>
+ <entry>
+ Der <parameter>mode</parameter>-Parameter wurde optional.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>mkdir</function>-Beispiel</title>
+ <programlisting role="php">
<![CDATA[
-mkdir ("/path/to/my/dir", 0700);
+<?php
+mkdir("/path/to/my/dir", 0700);
+?>
]]>
- </programlisting>
- </informalexample>
- </para>
- <para>
- &return.success;
- </para>
- <para>
- Siehe auch <function>rmdir</function>.
- </para>
- </refsect1>
- </refentry>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ ¬e.sm.uidcheck.dir;
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>rmdir</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -63,7 +161,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
Modified: phpdoc/de/trunk/reference/filesystem/functions/stat.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/stat.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/stat.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,88 +1,257 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 -->
-<!-- last change to 'stat' in en/ tree in rev 1.2 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.142/EN.1.2 -->
- <refentry xml:id="function.stat" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>stat</refname>
- <refpurpose>
- Liefert diverse Informationen über eine Datei
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>array</type><methodname>stat</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- </methodsynopsis>
- <para>
- Sammelt Informationen über eine Datei spezifiziert in
- <parameter>filename</parameter>.
- </para>
- <para>
- Gibt einen Array mit folgenden statistischen Informationen als
- Array- Elemente zurück:
- <orderedlist>
- <listitem>
- <simpara>Laufwerk</simpara>
- </listitem>
- <listitem>
- <simpara>inode</simpara>
- </listitem>
- <listitem>
- <simpara>inode protection mode</simpara>
- </listitem>
- <listitem>
- <simpara>Anzahl der Links</simpara>
- </listitem>
- <listitem>
- <simpara>Benutzer ID des Inhabers</simpara>
- </listitem>
- <listitem>
- <simpara>Gruppen ID des Inhabers</simpara>
- </listitem>
- <listitem>
- <simpara>Laufwerkstyp wenn Inode-Laufwerk *</simpara>
- </listitem>
- <listitem>
- <simpara>Größe in Bytes</simpara>
- </listitem>
- <listitem>
- <simpara>Zeitpunkt des letzten Zugriffs</simpara>
- </listitem>
- <listitem>
- <simpara>Zeitpunkt der letzten Modifizierung</simpara>
- </listitem>
- <listitem>
- <simpara>Zeitpunkt der letzten Änderung</simpara>
- </listitem>
- <listitem>
- <simpara>Blockgröße für das Dateisystem I/O *</simpara>
- </listitem>
- <listitem>
- <simpara>Anzahl der zugewiesenen Blöcke</simpara>
- </listitem>
- </orderedlist>
- * - nur gültig auf Systemen, die st_blksize unterstützen. Andere
- Systeme (z.B. Windows) geben '-1' zurück.
- </para>
- <para>
- Gibt &false; zurück, wenn ein Fehler auftrat.
- </para>
- <para>
- <function>stat</function> ist nicht für <link
- linkend="features.remote-files">remote Dateien</link> geeignet.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe auch <function>clearstatcache</function> für weitere
- Einzelheiten.
- </para>
- </refsect1>
- </refentry>
+<!-- EN-Revision: 293049 Maintainer: wiesemann Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stat">
+ <refnamediv>
+ <refname>stat</refname>
+ <refpurpose>Sammelt Informationen über eine Datei</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>stat</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sammelt Statistiken über die per <parameter>filename</parameter>
+ angegebene Datei. Falls <parameter>filename</parameter> ein symbolischer
+ Link ist, beziehen sich die Statistiken auf die Datei selbst, nicht auf
+ den symbolischen Link.
+ </para>
+ <para>
+ <function>lstat</function> ist identisch zu <function>stat</function>,
+ mit dem Unterschied, dass es sich auf den Status des symbolischen Links
+ bezieht.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ Pfad zur Datei.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ <table>
+ <title><function>stat</function>- und
+ <function>fstat</function>-Ergebnisformat</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Numerisch</entry>
+ <entry>Assoziativ (seit PHP 4.0.6)</entry>
+ <entry>Beschreibung</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>0</entry>
+ <entry>dev</entry>
+ <entry>Gerätenummer</entry>
+ </row>
+ <row>
+ <entry>1</entry>
+ <entry>ino</entry>
+ <entry>Inode-Nummer *</entry>
+ </row>
+ <row>
+ <entry>2</entry>
+ <entry>mode</entry>
+ <entry>Inode-Schutzmodus</entry>
+ </row>
+ <row>
+ <entry>3</entry>
+ <entry>nlink</entry>
+ <entry>Anzahl der Links</entry>
+ </row>
+ <row>
+ <entry>4</entry>
+ <entry>uid</entry>
+ <entry>userid des Besitzers *</entry>
+ </row>
+ <row>
+ <entry>5</entry>
+ <entry>gid</entry>
+ <entry>groupid des Besitzers *</entry>
+ </row>
+ <row>
+ <entry>6</entry>
+ <entry>rdev</entry>
+ <entry>Gerätetyp, falls Inode-Gerät</entry>
+ </row>
+ <row>
+ <entry>7</entry>
+ <entry>size</entry>
+ <entry>GröÃe in Bytes</entry>
+ </row>
+ <row>
+ <entry>8</entry>
+ <entry>atime</entry>
+ <entry>Zeitpunkt des letzten Zugriffs (Unix-Timestamp)</entry>
+ </row>
+ <row>
+ <entry>9</entry>
+ <entry>mtime</entry>
+ <entry>Zeitpunkt der letzten Ãnderung (Unix-Timestamp)</entry>
+ </row>
+ <row>
+ <entry>10</entry>
+ <entry>ctime</entry>
+ <entry>Zeitpunkt der letzten Inode-Ãnderung (Unix-Timestamp)</entry>
+ </row>
+ <row>
+ <entry>11</entry>
+ <entry>blksize</entry>
+ <entry>BlockgröÃe des Dateisystem-I/O **</entry>
+ </row>
+ <row>
+ <entry>12</entry>
+ <entry>blocks</entry>
+ <entry>Anzahl der zugewiesenen 512-Byte-Blöcke **</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ * Unter Windows wird dies immer 0 sein.
+ </para>
+ <para>
+ ** Nur gültig unter Systemen, die den st_blksize-Typ unterstützen - andere
+ Systeme (z.B. Windows) geben -1 zurück.
+ </para>
+ <para>
+ Im Fehlerfall gibt <function>stat</function> &false; zurück.
+ </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+ &reftitle.errors;
+ <para>
+ Im Fehlerfall wird eine <constant>E_WARNING</constant> geworfen.
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>4.0.6</entry>
+ <entry>
+ Zusätzlich zur Rückgabe dieser Attribute in einem numerischen Array
+ kann auf sie auch mit assoziativen Indizes zugriffen werden (wie
+ in der obigen Tabelle beschrieben).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>stat</function>-Beispiel</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+/* Hole Datei-Statistik */
+$stat = stat('C:\php\php.exe');
+
+/*
+ * Gebe den Zugriffszeitpunkt der Datei aus; dies entspricht dem
+ * Aufruf von fileatime()
+ */
+echo 'Zugriffszeitpunkt: ' . $stat['atime'];
+
+/*
+ * Gebe den Ãnderungszeitpunkt der Datei aus; dies entspricht dem
+ * Aufruf von filemtime()
+ */
+echo 'Ãnderungszeitpunkt: ' . $stat['mtime'];
+
+/* Gebe die Gerätenummer aus */
+echo 'Gerätenummer: ' . $stat['dev'];
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Nutzung von <function>stat</function>-Informationen zusammen mit <function>touch</function></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+/* Hole Datei-Statistik */
+$stat = stat('C:\php\php.exe');
+
+/* Hat das Holen der Statistik-Informationen geklappt? */
+if (!$stat) {
+ echo 'stat()-Aufruf schlug fehl ...';
+} else {
+ /*
+ * Wir wollen den Zugriffszeitpunkt auf eine Woche vor dem aktuellen
+ * Zugriffszeitpunkt setzen.
+ */
+ $atime = $stat['atime'] + 604800;
+
+ /* Ãndere die Datei */
+ if (!touch('eine_datei.txt', time(), $atime)) {
+ echo 'Ãndern der Datei schlug fehl ...';
+ } else {
+ echo 'touch()-Befehl war erfolgreich ...';
+ }
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ ¬e.filesystem-time-res;
+ ¬e.clearstatcache;
+ &tip.fopen-wrapper.stat;
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>lstat</function></member>
+ <member><function>fstat</function></member>
+ <member><function>filemtime</function></member>
+ <member><function>filegroup</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -94,7 +263,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
Modified: phpdoc/de/trunk/reference/filesystem/functions/symlink.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/symlink.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/symlink.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,31 +1,127 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
- <refentry xml:id="function.symlink" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>symlink</refname>
- <refpurpose>Erzeugt einen symbolischen Link</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>int</type><methodname>symlink</methodname>
- <methodparam><type>string</type><parameter>target</parameter></methodparam>
- <methodparam><type>string</type><parameter>link</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>symlink</function> erzeugt einen symbolischen Link von
- dem gegebenen Parameter <parameter>target</parameter> mit dem
- spezifiziertem Namen <parameter>link</parameter>.
- </para>
- <para>
- Siehe auch <function>link</function> um absolute Links zu
- erstellen, und <function>readlink</function> zusammen mit
- <function>linkinfo</function>.
- </para>
- </refsect1>
- </refentry>
+<!-- EN-Revision: 293049 Maintainer: wiesemann Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.symlink">
+ <refnamediv>
+ <refname>symlink</refname>
+ <refpurpose>Erzeugt einen symbolischen Link</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>symlink</methodname>
+ <methodparam><type>string</type><parameter>target</parameter></methodparam>
+ <methodparam><type>string</type><parameter>link</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>symlink</function> erzeugt einen symbolischen Link auf das
+ existierende Ziel (<parameter>target</parameter>) mit dem angegebenen
+ Namen (<parameter>link</parameter>).
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>target</parameter></term>
+ <listitem>
+ <para>
+ Ziel des Links.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>link</parameter></term>
+ <listitem>
+ <para>
+ Der Linkname.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.3.0</entry>
+ <entry>
+ Diese Funktion ist nun verfügbar auf Windows-Plattformen (Vista,
+ Server 2008 oder neuer).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>Einen symbolischen Link erzeugen</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$target = 'uploads.php';
+$link = 'uploads';
+symlink($target, $link);
+
+echo readlink($link);
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <simpara>
+ Nur unter Windows: Diese Funktion wird nur funktionieren, falls
+ das System, unter dem PHP ausgeführt wird, Windows Vista, Windows
+ Server 2008 oder neuer ist. Frühere Windows-Versionen unterstützen
+ keine symbolischen Links.
+ </simpara>
+ </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>link</function></member>
+ <member><function>readlink</function></member>
+ <member><function>linkinfo</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -37,7 +133,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
Modified: phpdoc/de/trunk/reference/filesystem/functions/tempnam.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/tempnam.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/tempnam.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,51 +1,119 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 293048 Maintainer: wiesemann 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>
+
+ <refsect1 role="description">
+ &reftitle.description;
<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.
+ Erzeugt eine Datei mit einem eindeutigen Dateinamen in dem angegebenen
+ Verzeichnis, wobei die Zugriffsberechtigungen auf 0600 gesetzt werden.
+ Wenn das Verzeichnis nicht existiert, erstellt
+ <function>tempnam</function> eine Datei im temporären Verzeichnis des
+ Systems und gibt diesen Namen zurück.
</para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
<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.
+ <variablelist>
+ <varlistentry>
+ <term><parameter>dir</parameter></term>
+ <listitem>
+ <para>
+ Das Verzeichnis, in dem die temporäre Datei erstellt werden soll.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>prefix</parameter></term>
+ <listitem>
+ <para>
+ Der Präfix des genererierten temporären Dateinamens.
+ </para>
+ <note>
+ <simpara>
+ Windows nutzt nur die ersten drei Zeichen des Präfixes.
+ </simpara>
+ </note>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
- <note>
- <simpara>
- Wenn PHP keine Datei im angegebenen Verzeichnis <parameter>dir</parameter>
- erstellen kann benutzt es die Voreinstellung des Betriebssystems.
- </simpara>
- </note>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
- Gibt bei Erfolg den temporären Dateinamen zurück, andernfalls &false;
+ Gibt den neuen temporären Dateinamen zurück, oder im Fehlerfall &false;
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>4.0.6</entry>
+ <entry>
+ Vor PHP 4.0.6 war das Verhalten der
+ <function>tempnam</function>-Funktion systemabhängig. Unter Windows
+ wird die <varname>TMP</varname>-Umgebungsvariable den
+ <parameter>dir</parameter>-Parameter überschreiben, unter
+ Linux hat die <varname>TMPDIR</varname>-Umgebungsvariable Vorrang,
+ während SVR4 immer den <parameter>dir</parameter>-Parameter verwendet,
+ sofern das angegebene Verzeichnis existiert. Genauere Informationen
+ finden Sie in Ihrem Systemhandbuch zur tempnam(3)-Funktion.
+ </entry>
+ </row>
+ <row>
+ <entry>4.0.3</entry>
+ <entry>
+ Das Verhalten dieser Funktion hat sich in Version 4.0.3 geändert.
+ Die temporäre Datei wird auch erstellt, um eine "race condition" zu
+ vermeiden, falls die Datei zwischen dem Zeitpunkt, an dem der String
+ erzeugt wurde, und dem Zeitpunkt, an dem das Skript die Datei erzeugt,
+ im Dateisystem auftaucht. Beachten Sie, dass Sie die Datei löschen
+ müssen, wenn Sie sie nicht mehr benötigen; dies geschieht nicht
+ automatisch.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
<example>
- <title><function>tempnam</function> example</title>
+ <title><function>tempnam</function>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
$tmpfname = tempnam("/tmp", "FOO");
$handle = fopen($tmpfname, "w");
-fwrite($handle, "writing to tempfile");
+fwrite($handle, "schreiben in Temporärdatei");
fclose($handle);
// tue etwas
@@ -56,22 +124,31 @@
</programlisting>
</example>
</para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
<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.
+ Wenn PHP die Datei nicht im angegebenen
+ <parameter>dir</parameter>-Parameter erzeugen kann, fällt es auf den
+ Systemstandardwert zurück. Unter NTFS geschieht dies auch, wenn
+ <parameter>dir</parameter> mehr als 65534 Dateien enthält.
</simpara>
</note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Siehe auch <function>tmpfile</function>, <function>sys_get_temp_dir</function>
- und <function>unlink</function>.
+ <simplelist>
+ <member><function>tmpfile</function></member>
+ <member><function>sys_get_temp_dir</function></member>
+ <member><function>unlink</function></member>
+ </simplelist>
</para>
</refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file
@@ -85,7 +162,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
Modified: phpdoc/de/trunk/reference/filesystem/functions/tmpfile.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/tmpfile.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/tmpfile.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,48 +1,79 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
- <refentry xml:id="function.tmpfile" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>tmpfile</refname>
- <refpurpose>Legt eine temporäre Datei an</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>resource</type><methodname>tmpfile</methodname>
- <void/>
- </methodsynopsis>
- <para>
- Erstellt eine temporäre Datei mit einem eindeutigen
- Dateinamen im Schreibmodus und gibt einen Dateizeiger
- ähnlich wie es bei der Funktion <function>fopen</function>
- erfolgt, zurück. Die Datei wird automatisch gelöscht, wenn
- sie geschlossen wird (mit <function>fclose</function>), oder
- das Skript beendet wird.
- </para>
- <para>
- Für Details konsultieren Sie bitte die Dokumentation Ihres
- Betriebssystems bzgl. der <literal>tmpfile(3)</literal> Funktion,
- wie auch die <filename>stdio.h</filename> Header-Datei.
- </para>
- <para>
- <example>
- <title><function>tmpfile</function></title>
- <programlisting role="php">
+<!-- EN-Revision: 290410 Maintainer: wiesemann Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.tmpfile">
+ <refnamediv>
+ <refname>tmpfile</refname>
+ <refpurpose>Erstellt eine temporäre Datei</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>resource</type><methodname>tmpfile</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ Erstellt eine temporäre Datei mit einem eindeutigen Dateinamen im
+ Lese-Schreib-Modus (w+) und gibt einen Dateizeiger zurück.
+ </para>
+ <para>
+ Die Datei wird automatisch gelöscht, wenn sie geschlossen wird (mit
+ <function>fclose</function>), oder wenn das Skript beendet wird.
+ </para>
+ <para>
+ Für Details lesen Sie bitte die Dokumentation zur
+ <literal>tmpfile(3)</literal>-Funktion und die
+ <filename>stdio.h</filename>-Header-Datei.
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Gibt einen Dateizeiger für die neue Datei zurück, der ähnlich zu dem
+ Zeiger ist, den <function>fopen</function> zurückgibt.
+ &return.falseforfailure;.
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>tmpfile</function>-Beispiel</title>
+ <programlisting role="php">
<![CDATA[
+<?php
$temp = tmpfile();
-fwrite($temp, "schreibt in Temporärdatei");
+fwrite($temp, "schreiben in Temporärdatei");
+fseek($temp, 0);
+echo fread($temp, 1024);
fclose($temp); // dies entfernt die Datei
]]>
- </programlisting>
- </example>
- </para>
- <para>
- Siehe auch <function>tempnam</function>.
- </para>
- </refsect1>
- </refentry>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+schreiben in Temporärdatei
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>tempnam</function></member>
+ <member><function>sys_get_temp_dir</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -54,7 +85,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
Modified: phpdoc/de/trunk/reference/filesystem/functions/touch.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/touch.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/touch.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,56 +1,154 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
- <refentry xml:id="function.touch" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>touch</refname>
- <refpurpose>
- Setzt die Zugriffs- und Modifizierungszeit einer Datei
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>int</type><methodname>touch</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>time</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>atime</parameter></methodparam>
- </methodsynopsis>
- <para>
- Setzt Datum und Uhrzeit der letzten Änderung und des letzten Zugriffs
- der durch <parameter>filename</parameter> spezifizierten Datei auf den
- durch <parameter>time</parameter> spezifizierten Wert. Wenn die Option
- <parameter>time</parameter> nicht angegeben wurde, wird die aktuelle
- Zeit benutzt. Dies ist äquivalent zu dem, was utime tut (manchmal wird
- auch als utimes davon gesprochen). Ist die dritte Option
- <parameter>atime</parameter> angegeben, so wird die Zugriffszeit
- auf <parameter>atime</parameter> gesetzt. Beachten Sie, dass die
- Zugriffszeit unabhängig von der Anzahl der Parameter stets modifiziert
- wird.
- </para>
- <para>
- Wenn die Datei nicht existiert, wird sie erzeugt.
- </para>
- <para>
- &return.success;
- <example>
- <title><function>touch</function></title>
- <programlisting role="php">
+<!-- EN-Revision: 293050 Maintainer: wiesemann Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.touch">
+ <refnamediv>
+ <refname>touch</refname>
+ <refpurpose>
+ Setzt die Zugriffs- und Modifikationszeit einer Datei
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>touch</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>time</parameter><initializer>time()</initializer></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>atime</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Versucht die Zugriffs- und Modifikationszeit der im
+ <parameter>filename</parameter>-Parameter angegebenen Datei auf
+ <parameter>time</parameter> zu setzen.
+ Beachten Sie, dass die Zugriffszeit unabhängig von der Anzahl der
+ Parameter immer geändert wird.
+ </para>
+ <para>
+ Wenn die Datei nicht existiert, wird sie erzeugt.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ Der Name der zu ändernden Datei.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>time</parameter></term>
+ <listitem>
+ <para>
+ Die Modifikationszeit. Wenn <parameter>time</parameter> nicht angegeben
+ ist, wird die aktuelle Systemzeit verwendet.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>atime</parameter></term>
+ <listitem>
+ <para>
+ Falls angegeben, wird die Zugriffszeit der angegebenen Datei auf
+ <parameter>atime</parameter> gesetzt. Andernfalls wird sie auf
+ <parameter>time</parameter> gesetzt.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.3.0</entry>
+ <entry>
+ Es wurde ermöglicht, die Modifikationszeit eines Verzeichnisses
+ unter Windows zu ändern.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>touch</function>-Beispiel</title>
+ <programlisting role="php">
<![CDATA[
-if (touch ($DateiName)) {
- print "$DateiName Modifizierungs-Zeit wurde auf das aktuelle
- Datum und die aktuelle Uhrzeit gesetzt.";
+if (touch($filename)) {
+ echo $filename . '-Modifikationszeit wurde auf die aktuelle Zeit gesetzt.';
} else {
- print "Tut mir leid, Modifikations-Zeit von $DateiName konnte
- nicht geändert werden.";
+ echo 'Entschuldigung, die Ãnderung der Modifikationszeit von ' . $filename
+ ' war nicht möglich.';
}
+?>
]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Nutzung von <function>touch</function> mit dem <parameter>time</parameter>-Parameter</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Modifikationszeit (eine Stunde in der Vergangenheit)
+$time = time() - 3600;
+// Ãndern der Datei
+if (!touch('eine_datei.txt', $time)) {
+ echo 'Ein Fehler ist aufgetreten ...';
+} else {
+ echo 'Ãnderung der Modifikationszeit war erfolgreich';
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ ¬e.filesystem-time-res;
+ <warning>
+ <para>
+ Vor PHP 5.3.0 war es nicht möglich, die Modifikationszeit eines
+ Verzeichnisses mit dieser Funktion unter Windows zu ändern.
+ </para>
+ </warning>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -62,7 +160,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
Modified: phpdoc/de/trunk/reference/filesystem/functions/umask.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/umask.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/umask.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,32 +1,89 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
- <refentry xml:id="function.umask" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>umask</refname>
- <refpurpose>
- Ändert die aktuelle umask (Zugriffsrechte)
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>int</type><methodname>umask</methodname>
- <methodparam choice="opt"><type>int</type><parameter>mask</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>umask</function> setzt PHP's umask auf
- <parameter>mask</parameter> & 0777 und gibt die alte umask
- zurück. Wird PHP als Servermodul benutzt, wird die umask
- zurückgespeichert wenn die jeweilige Anfrage beendet ist.
- </para>
- <para>
- <function>umask</function> ohne Argumente gibt einfach die
- aktuelle umask zurück.
- </para>
- </refsect1>
- </refentry>
+<!-- EN-Revision: 288721 Maintainer: wiesemann Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.umask">
+ <refnamediv>
+ <refname>umask</refname>
+ <refpurpose>Changes the current umask</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>umask</methodname>
+ <methodparam choice="opt"><type>int</type><parameter>mask</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>umask</function> setzt die umask von PHP auf
+ <parameter>mask</parameter> & 0777 und gibt die alte umask
+ zurück. Wird PHP als Servermodul benutzt, wird die umask
+ wiederhergestellt, wenn die jeweilige Anfrage beendet ist.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>mask</parameter></term>
+ <listitem>
+ <para>
+ Die neue umask.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ <function>umask</function> ohne Parameter gibt nur die aktuelle umask
+ zurück; andernfalls wird die alte umask zurückgegeben.
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>umask</function>-Beispiel</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$old = umask(0);
+chmod("/pfad/ein_verzeichnis/eine_datei.txt", 0755);
+umask($old);
+
+// Prüfung
+if ($old != umask()) {
+ die('Ein Fehler trat beim Wiederherstellen der umask auf');
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ Sie sollten diese Funktion nicht in Multithreaded-Webservern nutzen. Der
+ bessere Weg ist, die Dateiberechtigungen mit <function>chmod</function>
+ zu ändern nachdem die Datei erstellt wurde. Die Nutzung von
+ <function>umask</function> kann zu unerwartetem Verhalten von gleichzeitig
+ ausgeführten Skripten und des Webservers führen, weil die gleiche umask
+ genutzt wird.
+ </para>
+ </note>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -38,7 +95,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
Modified: phpdoc/de/trunk/reference/filesystem/functions/unlink.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/unlink.xml 2010-01-04 22:01:47 UTC (rev 293117)
+++ phpdoc/de/trunk/reference/filesystem/functions/unlink.xml 2010-01-04 22:04:12 UTC (rev 293118)
@@ -1,33 +1,115 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 -->
-<!-- last change to 'unlink' in en/ tree in rev 1.2 -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-<!-- OLD-Revision: 1.142/EN.1.2 -->
- <refentry xml:id="function.unlink" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>unlink</refname>
- <refpurpose>Löscht eine Datei</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <methodsynopsis>
- <type>bool</type><methodname>unlink</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- </methodsynopsis>
- <para>
- Löscht <parameter>filename</parameter>. Ähnlich der UNIX C
- unlink() Funktion.
- </para>
- <para>
- &return.success;
- </para>
- <para>
- Siehe auch <function>rmdir</function> um Verzeichnisse zu löschen.
- </para>
- </refsect1>
- </refentry>
+<!-- EN-Revision: 288721 Maintainer: wiesemann Status: ready -->
+<refentry xml:id="function.unlink" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>unlink</refname>
+ <refpurpose>Löscht eine Datei</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>unlink</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Löscht <parameter>filename</parameter>. Ãhnlich der
+ UNIX-C-unlink()-Funktion.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ Pfad zur Datei.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>context</parameter></term>
+ <listitem>
+ ¬e.context-support;
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.0.0</entry>
+ <entry>
+ Seit PHP 5.0.0 kann <function>unlink</function> auch mit
+ <emphasis>einigen</emphasis> URL-Wrappern genutzt werden.
+ In der <xref linkend="wrappers"/> finden Sie eine Liste aller
+ Wrapper, die <function>unlink</function> unterstützen.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>Einfache Nutzung von <function>unlink</function></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$fh = fopen('test.html', 'a');
+fwrite($fh, '<h1>Hallo Welt!</h1>');
+fclose($fh);
+
+mkdir('testdir', 0777);
+
+unlink('test.html');
+unlink('testdir');
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>rmdir</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -39,7 +121,7 @@
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil