Phar::mount

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

Phar::mount — Monta um caminho externo ou arquivo em um local virtual dentro do arquivo phar

Descrição

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

Assim como o conceito do sistema de arquivos Unix de montar dispositivos externos em caminhos dentro da árvore de diretórios, Phar::mount() permite referenciar arquivos e diretórios externos como se estivessem dentro de um arquivo. Isso permite uma abstração poderosa como, por exemplo, referenciar arquivos de configuração externos como se estivessem dentro do arquivo.

Parâmetros

pharPath: O caminho interno dentro do arquivo phar a ser usado como local do caminho montado. Este deve ser um caminho relativo dentro do arquivo phar e não deve existir ainda.
externalPath: Um caminho ou URL para um arquivo ou diretório externo para montar dentro do arquivo phar

Valor Retornado

Sem retorno. PharException é lançada em caso de falha.

Erros/Exceções

Lança PharException se ocorrer algum problema ao montar o caminho.

Exemplos

Exemplo #1 Um exemplo de Phar::mount()

O exemplo a seguir mostra o acesso a um arquivo de configuração externo como se fosse um caminho dentro de um arquivo phar.

Primeiro, o código dentro de um arquivo phar:

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

A seguir, o código externo usado para montar o arquivo de configuração:

<?php
// primeiro configura a associação entre o config.xml abstrato
// e o real no disco
Phar::mount('phar://config.xml', '/etc/exemplo/config.xml');
// agora executa a aplicação
include '/caminho/para/arquivo.phar';
?>

Outro método é colocar o código de montagem dentro do stub do arquivo phar. Aqui está um exemplo de configuração de um arquivo de configuração padrão caso nenhuma configuração de usuário seja especificada:

<?php
// primeiro configura a associação entre o config.xml abstrato
// e o real no disco
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__ . '/config_padrao.xml');
    Phar::mount('extra.xml', 'phar://' . __FILE__ . '/extra_padrao.xml');
}
// agora executa a aplicação
include 'phar://' . __FILE__ . '/index.php';
__HALT_COMPILER();
?>

...e o código externo para carregar este arquivo phar:

<?php
define('EXTERNAL_CONFIG', '/etc/exemplo/config.xml');
// agora executa a aplicação
include '/caminho/para/arquivo.phar';
?>

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicionar nota

Notas de Usuários 1 note

down

espendiller at gmx dot de ¶

15 years ago

i tested phar to generate a one file drupal installation.
as every cms, drupal put all uploaded files in a seperate folder (i.e. /sites).

i think the mount options here expected a file, i didnt get it to work on mounting a folder. is there any possibility to do that?

to generate a phar out of drupal7 with sqlite database

build.php
$phar = new Phar('drupal7.phar');
$phar->buildFromDirectory(dirname(__FILE__) . '/drupal-7.0-alpha5');
$phar->setStub("<?php
Phar::interceptFileFuncs();
Phar::mount('sites/default/settings.php', __DIR__ . '/sites/default/settings.php');
Phar::mount('database.db', __DIR__ . '/database.db');
Phar::webPhar();
__HALT_COMPILER(); ?>"
);

to call the phar iam using a .htacces file:
RewriteCond %{REQUEST_URI} !^/drupal.phar/
RewriteCond %{REQUEST_URI} !build.php
RewriteRule ^(.*)$ /drupal.phar/$1

＋adicionar nota