surangapg/phing-property-bundle

Helper to make it easier to load entire config directories into phing properties.

Phing property bundle

Contains a tasks to load in a full complement of all the files in a directory. This allows phing to load in a set of files without being overly verbose or tedious to maintain. For example, pointing at a /properties folder with 8 yml files will automatically load in all 8 files into properties (prefixed with their filename)., _(*1)

Use cases

Assume you have a project with a lot of properties and various stages, environements etc. But still want to automate this build process. You could put everything in a very large build.properties file. But using this task you can make it into a dir based structure., _(*2)

E.g the file system looks like this:, _(*3)

properties/ dist/ project.yml behat.yml githook.yml env/ githook.yml stage/ db.yml, _(*4)

Using the tasks

Before any of the tasks are available you'll need to load them in via the build.xml., _(*5)

    <includepath classpath="${project.basedir}/vendor/surangapg/phing-property-bundle/src" />
    <taskdef classname="PropertyDirWriteTask" name="property-dir-write" />
    <taskdef classname="PropertyDirLoadTask" name="property-dir" />

Writing all the properties

This will write a full set of consolidated properties to the /properties dir., _(*6)

    <taskdef classname="PropertyDirLoadTask" name="property-dir-load" />
    <property-dir-load originDir="${project.basedir}/properties"
                   subLevels="dist,env,stage"
                   outputDir="${project.basedir}/properties"
                   order="project,dir,bin,behat"
                   override="true"
                   outputFull="true"
    />

Writing reading in a properties dir

Reads all the consolidated data from the new dir., _(*7)

    <property-dir propertyDir="${project.basedir}/properties"/>