dio_open
(PHP 4 >= 4.2.0, PHP 5 <= 5.0.5)
dio_open — Ouvre un nouveau fichier avec les permissions spécifiées
Description
$filename
, int $flags
[, int $mode
= 0
] )Ouvre un accès à un fichier et retourne une ressource de fichier.
Liste de paramètres
-
filename
-
Le chemin vers le fichier à ouvrir.
-
flags
-
Le paramètre
flags
est une valeur comprenant des drapeaux depuis la liste suivante. Cette valeur doit inclure une constante parmiO_RDONLY
,O_WRONLY
, ouO_RDWR
. À cette constante, vous pouvez y ajouter n'importe quel drapeaux depuis cette liste.-
O_RDONLY
: ouvre le fichier en lecture seule. -
O_WRONLY
: ouvre le fichier en écriture. -
O_RDWR
: ouvre le fichier en lecture et écriture. -
O_CREAT
: crée le fichier, s'il n'existe pas. -
O_EXCL
: siO_CREAT
etO_EXCL
sont utilisés et que le fichier existe, dio_open() échouera. -
O_TRUNC
: si le fichier existe et qu'il est ouvert en écriture, le fichier sera réduit à la taille nulle. -
O_APPEND
: les écritures se font à partir de la fin du fichier. -
O_NONBLOCK
: active le mode non-bloquant. -
O_NOCTTY
: évite que le système d'exploitation n'assigne au fichier ouvert un processus contrôlant le terminal lorsque ce fichier est un fichier TTY.
-
-
mode
-
Si
flags
contientO_CREAT
,mode
définira les permissions du fichier (permissions de création).Mode
est requis pour une opération correcte lorsqueO_CREAT
est spécifié dans lemode
et est ignoré sinon.Les permissions assignées au fichier créé seront affectées par la configuration du processus umask.
Valeurs de retour
Une ressource de fichier ou FALSE
en cas d'erreur.
Exemples
Exemple #1 Ouverture d'un fichier
<?php $fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK); dio_close($fd); ?>