README

此Laravel包提供了一个易于使用的界面，用于生成您提供数据的 发票PDF文件。

发票文件可以存储、下载、在您配置的任何文件系统中流式传输。支持不同的模板和区域设置。

原始包是在PHP 7.3.11和Laravel 6.2上开发的，但应该也能在更低版本上运行。

特性

• 税费 - 固定或比率 - 对于项目或发票
• 折扣 - 固定或百分比 - 对于项目或发票
• 运费 - 将运费添加到您的发票中
• 自动计算 - 提供最小信息集，或自行计算并提供打印内容
• 到期日
• 易于自定义货币格式
• 按您喜欢的顺序编号
• 模板
• 翻译
• 全局设置和即时覆盖

变更日志

有关最近更改的更多信息，请参阅变更日志。

安装

通过Composer

Laravel版本 <= 9

$ composer require laraveldaily/laravel-invoices:^3.0

Laravel版本 <= 8

$ composer require laraveldaily/laravel-invoices:^2.0

Laravel版本 <= 7

$ composer require laraveldaily/laravel-invoices:^1.3

安装Laravel Invoices后，使用invoices:install Artisan命令发布其资产、视图、翻译和配置

$ php artisan invoices:install

更新

由于它发展迅速，您可能希望使用Artisan命令在更新后获取最新模板

$ php artisan invoices:update

如果确实想要覆盖默认资源，将会给出警告

或者，可以单独执行。

$ php artisan vendor:publish --tag=invoices.views --force

$ php artisan vendor:publish --tag=invoices.translations --force

对于Laravel版本 < 5.5

如果您不使用自动发现，请将ServiceProvider添加到config/app.php中的providers数组

LaravelDaily\Invoices\InvoiceServiceProvider::class,

如果您想使用外观生成发票，请将以下内容添加到您的facades中的config/app.php

'Invoice' => LaravelDaily\Invoices\Facades\Invoice::class

模板

发布资产后，您可以修改或创建自己的发票模板。

模板存储在resources/views/vendor/invoices/templates目录中。在那里您将找到默认使用的default.blade.php模板。

您可以通过在Invoice对象上调用template方法来指定要使用的模板。

例如，如果您有resources/views/vendor/invoices/templates/my_company.blade.php，它应该看起来像这样

Invoice::make('receipt')->template('my_company');

要了解模板中事物的运作方式，您可以查看default.blade.php作为示例。

测试

$ composer test