Phar::mount
(PHP 5 >= 5.3.0, PHP 7, PECL phar >= 2.0.0)
Phar::mount — Монтирование внешнего путь или файла к виртуальному пути в phar-архиве
Описание
$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';
?>