PhantomJS 配置指南

注：本文内容只适用于 2020-04-26 之前版本的 JAR 包， 因为 2020-04-26 及之后版本的 JAR 包，已经用 canvas 替代 phantomjs 了。详情参见文档：图表导出升级说明

1.1 Windows、macOS、Linux 用户

FineReport 图表内置了 phantomjs 环境，Windows、macOS、Linux 用户安装设计器或部署了工程后，就内置了 phantomjs 环境，无需另行安装。

注：如果不想使用内置的环境，也可以按照下面 2.自定义安装 的方法另行配置 phantomjs 环境。

1.2 Unix 用户

Unix 系统用户需要自行配置 phantomjs 环境，方法如下：

1）登入系统后，执行命令：sudo pkg install phantomjs，如果当前用户为管理员，执行命令： pkg install phantomjs

2）命令行执行命令：phantomjs --version，显示版本信息即安装成功。

3）用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 文件。

4）找到 PhantomConf.exe 节点配置，修改节点的值为default，如下图所示：

如果用户不想用内置的 phantomjs 环境，可以按照下面的方法自行安装 phantomjs 。

2.1 Windows 用户

2.1.1 方法一

1）从 官网 下载对应版本的压缩包，解压到某个目录下，例如解压后的 phantomjs.exe 在D:\phantomjs\bin路径下，如下图所示：

2）用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 文件。

3）找到 PhantomConf.exe 节点，修改节点的值为 phantomjs 可执行程序的路径，比如这里就是：D:\phantomjs\bin\phantomjs.exe

2.1.2 方法二

1）在 官网 下载对应版本的压缩包解压，例如解压后的 phantomjs.exe 在D:\phantomjs\bin路径下。

2）配置 phantomjs 环境变量

右键我的电脑，点击属性>高级系统设置>高级>环境变量，在系统变量里找到 Path，将 phantomjs 添加到环境变量里。如下图所示：

示例添加的环境变量为：;D:\phantomjs\bin

3）控制台执行 phantomjs --version 命令，出现版本信息即安装成功。

4）用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 配置文件。

5）找到 PhantomConf.exe 节点配置，修改节点的值为default，如下图所示：

2.2 Linux 用户

2.2.1 Ubuntu 系统

1）登入系统，执行命令：sudo apt-get install phantomjs，如果当前用户为管理员用户时，执行命令：apt-get install phantomjs

2）确保能在命令行执行命令：phantomjs --version

3）用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 配置文件。

4）找到 PhantomConf.exe 节点配置，修改节点的值为default

2.2.2 CentOS 系统

1）下载安装包并解压

下载 phantomjs 的 Linux 安装包到/phantomjs文件夹下

tar -xjvf phantomjs-2.1.1-linux-x86_64.tar.bz2解压文件

2）安装依赖环境，过程选项都直接 y

yum install fontconfig freetype2

3）配置环境变量

已配置 JDK 环境变量前提下，export PATH 这条后面加上：

:/phantomjs/phantomjs-2.1.1-linux-x86_64/bin

变成

export PATH=$JAVA_HOME/bin:$PATH:/phantomjs/phantomjs-2.1.1-linux-x86_64/bin

没有的话就如下：

export PATH=$PATH:/phantomjs/phantomjs-2.1.1-linux-x86_64/bin

source /etc/profile使改动生效

4）查看结果

输入 phantomjs --version，显示版本号，说明 phantomjs 安装成功。

5）修改 db.script 文件

用编辑器打开%FR_HOME%\webapps\webroot\WEB-INF\embed\finedb\目录下的 db.script 配置文件。

找到 PhantomConf.exe 节点配置，修改节点的值为default

3.1 报表无法调用

1）问题描述

在 Linux 环境下，当手动启动 pahtomjs 成功，报表调用不到。

2）原因分析

未指定启动路径。

3）解决方案

需要指定启动路径：

打开 finedb 中的 fine_conf_entity 表把 phantomconf.exe 的值( 一般默认为inner server )改为具体工程路径：/usr/local/finereport/tomcat/webapps/webroot/WEB-INF/assist/phantomjs/phantomjs-linux64/bin/phantomjs，然后 kill 掉 tomcat 进程，重启服务器即可。