PHP 7.2.0 Beta 1 Released

Configuración en tiempo de ejecución

El comportamiento de estas funciones se ve afectado por la configuración de php.ini.

Opciones de configuración del sistema de ficheros y flujos
Nombre Por defecto Cambiable Historial de cambios
allow_url_fopen "1" PHP_INI_SYSTEM PHP_INI_ALL en PHP <= 4.3.4. Disponible desde PHP 4.0.4.
allow_url_include "0" PHP_INI_SYSTEM Disponible a partir de PHP 5.2.0.
user_agent NULL PHP_INI_ALL Disponible a partir de PHP 4.3.0.
default_socket_timeout "60" PHP_INI_ALL Disponible a partir de PHP 4.3.0.
from "" PHP_INI_ALL  
auto_detect_line_endings "0" PHP_INI_ALL Disponible a partir de PHP 4.3.0.

He aquí una breve explicación de las directivas de configuración.

allow_url_fopen boolean

Esta opción habilita las envolturas fopen de tipo URL que permiten el acceso a objetos URL como ficheros. Las envolturas predeterminadas están proporcionads para el acceso de ficheros remotos usando los protocolos ftp o http, algunas extensiones como zlib pueden registrar envolturas adicionales.

Nota:

Esta opción fue introducida inmediatamente después que la distribución de la versión 4.0.3. Para versiones hasta 4.0.3 inclusive, sólo se puede deshabilitar esta característica en tiempo de compilación usando el conmutador de configuración --disable-url-fopen-wrapper.

Advertencia

En versiones de Windows anteriores a PHP 4.3.0, las siguientes funciones no soportan el acceso a ficheros remotos: include, include_once, require, require_once y las funciones imagecreatefromXXX de la extensión Funciones de GD e Imágenes.

allow_url_include boolean

Esta opción permite es uso de envolturas fopen de tipo URL con las siguientes funciones: include, include_once, require, require_once.

Nota:

Esta opción requiere allow_url_fopen para ser activada.

user_agent string

Define el agente de usuario de PHP para el envío.

default_socket_timeout integer

Tiempo de espera predeterminado (en segundos) para sockets basados en flujos.

Nota: Esta opción de configuración fue introducida en PHP 4.3.0

from string

La dirección de email a usar en conexiones FTP no autenticadas y como valor de la cabecera From de conexiones HTTP, al usar las envolturas ftp y http, respectivamente.

auto_detect_line_endings boolean

Cuando se activa, PHP examinará la información leída por fgets() y file() para ver si se está usando las convenciones de final de línea de Unix, MS-Dos o Macintosh.

Esto permite a PHP inter-operar con los sistemas Macintosh, pero por defecto está en Off, ya que hay una pérdida muy pequeña de rendimiento cuando se detectan las convenciones de EOL para la primera línea, y también porque la gente que usa retornos de carro como elementos serparadores bajo sistemas Unix podrían experimentar un comportamiento que no es compatible con versiones anteriores.

Nota: Esta opción de configuración fue introducida en PHP 4.3.0

add a note add a note

User Contributed Notes 6 notes

up
86
Pistachio
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:

<?php
ini_set
("auto_detect_line_endings", true);

// Now I can invoke fgets() on files that contain silly \r line endings.
?>
up
0
traian dot bratucu at gmail dot com
5 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.
up
-2
Chris
4 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
}

(Reference: https://bugs.php.net/bug.php?id=63341&edit=2)

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.
up
-4
bimal at sanjaal dot com
1 year ago
Using CURL may be useful if file_get_contents to URLs is not working.
up
-7
Steve
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]!
up
-57
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