File_get_contents функциясы
file_get_contents функциясы файлдың мазмұнын оқып, оны жол түрінде қайтарады.
Бірінші параметрге файлға дейінгі жол беріледі, екіншісіне - іздеу жолын қосу туралы байрақ,
үшіншісіне - ағын контексті, төртіншісіне - оқуды бастау үшін ығысу,
бесіншісіне - деректердің ең үлкен ұзындығы.
Үшінші параметр, PHP конфигурациясында көрсетілген стандартты директориялардағы файлдарды тек абсолютті жол бойынша ғана емес, сонымен қатар іздеу қажет болғанда әсіресе пайдалы.
Синтаксис
file_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
$res = file_get_contents('data.txt');
echo $res;
?>
Кодты орындау нәтижесі:
'abcde'
Мысал
Ығысу мен ұзындықты көрсете отырып, файлдың бір бөлігін оқу:
<?php
$res = file_get_contents('data.txt', false, null, 1, 3);
echo $res;
?>
Кодты орындау нәтижесі:
'bcd'
Мысал
Веб-беттің мазмұнын оқу:
<?php
$res = file_get_contents('https://example.com');
echo substr($res, 0, 50) . '...';
?>
Кодты орындау нәтижесі:
'<!doctype html><html><head><title>Example D...'
Мысал
Include_path-тен файлды іздеу:
<?php
$res = file_get_contents('config.ini', true);
echo $res;
?>
Кодты орындау нәтижесі:
'config_data'
Ағын контексті параметрі
context параметрі файлдармен немесе желілік ресурстармен жұмыс істеген кезде функцияның мінез-құлқын өзгертуі мүмкін ағын контекстінің ресурсын беруге мүмкіндік береді.
stream_context_create функциясы арқылы жасалған ағын контекстінің ресурсы.
Егер арнайы баптаулар қажет болмаса, null беруге болады.
Контекст мүмкіндіктері:
- Сұранымдар кезінде HTTP-тақырыпшаларды орнату
- Қосылым таймауттарын баптау
- Прокси-серверін көрсету
- SSL/TLS параметрлерімен жұмыс
- Файлдық жүйеге қатынасты баптау
Жұмыс мысалы:
<?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функциясын,
ол файлды жолдар массивіне оқиды