Интерпретирует XML-файл и преобразовывает XML-документ в объект

# simplexml_load_file

(PHP 5, PHP 7, PHP 8)

simplexml_load_file — Интерпретирует XML-файл и преобразовывает XML-документ в объект

### Описание

function simplexml_load_file(
string `$filename`,
?string `$class_name` = `SimpleXMLElement::class`,
int `$options` = 0,
string `$namespace_or_prefix` = "",
bool `$is_prefix` = `false`
): SimpleXMLElement|false

Функция преобразовывает корректный XML-документ из файла в объект.

### Список параметров

`filename`

  Путь к XML-файлу.

`class_name`

  При установке этого необязательного параметра функция simplexml_load_file() возвращает объект заданного класса. Функция выдаст ошибку, если класс возврата не расширяет класс SimpleXMLElement.

`options`
  Побитовое ИЛИ (`OR`) констант опций libxml.
`namespace_or_prefix`

  Префикс пространства имён или URI.

`is_prefix`

  При установке значения `true` функция интерпретирует значение параметра `namespace_or_prefix` как префикс, а со значением `false` — как URI; значение по умолчанию равно `false`.

### Возвращаемые значения

Функция возвращает объект (object) класса SimpleXMLElement, свойства которого содержат данные XML-документа или `false`, если возникла ошибка.

Внимание

Функция возвращает как логическое значение `false`, так и нелогическое значение, которое приводится к `false`. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.

### Ошибки

Функция сгенерирует сообщение об ошибке уровня `E_WARNING` для каждой ошибки, которую найдёт в XML-данных.

Подсказка

Функция libxml_use_internal_errors() подавляет ошибки, а функция libxml_get_errors() возвращает список ошибок для обработки.

### Примеры

Пример #1 Пример интерпретации XML-документа

    <?php

    // Файл examples/book.xml содержит XML-документ с корневым элементом
    // и по крайней мере элемент /[root]/title.

    if (file_exists('examples/book.xml')) {
        $xml = simplexml_load_file('examples/book.xml');

        print_r($xml);
    } else {
        exit('Файл examples/book.xml недоступен.');
    }

    ?>

Скрипт выведет следующее, если выполнится успешно:

    SimpleXMLElement Object
    (
      [book] => Array
      ...
    )

На этом этапе доступно обращение к заголовку и другим элементам: `$xml->title`.

### Смотрите также

- simplexml_load_string() - Интерпретирует строку в XML-формате в объект
- SimpleXMLElement::__construct() - Создаёт новый объект SimpleXMLElement
- Обработка ошибок в XML-документах
- libxml_use_internal_errors() - Отключение ошибок libxml и передача полномочий по выборке и обработке информации об ошибках пользователю
- Основы работы с модулем SimpleXML
- libxml_set_streams_context() - Устанавливает контекст потоков для следующей загрузки или записи документа средствами модуля libxml

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open