Funcția file_get_contents

Funcția file_get_contents citește conținutul unui fișier și îl returnează sub formă de șir. În primul parametru se transmite calea către fișier, în al doilea - un flag pentru activarea căii de căutare, în al treilea - contextul fluxului, în al patrulea - decalajul pentru începutul citirii, în al cincilea - lungimea maximă a datelor.

Al treilea parametru este util în special atunci când trebuie să căutați fișiere în directoarele standard, specificate în configurația PHP, și nu numai pe calea absolută.

Sintaxă

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

Parametrii

Exemplu

Citirea conținutului unui fișier local:

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

Rezultatul executării codului:

php'abcde'

Exemplu

Citirea unei părți a fișierului cu specificarea decalajului și lungimii:

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

Rezultatul executării codului:

php'bcd'

Exemplu

Citirea conținutului unei pagini web:

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

Rezultatul executării codului:

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

Exemplu

Căutarea fișierului în include_path:

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

Rezultatul executării codului:

php'config_data'

Parametrul contextului fluxului

Parametrul context permite transmiterea unei resurse de context a fluxului, care poate modifica comportamentul funcției atunci când lucrează cu fișiere sau resurse de rețea.

Resursa de context, creată de funcția stream_context_create. Dacă nu sunt necesare setări speciale, se poate transmite null.

Capabilitățile contextului:

• Setarea antetelor HTTP la cereri
• Configurarea timeout-urilor de conexiune
• Specificarea serverului proxy
• Lucrul cu parametrii SSL/TLS
• Configurarea accesului la sistemul de fișiere

Exemplu de funcționare:

php<?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);
?>

Vedeți și