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, ֆունկցիան կփնտրի ֆայլը այն դիրեկտորիաներում, որոնք նշված են include_path պարամետրում PHP-ի կարգավորումներում php.ini ֆայլում: Լռելյայնը 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 ֆունկցիան,
    որը ընթերցում է ֆայլը տողերի զանգվածի մեջ