include_file

Функция include_file($file, $callback = null, $required = true) подключает файл и при необходимости передаёт результат в callback.

$file — путь к файлу относительно ROOT_FULL_PATH;
$callback — необязательная функция обратного вызова;
$required — признак обязательного файла.

Пример с callback

include_file('/app/lang/ru/main.php', function (bool $status, $data) {
    if ($status) {
        echo 'Файл "/app/lang/ru/main.php" подключён';
        echo PHP_EOL;
        echo 'Содержимое файла: ' . print_r($data, true);
    } else {
        echo 'Не удалось подключить файл "/app/lang/ru/main.php"';
    }
});

В callback передаются два аргумента: флаг успешного подключения $status и любое значение $data, которое вернул подключаемый файл.

Пример без callback

$messages = include_file('/app/lang/ru/main.php');

echo 'Содержимое файла: ' . print_r($messages, true);

Необязательный файл

$messages = include_file('/app/lang/ru/optional.php', function (bool $status, $data) {
    if (!$status) {
        echo 'Необязательный файл не найден';
    }
}, false);

echo 'Содержимое файла: ' . print_r($messages, true);