背景与挑战
在linux环境下，有时我们需要通过命令行自动化地修改php配置文件，例如向一个现有的php数组中追加新的配置项或子数组。一个典型的场景是，在一个名为config.php的文件中，存在一个 $config 数组，我们需要在其中添加一个新的数组元素。
例如，原始的config.php可能如下所示：
<?php $CONFIG = array ( 'installed' => true, 'instanceid' => 'sdsdfsfdsdf', 'ldapProviderFactory' => 'OCA\User_LDAP\LDAPProviderFactory', );
我们希望追加的数组内容是：
array (
'class' => '\OC\Files\ObjectStore\S3',
'arguments' =>
array (
'val1' => 'val1x',
'val2' => 'val1x',
),
),最终目标是得到一个语法正确的PHP文件：
<?php
$CONFIG = array (
'installed' => true,
'instanceid' => 'sdsdfsfdsdf',
'ldapProviderFactory' => 'OCA\User_LDAP\LDAPProviderFactory',
array (
'class' => '\OC\Files\ObjectStore\S3',
'arguments' =>
array (
'val1' => 'val1x',
'val2' => 'val1x',
),
),
);直接使用cat命令将新内容追加到文件末尾会导致语法错误，因为这会在 ); 之后添加内容，破坏了PHP数组的结构。而sed虽然功能强大，但在处理多行插入并精确匹配特定行（如数组的闭合括号）之前插入时，其脚本编写可能相对复杂。因此，我们需要一个更灵活、更精确的解决方案。
立即学习“PHP免费学习笔记（深入）”；
解决方案：使用 awk
awk是一个强大的文本处理工具，它按行处理文件，并允许我们根据模式匹配执行相应的操作。其强大的流程控制和对文件内容的逐行处理能力，使其成为解决此类问题的理想选择。
核心思路是：
- 逐行读取原始PHP文件。
- 打印所有不包含数组闭合符 ); 的行。
- 当文件处理完毕时（END块），在打印闭合符之前，将要添加的新数组内容插入。
1. 准备工作
为了演示方便，我们将原始PHP数组内容和要添加的新数组内容分别保存到两个临时文件。
orig.txt (模拟原始PHP文件中的数组部分)
$CONFIG = array ( 'installed' => true, 'instanceid' => 'sdsdfsfdsdf', 'ldapProviderFactory' => 'OCA\User_LDAP\LDAPProviderFactory', );
add.txt (要追加的新数组元素)
array (
'class' => '\OC\Files\ObjectStore\S3',
'arguments' =>
array (
'val1' => 'val1x',
'val2' => 'val1x',
),
),请注意，orig.txt中只包含了 $CONFIG = array (...) 的内容，并且省略了 <?php 标签，这是为了聚焦于数组内容的修改。在实际操作中，您需要处理完整的PHP文件。
2. awk 脚本详解
创建一个名为 merge.awk 的文件，并写入以下内容：
#!/usr/bin/awk -f
# 遍历输入文件的每一行
!/);/ {
# 如果当前行不包含 ");" 字符串，则打印该行
print
}
# 文件处理完毕后执行的END块
END {
# 使用cat命令将add.txt文件的内容输出到标准输出
system("cat add.txt")
# 最后，打印数组的闭合符 ");"
print ");"
}脚本解释：
- #!/usr/bin/awk -f：Shebang行，指定使用awk解释器执行此脚本。
- !/);/ { print }：这是awk的主处理逻辑。
- !/);/ 是一个模式，表示“不匹配包含字符串 ); 的行”。
- { print } 是一个动作，表示“打印当前行”。
- 因此，这行代码的作用是：对于输入文件中的每一行，如果它不包含 );，就将其原样打印出来。
- END { ... }：这是一个特殊的awk块，在awk处理完所有输入行之后执行。
- system("cat add.txt")：在END块中，我们使用system()函数执行一个外部shell命令。这里是cat add.txt，它会将add.txt文件的内容输出到awk的当前标准输出流中。这正是我们将新数组内容插入到原有内容和闭合符之间的关键步骤。
- print ");"：最后，打印出正确的数组闭合符 );，确保PHP语法完整。
3. 执行与验证
首先，确保merge.awk脚本具有执行权限：
chmod +x merge.awk
然后，执行awk脚本，将orig.txt作为输入：
./merge.awk orig.txt
您将在终端看到如下输出：
$CONFIG = array (
'installed' => true,
'instanceid' => 'sdsdfsfdsdf',
'ldapProviderFactory' => 'OCA\User_LDAP\LDAPProviderFactory',
array (
'class' => '\OC\Files\ObjectStore\S3',
'arguments' =>
array (
'val1' => 'val1x',
'val2' => 'val1x',
),
),
);这个输出正是我们期望的，新的数组元素被成功地插入到了 $CONFIG 数组的闭合括号之前。
实际应用与注意事项
在实际操作中，您通常不会将原始文件和追加内容分别保存。您可以直接将PHP配置文件作为awk的输入，并将add.txt替换为包含实际新内容的变量或临时文件。
直接修改原始文件：
为了将输出重定向回原始文件（或新的文件），您可以使用重定向操作符。在进行任何文件修改之前，强烈建议备份原始文件。
# 假设您的原始PHP配置文件是 config.php
# 假设您要添加的内容保存在 add_array_element.txt 中
# 1. 备份原始文件
cp config.php config.php.bak
# 2. 创建 awk 脚本（或直接在命令行使用）
# awk_script.awk
# !/);/ { print }
# END { system("cat add_array_element.txt"); print ");" }
# 3. 执行 awk 并重定向输出到临时文件
awk '!/);/ { print } END { system("cat add_array_element.txt"); print ");" }' config.php > config.php.tmp
# 4. 替换原始文件
mv config.php.tmp config.php
# 5. 清理临时文件（如果需要）
rm add_array_element.txt # 如果 add_array_element.txt 是临时创建的注意事项：
- 备份： 始终在修改重要文件之前创建备份。
- 精确匹配： awk脚本中的模式 !/);/ 假定 ); 是数组的唯一闭合标志。如果您的PHP文件中有其他地方也包含 ); 并且不希望被误处理，您可能需要更精确的正则表达式来匹配数组的闭合行（例如，匹配只包含 ); 的行，或者前面有特定缩进的行）。
- add.txt 内容： 确保 add.txt 中的内容格式正确，包含逗号,等必要的PHP语法元素，以便它能正确地作为数组的一个新元素。
- 多数组处理： 如果文件中有多个PHP数组需要修改，此awk脚本可能需要进行调整，以区分不同的数组。这可能涉及到更复杂的上下文匹配。
- PHP解析器： 修改后，最好通过PHP解析器检查文件的语法是否仍然有效，例如 php -l config.php。
总结
通过awk工具，我们可以优雅且精确地在Linux命令行中向PHP配置文件中的现有数组追加新的数组元素，避免了直接追加可能导致的语法错误。这种方法利用了awk的逐行处理和END块特性，实现了在特定行之前插入内容的需求。掌握这类命令行文本处理技巧，对于自动化配置管理和系统维护具有重要意义。
