README

为phar库添加搜索和替换支持。

要求

• PHP >= 5.3.3
• Phine 异常 >= 1.0.0
• Phine 观察者 >= 2.0
• Phine Phar >= 1.0.0

安装

通过 Composer

$ composer require "phine/phar-replace=~1.0"

使用方法

该库为lib-phar提供了一个单主题观察者。此观察者可以注册到以下主题，以执行一个或多个搜索字符串的全局搜索和替换

• Builder::ADD_FILE
• Builder::ADD_STRING

要创建一个观察者，您需要一个新的ReplaceObserver实例。

use Phine\Phar\Builder;
use Phine\Phar\Replace\ReplaceObserver;

// create the archive builder
$builder = Builder::create('example.phar');

// create the replace observer
$observer = new ReplaceObserver(
    array(
        'search' => 'replace',
        '@search@' => 'replace',
        '{{ search }}' => 'replace',
        // ...etc...
    )
);

// register it with the builder subjects
$builder->observe(Builder::ADD_FILE, $observer);
$builder->observe(Builder::ADD_STRING, $observer);

注册观察者后，添加的任何文件或字符串都将替换其所有 search、@search@、{{ search }} 字符串出现。

需要注意的是，仅支持标量值。

您还可以在创建观察者后通过调用setSearchValue()或setSearchValues()来设置搜索字符串和替换值

// add a value
$observer->setSearchValue('search string', 'replacement value');

// replace a value
$observer->setSearchValue('search string', 'a different value');

// replace all search strings and their values
$observer->setSearchValues(
    array(
        'search' => 'replace',
        '@search@' => 'replace',
        '{{ search }}' => 'replace',
        // ...etc...
    )
);

使用setSearchValues()，您将删除所有先前的搜索字符串及其替换值。仅使用提供的新搜索字符串和替换值。

文档

您可以在此处找到API文档。

许可

该库可在MIT许可下获得。