Phar::mount

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

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

    Описание

    finalpublicstaticPhar::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';
    ?>
    To Top