Funktionen des DateisystemsFilesystembasename
Extrahiert den Namen einer Datei aus einer vollständigen Pfadangabe
Beschreibungstring basenamestring path
Diese Funktion extrahiert aus einer vollständigen Pfadangabe den
Namen der Datei und gibt diesen zurück.
Unter Windows wird sowohl der Slash (/) als
auch der Backslash (\) als Trennzeichen bei
Pfadangaben benutzt. Unter anderen Betriebssystemen hingegen nur
der Slash (/).
Basename
$path = "/home/httpd/html/index.php3";
$file = basename($path); // $file enthält den Wert "index.php3"
Siehe auch dirname.
chgrp
Wechselt die Gruppenzugehörigkeit einer Datei
Beschreibungint chgrpstring filenamemixed group
Weist einer Datei einer Benutzergruppe zu. Um diese Funktion
ausführen zu können, müssen Sie Superuser sein. Andere Benutzer
können die Gruppenzugehörigkeit einer Datei in jede Gruppe
ändern, derer sie angehören.
Gibt bei Erfolg TRUE zurück, andernfalls FALSE.
Unter Windows-Systemen bleibt diese Funktion ohne Effekt.
Siehe auch chown und
chmod.
chmodÄndert die Zugriffsrechte einer DateiBeschreibungint chmodstring filenameint mode
Diese Funktion ändert die Zugriffsrechte der Datei spezifiziert
in filename in die Zugriffsrechte um, die
in mode spezifiziert sind.
Bedenken Sie, das mode nicht automatisch
für einen Oktalwert gehalten wird. Um sicher zu gehen, dass die
Operation wie erwartet verläuft sollten Sie
mode mit dem Prefix Null (0) versehen:
chmod ("/somedir/somefile", 755); // dezimal; möglicherweise falsch
chmod ("/somedir/somefile", "u+rwx,go+rx"); // String; falsch
chmod ("/somedir/somefile", 0755); // oktal; richtiger Wert von mode
Gibt TRUE bei Erfolg zurück, andernfalls FALSE.
Siehe auch chown und
chgrp.
Diese Funktion bleibt unter Windows-Systemen ohne Effekt.
chownÄndert den Eigentümer einer DateiBeschreibungint chownstring filenamemixed user
Ändert den Eigentümer der Datei filename
in Benutzer user. Nur der Superuser kann
den Eigentümer einer Datei ändern.
Gibt bei Erfolg TRUE zurück, andernfalls FALSE.
Unter Windows bleibt diese Funktion ohne Effekt.
Siehe auch chown und
chmod.
clearstatcacheLöscht den Status CacheBeschreibungvoid clearstatcacheclearstatcache löscht den Zwischenspeicher
mit den Dateistatuswerten. Die Systemaufrufe
stat oder lstat
sind auf den meisten Systemen sehr "teure" Aufrufe. Daher wird
das Ergebnis des letzten Aufrufs von einer der unten aufgeführten
Funktionen für die nächste Benutzung eines ähnlichen Aufrufs mit
dem gleichen Dateinamen gespeichert. Wenn Sie einen neuen
Status-Check erzwingen wollen, z.B. wenn die Datei in der
Zwischenzeit oftmals aufgerufen wurde, verändert oder
verschwunden ist, können Sie diese Funktion dazu benutzen, das
Ergebnis des letzten Aufrufes aus dem Speicher zu leeren.
Dieser Wert wird nur für die Zeit eines einzelnen Requests
zwischengespeichert.
Folgende Funktionen betreffen den Dateistatus:
stat, lstat,
file_exists,
is_writeable,
is_readable,
is_executable, is_file,
is_dir, is_link,
filectime, fileatime,
filemtime, fileinode,
filegroup, fileowner,
filesize, filetype, and
fileperms.
copyKopiert eine DateiBeschreibungint copystring sourcestring dest
Die Funktion copy kopiert eine Datei. Sie
gibt TRUE zurück, wenn der Kopiervorgang erfolgreich war,
andernfalls FALSE.
Copy
if (!copy ($file, $file.'.bak')) {
print ("failed to copy $file...<br>\n");
}
Siehe auch: rename.
delete"Dummy Handbuch Eintrag"Beschreibungvoid deletestring file
Dieses ist ein "Dummy Handbuch Eintrag" für diejenigen, die nach
einer Funktion wie unlink oder
unset an der falschen Stelle suchen.
Siehe auch unlink um Dateien zu löschen,
unset um Variablen zu löschen.
dirname
Extrahiert den Verzeichnis-Namen aus einer vollständigen
Pfadangabe
Beschreibungstring dirnamestring path
Bei einer vollständigen Pfadangabe gibt diese Funktion den
Verzeichnispfad zurück.
Unter Windows wird sowohl der Slash (/) als
auch der Backslash (\) als Trennzeichen bei
Pfadangaben benutzt. Unter anderen Betriebssystemen hingegen nur
der Slash (/).
dirname
$path = "/etc/passwd";
$file = dirname ($path); // $file enthält den Wert "/etc"
Siehe auch basename.
diskfreespace
Liefert den freien Speicherplatz in einem Verzeichnis
Beschreibungfloat diskfreespacestring directory
Diese Funktion gibt den freien Speicherplatz eines Verzeichnisses
in Byte zurück.
diskfreespace
$df = diskfreespace("/"); // $df hält die Anzahl an freien Bytes
// im Verzeichnis "/"
fcloseSchließt einen offenen DateizeigerBeschreibungint fcloseint fp
Die Datei, auf die der Dateizeiger fp
zeigt wird geschlossen.
Gibt bei erfolgreichem Schließen der Datei TRUE, andernfalls
FALSE zurück.
Der Datei-Zeiger muss gültig sein, d.h. die Datei, auf die
gezeigt wird muss zuvor mit fopen
oder fsockopen geöffnet worden sein.
feof
Prüft, ob der Dateizeiger am Ende der Datei steht
Beschreibungint feofint fp
Gibt TRUE zurück, falls der Dateizeiger am Ende der Datei steht
oder ein Fehler aufgetreten ist, andernfalls FALSE.
Der Dateizeiger muss gültig sein, d.h. die Datei, auf die gezeigt
wird, muss zuvor mit fopen,
popen oder fsockopen
geöffnet worden sein.
fflushSchreibt den Ausgabepuffer in eine DateiBeschreibungint fflushint fp
Diese Funktion erzwingt das Schreiben des gesamten Ausgabepuffers
in die von dem Dateizeiger fp angegebenen
Datei. Gibt bei Erfolg TRUE, andernfalls FALSE zurück.
Der Dateizeiger muss gültig sein, und auf eine mittels
fopen, popen, oder
fsockopen erfolgreich geöffnete Datei zeigen.
fgetc
Liest das Zeichen, auf welches der Dateizeiger zeigt
Beschreibungstring fgetcint fp
Gibt einen String zurück, der ein einzelnes Zeichen von der
aktuellen Position des Dateizeigers fp
enthält. Gibt FALSE zurück, wenn der Dateizeiger am Ende der
Datei steht (wie die Funktion feof).
Der Dateizeiger muss gültig sein, d.h. die Datei, auf die gezeigt
wird, muss zuvor mit fopen,
popen oder fsockopen
geöffnet worden sein.
Siehe auch fread,
fopen, popen,
fsockopen und fgets.
fgetcsv
Liest eine Zeile von der Position des Dateizeigers und
prüft diese auf Komma-Separierte-Werte (CSV)
Beschreibungarray fgetcsvint fpint lengthstring
Trennzeichen (Delimiter)
Die Funktion fgetcsv handelt ähnlich der
Funktion fgets, bis auf den Umstand, das
fgetcsv die eingelesene Zeile auf
Kommaseparierte Felder hin überprüft. Das Ergebnis wird als Array
zurückgegeben. Als Trennzeichen (Delimiter) wird - wenn kein
anderes Trennzeichen im dritten optionalen Parameter angegeben
wird - das Komma benutzt.
Der Dateizeiger fp muss gültig sein,
d.h. die Datei, auf die gezeigt wird, muss zuvor mit
fopen, popen oder
fsockopen geöffnet worden sein.
'length' muss größer sein als die längste in der CSV-Datei
vorhandene Zeile (um das Erkennen von EndOfLine(Ende der Zeile)
Zeichen zu ermöglichen).
fgetcsv gibt FALSE am Dateiende und bei
Lesefehlern zurück.
Eine leere Zeile der CSV-Datei wird als Array mit einem Feld das
den Wert NULL hält zurückgegeben. Sie wird nicht als Fehler
behandelt.
Fgetcsv Beispiel - Lesen und Ausgabe des
Inhalts einer CSV-Datei
$row = 1; // Anzahl der Arrays
$fp = fopen ("test.csv","r"); // Datei wird zum Lesen
// geöffnet
while ($data = fgetcsv ($fp, 1000, ",")) { // Daten werden aus der Datei
// in einen Array $data gelesen
$num = count ($data); // Felder im Array $data
// werden gezählt
print "<p> $num fields in line $row: <br>";
$row++; // Anzahl der Arrays wird
// inkrementiert
for ($c=0; $c<$num; $c++) { // FOR-Schleife, um Felder
print $data[$c] . "<br>"; // des Arrays auszugeben
}
}
fclose ($fp);
fgets
Liest eine Zeile von der Position des Dateizeigers
Beschreibungstring fgetsint fpint length
Gibt eine Zeile bis zu length -1 Bytes
Länge zurück, welche aus der Datei von der aktuellen Position des
Dateizeigers fp aus ausgelesen wird. Die
Zeile endet an einem Zeilenumbruch (welcher im Rückgabewert enthalten
ist), EOF (Ende der Datei) oder bei length
- 1 Bytes (Je nachdem, was eher auftritt).
Wenn ein Fehler auftritt, wird FALSE zurückgegeben.
Häufig auftretende Fehler:
Wenn Sie an die C-Semantik von fgets gewöhnt sind, sollten
Sie auf die unterschiedliche Behandlung von EOF (genauer:
wie EOF zurückgegeben wird) achten.
Der Datei-Zeiger fp muss gültig sein,
d.h. die Datei, auf die gezeigt wird, muss zuvor mit
fopen, popen oder
fsockopen geöffnet worden sein.
Ein einfaches Beispiel:
Eine Datei Zeile für Zeile einlesen
$fd = fopen ("/tmp/inputfile.txt", "r");
while (!feof($fd)) {
$buffer = fgets($fd, 4096);
echo $buffer;
}
fclose ($fd);
Siehe auch fread, fopen,
popen, fgetc,
fsockopen, und
socket_set_timeout.
fgetss
Liest eine Zeile von der Position des Dateizeigers und entfernt
HTML und PHP-Tags.
Beschreibungstring fgetssint fpint lengthstring
allowable_tags
Diese Funktion ist identisch mit der Funktion
fgets, ausser das
fgetss versucht, vorhandene HTML und
PHP-Tags aus dem gelesenen Text zu entfernen.
Optional können mit dem dritten Parameter
allowable_tags Tags spezifiziert werden,
die nicht entfernt werden sollen.
allowable_tags wurden in PHP 3.0.13
hinzugefügt, PHP4B3.
Siehe auch fgets,
fopen, fsockopen,
popen und strip_tags.
file
Liest eine Datei komplett in einen Array
Beschreibungarray filestring filenameint
use_include_path
Die Funktion file ist identisch mit der
Funktion readfile, bis auf den Umstand, das
die eingelesene Datei als Array zurückgegeben wird. Jedes Feld
des Arrays korrespondiert mit einer Zeile der Datei. Der
Zeilenumbruch bleibt erhalten.
Optional kann der zweite Parameter benutzt und auf '1' gesetzt
werden, wenn in dem include_path ebenfalls nach der
Datei gesucht werden soll.
<?php
// liest eine Webseite in einen Array und gibt das Ergebnis aus
$fcontents = file ('http://www.php.net');
while (list ($line_num, $line) = each ($fcontents)) {
echo "<b>Line $line_num:</b>" . htmlspecialchars($line) . "<br>\n";
}
// liefert eine Webseite in einen String
$fcontents = join ('', file ('http://www.php.net'));
?>
Siehe auch readfile,
fopen, fsockopen, und
popen.
file_existsÜberprüft, ob eine Datei existiertBeschreibungint file_existsstring filename
Gibt TRUE zurück, wenn die mit filename
spezifizierte Datei existiert, andernfalls FALSE.
File_exists funktioniert nur mit lokalen
Dateien. Die Datei, deren Existenz überprüft werden soll muss
über das Dateisystem des Servers erreichbar sein.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
fileatime
Liefert Datum und Uhrzeit des letzten Zugriffs auf eine Datei
Beschreibungint fileatimestring filename
Gibt Datum und Uhrzeit des letzten Zugriffs auf eine Datei
zurück, oder FALSE wenn ein Fehler auftrat. Das Datum wird als
UNIX-Timestamp zurückgegeben.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
Anmerkung: Die atime einer Datei vorgesehen sich immer zu ändern,
sobald Datenblöcke einer Datei geändert werden. Das kann sich
folgenschwer auf die Performance auswirken, wenn eine Anwendung
regelmässig auf eine grosse Anzahl Dateien oder Verzeichnisse zugreift.
Manche Unix Dateisysteme können mit deaktivierter atime-Aktualisierung
gemountet werden, um die Performance solcher Applikationen zu erhöhen;
USENET news spools sind ein häufiges Beispiel. Auf solchen
Dateisystemen wird diese Funktion nutzlos.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
filectime
Liefert Datum und Uhrzeit der letzten Änderung des Dateizeigers
Inode
Beschreibungint filectimestring filename
Gibt Zeit der letzten Änderung des Dateizeigers Inode zurück,
oder FALSE wenn ein Fehler auftrat. Die Zeit wird als
UNIX-Timestamp zurückgegeben.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
Anmerkung: Bei den meisten Unix Dateisystemen gilt eine Datei als
geändert, sobald ihre Inode-Daten geändert wurden; d.h. wenn die
Rechte, Eigentümer, Gruppe, oder andere Metadaten des Inodes
aktualisiert werden. Siehe auch filemtime (das
ist was Sie suchen, wenn Sie Fusszeilen mit "Zuletzt Aktualisiert"
für Webseiten erstellen möchten) und fileatime.
Beachten Sie auch, dass in einigen Unix-Texten ctime als die Zeit
der Erstellung der Datei beschrieben wird. Das ist falsch. Bei den
meisten Unix Dateisystemen gibt es keine Zeitangabe für die Erstellung
von Unix Dateien.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
filegroup
Liefert die Gruppenzugehörigkeit einer Datei
Beschreibungint filegroupstring filename
Gibt die Gruppen ID des Besitzers einer Datei zurück, oder FALSE
wenn ein Fehler auftrat. Die Gruppen ID wird im numerischen
Format zurückgegeben. Mit der Funktion
posix_getgrgid können Sie diese zu ihrem
Gruppennamen auflösen.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
Diese Funktion hat unter Windows-Systemen keinen Effekt.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
fileinodeLiefert die Inode-Nummer einer DateiBeschreibungint fileinodestring filename
Gibt die Inode-Nummer einer Datei zurück, oder FALSE wenn ein
Fehler auftrat.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
Diese Funktion hat unter Windows-Systemen keinen Effekt.
filemtime
Liefert Datum und Uhrzeit der letzten Dateiänderung
Beschreibungint filemtimestring filename
Gibt Datum und Uhrzeit zurück, wann die Datei das letzte mal
modifiziert wurde, oder FALSE wenn ein Fehler auftrat. Das Datum
wird als UNIX-Timestamp zurückgegeben.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
Anmerkung: Diese Funktion gibt den Zeitpunkt zurück, an dem in
die Datenblöcke einer Datei geschrieben wurde; d.h. den Zeitpunkt der
Änderung des Inhalts der Datei. Verwenden Sie date,
um das Ergebnis dieser Funktion in ein ausgabefähiges Änderungsdatum
für z.B. Fusszeilen in Webseiten zu erhalten.
fileownerLiefert den DateieigentümerBeschreibungint fileownerstring filename
Gibt die Benutzer ID des Eigentümers einer Datei zurück, oder
FALSE wenn ein Fehler auftrat. Die Benutzer ID wird in
numerischem Format zurückgegeben und kann mit der Funktion
posix_getpwuid zum Benutzernamen aufgelöst
werden.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
Diese Funktion hat unter Windows keinen Effekt.
filepermsLiefert die Zugriffsrechte einer DateiBeschreibungint filepermsstring filename
Gibt die Zugriffsrechte einer Datei zurück, oder FALSE wenn ein
Fehler auftrat.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
filesizeLiefert die Größe einer DateiBeschreibungint filesizestring filename
Gibt die Größe einer Datei zurück, oder FALSE wenn ein Fehler
auftrat.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
filetypeLiefert den Typ einer DateiBeschreibungstring filetypestring filename
Gibt den Typ einer Datei zurück. Mögliche Werte sind fifo, char,
dir, block, link, file und unknown.
Gibt FALSE zurück, wenn ein Fehler auftrat.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe clearstatcache für weitere
Einzelheiten.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
flockPortables Datei-Verriegelungs-VerfahrenBeschreibungbool flockint fpint operationint
wouldblock
PHP liefert einen portablen Weg, Dateien in einer "beratenden"
Art und Weise zu verriegeln. D.h. alle zugreifende Programme
müssen die gleiche Art und Weise der Verriegelung benutzen, oder
es funktioniert nicht.
flock arbeitet mit fp
welcher ein existierender Dateizeiger sein muss. Der Parameter
operation bestimmt die Art der
Verriegelung und kann einen der folgenden Werte annehmen:
Um eine verteilte, nur lesende Verriegelung zu erhalten,
setzten Sie operation auf LOCK_SH (bzw.
1 vor PHP 4.0.1).
Um eine exklusive, nur schreibende Verriegelung zu erhalten,
setzen Sie operation auf LOCK_EX (bzw.
2 vor PHP 4.0.1).
Um eine Verriegelung freizugeben (lesend oder schreibend),
setzten Sie operation auf LOCK_UN (bzw.
3 vor PHP 4.0.1).
Wenn Sie Zugriffe während der Verriegelung durch
flock erlauben wollen, fügen Sie LOCK_NB
(bzw. 4 vor PHP 4.0.1) zu operation hinzu.
flock erlaubt es Ihnen ein einfaches
Leser/Schreiber Modell zu erstellen, welches auf fast jeder Plattform
benutzt werden kann (inkl. den meisten UNICES- und Windows-Systemen).
Das optionale dritte Argument ist auf TRUE gesetzt, wenn die
Verriegelung sperren sollte (EWOULDBLOCK errno Bedingung).
flock gibt TRUE bei Erfolg, FALSE wenn ein
Fehler auftrat (z.B. wenn eine Verriegelung nicht erstellt werden
konnte) zurück.
Bei den meisten Betriebssystemen ist flock
auf dem Prozesslevel implementiert. Wenn Sie ein multithreaded
Server API wie ISAPI benutzen können Sie sich nicht auf
flock verlassen, um Dateien vor anderen PHP-Scripten
zu schützen, welche in parallelen Threads der gleichen Server-Instanz laufen!
fopenÖffnet eine Datei oder URLBeschreibungint fopenstring filenamestring modeint
use_include_path
Wenn filename mit "http://" (nicht case
sensitive) beginnt, wird zu dem spezifiziertem Server eine HTTP
1.0 Connection geöffnet und ein Dateizeiger auf den Anfang des
Textes der Antwort zurückgegeben. Ein 'Host:' header wird mit der
Anfrage geschickt, um namens-basierte Virtual Hosts zu verarbeiten.
Weiterleitungen (HTTP Redirects) werden nicht unterstützt, die
Datei muss daher vollständig und mit abschließendem "/"
beschrieben werden.
Wenn filename mit "ftp://" (nicht case
sensitive) beginnt, wird eine ftp-Connection zu dem
spezifizierten Server geöffnet und ein Zeiger auf die
angeforderte Datei zurückgegeben. Wenn der Server keinen
passiven FTP-Modus unterstützt, wird diese Methode
fehlschlagen. Sie können Dateien entweder zum Schreiben oder zum
Lesen öffnen, jedoch nicht für beides gleichzeitig.
Wenn filename "php://stdin",
"php://stdout", oder "php://stderr" ist, wird der
korrespondierende stdio stream geöffnet (Feature wurde in Version
3.0.13 eingeführt, in früheren Versionen muss der Dateiname wie
z.B. "/dev/stdin" oder "/dev/fd/0" benutzt werden, um auf die
stdio streams zuzugreifen).
Wenn filename mit irgendetwas anderem
beginnt, wird die Datei vom lokalen Dateisystem geöffnet und ein
Dateizeiger auf die geöffnete Datei zurückgegeben.
Wenn das Öffnen scheitert, gibt die Funktion FALSE zurück.
mode kann einen der folgenden Werte
einnehmen:
'r' - öffnet die Datei nur zum Lesen und positioniert den
Dateizeiger auf den Anfang der Datei.
'r+' - Öffnet die Datei zum Lesen und Schreiben und setzt den
Dateizeiger auf den Anfang der Datei.
'w' - Öffnet die Datei nur zum Schreiben und setzt den
Dateizeiger auf den Anfang der Datei sowie die Länge der Datei
auf 0 Byte. Wenn die Datei nicht existiert wird versucht sie
anzulegen.
'w+' - Öffnet die Datei zum Lesen und Schreiben und setzt den
Dateizeiger auf den Anfang der Datei sowie die Länge der Datei
auf 0 Byte. Wenn die Datei nicht existiert, wird versucht sie
anzulegen.
'a' - Öffnet die Datei nur zum Schreiben. Positioniert den
Dateizeiger auf das Ende der Datei. Wenn die Datei nicht
existiert, wird versucht sie anzulegen.
'a+' - Öffnet die Datei zum Lesen und Schreiben. Positioniert
den Dateizeiger auf das Ende der Datei. Wenn die Datei nicht
existiert, wird versucht sie anzulegen.
Zusätzlich kann mode der Buchstabe 'b'
hinzugefügt werden, der die Behandlung von Binär-Dateien
erlaubt. Dies ist nur auf Systemen sinnvoll, welche zwischen Binär-
und Text-Dateien unterscheiden (z.B. Windows. Ist bei Unix sinnlos).
Wenn das Feature nicht gebraucht wird, wird es einfach ignoriert.
Sie können optional ein dritten Parameter benutzen und diesen auf
'1' setzten, wenn Sie auch im include_path nach der Datei
suchen möchten.
fopen()
$fp = fopen ("/home/simi/simi.txt", "r");
$fp = fopen ("/home/simi/simi.gif", "wb");
$fp = fopen ("http://www.php.net/", "r");
$fp = fopen ("ftp://user:password <email protected>/", "w");
Wenn Sie Probleme mit dem Lesen oder Schreiben von Dateien haben
und PHP als Servermodul benutzen, stellen Sie zunächst
sicher, dass die Dateien und Verzeichnisse die Sie benutzen
wollen auch für den Server-Prozeß zugänglich sind
(Rechtevergabe).
Achten Sie auf Windows-Systemen darauf, dass Sie als
Verzeichnistrenner normale Schrägstriche '/' benutzen um
plattformunabhängig programmieren zu können. Sollten Sie dennoch
Backslashes verwenden, vergessen Sie nicht diese zu escapen '\\'
$fp = fopen ("c:\\data\\info.txt", "r");
Siehe auch fclose,
fsockopen,
socket_set_timeout, und
popen.
fpassthru
Gibt alle verbleibenden Daten eines Dateizeigers direkt aus.
Beschreibungint fpassthruint fp
Die Funktion liest alle Daten vom Dateizeiger bis EOF aus und
gibt die Daten auf der Standartausgabe (Browser) aus.
Wenn ein Fehler auftritt, gibt fpassthru
FALSE zurück.
Der Dateizeiger muss gültig sein und auf eine erfolgreich durch
fopen, popen oder
fsockopen geöffnete Datei zeigen. Die Datei
wird geschlossen, wenn fpassthru die Datei
komplett gelesen hat (hinterläßt nutzlosen
fp-Dateizeiger).
Wenn Sie den Inhalt einer Datei nur auf der Standartausgabe
(Browser) ausgeben wollen, sollten Sie besser
readfile benutzen, bei der Sie nicht zuvor
die Datei mittels fopen geöffnet haben
müssen.
Siehe auch readfile,
fopen, popen und
fsockopenfputs
Schreibt Daten an die Position des Dateizeigers
Beschreibungint fputsint fpstring strint
lengthFputs ist ein Alias für die Funktion
fwrite, und ist in jeder Hinsicht identisch
mit ihr. Beachten Sie, dass der Parameter
length optional ist, und dass, wenn er
nicht benutzt wird, die gesamte Zeichenkette geschrieben wird.
freadLiest Binärdaten aus einer DateiBeschreibungstring freadint fpint lengthFread liest length
Bytes vom Dateizeiger, maximal jedoch bis zum Dateiende.
// liest den Inhalt einer Datei in einen String
$filename = "/usr/local/simi.txt";
$fd = fopen ($filename, "r");
$contents = fread ($fd, filesize ($filename));
fclose ($fd);
Auf Systemen, welche zwischen Binär- und Textdateien (z.B. Windows)
unterscheiden, muß die Datei mit 'b' im fopen
Mode-Parameter geöffnet werden.
$filename = "c:\\files\\somepic.gif";
$fd = fopen ($filename, "rb");
$contents = fread ($fd, filesize ($filename));
fclose ($fd);
Siehe auch fwrite, fopen,
fsockopen, popen,
fgets, fgetss,
fscanf, file und
fpassthru.
fscanfInterpretiert den Input einer Datei entsprechend einem
angegebenen Format Beschreibungmixed fscanfint handlestring formatstring
var1...
Die Funktion fscanf ist
sscanf ähnlich, wobei sie ihren Input aus
der mit handle angegebenen Datei nimmt, und
entsprechend dem angegebenen format
interpretiert. Sind nur 2 Parameter angegeben, werden die analysierten
Werte als Array zurückgegeben. Werden auch optionale Parameter
übergeben, gibt die Funktion die Anzahl der ermittelten Werte zurück.
Die optionalen Parameter müssen referenziert übergeben werden.
Fscanf
$fp = fopen ("users.txt","r");
while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) {
list ($name, $profession, $countrycode) = $userinfo;
//... Tue etwas mit den Werten
}
fclose($fp);
users.txt
javier argonaut pe
hiroshi sculptor jp
robert slacker us
luigi florist it
Siehe auch fread, fgets,
fgetss, sscanf,
printf, und sprintf.
fseek
Positioniert den Dateizeiger
Beschreibungint fseekint fpint offsetint whence
Setzt den Dateizeiger einer mit fp angegebenen
Datei auf eine neue Position. Diese neue Position, angegeben in Bytes
vom Begin der Datei an, wird definiert durch Hinzufügen von
offset zu der Position spezifiziert durch
whence, deren Werte wie folgt definiert sind:
SEEK_SET - Setzt Position gleich
offset bytes.SEEK_CUR - Setzt Position auf die aktuelle Stelle plus
offset.SEEK_END - Setzt die Position ans Ende der Datei plus
offset.Wenn whence nicht angegeben wurde, wird
SEEK_SET angenommen.
Bei Erfolg wird '0' zurückgegeben, andernfalls '-1'. Beachten
Sie, dass die Überschreitung des Dateiendes (EOF) nicht als
Fehler bewertet wird.
Diese Funktion sollte nicht auf Dateizeiger angewandt werden, die
durch die Verwendung von "http://" oder "ftp://" bei der Funktion
fopen erhalten wurden.
Das whence-Argument wurde nach PHP 4.0 RC1
eingeführt.
Siehe auch ftell und
rewind.
fstat
Liefert Informationen über eine Datei mit offenem Dateizeiger
Descriptionarray fstatint fp
Trägt die Statistiken der mittel des Dateizeigers fp geöffneten
Datei zusammen. Diese Funktion ist ähnlich der Funktion
stat, außer dass sie mit einem offenen
Dateizeiger anstatt eines Dateinamens arbeitet.
Gibt die Statistiken einer Datei in Form eines Arrays mit den
folgenden Elementen zurück:
GerätInodeAnzahl LinksUser id des EigentümersGruppen id EigentümerGerätetype wenn ein Inode-Gerät *Größe in BytesZeit des letzten ZugriffsZeit der letzten ModifikationZeit der letzten ÄnderungBlockgröße für Dateisystem I/O *Anzahl der Blöcke
* - nur gültig bei Systemen, welche den st_blksize Typ unterstützen, andere
Systeme (z.B. Windows) geben -1 zurück
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert. Siehe
clearstatcache für weitere Einzelheiten.
ftell
Ermittelt die aktuelle Position des Dateizeigers
Beschreibungint ftellint fp
Gibt die aktuelle Position des Dateizeigers
fp zurück, z.B. seinen Offset im
Dateistream.
Wenn ein Fehler auftritt, wird FALSE zurückgegeben.
Der Dateizeiger muss gültig sein und auf eine erfolgreich durch
fopen oder popen
geöffnete Datei zeigen.
Siehe auch fopen,
popen, fseek und
rewind.
ftruncate
Kürzt eine Datei auf die angegebene Länge
Descriptionint ftruncateint fpint size
Nimmt den Dateizeiger fp, und verkürzt die
Datei auf die Länge size.
Diese Funktion gibt bei Erfolg TRUE, ansonsten FALSE zurück.
fwriteSchreibt Binärdaten in eine DateiBeschreibungint fwriteint fpstring stringint
lengthFwrite schreibt den Inhalt einer
Zeichenkette string in die Datei, auf
welche der fp Dateizeiger zeigt. Wenn der
length Parameter gegeben ist, wird das
Schreiben nach length Bytes beendet, oder
wenn das Dateiende (EOF) erreicht ist, je nachdem, was eher
eintritt.
Bedenken Sie, dass wenn der length
Parameter gesetzt ist, die magic_quotes_runtime
Konfigurations-Option ignoriert wird und somit keine Slashes mehr
von der Zeichenkette string entfernt
werden.
Auf Systemen, welche zwischen Binär- und Textdateien (z.B. Windows)
unterscheiden, muß die Datei mit 'b' im fopen
Mode-Parameter geöffnet werden.
Siehe auch fread,
fopen, fsockopen,
popen und fputs.
set_file_buffer
Setzt die Dateipufferung für einen gegebenen Dateizeiger
Beschreibungint set_file_bufferint fpint buffer
Eine Ausgabe mittels fwrite wird normalerweise
mit 8k gepuffert. Das heißt, dass wenn zwei Prozesse in den gleichen
Output Stream (eine Datei) schreiben wollen, jeder nach 8k Daten
unterbrochen wird, um den anderen schreiben zu lassen.
set_file_buffer setzt die Pufferung für
Schreiboperationen des gegebenen Dateizeigers
fp auf buffer
Bytes. Wenn buffer 0 ist, erfolgen die
Schreiboperationen ungepuffert. Dies stellt sicher, dass alle
Schreiboperationen mit fwrite abgeschlossen
werden, bevor andere Prozesse in diesen Output Stream schreiben können.
Die Funktion gibt bei Erfolg 0, oder EOF wenn die Anfrage nicht
erfolgreich war, zurück.
Das folgende Beispiel zeigt, wie man mittels
set_file_buffer einen ungepufferten Stream
generiert.
set_file_buffer
$fp=fopen($file, "w");
if($fp){
set_file_buffer($fp, 0);
fputs($fp, $output);
fclose($fp);
}
Siehe auch fopen, fwrite.
is_dir
Prüft, ob der gegebene Dateiname ein Verzeichnis ist
Beschreibungbool is_dirstring filename
Gibt TRUE zurück, wenn der Dateiname existiert und es sich
hierbei um ein Verzeichnis handelt.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe auch clearstatcache für weitere
Einzelheiten.
Siehe auch is_file und
is_link.
is_executable
Prüft, ob eine Datei ausführbar ist
Beschreibungbool is_executablestring filename
Gibt TRUE zurück, wenn die Datei existiert und ausführbar ist.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe auch clearstatcache für weitere
Einzelheiten.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
Siehe auch is_file und
is_link.
is_file
Prüft, ob der Dateiname eine reguläre Datei ist
Beschreibungbool is_filestring filename
Gibt TRUE zurück, wenn die Datei existiert und eine reguläre
Datei ist.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe auch clearstatcache für weitere
Einzelheiten.
Siehe auch is_dir und
is_link.
is_link
Prüft, ob der Dateiname ein symbolischer Link ist
Beschreibungbool is_linkstring filename
Gibt TRUE zurück, wenn der Dateiname existiert und es sich um
einen symbolischen Link handelt.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe auch clearstatcache für weitere
Einzelheiten.
Siehe auch is_dir und
is_file.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
Diese Funktion hat auf Windows-Systemen keinen Effekt.
is_readable
Prüft, ob eine Datei lesbar ist
Beschreibungbool is_readablestring filename
Gibt TRUE zurück wenn die Datei existiert und sie lesbar ist.
Bedenken Sie, dass PHP mit der Benutzer ID auf die Datei
zugreift, unter der der Webserver läuft (oftmals ist dieses
'nobody'). Beschränkungen durch safe_mode werden nicht
berücksichtigt.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe auch clearstatcache für weitere
Einzelheiten.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
Siehe auch is_writable.
is_writable
Prüft, ob in eine Datei geschrieben werden kann
Beschreibungbool is_writablestring filename
Gibt TRUE zurück, wenn die Datei existiert und nicht
schreibgeschützt ist. Das Dateinamen-Argument
filename kann ein Verzeichnisname
sein. So können Sie überprüfen, ob in ein Verzeichnis
geschrieben werden kann.
Bedenken Sie, dass PHP mit der Benutzer ID auf die Datei
zugreift, unter der der Webserver läuft (oftmals ist dieses
'nobody'). Beschränkungen durch safe_mode werden nicht
berücksichtigt.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe auch clearstatcache für weitere
Einzelheiten.
Diese Funktion ist nicht für remote Dateien geeignet, die zu
prüfende Datei muss über das Dateisystem des Servers verfügbar sein.
Siehe auch is_readable.
is_writeablePrüft, ob in eine Datei geschrieben werden kannBeschreibungbool is_writeablestring filename
Dies ist ein Alias für is_writableis_uploaded_filePrüft, ob die Datei mittels HTTP POST upgeloaded wurde.
Beschreibungbool is_uploaded_filestring filename
Diese Funktion ist nur in PHP 3 Versionen nach PHP 3.0.16, und
PHP 4 Versionen nach PHP 4.0.2 verfügbar.
Gibt TRUE zurück, wenn die Datei filename mittels
HTTP POST upgeloaded wurde. Das ist hilfreich sicherzustellen, daß
kein böswilliger User versucht hat das Script zu überlisten, indem
er es Dateien bearbeiten lässt, die es gar nicht bearbeiten sollte.
Zum Beispiel /etc/passwd.
Diese Prüfung ist speziell dort interessant, wo irgendeine Aktion mit
upgeloadeten Dateien deren Inhalt dem User zugänglich machen könnte
(oder auch anderen Usern auf dem selben System).
Siehe auch move_uploaded_file, und das Kapitel
Steuerung von Dateiuploads
für ein einfaches Anwendungsbeispiel.
linkErzeugt einen absoluten LinkBeschreibungint linkstring targetstring linkLink erzeugt einen absoluten Link mit dem
Ziel target.
Siehe auch symlink um symbolische Links zu
erstellen und readlink zusammen mit
linkinfo.
Diese Funktion hat unter Windows-Systemen keinen Effekt.
linkinfoLiefert Informationen über einen LinkBeschreibungint linkinfostring pathLinkinfo gibt das st_dev Feld des UNIX C
stat structure resultierend aus dem lstat System Call
zurück. Diese Funktion wird benutzt, um zu verifizieren ob ein
Link (auf den mit path gezeigt wird)
wirklich existiert (Hierbei wird die gleiche Methode benutzt,
die in dem S_ISLNK Makro in stat.h definiert ist). Gibt 0 oder
FALSE zurück wenn ein Fehler auftrat.
Siehe auch symlink,
link, und readlink.
Diese Funktion hat unter Windows keinen Effekt.
mkdirErstellt ein VerzeichnisBeschreibungint mkdirstring pathnameint mode
Versucht ein Verzeichnis mit dem spezifiziertem Namen zu
erstellen.
Bedenken Sie, dass sie wahrscheinlich den Mode als oktalen
Wert spezifizieren wollen, was bedeutet, dass er eine
voranstehende Null haben sollte.
mkdir ("/path/to/my/dir", 0700);
Gibt TRUE bei Erfolg, andernfalls FALSE zurück.
Siehe auch rmdir.
move_uploaded_fileVerschiebt eine upgeloadete Datei an einen neuen Ort.
Beschreibungbool move_uploaded_filestring filenamestring destination
Diese Funktion ist nur in PHP 3 Versionen nach PHP 3.0.16, und
PHP 4 Versionen nach PHP 4.0.2 verfügbar.
Diese Funktion prüft, ob die mit filename
bezeichnete Datei eine gültige Upload-Datei ist (d.h., dass sie
mittels PHP's HTTP POST Upload-Mechanismus upgeloaded wurde).
Ist die Datei gültig, wird sie zum in
destination bezeichneten Dateinamen
verschoben.
Wenn filename keine gültige Datei ist, wird
keine Aktion ausgeführt, und
move_uploaded_file gibt
false zurück.
Wenn filename eine gültige Datei ist, jedoch
aus irgendeinem Grund nicht verschoben werden kann, wird keine
Aktion ausgeführt, und move_uploaded_file
gibt false zurück. Zusätzlich wird eine Warnung
ausgegeben.
Diese Prüfung ist speziell dort interessant, wo irgendeine Aktion mit
upgeloadeten Dateien deren Inhalt dem User zugänglich machen könnte
(oder auch anderen Usern auf dem selben System).
Siehe auch is_uploaded_file, und das Kapitel
Steuerung von Dateiuploads
für ein einfaches Anwendungsbeispiel.
pathinfoLiefert Informationen über den DateipfadDescriptionarray pathinfostring pathpathinfo gibt ein assoziatives Array
mit Informationen über den Pfad path
zurück. Die folgenden Arrayelemente werden zurückgegeben:
den Verzeichnisnamen dirname, den Dateinamen
basename, und die Dateinamenserweiterung
extension.
pathinfo
<?php
$path_parts = pathinfo("/www/htdocs/index.html");
echo $path_parts["dirname"] . "\n";
echo $path_parts["basename"] . "\n";
echo $path_parts["extension"] . "\n";
?>
Würde ausgeben:
/www/htdocs
index.html
html
Siehe auch dirname,
basename und realpath.
pcloseSchließt einen Prozess-DateizeigerBeschreibungint pcloseint fp
Schließt einen Prozess-Dateizeiger, der durch einen Aufruf von
popen geöffnet wurde.
Der Dateizeiger muss gültig sein und durch einen erfolgreichen
Funktionsaufruf von popen zurückgegeben
worden sein.
Gibt den End-Status eines laufenden Prozesses zurück.
Siehe auch popen.
popenÖffnet einen ProzesszeigerBeschreibungint popenstring commandstring mode
Öffnet eine Verbindung zu einem Prozess, der durch die Anweisung
command ausgeführt wurde.
Gibt einen Dateizeiger zurück, der identisch ist mit dem, der bei
der Funktion fopen zurückgegeben wird,
ausser dass dieser nur in eine Richtung funktioniert (entweder
lesend oder schreibend) und mit der Funktion
pclose geschlossen werden muss. Dieser
Zeiger kann mit den Funktionen fgets,
fgetss und fputs
benutzt werden.
Wenn ein Fehler auftritt, gibt diese Funktion FALSE zurück.
$fp = popen ("/bin/ls", "r");
Siehe auch pclose.
readfileGibt eine Datei ausBeschreibungint readfilestring filenameint
use_include_path
Liest den Inhalt einer Datei und gibt ihn an der Standartausgabe
(Browser) aus.
Gibt die Anzahl der Bytes einer Datei zurück. Wenn ein Fehler
auftritt wird FALSE zurückgegeben und eine Fehlermeldung wird auf
der Standartausgabe ausgegeben. Die Ausgabe einer Fehlermeldung
kann durch Voranstellen eines '@' verhindert werden ( <email protected>).
Wenn filename mit "http://" (nicht case
sensitive) beginnt, wird eine HTTP 1.0 Connection zu dem
spezifiziertem Server geöffnet und der Text der Antwort wird auf
die Standartausgabe geschrieben.
Weiterleitungen (HTTP Redirects) werden nicht unterstützt, daher
muss die Datei vollständig mit abschliessendem '/' geschrieben
werden.
Wenn filename mit "ftp://" (nicht case
sensitive) beginnt, wird eine FTP-Connection zu dem
spezifiziertem Server geöffnet und die angeforderte Datei wird
auf der Standartausgabe ausgegeben. Wenn der Server keinen
passiven Mode unterstützt, wird diese Funktion fehlschlagen.
Wenn filename mit keinem dieser
Zeichenketten beginnt, wird die Datei vom lokalen Dateisystem
geöffnet und ihr Inhalt auf der Standartausgabe ausgegeben.
Sie können optional den zweiten Parameter benutzen und diesen
auf '1' setzen, wenn Sie auch im include_path nach der Datei
suchen möchten.
Siehe auch fpassthru,
file, fopen,
include, require und
virtual.
readlink
Liefert das Ziel eines symbolischen Links
Beschreibungstring readlinkstring pathReadlink ist von der Funktionalität her
identisch mit der 'readlink C Funktion' und gibt den Inhalt des
Pfades des symbolischen Links zurück oder 0, wenn der Aufruf
fehlschlug.
Siehe auch symlink,
readlink und linkinfo.
Diese Funktion hat unter Windows keinen Effekt.
renameBenennt eine Datei umBeschreibungint renamestring oldnamestring newname
Versucht eine Datei oldname in
newname umzubenennen.
Gibt TRUE bei Erfolg, andernfalls FALSE zurück.
rewind
Setzt den Dateizeiger auf das erste Byte der Datei
Beschreibungint rewindint fp
Setzt den Dateizeiger (Datei-Positions-Indikator) für
fp an den Anfang des Dateistreams.
Wenn ein Fehler auftritt, gibt die Funktion 0 zurück.
Der Dateizeiger muss gültig sein und auf eine Datei zeigen, die
zuvor erfolgreich durch fopen geöffnet
wurde.
Siehe auch fseek und
ftell.
rmdirLöscht ein VerzeichnisBeschreibungint rmdirstring dirname
Versucht ein Verzeichnis spezifiziert durch die Pfadangabe zu
löschen. Das Verzeichnis muss leer sein und die relevanten Rechte
müssen erteilt sein.
Wenn ein Fehler auftritt wird 0 zurückgegeben.
Siehe auch mkdir.
stat
Liefert diverse Informationen über eine Datei
Beschreibungarray statstring filename
Sammelt Informationen über eine Datei spezifiziert in
filename.
Gibt einen Array mit folgenden statistischen Informationen als
Array- Elemente zurück:
Laufwerkinodeinode protection modeAnzahl der LinksBenutzer ID des InhabersGruppen ID des InhabersLaufwerkstyp wenn Inode-Laufwerk *Größe in BytesZeitpunkt des letzten ZugriffsZeitpunkt der letzten ModifizierungZeitpunkt der letzten ÄnderungBlockgröße für das Dateisystem I/O *Anzahl der zugewiesenen Blöcke
* - nur gültig auf Systemen, die st_blksize unterstützen. Andere
Systeme (z.B. Windows) geben '-1' zurück.
Gibt FALSE zurück, wenn ein Fehler auftrat.
stat handhabt keine URL, wie
fopen.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe auch clearstatcache für weitere
Einzelheiten.
lstat
Liefert Informationen über eine Datei oder einen symbolischen Link.
Beschreibungarray lstatstring filename
Ermittelt statistische Informationen über eine Datei oder
symbolischen Link, spezifiziert in filename.
Diese Funktion ist identisch mit der Funktion
stat, ausser dass wenn der Parameter
filename ein symbolischer Link ist, dessen
Status zurückgegeben wird und nicht der Status der Datei, auf die
der symbolische Link zeigt.
Gibt einen Array mit statistischen Informationen über die Datei
als Array-Elemente zurück:
LaufwerkinodeAnzahl der LinksBenutzer ID des InhabersGruppen ID des InhabersLaufwerkstyp wenn inode Laufwerk *Größe in BytesZeitpunkt des letzten ZugriffsZeitpunkt der letzten ModifikationZeitpunkt der letzen ÄnderungBlockgröße für das Dateisystem I/O *Anzahl der zugewiesenen Blöcke
* - nur gültig auf Systemen, die st_blksize unterstützen. Andere
Systeme (z.B. Windows) geben '-1' zurück.
Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
Siehe auch clearstatcache für weitere
Einzelheiten.
realpathErzeugt einen kanonisch absoluten PfadnamenBeschreibungstring realpathstring pathrealpath expandiert alle symbolischen Links, und
beseitigt Verweise zu '/./', '/../' und extra '/' Zeichen im Input
path, und gibt den absoluten Pfadnamen
kanonisch zurück. Der Pfad im Ergebnis enthält keine Komponenten
eines symbolischen Links mehr, wie '/./' or '/../'.
realpath
$real_path = realpath("../../index.php");
symlinkErzeugt einen symbolischen LinkBeschreibungint symlinkstring targetstring linkSymlink erzeugt einen symbolischen Link von
dem gegebenen Parameter target mit dem
spezifiziertem Namen link.
Siehe auch link um absolute Links zu
erstellen, und readlink zusammmen mit
linkinfo.
Diese Funktion hat unter Windows-Systemen keinen Effekt.
tempnamErzeugt einen eindeutigen DateinamenBeschreibungstring tempnamstring dirstring prefix
Erzeugt einen eindeutigen temporären Dateinamen in dem
spezifizierten Verzeichnis. Wenn das Verzeichnis nicht existiert,
wird tempnam einen Dateinamen im temporären
Verzeichnis des Systems erstellen.
Das Verhalten von tempnam ist
systemabhängig. Unter Windows wird die TMP-Umgebungsvariable den
dir 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 tempnam behandelt, dann konsultieren
Sie bitte Ihre System-Dokumentation.
Gibt den neuen temporären Dateinamen bei Erfolg, oder eine
NULL-Zeichenkette wenn ein Fehler auftritt zurück.
Tempnam
$tmpfname = tempnam ("/tmp", "FOO");
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.
Siehe auch tmpfile.
tmpfileLegt eine temporäre Datei anBeschreibungint tmpfilevoid
Erstellt eine temporäre Datei mit einem eindeutigen
Dateinamen im Schreibmodus und gibt einen Dateizeiger
ähnlich wie es bei der Funktion fopen
erfolgt, zurück. Die Datei wird automatisch gelöscht, wenn
sie geschlossen wird (mit fclose), oder
das Skript beendet wird.
Für Details konsultieren Sie bitte die Dokumentation Ihres
Betriebssystems bzgl. der tmpfile(3) Funktion,
wie auch die stdio.h Header-Datei.
Siehe auch tempnam.
touch
Setzt das Datum der letzten Änderung einer Datei
Beschreibungint touchstring filenameint
time
Versucht das Datum der letzten Modifikation einer Datei
spezifiziert durch filename auf den Wert
spezifiziert durch time zu setzten. Wenn
die Option time nicht angegeben wurde,
benutzt die Funktion die aktuelle Zeit.
Wenn die Datei nicht existiert, wird sie erzeugt.
Gibt TRUE bei Erfolg, andernfalls FALSE zurück.
Touch
if (touch ($DateiName)) {
print "$DateiName Modifizierungs-Zeit wurde auf das aktuelle
Datum und und die aktuelle Uhrzeit gesetzt.";
} else {
print "Tut mir leid, Modifikations-Zeit von $DateiName konnte
nicht geändert werden.";
}
umask
Ändert die aktuelle umask (Zugriffsrechte)
Beschreibungint umaskint maskUmask setzt PHP's umask auf
mask & 0777 und gibt die alte umask
zurück. Wenn PHP als Servermodul benutzt wird, wird die umask
zurückgespeichert wenn die jeweilige Anfrage beendet ist.
Umask ohne Argumente gibt einfach die
aktuelle umask zurück.
Diese Funktion hat auf Windows-Systemen keinen Effekt.
unlinkLöscht eine DateiBeschreibungint unlinkstring filename
Löscht filename. Ähnlich der UNIX C
unlink() Fun