用ExportStrategy和CalculationStrategy接口解耦导出与计算逻辑，通过依赖注入策略实例替代if-else，确保ReportContext仅持接口类型参数，模板渲染与策略职责分离，策略无状态、不查库、不涉时区转换。
报表导出格式切换总要改if-else？用ExportStrategy接口统一入口
直接替换条件分支，把if ($format === 'pdf') { ... }这类代码全删掉。核心是定义一个ExportStrategy接口，只暴露export(array $data): string方法。所有具体导出逻辑（PDF、Excel、CSV）都实现这个接口，不暴露内部细节，也不依赖任何第三方库路径——那只是具体策略类里的私有实现。
常见错误是让上下文类（比如ReportExporter）直接new某个导出类，这会破坏解耦。正确做法是把策略实例注入进去，由外部容器或工厂决定用哪个。
-
DompdfExportStrategy：生成PDF时需提前检查dompdf/dompdf是否已安装，否则export()应抛出UnsupportedFormatException -
PhpSpreadsheetExportStrategy：对大数据量报表，避免一次性加载全部行到内存，改用fromArray()分块写入 -
CsvExportStrategy：注意中文字段必须用fputcsv()并设置BOM头，否则Excel打开乱码
不同统计维度怎么动态换算法？靠CalculationStrategy而不是硬编码
报表里“按日汇总”“按周分组”“同比计算”这些逻辑，本质是数据处理策略，不是报表模板的事。单独抽成CalculationStrategy接口，方法签名定为process(array $rawData): array，返回结构始终是['headers' => [...], 'rows' => [...]]，保证下游导出层完全无感。
别在策略里做数据库查询——那是Repository层的事。策略只负责转换已有数据。如果发现某个MonthlyCalculationStrategy里写了SELECT ... GROUP BY MONTH，说明职责错位了。
立即学习“PHP免费学习笔记（深入）”；
- 时间维度策略需兼容时区：传入的
$rawData时间戳应已转为报表目标时区，策略不负责时区转换 - 空值处理策略可复用：比如
NullAsZeroStrategy和NullAsDashStrategy，都实现同一接口，切换成本为零 - 性能敏感场景下，避免在
process()里做array_map嵌套循环，优先用foreach单遍历
为什么ReportContext不能自己决定用哪个策略？
因为策略选择权必须交给调用方。比如API请求带format=excel&calculation=weekly，控制器解析后，应主动构造对应策略并传给ReportContext，而不是让ReportContext去读$_GET或配置文件。后者会导致测试困难、无法Mock、违反单一职责。
容易被忽略的一点：ReportContext的构造函数参数类型必须是接口，不是具体类。写成public function __construct(ExportStrategy $exporter, CalculationStrategy $calculator)，而不是DompdfExportStrategy——否则类型声明就锁死了实现。
- 若需运行时切换，提供
setExporter(ExportStrategy $strategy)和setCalculator(CalculationStrategy $strategy)方法，但注意它们不是必需的；多数场景一次构造、一次使用更清晰 - 不要在
ReportContext里加缓存逻辑：缓存应放在Repository或独立服务中，策略本身必须是无状态的
模板渲染和策略模式能混用吗？可以，但边界必须划清
低代码平台导出的HTML模板（如invoice_template.html）属于静态结构，而策略模式管的是动态行为。两者可以协作，但不能耦合：模板变量填充由TemplateRenderer负责，它接收ReportContext->getData()返回的标准化数组，不接触任何策略类。
典型错误是把generatePdfFromHtml()塞进某个策略里——这会让PDF生成逻辑污染导出策略的职责。正确链路是：ReportContext->export() → 调用当前ExportStrategy->export() → 该策略内部调用TemplateRenderer->render($template, $data) → 返回二进制流。
- 模板路径不应写死在策略里，应作为参数传入，方便单元测试替换mock模板
- 若模板含复杂逻辑（如条件显示某栏位），用轻量级引擎（如Twig）比字符串替换更可靠，但引擎初始化仍不属于策略责任
ExportStrategy实现，却没在DI容器里注册，结果运行时报Class not found——这不是策略模式的问题，是工程落地的断点。 
