Συνάρτηση 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`, η συνάρτηση θα αναζητήσει το αρχείο στους καταλόγους που ορίζονται στην παράμετρο include_path στις ρυθμίσεις PHP στο αρχείο `php.ini`. Από προεπιλογή `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,
που διαβάζει ένα αρχείο σε πίνακα συμβολοσειρών