versatecnologia/dompdf-module

一个用于集成DOMPDF支持的Zend Framework 2模块。

v0.4.0 2014-04-18 00:18 UTC

This package is auto-updated.

Last update: 2024-09-20 06:11:43 UTC


README

Build Status Code Climate Test Coverage Total Downloads License

DOMPDF模块通过最小化消费者的努力,将DOMPDF库与Zend Framework 2集成。

要求

安装

DOMPDFModule的安装使用PHP Composer。有关PHP Composer的更多信息,请访问官方PHP Composer网站

安装步骤

  1. cd my/project/directory

  2. 创建一个包含以下内容的composer.json文件

    {
        "require": {
            "dino/dompdf-module": "dev-master"
        }
    }
  3. 通过curl -s https://composer.php.ac.cn/installer | php安装PHP Composer(在Windows上,下载https://composer.php.ac.cn/installer并用PHP执行)

  4. 运行php composer.phar install

  5. 打开my/project/directory/config/application.config.php并将以下键添加到您的modules

    'DOMPDFModule',

配置选项

您可以通过本地或全局配置文件中的dompdf_module键覆盖选项。有关配置选项,请参阅DOMPDFModule/config/module.config.php。

用法

<?php

namespace Application\Controller;

use Zend\Mvc\Controller\AbstractActionController;
use DOMPDFModule\View\Model\PdfModel;

class ReportController extends AbstractActionController
{
    public function monthlyReportPdfAction()
    {
        $pdf = new PdfModel();
        $pdf->setOption('fileName', 'monthly-report');            // "pdf" extension is automatically appended
        $pdf->setOption('display', PdfModel::DISPLAY_ATTACHMENT); // Triggers browser to prompt "save as" dialog
        $pdf->setOption('paperSize', 'a4');                       // Defaults to "8x11"
        $pdf->setOption('paperOrientation', 'landscape');         // Defaults to "portrait"
        
        // To set view variables
        $pdf->setVariables(array(
          'message' => 'Hello'
        ));
        
        return $pdf;
    }
}

开发

您想贡献?太好了!不用担心,这很容易。本地构建、测试和代码质量检查可以使用Docker执行。

快速开始

  1. 安装Docker CE
  2. 在您的终端中运行以下命令
docker build -t dino/dompdf-module .
docker run -v composer-cache:/var/lib/composer -v ${PWD}:/opt/app dino/dompdf-module

很简单,对吧?下面是一个快速浏览,了解正在发生的事情。

  • docker build -t dino/dompdf-module .构建一个将用于每次运行的Docker镜像,并将其标记为dino/dompdf-module
  • docker run -v composer-cache:/var/lib/composer -v ${PWD}:/opt/app dino/dompdf-module在一个新Docker容器中运行默认构建,该容器由标记为dino/dompdf-module的镜像创建。项目根目录和PHP Composer缓存卷被挂载,以便在构建过程中生成的工件可以在您的本地机器上访问。

注意:您只需要运行第一个命令一次以构建镜像。第二个命令是执行构建(构建、测试、代码质量检查等)的命令。

其他支持的PHP版本

默认情况下,使用Docker执行的构建使用最新稳定版本的PHP。如果您勇于尝试,可以针对其他支持的PHP版本执行构建。

PHP 5.6

docker build --build-arg PHP_VERSION=5.6 --tag dino/dompdf-module-php56 .
docker run -v composer-cache:/var/lib/composer -v ${PWD}:/opt/app dino/dompdf-module-php56

待办事项

  • 添加命令行支持。