Download the PHP package noflash/waffer without Composer
On this page you can find all versions of the php package noflash/waffer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download noflash/waffer
More information about noflash/waffer
Files in noflash/waffer
Package waffer
Short Description It holds every bit of your configuration ...and a maple syrup!
License MIT
Homepage https://github.com/kiler129/waffer
Informations about the package waffer
PROJECT ARCHIVED
Code is left for historical reasons. If you want something good and modern use Symfony Config.
Waffer
A tiny, fast and (if you want) powerful configuration library. It was wrote in intetion of usage with long running PHP daemons. It supports JSON & serializations configuration files out-of-box.
FAQ
Why Waffer?
When I started working on this code I need some sort of a name. Since it was intended to have smaller version along with bigger one (extending it) I came up with "diet" term stolen right from Panic Inc. and it's DietCoda app ;)
Still eating waffers with maple syrup I laughed and created DietWaffer class. This name sticks.
There's no XML!
Yup, you're right. I fully agree with Linus who's said:
XML is the worst format ever designed
I never had enough patience to deal with DOM trees, even with SimpleXML library onboard.
If you wish XML to be supported I kindly welcome pull-request for that feature.
Wait, where's INI?
INI format have a lot of limitations, and it's full of hacks. To be honest Waffer had INI support while ago, bud it was removed due to naming limitations.
For further informations see Notes section in PHP documentation for parse_ini_string().
Usage
Every library using Waffer is intended to have it it's default configuration. It's much like jQuery plugins - you can provide some extra options which overwrite default configuration. Single instance of Waffer is intended to be injected into multiple objects, deep into application.
Initialization
You can choose one of two classes - Waffer and DietWaffer. Second one contains only core configuration black-box, without any export/import capabilities.
Initial configuration array can be specified as constructor parameter.
(Re)storing data
Waffer was built to be simple, powerful and flexible tool. It supports many different ways of getting and storing configuration data. Let code below exaplains all of them:
Importing & exporting
Library supports JSON & (un)serialize oob. It also handles loading & saving settings from/to files.
Let's a piece of code explain everything.
Libraries integration
Waffer intrnally stores configuration as large array. By design every library using Waffer should register it's settings under own namespace key as shown below.