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
Список параметров
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';
?>