loskoderos / faktura-php
使用PHP生成漂亮的PDF发票
dev-master
2022-12-21 08:08 UTC
Requires
- php: >=7.4
- loskoderos/generic-php: dev-master
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依赖于xvfb和wkhtmltopdf来创建PDF文件。Faktura具有基于原生PHP模板的内置渲染功能,可以使用插件函数进行自定义。
示例PDF发票:https://github.com/loskoderos/faktura-php/blob/master/examples/simple_invoice_pl.pdf
基本用法
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