PHP 7.1.12 Released

Настройка во время выполнения

Поведение этих функций зависит от установок в php.ini.

Директивы конфигурации файловой системы и потоков
Имя По умолчанию Место изменения Список изменений
allow_url_fopen "1" PHP_INI_SYSTEM PHP_INI_ALL в PHP <= 4.3.4. Доступна с PHP 4.0.4.
allow_url_include "0" PHP_INI_SYSTEM Доступна начиная с версии PHP 5.2.0.
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_fopen boolean

Данная директива включает поддержку оберток URL (URL wrappers), которые позволяют работать с объектами URL как с обычными файлами. Обертки, доступные по умолчанию, служат для работы с удаленными файлами с использованием ftp или http протокола. Некоторые расширения, например, zlib, могут регистрировать собственные обертки.


Эта директива была представлена сразу же после выхода PHP версии 4.0.3. В этой и в последующих версиях эта функциональность может быть отключена только во время компиляции PHP с помощью ключа --disable-url-fopen-wrapper.


В версиях PHP для платформ Windows, более ранних, чем 4.3.0, поддержка работы с удаленными файлами отсутствует для следующих функций: include, include_once, require, require_once и функции imagecreatefromXXX расширения GD и функции для работы с изображениями Функции.

allow_url_include boolean

Эта опция позволяет использование оберток fopen, которые поддерживают работу с URL, в функциях include, include_once, require, require_once.


Эта опция требует включения опции allow_url_fopen.

user_agent string

Устанавливает отсылаемую PHP строку "User-Agent".

default_socket_timeout integer

Значение таймаута по умолчанию (в секундах) для потоков, использующих сокеты.

Замечание: Данная директива стала доступна с версии PHP 4.3.0

from string

Адрес email, используемый в соединениях FTP без авторизации, а также в качестве значения заголовка From в HTTP соединениях при использовании ftp и http оберток, соответственно.

auto_detect_line_endings boolean

Когда данная директива включена, PHP проверяет данные, получаемые функциями fgets() и file() с тем, чтобы определить способ завершения строк (Unix, MS-Dos или Macintosh).

Данная директива позволяет PHP взаимодействовать с системами Macintosh, однако, по умолчанию эта директива выключена, поскольку при ее использовании возникает (несущественная) потребность в дополнительных ресурсах для определения символа окончания первой строки, а также потому, что программисты, использующие в системах Unix символы возврата каретки в качестве разделителей, столкнутся с обратно-несовместимым поведением PHP.

Замечание: Эта директива стала доступна с версии PHP 4.3.0

add a note add a note

User Contributed Notes 7 notes

5 years ago
I'm surprised this isn't mentioned in docs here, but to set these values at runtime use "ini_set()". For example:

("auto_detect_line_endings", true);

// Now I can invoke fgets() on files that contain silly \r line endings.
ZweiBieren at yahoo dot com
22 days ago
ini_set() cannot be used for allow_url_fopen and allow_url_include (note that they are marked "PHP_INI_SYSTEM")
8 months ago
If you want to use auto_detect_line_endings, e.g. to recognize carriage return on a Classic Mac file, you must set it before calling fopen. You can then reset it to its original value. E.g,

$original = ini_get("auto_detect_line_endings");
ini_set("auto_detect_line_endings", true);
$handle = fopen($someFile, "r");
ini_set("auto_detect_line_endings", $original);
while (($line = fgets($handle)) !== false) {
  echo "$line\n"; // etc


Keep in mind also that Mac OS X bash does not handle carriage returns well, so if it seems like your code is not working when testing from the command line, redirect your output to a file and then try looking at that. On my system, doing it directly on the command line only showed the last line (with or without this setting turned on).

Also note that this will not do what you want if you have a file with mixed line endings (!). If you really care about that case, you have to do something else, like run the file through a translation first and then read it.
traian dot bratucu at gmail dot com
9 months ago
Please note that although you may try to set default_socket_timeout to something over 20s, you may get tricked by the Linux kernel.

The default value of tcp_syn_retries is set to 5, which will effectively timeout any TCP connection after roughly 20s, no matter what limits you set in PHP higher than this.

The value can be altered by root only, like this:

echo 6 > /proc/sys/net/ipv4/tcp_syn_retries

A value of 6, as above, will give you a timeout up to ~45s.
bimal at sanjaal dot com
1 year ago
Using CURL may be useful if file_get_contents to URLs is not working.
1 year ago
NOTE that setting 'auto_detect_line_endings' to true also affects exec() on Windows: the array &$output will technically still be filled with every line of output from the command, but instead contain all output as a single line in $output[0]!
Snow IT
6 years ago
Just a quick note: setting default_socket_timeout to zero causes file_get_contents(<url>) to immediately fail.

We were under the (false) impression that zero meant never time out.
To Top