typesetsh/pdf-bundle
最新稳定版本：18.0.0
Composer 安装命令：
composer require typesetsh/pdf-bundle
包简介
This bundle provides a wrapper for using the typeset.sh pdf engine.
README 文档
README
This bundle is simple wrapper for the typeset.sh pdf engine.
Typeset.sh is a css/html layout engine that allows to render as PDF.
Installation
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
composer require typesetsh/pdf-bundle Enable the Bundle
Then, enable the bundle by adding it to the list of registered bundles in config/bundles.php file of your project:
return [ // [...] Typesetsh\PdfBundle\TypesetshPdfBundle::class => ['all' => true], ];
Usage
Render a view as pdf. You can use the abstract controller to render a twig view as pdf.
<?php namespace App\Controller; use Symfony\Component\HttpFoundation\HeaderUtils; use Typesetsh\PdfBundle; class TestController extends PdfBundle\Controller\AbstractController { public function printOrder() { $order = new \stdClass(); return $this->pdf( 'pdf/invoice.html.twig', ['order' => $order], 'test.pdf', HeaderUtils::DISPOSITION_INLINE ); } }
Alternative you can also use dependency injection to retrieve the pdf generation and do with it as you wish.
<?php use Typesetsh\PdfBundle\PdfGenerator; class PrintService { /** @var PdfGenerator */ private $pdfGenerator; public function __construct(PdfGenerator $pdfGenerator) { $this->pdfGenerator = $pdfGenerator; } public function execute() { $html = '...'; $result = $this->pdfGenerator->render($html); $result->toFile('./somefile.pdf'); $result->asString(); } }
Configuration
# /config/packages/typesetsh_pdf.yaml typesetsh_pdf: # List of allowed directories to load external resources (css, images, fonts,...) allowed_directories: - '%kernel.project_dir%/public' # Default base dir - Used when view URIs use relative path / base_dir: '%kernel.project_dir%/public' http: # Allow to download external resources via http(s) allow: false # Cache dir fir files downloaded via http(s) cache_dir: '%kernel.cache_dir%/typesetsh' # Maximum file size in bytes to download via http(s) download_limit: 1048576 # Timeout in seconds when downloading files timeout: 5
Security
Make sure to only whitelist the directories that do not contain any sensitive information to prevent leaking any data. If your templates are escaped correctly this should never be an issue, yet it's always good to ignore any resource that is not whitelisted in allowed_directories.
By default only the /public directory is allowed. If you like to add any other directory you must whitelist it first.
HTML template example
Many CSS features are supported. See typeset.sh for more details and demos.
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>test</title> <style> @page { size: A4; margin: 10mm 20mm; } @font-face { font-family: "my font"; src: url("/fonts/my-font.otf"); font-weight: 400; } @font-face { font-family: "my font"; src: url("/fonts/my-font.otf"); font-weight: 800; } html { font-family: "my font", serif; font-size: 12pt; } </style> </head> <body> <h1>Your lucky number is {{ number }}</h1> <p>Some text....</p> </body> </html>
License
This bundle is under the MIT license.
However, it requires a version of typeset.sh to work.
统计信息
- 总下载量： 22.29k
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 11
- 点击次数： 0
- 依赖项目数： 1
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2026-01-04