ფუნქცია 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 საშუალებას აძლევს გადააწოდო ნაკადის კონტექსტის რესურსი, რომელსაც შეუძლია შეცვალოს ფუნქციის ქცევა ფაილებთან მუშაობისას ან ქსელურ რესურსებთან.

კონტექსტის რესურსი, რომელიც created ფუნქციის მიერ 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,
    რომელიც კითხულობს ფაილს სტრიქონების მასივში