loskoderos/faktura-php

使用PHP生成漂亮的PDF发票

dev-master 2022-12-21 08:08 UTC

This package is not auto-updated.

Last update: 2024-09-25 16:40:28 UTC


README

使用PHP生成漂亮的PDF发票

这是什么?

在波兰语中,Faktura意为发票,这个库是为了在PHP中渲染漂亮的发票而创建的。

Faktura是一个简单的独立PHP库,用于在PHP中渲染PDF发票。您可以使用标准工具如composer轻松将其集成到自己的项目中。目前,Faktura依赖于xvfbwkhtmltopdf来创建PDF文件。Faktura具有基于原生PHP模板的内置渲染功能,可以使用插件函数进行自定义。

示例PDF发票:https://github.com/loskoderos/faktura-php/blob/master/examples/simple_invoice_pl.pdf sample

基本用法

Faktura易于使用,它允许您将发票结构映射并按需进行自定义。

use LosKoderos\Faktura\Faktura;

$faktura = new Faktura();

$invoice = $faktura->newInvoice();
$invoice->setInvoiceReference('INV/123/2018');

//...

$invoice->newItem()
    ->setDescription('Some item on the invoice')
    ->setUnitNetPrice(123)
    ;

//...

$faktura->setTemplate('path_to_your_invoice_template.phtml');
$faktura->export($invoice, 'invoice.pdf');

查看examples文件夹以查看完整示例:https://github.com/loskoderos/faktura-php/blob/master/examples/simple_invoice_pl.php

功能

  • 独立库,无需外部PHP框架。
  • 易于与其他系统集成。
  • 使用原生PHP模板的内置模板。
  • 内置对UTF-8和图像的支持。
  • 使用自定义插件函数扩展模板渲染。
  • 发票结构可以自定义,您可以根据需要添加自定义字段。
  • 发票可以序列化以保存到数据库进行会计目的。
  • 您可以使用覆盖轻松自定义库。

安装

Faktura仍在开发中,但是如果您想尝试它,可以使用Composer轻松安装。

composer config minimum-stability dev
composer require loskoderos/faktura-php:dev-master

在您使用它之前,您需要处理一些系统依赖项。您需要安装Xvfb和Wkhtmltopdf,在Ubuntu上运行

sudo apt-get install xvfb wkhtmltopdf

确认一切正常,请运行示例

php examples/simple_invoice_pl.php

它应该在没有错误的情况下完成并生成examples/simple_invoice_pl.pdf

贡献

欢迎贡献,请提交拉取请求。

许可证

MIT