Монтирование внешнего путь или файла к виртуальному пути в phar-архиве

# Phar::mount

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

Phar::mount — Монтирование внешнего путь или файла к виртуальному пути в phar-архиве

### Описание

final public static function Phar::mount(string `$pharPath`, string `$externalPath`): void

Очень похоже на концепцию файловой системы unix по монтированию внешнего устройства в существующее дерево директорий. Phar::mount() позволяет ссылаться на внешние файлы и директории, как будто они находятся внутри архива. Это позволяет повысить уровень абстракции обращаясь ко внешним конфигурационным файлам так, как будто они являются частью архива.

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

`pharPath`

  Внутренний путь в архиве, по которому необходимо примонтировать внешний путь. Это должен быть несуществующий относительный путь внутри архива.

`externalPath`

  Путь или URL внешнего файла или директории

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

Ничего не возвращает. В случае возникновения ошибки выбрасывает исключение PharException.

### Ошибки

Выбрасывает исключение PharException при возникновении ошибок.

### Примеры

Пример #1 Пример использования Phar::mount()

В следующем примере демонстрируется доступ к внешнему конфигурационному файлу, как будто он находится внутри архива.

Для начала код, содержащийся в архиве:

    <?php
    $configuration = simplexml_load_string(file_get_contents(
        Phar::running(false) . '/config.xml'));
    ?>

Далее внешний код, монтирующий файл в архив:

    <?php
    // для начала настроим ассоциацию между абстрактным config.xml
    // и конкретным файлом на диске
    Phar::mount('phar://config.xml', '/home/example/config.xml');
    // а теперь запускаем приложение
    include '/path/to/archive.phar';
    ?>

Другой метод - поместить монтирующий код в заглушку (stub) Phar-архива. Пример использования конфигурационного файла по умолчанию, если пользовательский файл конфигурации не задан:

    <?php
    // для начала настроим связь между абстрактным config.xml
    // и конкретным файлом на диске
    if (defined('EXTERNAL_CONFIG')) {
        Phar::mount('config.xml', EXTERNAL_CONFIG);
        if (file_exists(__DIR__ . '/extra_config.xml')) {
            Phar::mount('extra.xml', __DIR__ . '/extra_config.xml');
        }
    } else {
        Phar::mount('config.xml', 'phar://' . __FILE__ . '/default_config.xml');
        Phar::mount('extra.xml', 'phar://' . __FILE__ . '/default_extra.xml');
    }
    // а теперь запускаем приложение
    include 'phar://' . __FILE__ . '/index.php';
    __HALT_COMPILER();
    ?>

... и код для загрузки этого phar-архива:

    <?php
    define('EXTERNAL_CONFIG', '/home/example/config.xml');
    // а теперь запускаем приложение
    include '/path/to/archive.phar';
    ?>

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