File_get_contents функциясы

file_get_contents функциясы файлдың мазмұнын оқып, оны жол түрінде қайтарады. Бірінші параметрге файлға дейінгі жол беріледі, екіншісіне - іздеу жолын қосу туралы байрақ, үшіншісіне - ағын контексті, төртіншісіне - оқуды бастау үшін ығысу, бесіншісіне - деректердің ең үлкен ұзындығы.

Үшінші параметр, PHP конфигурациясында көрсетілген стандартты директориялардағы файлдарды тек абсолютті жол бойынша ғана емес, сонымен қатар іздеу қажет болғанда әсіресе пайдалы.

Синтаксис

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

Параметрлер

Параметр Сипаттама
filename Файлға дейінгі жол немесе URL
use_include_path Егер true мәніне орнатылса, функция файлды PHP параметрлеріндегі php.ini файлындағы include_path параметрінде көрсетілген директориялардан іздейді. Әдепкі бойынша false.
context Ағын контекстінің ресурсы
offset Оқуды бастау үшін ығысу
maxlen Оқылатын деректердің ең үлкен ұзындығы

Мысал

Жергілікті файлдың мазмұнын оқу:

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

Кодты орындау нәтижесі:

php'abcde'

Мысал

Ығысу мен ұзындықты көрсете отырып, файлдың бір бөлігін оқу:

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

Кодты орындау нәтижесі:

php'bcd'

Мысал

Веб-беттің мазмұнын оқу:

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

Кодты орындау нәтижесі:

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

Мысал

Include_path-тен файлды іздеу:

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

Кодты орындау нәтижесі:

php'config_data'

Ағын контексті параметрі

context параметрі файлдармен немесе желілік ресурстармен жұмыс істеген кезде функцияның мінез-құлқын өзгертуі мүмкін ағын контекстінің ресурсын беруге мүмкіндік береді.

stream_context_create функциясы арқылы жасалған ағын контекстінің ресурсы. Егер арнайы баптаулар қажет болмаса, null беруге болады.

Контекст мүмкіндіктері:

Жұмыс мысалы:

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

Сондай-ақ қараңыз

  • file_put_contents функциясын,
    ол деректерді файлға жазады
  • fopen функциясын,
    ол файлды ашады
  • file функциясын,
    ол файлды жолдар массивіне оқиды