运行时配置
这些函数的行为受php.ini中的设置影响。
名字 | 默认 | 可修改范围 | 更新日志 |
---|---|---|---|
allow_url_fopen | "1" | PHP_INI_SYSTEM | 在 PHP <= 4.3.4 时是 PHP_INI_ALL。PHP 4.0.4 版以后可用。 |
user_agent | NULL | PHP_INI_ALL | PHP 4.3.0 版以后可用。 |
default_socket_timeout | "60" | PHP_INI_ALL | PHP 4.3.0 版以后可用。 |
from | "" | PHP_INI_ALL | |
auto_detect_line_endings | "0" | PHP_INI_ALL | PHP 4.3.0 版以后可用。 |
这是配置指令的简短说明。
- $allow_url_fopenboolean
本选项激活了 URL 形式的 fopen 封装协议使得可以访问 URL 对象例如文件。默认的封装协议提供用 ftp 和 http 协议来访问远程文件,一些扩展库例如 zlib 可能会注册更多的封装协议。
Note:
出于安全性考虑,此选项只能在 php.ini 中设置。
Note:
此选项是紧接着版本 4.0.3 发布后引进的。版本 4.0.3 以及之前的版本只能在编译时通过配置项
--disable-url-fopen-wrapper
来取消此特性。Warning
Windows 版在 PHP 4.3.0 之前,以下函数不支持远程文件访问:include,include_once, require,require_once 和GD 和图像处理函数中的 imagecreatefromXXX 函数。
- $allow_url_includeboolean
This option allows the use of URL-aware fopen wrappers with the following functions: include, include_once, require, require_once.
Note: This setting requires allow_url_fopen to be on.
- $user_agentstring
定义 PHP 发送的 User-Agent。
- $default_socket_timeoutinteger
基于 socket 的流的默认超时时间(秒)。
Note:本配置参数是 PHP 4.3.0 引进的。
- $fromstring
定义匿名 ftp 的密码(email 地址)。
- $auto_detect_line_endingsboolean
当设为 On 时,PHP 将检查通过 fgets()和 file()取得的数据中的行结束符号是符合 Unix,MS-DOS,还是 Macintosh 的习惯。
这使得 PHP 可以和 Macintosh 系统交互操作,但是默认值是 Off,因为在检测第一行的 EOL 习惯时会有很小的性能损失,而且在 Unix 系统下使用回车符号作为项目分隔符的人们会遭遇向下不兼容的行为。
Note:本配置参数是 PHP 4.3.0 引进的。
资源类型
文件系统使用 streams 作为资源类型。
预定义常量
下列常量由此扩展定义,且仅在此扩展编译入 PHP 或在运行时动态载入时可用。
- SEEK_SET (integer)
- SEEK_CUR (integer)
- SEEK_END (integer)
- LOCK_SH (integer)
- LOCK_EX (integer)
- LOCK_UN (integer)
- LOCK_NB (integer)
- GLOB_BRACE (integer)
- GLOB_ONLYDIR (integer)
- GLOB_MARK (integer)
- GLOB_NOSORT (integer)
- GLOB_NOCHECK (integer)
- GLOB_NOESCAPE (integer)
- GLOB_AVAILABLE_FLAGS (integer)
- PATHINFO_DIRNAME (integer)
- PATHINFO_BASENAME (integer)
- PATHINFO_EXTENSION (integer)
- PATHINFO_FILENAME (integer):自 PHP 5.2.0 起
- FILE_USE_INCLUDE_PATH (integer):在 include_path 里搜索$filename。(自 PHP 5 起)。
- FILE_NO_DEFAULT_CONTEXT (integer)
- FILE_APPEND (integer):为存在的文件添加内容。
- FILE_IGNORE_NEW_LINES (integer):过滤换行(EOL)字符(PHP 5 起)。
- FILE_SKIP_EMPTY_LINES (integer):过滤空行(自 PHP 5 起)。
- FILE_BINARY (integer):二进制模式(自 PHP 5.2.7 起)。Note:此常量无效,仅仅用于向后兼容(forward compatibility)。
- FILE_TEXT (integer):文本模式(自 PHP 5.2.7 起)。Note:此常量无效,仅仅用于向后兼容(forward compatibility)。
- INI_SCANNER_NORMAL (integer):普通的 INI 扫描模式(自 PHP 5.3 起)。
- INI_SCANNER_RAW (integer):原始(Raw) INI 扫描模式(自 PHP 5.3 起)。
- INI_SCANNER_TYPED (integer):Typed INI 扫描模式(自 PHP 5.5.6.1 起)。
- FNM_NOESCAPE (integer):禁用反斜线转义
- FNM_PATHNAME (integer):字符串里的斜杠只匹配指定模式里的斜杠。
- FNM_PERIOD (integer):字符串里的起始点号必须完全匹配指定模式里的点号。
- FNM_CASEFOLD (integer):大小写不敏感的匹配,GNU 扩展的一部分。