KnpSnappyBundle 教程：安装与使用

1. 项目目录结构及介绍

在 KnpSnappyBundle 中，目录结构如下：

.
├── bin # 存放可执行脚本
├── src # 主代码库
│   └── Knp
│       └── SnappyBundle
│           ├── Controller # 控制器
│           ├── DependencyInjection # 配置服务
│           ├── EventSubscriber # 事件订阅者
│           ├── Exception # 异常处理
│           ├── Resources # 资源文件
│           │   └── config # 配置样例
│           └── Tests # 测试代码
├── test # 单元测试
├── composer.json # 项目依赖定义
└── README.md # 项目说明

此结构中，关键部分包括：

• src/Knp/SnappyBundle: 所有 Bundle 的核心组件，包含了控制器、服务配置和其他必要的类。
• Resources/config: 提供示例配置文件，帮助设置 Bundle。
• composer.json: 用于管理项目依赖的 JSON 文件。

2. 项目的启动文件介绍

Symfony 框架中的启动文件通常是 public/index.php。在这个例子中，index.php 是应用程序的入口点，负责加载 Symfony 容器并处理请求。虽然 KnpSnappyBundle 自身没有特定的启动文件，但你需要确保 index.php 已正确配置以加载所有 Bundles 和应用环境。通常，这会在 appKernel.php 或类似文件中完成。

// app/AppKernel.php

public function registerBundles()
{
    $bundles = [
        // ...
        new Knp\Bundle\SnappyBundle\KnpSnappyBundle(),
        // 其他 Bundle
    ];

    // ...
}

3. 项目的配置文件介绍

在 KnpSnappyBundle 中，主要的配置文件位于 config.yml（或者在你的 Symfony 应用配置文件中）。以下是一个基本的配置示例：

# config/config.yml

knp_snappy:
    pdf:
        enabled: true
        binary: '/path/to/wkhtmltopdf'
        options:
            toc:
                disable: false
            margin-top: 20mm
            margin-right: 15mm
            margin-bottom: 20mm
            margin-left: 15mm
    image:
        enabled: true
        binary: '/path/to/wkhtmltoimage'
        options: ~

这个配置设置了 PDF 和图片生成器的启用状态、二进制路径（wkhtmltopdf 和 wkhtmltoimage）以及一些默认选项。你可以根据实际需求调整这些设置。

为了使配置生效，需要将它添加到你的 app/config/config.yml 并运行 php bin/console cache:clear 来更新缓存。

---

通过以上步骤，你应该了解了如何配置和使用 KnpSnappyBundle 在 Symfony 应用中生成 PDF 和图像。更多详细信息和高级用法，请参考项目 官方文档。