<think>我们是在
宝塔面板的
Linux服务器上为Think
PHP5.0项目安装mPDF。
步骤：
1
. 确保服务器环境满足要求：
PHP版本（
TP5.0要求
PHP>=
5.4，但mPDF有版本要求，建议
PHP5.6以上，最好7
.x）
2
. 通过Composer安装mPDF（推荐方式）
3
. 或者手动下载mPDF并整合到项目中（不推荐，但有时服务器环境可能限制Composer）
由于用户使用
宝塔面板，我们可以通过终端或
宝塔的文件管理器操作。
方法一：使用Composer安装（推荐）
步骤：
a
. 登录服务器，进入Think
PHP5.0项目的根目录（即包含composer
.json的目录）。
b
. 执行composer命令安装mPDF。
但是注意：
TP5.0的依赖管理也是通过Composer，所以我们需要确保项目目录下有composer
.json，并且可以正常使用Composer。
具体命令：
```
composer require mpdf/mpdf
```
如果服务器没有安装Composer，可以通过
宝塔面板安装：
- 打开
宝塔面板，选择“软件商店”
- 搜索“Composer”，找到对应版本安装（注意选择项目所用的
PHP版本）
然后在项目根目录执行上述命令。
方法二：手动安装（如果Composer不可用）
步骤：
a
. 下载mPDF：从官方仓库（ht
tps://github
.com/mpdf/mpdf）下载最新的版本（注意选择兼容
PHP5的版本，例如7
.x版本要求
PHP7，所以如果
PHP5可以选择6
.x版本，但具体要查版本要求）
实际上，mPDF v6
.x支持
PHP5.4以上，v7
.x需要
PHP7
.0以上，v8
.x需要
PHP7
.2以上。因此，根据项目
PHP版本选择。
b
. 解压下载的文件，将其
中的src目录复制到项目的vendor目录下，并重命名为mpdf（或者放在extend目录下，然后通过命名空间引入）。
c
. 在
TP5项目中，我们需要在控制器或公共函数中引入mPDF。
但是，手动安装需要自己处理自动加载，我们可以使用Think
PHP5的加载机制。
例如，将mPDF放在`extend`目录下，然后在需要的地方：
```
php
use \Mpdf\Mpdf; // 如果放在extend/mpdf/Mpdf
.php，那么命名空间应该是namespace mpdf; 然后类名为Mpdf。因此可能需要调整目录结构。
更规范的做法：
在extend目录下创建mpdf目录，然后将src目录下的内容（即mPDF的类文件）放入extend/mpdf中。
然后，在代码中：
use mpdf\Mpdf;
```
但是，注意原mPDF的src目录下文件是以`Mpdf`命名空间开头的，所以我们放在extend/mpdf目录下，实际上是符合PSR-4的（只要我们把mpdf目录看作Mpdf命名空间）。但是Think
PHP5的extend目录默认是根命名空间，所以我们需要调整。
另一种方式是，将mPDF的整个src目录放到`extend`目录下，并重命名为`mpdf`，然后在代码中使用：
```
php
include_once \think\facade\Env::get('root_path')
.'extend/mpdf/Mpdf
.php';
$mpdf = new \Mpdf\Mpdf();
```
但是这样会破坏自动加载，所以更好的方式是使用Composer。
因此，强烈建议使用
方法一。
安装完成后，在代码中使用：
```
php
public function generatePdf()
{
// 如果通过Composer安装，则可以直接使用
$mpdf = new \Mpdf\Mpdf();
$mpdf->WriteHTML('<h1>Hello World</h1>');
$mpdf->Ou
tput('filename
.pdf', 'I'); // 直接输出到浏览器
// 或者保存文件
// $mpdf->Ou
tput('path/to/save/filename
.pdf', 'F');
}
```
注意事项：
- 生成PDF时，中文乱码问题：mPDF默认不支持中文字体，需要添加中文字体并配置。
- 解决中文乱码：可以下载一个中文字体（如simsun
.ttf）放到项目目录，然后在初始化mPDF时配置：
```
php
$mpdf = new \Mpdf\Mpdf([
'mode' => 'zh-CN',
'default_font' => 'simsun'
]);
```
同时，需要将字体文件放到mPDF的字体目录（如果使用Composer安装，字体目录在vendor/mpdf/mpdf/ttfonts下）。但是不建议直接修改vendor，我们可以使用mPDF的字体添加
方法：
```
php
$mpdf = new \Mpdf\Mpdf(['mode' => 'zh-CN', 'default_font' => 'simsun']);
$mpdf->autoScriptToLang = true;
$mpdf->autoLangToFont = true;
```
或者，使用addFont
方法添加字体（具体参考mPDF文档）。
- 如果使用手动安装，字体配置同理。
由于安装过程可能遇到环境问题，比如需要安装gd库、mbstring等扩展，
宝塔面板可以很方便地安装
PHP扩展。
在
宝塔面板中，检查
PHP扩展是否安装：
- 打开
宝塔面板，选择“软件商店”，找到使用的
PHP版本，点击设置，在“安装扩展”中安装：gd、mbstring、zlib等。
另外，mPDF还需要
php-xml扩展，同样需要安装。
总结步骤：
1
. 确保
PHP版本符合要求（>=
5.6，推荐7
.x）
2
. 确保安装了必要的扩展：gd, mbstring, zlib, xml
3
. 通过Composer安装mPDF：进入项目根目录，执行 `composer require mpdf/mpdf`
4
. 在代码中实例化mPDF并配置中文字体（如果需要）
相关问题：
1
. 如何解决mPDF生成PDF的中文乱码问题？
2
. 在
宝塔面板中如何安装Composer？
3
. 如何在Think
PHP5中引入第三方类库？
4
. 使用mPDF时，如何添加自定义字体？
5. 如何配置mPDF的默认设置（如页边距、页面方向等）？
下面，我们生成相关问题：
</think>### 在
宝塔面板的
Linux服务器上为Think
PHP5.0安装mPDF的完整教程
#### 步骤一：登录服务器
1
. 通过SSH工具（如Xshell/FinalShell）或
宝塔面板的**终端**功能登录服务器
2
. 进入
TP5项目根目录：
```bash
cd /www/wwwroot/your_project_name
```
（将`your_project_name`替换为实际项目目录名）
#### 步骤二：通过Composer安装mPDF（推荐）
1
. 安装Composer（如未安装）：
```bash
curl -sS ht
tps://getcomposer
.org/installer |
php
mv composer
.phar /usr/local/bin/composer
```
2
. 安装mPDF：
```bash
composer require mpdf/mpdf:^7
.0 # 兼容
PHP5.6+的版本
```
 [^1]
#### 步骤三：配置中文支持（解决乱码问题）
1
. 添加中文字体到项目：
```bash
# 创建字体目录
mkdir -p vendor/mpdf/mpdf/ttfonts
# 复制
系统字体（以宋体为例）
cp /usr/share/fonts/chinese/simsun
.ttc vendor/mpdf/mpdf/ttfonts/
```
2
. 修改配置文件 `config/mpdf
.php` (新建)：
```
php
<?
php
return [
'mode' => 'zh-CN',
'default_font' => 'simsun',
'fontDir' => [
vendor_path('mpdf/mpdf/ttfonts') // 字体目录
],
'fontdata' => [
'simsun' => [
'R' => 'simsun
.ttc', // 常规字体
'I' => 'simsun
.ttc', // 斜体
]
]
];
```
#### 步骤四：在控制器中使用mPDF
```
php
// application/
index/controller/Export
.php
use think\Controller;
class Export extends Controller
{
public function pdf()
{
// 引入配置
$config = config('mpdf');
// 实例化mPDF
$mpdf = new \Mpdf\Mpdf($config);
// 生成PDF内容
$html = '<h1>Think
PHP5测试文档</h1><p>中文显示测试</p>';
$mpdf->WriteHTML($html);
// 输出PDF（I=浏览器预览，D=下载）
$mpdf->Ou
tput('document
.pdf', 'I');
}
}
```
#### 步骤五：验证安装
1
. 访问控制器
方法：`ht
tp://yourdomain
.com/
index/export/pdf`
2
. 预期结果：浏览器显示包含中文的PDF文档
### 常见问题解决
1
. **Composer安装失败**：
- 检查
PHP版本：`
php -v`（需≥
5.6）
-
宝塔面板安装
PHP扩展：
PHP管理→安装`fileinfo`、`gd`、`mbstring`扩展
- 内存限制：修改`
php.ini`中`memory_limit ≥
512M`
2
. **中文显示方框**：
```
php
// 在实例化时添加强制配置
$mpdf = new \Mpdf\Mpdf([
'autoScriptToLang' => true,
'autoLangToFont' => true,
]);
```
3
. **文件权限问题**：
```bash
chown -R www:www /www/wwwroot/your_project
chmod -R 7
55 vendor/mpdf
```
### 性能优化建议
1
. 使用OPcache加速：
宝塔面板→
PHP设置→安装OPcache
2
. 对大文档分页处理：
```
php
$mpdf->SetHeader('|第{PAGENO}页|');
$mpdf->SetFooter('生成日期：{DATE Y-m-d}');
```
---
### 相关问题
1
. 如何解决mPDF生成PDF时内存不足的问题？
2
. 在
TP5中如何将HTML模板渲染为PDF文件？
3
. mPDF支持哪些中文字体？如何添加自定义字体？
4
. 如何通过
宝塔面板定时生成PDF并发送邮件？
5. mPDF与TCPDF、Dompdf等库有何性能差异？
[^1]:
宝塔面板官方文档 - Composer管理器使用指南
本文详细介绍如何在Nginx中使用URL重写功能，通过简单的代码示例，教会大家如何将所有请求重定向到index.php，实现动态页面的友好URL展示。
扫一扫
3985
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
