dio_open
(PHP 4 >= 4.2.0, PHP 5 < 5.1.0)
dio_open — Öffnet eine Datei (falls nötig, wird diese erzeugt) auf einem niedrigeren Level als es die C-Bibliotheks Ein-/Ausgabe-Stream-Funktionen erlauben
Beschreibung
$filename, int $flags, int $mode = 0): resourcedio_open() öffnet eine Datei und liefert einen Dateideskriptor zurück.
Parameter-Liste
-
filename -
Der Pfadname der zu öffnenden Datei.
-
flags -
Der Parameter
flagsist ein bitweise ODER verknüpfter Wert bestehend aus Flags der folgende Liste. Dieser Wert muss entwederO_RDONLY,O_WRONLY, oderO_RDWRenthalten. Zusätzlich kann er eine beliebige Kombination der anderen Flags dieser Liste enthalten.-
O_RDONLY- öffnet die Datei zum Lesezugriff. -
O_WRONLY- öffnet die Datei zum Schreibzugriff. -
O_RDWR- öffnet die Datei zum Lesen und Schreiben. -
O_CREAT- erzeugt die Datei, falls diese nicht existiert -
O_EXCL- wird sowohlO_CREATals auchO_EXCLangegeben und die Datei existiert bereits, schlägt dio_open() fehl. -
O_TRUNC- falls die Datei bereits existiert, und sie für Schreibzugriff geöffnet wird, wird diese auf die Grösse 0 zurückgesetzt -
O_APPEND- setzt den Zeiger für Schreiboperationen an das Ende der Datei -
O_NONBLOCK- Setzt den Modus auf "nonblocking" -
O_NOCTTY- hält das Betriebssystem davon ab, die geöffnete Datei als Prozess steuerndes Terminal zuzuweisen, wenn eine TTY Gerätedatei geöffnet wird.
-
-
mode -
Wenn
flagsdas FlagO_CREATenthält, setztmodedie Dateizugriffsrechte.modewird für die korrekte Ausführung benötigt, wennO_CREATinflagsangegeben wird, und wird ansonsten ignoriert.Die tatsächlichen Dateizugriffsrechte, die der erzeugten Datei zugewiesen werden, werden von der umask Einstellung des Prozesses wie üblich beeinflusst.
Rückgabewerte
Ein Dateideskriptor oder false bei Fehlern.
Beispiele
Beispiel #1 Öffnen eines Dateideskriptors
<?php
$fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK);
dio_close($fd);
?>
