Home » Configuration » Config

Your configuration's swiss-army knife.

This package is unmaintained.

Download latest release 1.10.12 (archived versions might be outdated)

License: PHP License

Description

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

Documentation

Manual

Maintainers

• Bertrand Mansion (mansion) — lead, inactive
• Ryan King (ryansking) — lead, inactive
• Adam Ashley (aashley) — lead, active
• Adam Harvey (aharvey) — lead, active

Dependencies

Required

• PHP (>= 4.3.0)
• PEAR Installer (>= 1.4.0b1)

Optional

• XML_Parser
• XML_Util

Releases

• 1.10.12 (stable, 2010-12-24)
  Release notes

  License: PHP License

  I believe we'll call this the "all hail Christian Weiske" release, since he's
  been a very busy bee.

  Bugs fixed:

  * Fixed Bug #11435: Fix IniCommented parsing of ~ ! | & ( ). (aashley)
  * Fixed Bug #11807: Config can create invalid php for unknown values.
  (cweiske)
  * Fixed Bug #11827: notice when using arrays (directive[]=value) in inifiles.
  (cweiske)
  * Fixed Bug #12291: PEAR GenericConf newline shouldn't need a space. (cweiske)
  * Fixed Bug #12387: GenericConf doesn't allow for hyphens on left-hand-side of
  a directive. (cweiske)
  * Fixed Bug #12388: GenericConf doesn't allow whitepace to left of directive
  delimiter. (cweiske)
  * Fixed Bug #13116: Syntax Strict notice for references on constructors.
  (fjfnaranjo)
  * Fixed Bug #15964: errors in test suite. (cweiske)
  * Fixed Bug #16590: parseConfig phparray ignores named arrays that use numbers
  as name. (cweiske)
  * Fixed Bug #18124: Saving arrays back to ini file fails. (cweiske)

  Feature requests implemented:

  * Request #13791: Options for the PHPConstants container. (cweiske)
  * Request #16656: New 'linebreak' option for IniCommented container. (cweiske)
  * Request #16724: PHPConstants container should have option lowercase.
  (cweiske)

• 1.10.11 (stable, 2007-06-12)
  Release notes

  License: PHP License

  * Fixed Bug #11184: Knock on problems from fix for Bug #10185. Thanks to
  Thomas Despoix and Carsten Wiedmann for helping me understand it properly.

• 1.10.10 (stable, 2007-03-26)
  Release notes

  License: PHP License

  * Fix Bug #10010: numeric index lost when parsing subarrays
  * Fix Bug #10185: problem with addslashs in container "PHPArray" / method "toString"

• 1.10.9 (stable, 2006-12-21)
  Release notes

  License: PHP License

  * Fixed Bug #9632: PHPConstants container not registered. Thanks to
  Clemens Lang <neverpanic at gmail dot com>

• 1.10.8 (stable, 2006-11-09)
  Release notes

  License: PHP License

  * Fixed Bug #7097: writeConfig incorrect when root has attributes

• 1.10.8RC1 (beta, 2006-10-19)
  Release notes

  License: PHP License

  * Fixed Bug #7097: writeConfig incorrect when root has attributes
  This fix has the potential to break other things as it is a big change to the
  PHPArray backend. Please test.

• 1.10.7 (stable, 2006-08-10)
  Release notes

  License: PHP License

  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.

• 1.10.6 (stable, 2006-02-13)
  Release notes

  License: PHP License

  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 (stable, 2006-01-03)
  Release notes

  License: PHP License

  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 (stable, 2005-02-12)
  Release notes

  License: PHP License

  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 (stable, 2004-10-20)
  Release notes

  License: PHP License

  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 (stable, 2004-06-15)
  Release notes

  License: PHP License

  * 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 (stable, 2004-06-04)
  Release notes

  License: PHP License

  * 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 (stable, 2003-11-29)
  Release notes

  License: PHP License

  * 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 (stable, 2003-09-21)
  Release notes

  License: PHP License

  * 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 (stable, 2003-09-07)
  Release notes

  License: PHP License

  * Fix a bug in XML container related to cdata handler read by chunk, reported by Stephan Wentz

• 1.8 (stable, 2003-08-16)
  Release notes

  License: PHP License

  * 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 (stable, 2003-06-16)
  Release notes

  License: PHP License

  * 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 (stable, 2003-05-20)
  Release notes

  License: PHP License

  * Fix bug #23690 in toArray reported by Rob Halff

• 1.5 (stable, 2003-04-14)
  Release notes

  License: PHP License

  * Added an id private property for each node
  * Fix a bug in toArray when items are duplicates

• 1.4 (stable, 2003-04-02)
  Release notes

  License: PHP License

  * Fix setDirective method in Container
  * Fix warnings in foreach loop when attributes are not set
  * Added phpdoc comments

• 1.3 (stable, 2003-03-26)
  Release notes

  License: PHP License

  * 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 (stable, 2003-03-24)
  Release notes

  License: PHP License

  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 (beta, 2002-10-08)
  Release notes

  License: PHP License

  Fix bug in toArray().
  Thanks to Mark Polsen for noticing it.

• 1.0 (beta, 2002-10-06)
  Release notes

  License: PHP License

  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 (stable, 2002-07-02)
  Release notes

  License: PHP License

  Documentation is in README.Config.
  0.3.1
  - E_ALL fixes

Bugs