Funzione file_get_contents

La funzione file_get_contents legge il contenuto di un file e lo restituisce come stringa. Nel primo parametro viene passato il percorso del file, nel secondo - un flag per l'utilizzo del percorso di inclusione, nel terzo - il contesto dello stream, nel quarto - l'offset per l'inizio della lettura, nel quinto - la lunghezza massima dei dati.

Il terzo parametro è particolarmente utile quando è necessario cercare file nelle directory standard, specificate nella configurazione di PHP, e non solo per percorso assoluto.

Sintassi

file_get_contents(
	string $filename,
	bool $use_include_path = false,
	?resource $context = null,
	int $offset = 0,
	?int $maxlen = null
): string|false

Parametri

Parametro	Descrizione
`filename`	Percorso del file o URL
`use_include_path`	Se impostato a `true`, la funzione cercherà il file nelle directory specificate nel parametro include_path nelle impostazioni di PHP nel file `php.ini`. Per default `false`.
`context`	Risorsa del contesto dello stream
`offset`	Offset per l'inizio della lettura
`maxlen`	Lunghezza massima dei dati da leggere

Esempio

Lettura del contenuto di un file locale:

<?php
	$res = file_get_contents('data.txt');
	echo $res;
?>

Risultato dell'esecuzione del codice:

'abcde'

Esempio

Lettura di una parte del file con specifica dell'offset e della lunghezza:

<?php
	$res = file_get_contents('data.txt', false, null, 1, 3);
	echo $res;
?>

Risultato dell'esecuzione del codice:

'bcd'

Esempio

Lettura del contenuto di una pagina web:

<?php
	$res = file_get_contents('https://example.com');
	echo substr($res, 0, 50) . '...';
?>

Risultato dell'esecuzione del codice:

'<!doctype html><html><head><title>Example D...'

Esempio

Ricerca del file in include_path:

<?php
	$res = file_get_contents('config.ini', true);
	echo $res;
?>

Risultato dell'esecuzione del codice:

'config_data'

Parametro del contesto dello stream

Il parametro context permette di passare una risorsa del contesto dello stream, che può modificare il comportamento della funzione quando lavora con file o risorse di rete.

Risorsa del contesto, creata dalla funzione stream_context_create. Se non sono richieste impostazioni particolari, si può passare null.

Capacità del contesto:

Impostazione di header HTTP per le richieste
Configurazione dei timeout di connessione
Specifica del server proxy
Lavoro con parametri SSL/TLS
Configurazione dell'accesso al file system

Esempio di utilizzo:

<?php
	$opts = [
		'http' => [
			'method' => "GET",
			'header' => "Accept-language: en\r\n"
		]
	];
	$context = stream_context_create($opts);
	$res = file_get_contents('https://example.com', false, $context);
?>

Vedi anche

la funzione file_put_contents,
che scrive dati in un file
la funzione fopen,
che apre un file
la funzione file,
che legge un file in un array di stringhe