README

这是pdf-invoicr的简化分支pdf-invoicr。

变更

PHP 7.X 支持
PSR-4 兼容
作为composer包提供
依赖项通过composer提供

介绍

PHP Invoice是一个简单的面向对象的PHP类，只需几行代码即可生成美观的发票、报价或订单。使用您自己的标志和主题颜色进行品牌化，添加无限数量的项目并自动分页。您可以将PDF输出发送到用户的浏览器、保存在服务器上或强制下载文件。PHP Invoice完全可定制，可以集成到任何知名CMS中。

多语言与货币

PHP Invoice内置了印度尼西亚语（新添加）、英语、荷兰语、法语、德语、西班牙语和意大利语（如果需要，您可以轻松添加自己的语言）的翻译，并且您可以设置每份文档所需的货币。

额外的标题、段落和徽章

可以在文档底部添加额外的内容（标题和多行段落）。您可能用于付款或运输信息或任何其他需要的内容。

安装

composer require aldisa/pdf-invoice

示例

此存储库的examples/文件夹中包含3个示例

simple.php
example1.php
example2.php
change_timezone.php

创建新的发票

在使用类之前，请确保已设置默认的php日期时区。

在这个简单的示例中，我们生成一个带有自定义标志和主题颜色的发票。它将包含2个产品和一个包含增值税和总价的底部框。然后我们在输出之前添加一个“已支付”徽章。

use Aldisa\PdfInvoice\InvoicePrinter;

  $invoice = new InvoicePrinter();
  
  /* Header settings */
  $invoice->setLogo("images/sample1.jpg");   //logo image path
  $invoice->setColor("#007fff");      // pdf color scheme
  $invoice->setType("Sale Invoice");    // Invoice Type
  $invoice->setReference("INV-55033645");   // Reference
  $invoice->setDate(date('M dS ,Y',time()));   //Billing Date
  $invoice->setTime(date('h:i:s A',time()));   //Billing Time
  $invoice->setDue(date('M dS ,Y',strtotime('+3 months')));    // Due Date
  $invoice->setFrom(array("Seller Name","Sample Company Name","128 AA Juanita Ave","Glendora , CA 91740"));
  $invoice->setTo(array("Purchaser Name","Sample Company Name","128 AA Juanita Ave","Glendora , CA 91740"));
  
  $invoice->addItem("AMD Athlon X2DC-7450","2.4GHz/1GB/160GB/SMP-DVD/VB",6,0,580,0,3480);
  $invoice->addItem("PDC-E5300","2.6GHz/1GB/320GB/SMP-DVD/FDD/VB",4,0,645,0,2580);
  $invoice->addItem('LG 18.5" WLCD',"",10,0,230,0,2300);
  $invoice->addItem("HP LaserJet 5200","",1,0,1100,0,1100);
  
  $invoice->addTotal("Total",9460);
  $invoice->addTotal("VAT 21%",1986.6);
  $invoice->addTotal("Total due",11446.6,true);
  
  $invoice->addBadge("Payment Paid");
  
  $invoice->addTitle("Important Notice");
  
  $invoice->addParagraph("No item will be replaced or refunded if you don't have the invoice with you.");
  
  $invoice->setFooternote("My Company Name Here");
  
  $invoice->render('example1.pdf','I'); 
  /* I => Display on browser, D => Force Download, F => local path save, S => return document as string */

文档

创建实例

use Aldisa\PdfInvoice\InvoicePrinter;

// Default Param: Size: A4, Currency: $, Language: en
$invoice = new InvoicePrinter($size, $currency, $language);

数字格式化

您想如何显示您的数字？

$invoice->setNumberFormat($decimalpoint, $seperator);

颜色

设置自定义颜色以个性化您的发票。

// Hexadecimal color code
$invoice->setColor($color);

添加标志

$invoice->setLogo($image, $maxwidth, $maxheight);

文档标题

// A string with the document title, will be displayed
// in the right top corner of the document (e.g. 'Invoice' or 'Quote')
$invoice->setType($title);

发票号码

// Document reference number that will be displayed in
// the right top corner of the document (e.g. 'INV29782')
$invoice->setReference($number);

日期

//A string with the document's date
$invoice->setDate($date);

到期日

// A string with the document's due date
$invoice->setDue($duedate);

发行者信息

设置您的公司详情。

// An array with your company details. The first value of
// the array will be bold on the document so it's suggested
// to use your company's name. You can add as
// many lines as you need.
/** Example: */
$invoice->setFrom([
    'My Company',
    'Address line 1',
    'Address line 2',
    'City and zip',
    'Country',
    'VAT number'    
]);

客户信息

// An array with your clients' details. The first value of the
// array will be bold on the document so we suggest you to use
// the company's name. You can add as many lines as you need.
/** Example */
$invoice->setTo([
   'My Client',
   'Address line 1',
   'Address line 2',
   'City and zip',
   'Country',
   'VAT number'    
]);

翻转

切换公司和客户信息的水平位置。默认情况下，您的公司详情位于左侧。

$invoice->flipflop();

发行者和客户标题

隐藏发行者和客户标题行

$invoice->hideToFromHeaders();

添加项目

将新产品或服务行添加到文档中，位于公司和客户信息下方。PHP Invoice具有自动分页功能，因此绝对没有限制。

$invoice->addItem(name,description,amount,vat,price,discount,total);

name {string} 一个包含产品或服务名称的字符串。description {string} 一个包含描述的字符串，支持多行。您可以使用以下方式：
或 \n 添加换行。金额 {小数} 表示此项目数量的整数。vat {字符串} 或 {小数} 传递一个字符串（例如 "21%"，或您可能喜欢的任何其他文本）或小数，如果您想显示金额（例如 124.30）。价格 {小数} 单位价格的十进制数。折扣 {字符串}、{小数} 或 {布尔值} 可选传递一个字符串（例如 "10%"，或您可能喜欢的任何其他文本）或小数，如果您想显示金额（例如 50.00）。如果您不想提供折扣，只需在此字段中输入布尔值 false。注意：如果所有产品都没有设置折扣，最终输出将不会显示折扣列。总计 {小数} 产品或服务总价格的十进制数。

项目行描述字体大小

更改产品描述的字体大小。默认为 7

$invoice->setFontSizeProductDescription(9);

添加总计

在产品和服务的下方添加一行进行计算和总计。您可以添加无限行。

$invoice->addTotal(name,value,background);

名称 {字符串} 用于显示总计字段显示名称的字符串。值 {小数} 值的十进制数。背景 {布尔值} 可选将其设置为 true 以将主题颜色设置为行的背景颜色。

添加徽章

在产品和服务的下方添加徽章到您的发票。您可以使用此功能，例如，显示发票已支付。

$invoice->addBadge($badge);

徽章 {字符串} 包含徽章文本的字符串。

您可以将徽章的颜色设置为第二个参数。

$invoice->addBadge('Paid', '#00ff00');
// Short hex variant is also supported
$invoice->addBadge('Payment pending', '#f00');

CSS 颜色名称（例如 'red'、'cyan'、'fuchsia' 等）不支持

添加标题

您可以在文档底部添加标题和段落以显示信息，如支付详情或运输信息。

$invoice->addTitle($title);

标题 {字符串} 包含要显示在徽章中的标题的字符串。

添加段落

您可以在文档底部添加标题和段落以显示信息，如支付详情或运输信息。

$invoice->addParagraph($paragraph);

段落 {字符串} 包含具有多行支持的段落文本的字符串。使用以下方法之一
或 \n 添加换行。

页脚

您想在文档底部左角显示的简短文本。

$invoice->setFooternote($note);

注释 {字符串} 包含您想在页脚中显示的信息的字符串。

渲染发票

$invoice->render($name, $output);

名称 {字符串} 包含您的发票名称的字符串。

示例：'invoice.pdf'

输出 {字符串} 选择您想要如何将发票交付给用户的选项。以下选项可用：I（将文件内联发送到浏览器）D（发送到浏览器并强制以给定的名称下载）F（保存到本地文件。请确保在名称参数中设置路径）S（以字符串形式返回文档）

aldisa / pdf-invoice

维护者

详细信息