Config

Your configurations swiss-army knife.

The Config package provides methods for configuration manipulation. * Creates configurations from scratch * Parses and outputs different formats (XML, PHP, INI, Apache...) * Edits existing configurations * Converts configurations to other formats * Allows manipulation of sections, comments, directives... * Parses configurations into a tree structure * Provides XPath like access to directives mansion Bertrand Mansion bmansion@mamasam.com lead ryansking Ryan King ryansking@php.net lead aashley Adam Ashley aashley@php.net lead 1.10.7 2006-08-11 PHP License stable Changelog: * Fixed Bug #7544: Empty attributes in IniCommented are being discarded (Luis Correa d'Almeida) * Fixed Bug #7652: wrong xml to phparray convert. Caused by counting position of directives and sections seperately. While when converting to some containers we want to count them together. * Add tests to confirm behaviour of Bug #8357. Do not believe it is fixable without removing features. XML_Parser XML_Util 1.10.6 2006-02-14 PHP License stable Changelog: * More PHP 4.4 and 5.1 return by reference fixes * Fixed bug #4477 fatal error when key of array is longer than 114 chars under PHP4.x * Fixed bug #6385 Allow colon in directive name in IniCommented to match IniFile. * Fixed bug #6441 true and false literals should be parsed appropriately. Booleans are now parsed the same as in parse_ini_file() 1.10.5 2006-01-03 PHP License stable Changelog: * Make what we add quotes around consistent between IniFile and IniCommented. * Fixed bug #3137 Adding a comment caused problems outputing in phparray format. * Fixed bug #3590 Handling phparray formats with implicit numeric keys. * Fixed bug #4623 Rendering to Apache format a second time looses section attributes. * Fixed bug #5598 Allow '=' in values and output it correctly in IniFile format. * Fixed bugs #5033, #5835, #6294 Return only variables by reference as required by PHP 4.4 and 5.1. * Partial Fix for #6385 Allow colon in directive name in IniCommented to match IniFile. 1.10.4 2005-02-10 stable Changelog: * Fixed bug #3298 which wouldn't parse arrays with numerical indexes correctly. *Fixed bug #2742 which didn't trim variable names in Inicommented file *changed XML_Parser and XML_Util dependencies to optional, since they're only needed when parsing XML files (bug #2738) *added a new container for editing files of php constants, courtesy of philip ortel [me@phillipoertel.com] (beta) 1.10.3 2004-10-13 stable Changelog: *Fixed bug #2179 which prevented URL's containting ~ in ini files to be parsed correctly *Fixed bug #2439 which caused Config_Containter::countChildren() to return a PEAR_ERROR object when called on a non-section Config_Container object. This change brings the object's behavior inline with the documentation. Beware, if your code relies on the previous behavior, this change may break your code. 1.10.2 2004-06-14 stable * Fixed bug #1633 related to case-sensitivity of method names in PHP4. causing PHPArray container not to work correctly. See also #1556. Patch provided by m at tacker dotorg. 1.10.1 2004-06-04 stable * Fixed problems with PHP5 case sensitivity on class and method names. * Added possibility to actually replace the root container by using method Config::setRoot() with a container of type 'section' and name 'root'. * XML parser now makes use of the encoding specified in the options array. * Fixed a warning with array_splice() on an unset $children. 1.10 2003-11-29 stable * Added 'isFile' option to XML container * Fix a bug when a directive has no content in XML configurations * Fix slowdown caused by uniqid() on Linux * Fix regular expression for directives in .ini files (Emil Biserov) * Fix bug #132 concerning % in .ini files (Wagner netsols.de) * Fix possible warning if text is empty in .ini commented (Dean Urmson) * Small speed optimizations 1.9 2003-09-21 stable * Added a new boolean option/parameter in XML, PHPArray and toArray() to set whether attributes should be rendered. * Added comments rendering in XML. * Fix typo in PHPArray when setting the configuration array name (Laurent Laville) 1.8.1 2003-09-07 stable * Fix a bug in XML container related to cdata handler read by chunk, reported by Stephan Wentz 1.8 2003-08-16 stable * Fix a bug in setRoot() for the XML generator * Added new method searchPath() to Config_Container (taken from Alan Knowles for XML_Tree) * Added float detection in Config_Container_PHPArray (Sylvinus Prodi) * Uses XML_Util in xml container for special entities translation, customizable linebreaks, indents, xml declaration 1.7 2003-06-16 stable * Added new method registerConfigType() (Greg Beaver) * Root containers are not named 'root' anymore (Bertrand Mansion) * IniCommented handles comma, quotes, slashes (Greg Beaver) * IniFile and IniCommented take care of slashes (Greg Beaver) * Method _parseArray() in PHPArray refactored and much faster (Bertrand Mansion) * Fix bugs with certain type of arrays with PHPArray (Bertrand Mansion) * PHPArray now returns values between single quotes (Jean-Marc Fontaine) 1.6 2003-05-20 stable * Fix bug #23690 in toArray reported by Rob Halff 1.5 2003-04-14 stable * Added an id private property for each node * Fix a bug in toArray when items are duplicates 1.4 2003-04-02 stable * Fix setDirective method in Container * Fix warnings in foreach loop when attributes are not set * Added phpdoc comments 1.3 2003-03-26 stable * Fixed missing quote in xml generation (Nicolas Guennoc) * Fixed warning in xml container when no attributes (Nicolas Guennoc) * Added methods getAttribute and updateAttributes to container. * Added possibility to get item by looking at its attributes in getItem() * PHPArray container automatically generates array name when not specified in options * XML Container can accept a name too that will generate the global root entity if needed 1.2 2003-03-24 stable First stable release. * Added an XML container (uses XML_Parser), * Possibility to convert from one format to another, * Fixes in toArray(), * Added attributes to containers, * New methods for item manipulation. 1.1 2002-10-08 beta Fix bug in toArray(). Thanks to Mark Polsen for noticing it. 1.0 Complete rewrite : API has changed. The class now uses a tree structure of container objects. As a consequence, backward compatibility is not provided !!! Look at the Apache.php and IniCommented.php scripts in 'docs' for usage examples. Some containers are still missing : XML and DB. 0.3.1 Documentation is in README.Config. 0.3.1 - E_ALL fixes 0.3 - some fixes - add WDDX-Container for config data in WDDX-files - add phpIniFile, does the same like IniFile but based on the PHP build-in function parse_ini_file() 0.2.2 - Only the first char of ->feature['cc'] is taken as a comment deliminator - quoting supports both methods: [bla] foo = "'bar'" bar = '"foo"' - Value parser only parser until first comment-char or the end of the string, therefore spaces surrounded by nonspaces don't have to be quoted. 0.2.1 - Bug fixed, when $feature in ParseInput was not set - some e_warnings fixed (thanks to Markus Fischer for the reports)