admin管理员组文章数量:1648915
前言
上星期给毕设网站添加了markdown编辑器,然后周末突然想到如果给编辑器添加一个导出pdf的功能应该挺不错的(话说简书为啥不能导出pdf呢),所以就从网上找了一个生成pdf的PHP插件,叫做 tcpdf,东西很大,连带着实例文件接近16m,花了一天时间去弄这个。
其实这个根据这个插件的实例很快就能弄出pdf来,不过剩下的时间我都在研究怎么能让生成的pdf更好看,很明显我失败了。普通文本还好,如果有这样的代码,要么是显示不出来了,而显示出来的部分也是乱七八糟的。如下:
code显示不正确
code无法显示
虽然对我来说没什么价值,但毕竟研究了一番,写个小日志记录一下吧。
文件引入
从 tcpdf.php,从开始的代码可以看出,以下文件必须被包含:
tcpdf_autoconfig.php
include文件夹
在搜索所有文件中的require_once,有如下文件:
tcpdf_barcodes_1d.php
tcpdf_barcodes_2d.php
ok,将tcpdf.php和上述文件复制到项目文件夹,
require_once('./tcpdf.php');
$pdf = new TCPDF();
执行,然后就出错了:
Warning: opendir(C:\Practice\Apache24\htdocs\demo\PDF/fonts/,C:\Practice\Apache24\htdocs\demo\PDF/fonts/): in C:\Practice\Apache24\htdocs\demo\PDF\tcpdf.php on line 4148
Warning: opendir(C:\Practice\Apache24\htdocs\demo\PDF/fonts/): failed to open dir: No such file or directory in C:\Practice\Apache24\htdocs\demo\PDF\tcpdf.php on line 4148
TCPDF ERROR: Could not include font definition file: helvetica
显然还要将下载包中的fonts文件夹复制到项目中。
执行
经过上面的引入和调试,现在能正常实例化了,在上面代码中我实例化tcpdf方法未传递任何参数,但实际上该方法有7个参数可传递,如下:
属性
说明
默认值
$orientation
设置pdf页面的方向
Portrait
$unit
设置pdf单元的测量单位
mm
$format
页面的版式
A4
$unicode
是否使用unicode
true
$encoding
字符编码
utf-8
$diskcache
该功能被废弃
false
$pdfa
启用/关闭pdf/a
true
具体说明如下:
$orientation
用来设置pdf页面的方向,有两个参数:
参数名
含义
默认
P/Portrait
纵向
true
L/Landscape
横向
false
$unit
用来设置pdf单元的测量单位,有四个参数
参数名
含义
默认
pt: point
点数
false
mm: millimeter
毫米
true
cm: centimeter
厘米
false
in: inch
英寸
false
$format
表示页面的版式,如 A4等。而他默认的也是 A4。 tcpdf支持很多版式,可以到tcpdf_static.php中的$page_formats属性中查看。
$unicode
布尔类型,true代表是输入文本是$unicode。这个没什么说的,一般都是unicode,默认为true就行。
$encoding
字符编码,默认是utf-8。
$diskcache
这个参数官网没多做解释,程序文件也是,不过在其中写了DEPRECATED FEATURE,显然该功能被废弃了,不建议使用,直接设置为false即可。
$pdfa
PDF/A是PDF 的 ISO 标准,它是为长期保存文件而设计的,屏蔽了一些编辑功能。即设置`$pdfa = true**的话,生成的pdf是不能够编辑的。
好了,弄清楚了这7个参数,可以实例化了,当然如果你只是简单的使用一下可以直接进行实例化,因为这7个参数都有默认值,而一般这些默认值不用修改。
配置
tcpdf的配置选项很多,大致分成4个部分,包括文档的信息设置,页眉页脚设置,文本间距设置,正文设置。其中分成若干小部分。在完成功能之前,简单介绍一下,这几部分必要的方法。
如下:
1 文档的信息设置
包括 SetCreator(文档创建者名称),SetAuthor(设置作者),SetTitle(设置文档标题),SetKeywords(文档关键词)。这几个方法的参数没什么可说的,string类型,主要就是用来设置文档的属性的,如下面的东西一样:
文档属性
2 页眉页脚设置
包括SetHeaderData,setFooterData,setHeaderFont,setFooterFont
SetHeaderData方法有6个参数,包括:
属性
说明
默认值
$ln
logo文件路径
''
$lw
logo宽度
0
$ht
页眉标题
''
$hs
页眉的说明文字
''
$tc
文本的rgb颜色
array(0,0,0) (黑色)
$lc
页眉下划线的颜色
array(0,0,0) (黑色)
而setFooterData只有两个参数,页脚文本颜色和下划线的颜色。
而setHeaderFont,setFooterFont分别是设置页眉和页脚的字体,参数只有一个,且注意是数组类型,且传递的数组格式如下:
array(family, style, size)
对应的是font-family,font-style,font-size。
另外,如果不希望使用页眉页脚,可以使用setPrintHeader和setPrintFooter方法关闭页眉页脚,只要传递参数false即可。
3 文本间距设置
间距包含正文间距和页眉页脚的间距,有三个方法SetMargins,SetHeaderMargin,SetFooterMargin。
SetMargins是用于正文的,有三个参数,分别表示左侧、上侧、右侧的间距。SetHeaderMargin和SetFooterMargin分别是页眉与页脚的间距。
4.设置正文
正文设置包括 分页,图片比例,正文字体等。
首先利用 SetAutoPageBreak开启分页。该方法传递两个参数,参数1用户启动或禁用自动分页,而参数2只有参数1等于true时才起作用,它定义了页面距底部的距离。
再利用AddPage方法新添分页。同时,该方法如果前面已有页面,该方法会在将页脚添加到页面中 并自动添加下一页,否则直接添加新一页。
字体的设置包括,setFontSubsetting、SetFont、SetDefaultMonospacedFont。
setFontSubsetting这个方法我没弄懂,因为不了解什么叫字体构造子集,跳过。SetFont就是用来设置正文字体,参数传递和setHeaderFont类似,但该方法将三个选项分成了三个参数传递,而不是传递数组。另外,如果是生成中文pdf需要尤其注意,必须设置字体为stsongstdlight,否则会出现中文乱码。
当然还有正文写入了,如果只是普通文档,一般使用Write方法,共有12个参数,所以我就不一一介绍了,说一下必填的两个参数,也就是前两个参数,$h表示行高,$txt表示要打印的内容。其他可以默认。
如果打印html文档且包含了css文件,就需要使用writeHTML方法,该方法有6个参数,但必填的只有一个就是需要打印的内容,其他的参数可以是默认值。
好了,配置、参数介绍完毕,按照我介绍的步骤一步步的来,就能生成pdf了,下面是我自己写的生成代码:
class pdf {
# 常量设置
const PDF_LOGO = '\Logo\logo_big.png'; // LOGO路径 该路径是tcpdf下
const PDF_LOGO_WIDTH = '20'; // LOGO宽度
const PDF_TITLE = 'www.liuweime.me'; //
const PDF_HEAD = '上电脑课';
const PDF_FONT = 'stsongstdlight';
const PDF_FONT_STYLE = '';
const PDF_FONT_SIZE = 10;
const PDF_FONT_MONOSPACED = 'courier';
const PDF_IMAGE_SCALE='1.25';
# tcpdf对象存储
protected $pdf = null;
/**
* 构造函数 引入插件并实例化
*/
public function __construct() {
# 实例化该插件
$this->pdf = new TCPDF();
}
/**
* 设置文档信息
* @param $user string 文档作者
* @param $title string 文档标题
* @param $subject string 文档主题
* @param $keywords string 文档关键字
* @return null
*/
protected function setDocumentInfo($user = '', $title = '', $subject ='', $keywords = '') {
if(empty($user) || empty($title)) return false;
# 文档创建者名称
$this->pdf->SetCreator(APP_NAME);
# 作者
$this->pdf->SetAuthor($user);
# 文档标题
$this->pdf->SetTitle($title);
# 文档主题
if(!empty($subject)) $this->pdf->SetSubject($subject);
# 文档关键字
if(!empty($keywords)) $this->pdf->SetKeywords($keywords);
}
/**
* 设置文档的页眉页脚信息
* @param null
* @return null
*/
protected function setHeaderFooter() {
# 设置页眉信息
# 格式 logo地址 logo宽度 页眉标题 页眉说明文字 页眉字体颜色 页眉下划线颜色
$this->pdf->SetHeaderData(self::PDF_LOGO , self::PDF_LOGO_WIDTH , self::PDF_TITLE , self::PDF_HEAD , array(35 , 35 , 35) , array(221,221,221));
# 设置页脚信息
# 格式 页脚字体颜色 页脚下划线颜色
$this->pdf->setFooterData(array(35 , 35 , 35) , array(221,221,221));
# 设置页眉页脚字体
$this->pdf->setHeaderFont(array('stsongstdlight' , self::PDF_FONT_STYLE , self::PDF_FONT_SIZE));
$this->pdf->setFooterFont(array('helvetica' , self::PDF_FONT_STYLE , self::PDF_FONT_SIZE));
}
/**
* 关闭页眉页脚
* @param null
* @return null
*/
protected function closeHeaderFooter() {
# 关闭页头
$this->pdf->setPrintHeader(false);
# 关闭页脚
$this->pdf->setPrintFooter(false);
}
/**
* 设置间距 包括正文间距 页眉页脚间距
* @param null
* @return null
*/
protected function setMargin() {
# 设置默认的等宽字体
$this->pdf->SetDefaultMonospacedFont('courier');
# 正文左侧 上侧 右侧间距
$this->pdf->SetMargins(15, 7, 15);
# 页眉间距
$this->pdf->SetHeaderMargin(5);
# 页脚间距
$this->pdf->SetFooterMargin(10);
}
/**
* 正文设置 包括 分页 图片比例 正文字体
* @param null
* @return null
*/
protected function setMainBody() {
# 开启分页 true开启 false关闭 开启分页时参数2起作用 表示正文距底部的间距
$this->pdf->SetAutoPageBreak(true , 25);
# 设置图片比例
$this->pdf->setImageScale(self::PDF_IMAGE_SCALE);
#
$this->pdf->setFontSubsetting(true);
# 设置正文字体 stsongstdlight是Adobe Reader默认字体
> $this->pdf->SetFont('stsongstdlight', '', 14);
# 添加页面 该方法如果前面已有页面 会在将页脚添加到页面中 并自动添加下一页 否则添加新一页
$this->pdf->AddPage();
}
/**
* 生成pdf
* @param $info array
* array(
* 'user'=>'文档作者' ,
* 'title'=>'文档标题' ,
* 'subject'=>'文档主题' ,
* 'keywords'=>'文档关键字' ,
* 'content'=>'文档正文内容' ,
* 'HT'=>'是否开启页眉页脚' ,
* 'path'=>'文档保存路径');
* @return null
*/
public function createPDF($info = array()) {
if(empty($info) || !is_array($info)) return false;
$this->setDocumentInfo($info['user'] , $info['title'] , $info['subject'] , $info['keywords']);
if(!$info['HT']) {
$this->closeHeaderFooter();
} else {
$this->setHeaderFooter();
}
$this->setMargin();
$this->setMainBody();
# 写入内容
$this->pdf->writeHTML($info['content'], true, false, true, false, '');
# 输出 I输出到浏览器 F输出到指定路径
$this->pdf->Output($info['path'] , 'F');
}
}
结语
虽然,没达到我预想的效果,但还是有收获的,而且我是第一次看到两万多行代码在一个文件中的PHP文件,有点66的,本来准备看看源码,学习学习的,看到代码后有点发虚,哈哈。
END
版权声明:本文标题:php 生成pdf插件下载,PDF生成插件--TcPDF 内容由热心网友自发贡献,该文观点仅代表作者本人, 转载请联系作者并注明出处:https://m.elefans.com/xitong/1729505457a1203573.html, 本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容,一经查实,本站将立刻删除。
发表评论