PHP-CSS-Parser 中规则位置信息的重构与优化

在 CSS 解析器的开发过程中，代码的可读性和一致性至关重要。PHP-CSS-Parser 项目近期对其规则(Rule)类中位置信息相关的方法名进行了重构，将原本简写的方法名改为更具描述性的名称，同时优化了位置信息的处理逻辑。

方法名重构

项目中将以下方法进行了重命名：

• getLineNo() → getLineNumber()
• getColNo() → getColumnNumber()

这种重构遵循了更清晰的命名约定，使代码更易于理解和维护。新方法名明确表达了其返回值的含义，避免了简写可能带来的歧义。

位置信息处理的优化

在重构过程中，开发团队发现并解决了几个与规则位置信息相关的重要问题：

1. 位置信息的完整性：确保所有规则在添加到规则集(RuleSet)时都具有明确的行号和列号。现在addRule()方法会为第一个添加的规则自动分配有效的位置信息。

2. 规则插入逻辑的改进：修复了当使用addRule()方法插入规则时，如果指定了兄弟规则(sibling)但属性名不同，位置信息不会被正确设置的问题。现在无论属性名是否相同，新规则都会被正确地插入到兄弟规则之前。

3. 位置信息的有效性：移除了位置信息为null的情况，确保所有规则都有明确的行号和列号。这简化了排序逻辑并提高了代码的可靠性。

实现细节

为了实现平滑过渡，重构采用了分阶段的方式：

1. 首先添加新方法并让旧方法调用新方法
2. 然后标记旧方法为弃用
3. 最后在整个代码库中更新对新方法的使用

对于规则位置信息的排序处理，开发团队明确了以下原则：

• 规则按行号升序排列
• 同一行内的规则按列号升序排列
• 所有规则都必须有明确的位置信息

对开发者的影响

这些改进使得PHP-CSS-Parser在处理CSS规则的位置信息时更加可靠和一致。开发者现在可以：

• 使用更具描述性的方法名获取规则位置
• 依赖更可靠的规则插入行为
• 获得更可预测的规则排序结果

这次重构不仅提升了代码质量，也为未来可能的性能优化和功能扩展打下了良好基础。通过确保所有规则都有明确的位置信息，项目为后续可能实现的更精细的源代码映射(source map)功能做好了准备。