Configurazione di Runtime

Il comportamento di queste funzioni è influenzato dalle impostazioni di php.ini.

Opzioni di configurazione per Filesystem e Streams
Nome Default Modificabile Storico dei cambiamenti
allow_url_fopen "1" PHP_INI_SYSTEM PHP_INI_ALL in PHP <= 4.3.4. Disponibile dal PHP 4.0.4.
allow_url_include "0" PHP_INI_ALL PHP_INI_SYSTEM in PHP 5. Disponibile dal PHP 5.2.0.
user_agent NULL PHP_INI_ALL Disponibile dal PHP 4.3.0.
default_socket_timeout "60" PHP_INI_ALL Disponibile dal PHP 4.3.0.
from "" PHP_INI_ALL  
auto_detect_line_endings "0" PHP_INI_ALL Disponibile dal PHP 4.3.0.

Breve descrizione dei parametri di configurazione.

allow_url_fopen boolean

Questa opzione abilita i wrapper URL per fopen, in modo da potere accedere ad oggetti URL come file. Per default sono forniti wrapper per accedere a file remoti usando il protocollo ftp o http, alcune estensioni, tipo zlib, possono registrarne altri.

Nota:

Questa opzione è stata aggiunta subito dopo il rilascio di PHP 4.0.3. Per le versioni fino a 4.0.3 compresa si può disabilitare questa opzione solo al momento della compilazione utilizzando il parametro di configurazione --disable-url-fopen-wrapper.

Avviso

Nelle versioni precedenti alla 4.3.0 per i sistemi Windows, le seguenti funzioni non supportano l'accesso a file remoti: include, include_once, require, require_once e le funzioni imagecreatefromXXX nel modulo GD and Image Funzioni.

allow_url_include boolean

Questa opzione permette l'uso di URL e wrapper fopen con le seguenti funzioni: include, include_once, require, require_once.

Nota:

Questo parametro richiede che allow_url_fopen sia "on".

user_agent string

Definisce l'user agent inviato da PHP.

default_socket_timeout integer

Timeout di default (in secondi) per gli stream socket.

Nota: Questa opzione di configurazione è stata inserita in PHP 4.3.0

from string

L'indirizzo email da utilizzare per le connessioni FTP non autenticate e come valore dell'intestazione From per le connessioni HTTP, quando si utilizza il wrapper ftp e http, rispettivamente.

auto_detect_line_endings boolean

Quando è attivato, il PHP esamina i dati letti da fgets() e file() per vedere se si stanno utilizzando le convenzioni di Unix, MS-Dos o Macintosh.

Questo permette al PHP di operare con sistemi Macintosh, ma, per default, l'opzione è impostata a Off, poiché vi è una piccola penalizzazione di velocità nel cercare di individuare il tipo di EOL per la prima riga; e anche perché in alcuni casi si è sperimentato che l'utilizzo del carriage-returns come separatore nei sistemi Unix ha generato comportamenti non compatibili con il passato.

Nota: Questa opzione è stata introdotta in PHP 4.3.0

add a note add a note

User Contributed Notes 6 notes

up
80
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
1
traian dot bratucu at gmail dot com
1 month 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
-1
Chris
1 month 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
-2
bimal at sanjaal dot com
1 year ago
Using CURL may be useful if file_get_contents to URLs is not working.
up
-5
Steve
11 months 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
-59
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