(no version information, might be only in CVS)
php_stream_open_wrapper() opens
a stream on the file, URL or other wrapped resource specified
by path. Depending on the
value of mode, the stream
may be opened for reading, writing, appending or combinations
of those. See the table below for the different modes that
can be used; in addition to the characters listed below, you
may include the character 'b' either as the second or last
character in the mode string. The presence of the 'b'
character informs the relevant stream implementation to open
the stream in a binary safe mode.
The 'b' character is ignored on all POSIX conforming
systems which treat binary and text files in the same way. It
is a good idea to specify the 'b' character whenever your
stream is accessing data where the full 8 bits are important,
so that your code will work when compiled on a system where
the 'b' flag is important.
Any local files created by the streams API will have
their initial permissions set according to the operating
system defaults - under UNIX based systems this means that
the umask of the process will be used. Under Windows, the
file will be owned by the creating process. Any remote files
will be created according to the URL wrapper that was used to
open the file, and the credentials supplied to the remote
server.
Open text file for reading. The stream is
positioned at the beginning of the file.
Open text file for reading and writing. The stream
is positioned at the beginning of the file.
Truncate the file to zero length or create text
file for writing. The stream is positioned at the
beginning of the file.
Open text file for reading and writing. The file
is created if it does not exist, otherwise it is
truncated. The stream is positioned at the beginning of
the file.
Open for writing. The file is created if it does
not exist. The stream is positioned at the end of the
file.
Open text file for reading and writing. The file
is created if it does not exist. The stream is
positioned at the end of the file.
options affects how
the path/URL of the stream is interpreted, safe mode checks
and actions taken if there is an error during opening of the
stream. See Stream open
options for more information about options.
If opened is not NULL,
it will be set to a string containing the name of the actual
file/resource that was opened. This is important when the
options include USE_PATH,
which causes the include_path to be searched for the file.
You, the caller, are responsible for calling efree() on the filename returned in this
parameter.
注: If you specified STREAM_MUST_SEEK in options, the path returned in opened may not be the name of the actual stream that was returned to you. It will, however, be the name of the original resource from which the seekable stream was manufactured.