PHPackages                             cubemage/paging-seal-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PDF & Document Generation](/categories/documents)
4. /
5. cubemage/paging-seal-bundle

ActiveSymfony-bundle[PDF & Document Generation](/categories/documents)

cubemage/paging-seal-bundle
===========================

A Symfony Bundle to process PDF files, such as generating counter-signature seals or stamping images.

v1.0.0(10mo ago)241MITPHPPHP >=8.1

Since Jul 7Pushed 10mo agoCompare

[ Source](https://github.com/Cube-Mage/PagingSealBundle)[ Packagist](https://packagist.org/packages/cubemage/paging-seal-bundle)[ RSS](/packages/cubemage-paging-seal-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (2)Used By (0)

CubeMage Paging Seal Bundle
===========================

[](#cubemage-paging-seal-bundle)

一个为 Symfony 项目提供 PDF 骑缝章、盖章等处理功能的组件。

本组件的核心功能是提供一个可配置、可重用的服务，能够接收 PDF 文件，并以「骑缝章」或「单页盖章」的模式，专业地将印章图片叠加到PDF文档上。

系统要求
----

[](#系统要求)

- PHP 8.1+
- Symfony 6.0+
- `gd` PHP 扩展（用于图像处理）

安装
--

[](#安装)

#### 第一步：通过 Composer 安装

[](#第一步通过-composer-安装)

在您的 Symfony 项目根目录下，执行以下命令：

```
composer require cubemage/paging-seal-bundle
```

#### 第二步：启用 Bundle

[](#第二步启用-bundle)

如果您项目中启用了 Symfony Flex，这一步会自动完成。如果没有，请手动将以下这行加入到您项目的 `config/bundles.php` 文件中：

```
// config/bundles.php
return [
    // ... 其他的 bundle
    CubeMage\PagingSealBundle\CubeMagePagingSealBundle::class => ['all' => true],
];
```

配置 (可选)
-------

[](#配置-可选)

安装后，您可以选择性地在 `config/packages/` 目录下创建一个 `cube_mage_paging_seal.yaml` 文件，来覆写组件的默认配置。

```
# config/packages/cube_mage_paging_seal.yaml
cube_mage_paging_seal:
    # 自定义您希望存放临时PDF文件的路径
    # 默认路径是: '%kernel.project_dir%/var/cubemage/paging-seal'
    pdf_path: '%kernel.project_dir%/var/cubemage/paging-seal'

    # 设置一个全局的、默认使用的公章图片的绝对路径
    # 如果不设置，则每次调用服务时都必须提供公章图片路径
    default_seal_path: '%kernel.project_dir%/assets/images/default_company_seal.png'
```

使用方法
----

[](#使用方法)

本组件的核心是一个名为 `PagingSealGenerator` 的服务。在您的应用程序中（例如 Controller 或其他 Service），您只需要通过依赖注入来获取并使用它即可。

### Controller 使用示例

[](#controller-使用示例)

以下是一个完整的控制器示例，展示了如何创建一个 API 端点，它接收用户上传的PDF和可选的公章图片，处理后强制用户下载生成的新文件。

```