yii框架需手动引入echarts js文件才能渲染图表，hisune/echarts-php仅生成配置；须注册echartsasset加载echarts.min.js，注意编码、空值处理及数据类型转换。

Yii 框架本身不内置图表能力，报表统计必须靠前端图表库（如 ECharts）配合后端数据组装来实现。直接在控制器里查数据库、转数组、传给视图，再用 hisune/echarts-php 渲染配置，是最轻量也最可控的方式——但要注意它只生成 JS 配置代码，不加载 ECharts 运行时。

怎么让 ECharts 在 Yii 页面里真正跑起来

很多人卡在这步：页面上看不到图，控制台报 echarts is not defined。这是因为 hisune/echarts-php 只负责拼 Option JSON，不负责引入 echarts.js 文件。

• 必须手动注册 AssetBundle 加载 ECharts JS：比如创建 EchartsAsset，$sourcePath 指向 @bower/echarts/dist，$js = ['echarts.min.js']
• 确保该 Bundle 被 view 正确调用，例如在视图顶部加 EchartsAsset::register($this)
• 不要依赖 echarts.main.js：ECharts 5+ 已移除此文件，用 echarts.min.js 或按需引入 echarts.esm.js（需构建支持）
• 若用 YII2 + Bower 管理，确认 composer.json 中有 "bower-asset/echarts": "^5.4.0"，然后运行 composer update

用 hisune/echarts-php 生成配置时的典型坑

这个 PHP 包本质是把数组结构映射成 ECharts Option 对象，写法看着像链式调用，但底层是动态属性赋值，容易因大小写、嵌套层级或空值崩掉。

ECharts Master

ECharts 图表大师。根据用户数据和业务上下文，自动设计并生成专业的 ECharts 可视化图表。使用场景：(1) 用户提供表格/JSON/CSV 数据需要可视化，(2) 用户说"帮我做个图"、"画个图表"，(3) 需要将查询结果可视化展示。

下载

• $chart->xAxis[] = [...] 是合法的，但 $chart->xAxis->type = 'category' 会报错——因为 xAxis 是数组，不是对象
• 中文字段名（如 name、data）必须确保 UTF-8 编码，否则渲染后乱码或空白
• 时间类数据传入 series->data 时，别直接传 PHP DateTime 对象，要先 format('Y-m-d') 或转时间戳
• 如果图表需要响应式，别只靠 CSS 宽高；得在 JS 初始化后监听 resize 并调用 chart.resize() —— hisune/echarts-php 不处理这部分

数据从 Yii Model 到 ECharts 的安全转换

直接 Fee::find()->asArray()->all() 拿数据很常见，但要注意字段是否可被前端直接消费。

• 避免在 series->data 中传 null 值：ECharts 渲染会中断，建议用 array_map(fn($v) => $v ?? 0, $arr) 做兜底
• 类别轴（xAxis->data）如果是 ID 或编码，别忘了加 ArrayHelper::getColumn($fees, 'name') 提取可读标签
• 金额类数值建议统一用 floatval() 处理，防止字符串 "123.45" 被当成文本导致坐标轴错乱
• 若数据量大（>1000 条），别一股脑全传给前端；应在控制器里做聚合（如 sum、groupBy），或改用 AJAX 分页加载

最关键的其实是分清职责：Yii 负责把干净、结构明确的数据准备好，hisune/echarts-php 负责翻译成 Option，而真正的渲染、交互、重绘，全由前端 ECharts 实例承担——漏掉任意一环，图就出不来。