function drupal_parse_info_format
Parses data in Drupal's .info format.
Data should be in an .ini-like format to specify values. White-space generally doesn't matter, except inside values:
key = value
key = "value"
key = 'value'
key = "multi-line
value"
key = 'multi-line
value'
key
=
'value'
Arrays are created using a HTTP GET alike syntax:
key[] = "numeric array"
key[index] = "associative array"
key[index][] = "nested numeric array"
key[index][index] = "nested associative array"
PHP constants are substituted in, but only when used as the entire value. Comments should start with a semi-colon at the beginning of a line.
Parameters
$data: A string to parse.
Return value
The info array.
See also
2 calls to drupal_parse_info_format()
- drupal_parse_info_file in includes/
common.inc - Parses Drupal module and theme .info files.
- InfoFileParserTestCase::testDrupalParseInfoFormat in modules/
system/ system.test - Test drupal_parse_info_format().
File
-
includes/
common.inc, line 7715
Code
function drupal_parse_info_format($data) {
$info = array();
if (preg_match_all('
@^\\s* # Start at the beginning of a line, ignoring leading whitespace
((?:
[^=;\\[\\]]| # Key names cannot contain equal signs, semi-colons or square brackets,
\\[[^\\[\\]]*\\] # unless they are balanced and not nested
)+?)
\\s*=\\s* # Key/value pairs are separated by equal signs (ignoring white-space)
(?:
("(?:[^"]|(?<=\\\\)")*")| # Double-quoted string, which may contain slash-escaped quotes/slashes
(\'(?:[^\']|(?<=\\\\)\')*\')| # Single-quoted string, which may contain slash-escaped quotes/slashes
([^\\r\\n]*?) # Non-quoted string
)\\s*$ # Stop at the next end of a line, ignoring trailing whitespace
@msx', $data, $matches, PREG_SET_ORDER)) {
foreach ($matches as $match) {
// Fetch the key and value string.
$i = 0;
foreach (array(
'key',
'value1',
'value2',
'value3',
) as $var) {
${$var} = isset($match[++$i]) ? $match[$i] : '';
}
$value = stripslashes(substr($value1, 1, -1)) . stripslashes(substr($value2, 1, -1)) . $value3;
// Parse array syntax.
$keys = preg_split('/\\]?\\[/', rtrim($key, ']'));
$last = array_pop($keys);
$parent =& $info;
// Create nested arrays.
foreach ($keys as $key) {
if ($key == '') {
$key = count($parent);
}
if (!isset($parent[$key]) || !is_array($parent[$key])) {
$parent[$key] = array();
}
$parent =& $parent[$key];
}
// Handle PHP constants.
if (preg_match('/^\\w+$/i', $value) && defined($value)) {
$value = constant($value);
}
// Insert actual value.
if ($last == '') {
$last = count($parent);
}
$parent[$last] = $value;
}
}
return $info;
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.