library feature-php

ekuiter/feature-php

Feature-oriented programming with PHP and FeatureIDE

feature-php

feature-php is a Composer package for analyzing and implementing feature-oriented software product lines., _(*1)

It can be used to:, _(*2)

• analyze and validate FeatureIDE feature models and configurations (domain analysis)
• implement and trace features using the following variability mechanisms (domain implementation):
  • runtime variability for PHP code
  • build-system-like copying of files and directories
  • preprocessor-like template and chunk systems
  • feature-oriented programming (mixin-based)
  • aspect-oriented programming (using Go! AOP)
• generate products and export them (e.g. as a ZIP file) (product derivation)

(If you'd like some visual tools for feature models and configurations, have a look at ekuiter/feature-configurator or ekuiter/feature-model-viz.), _(*3)

Requirements

To use feature-php, the following is required:, _(*4)

• PHP >= 5.3
• the libxml and SimpleXML extensions (most servers have these)

Also recommended are:, _(*5)

• the DOM extension (for validating XML data)
• the ZIP extension (for exporting products as ZIP files)

feature-php also depends on some Composer packages:, _(*6)

• ekuiter/feature-schema for validating feature models and configurations
• nikic/PHP-Parser for feature- and aspect-oriented programming

To install the dependencies, create the following composer.json file:, _(*7)

{
    "minimum-stability": "dev",
    "require": {
        "ekuiter/feature-php": "dev-master"
    }
}

Then run composer install (more information on Composer). Refer to the guide for further information., _(*8)

Usage

Check out the User Guide for installation and usage., _(*9)

For a quick start, you can also, _(*10)

• look at the example below
• try ekuiter/feature-web
• run the command-line interface with vendor/bin/feature-php

API Reference

The API reference for feature-php can be found here., _(*11)

A good starting point is the ProductLine class. If you want to learn about configuration files, have a look at the ProductLine\Settings class., _(*12)

Example

Command line interface

After installing, run:, _(*13)

vendor/bin/feature-php --settings <productLine.json> --configuration <configuration.xml>

in your project root to analyze a given configuration. For more information on the command-line interface, run vendor/bin/feature-php or refer to the guide. To see example input files, see uvr2web.json and UVR1611.xml., _(*14)

Script usage

 "model.xml",
        "defaultConfiguration" => array(
            "data" => ""
        )
    )));

    // the configuration is user-supplied with the GET or POST parameter "configuration"
    // we could also use XmlConfiguration::fromString(...) or XmlConfiguration::fromFile(...)
    if (isset($_REQUEST["configuration"]))
        $configuration = new fphp\Model\Configuration(
            $productLine->getModel(),
            fphp\Model\XmlConfiguration::fromRequest("configuration")
        );
    else // if not supplied, use the default configuration
        $configuration = $productLine->getDefaultConfiguration();
    // used for replacements by the templating system
    fphp\Specification\ReplacementRule::setConfiguration($configuration);

    if (!isset($_REQUEST["generate"])) {
        // output some information on the model and configuration
        echo '
Generate
';
        echo $configuration->renderAnalysis();
        
    } else {
        // we want to generate or export a product
        $product = $productLine->getProduct($configuration);
        
        if (!isset($_REQUEST["export"])) {
            // output some information on the product
            echo '
Download ZIP
';
            echo $product->renderAnalysis();
            
        } else
            // export product as ZIP file (using "tmp" as a temporary directory)
            $product->export(new fphp\Exporter\DownloadZipExporter("tmp"));
    }
    
} catch (Exception $e) {
    echo $e->getMessage();
}

?>

License

This project is released under the LGPL v3 license., _(*15)