homord/tax-calculator

一个用于计算多个国家税款的Laravel扩展包

dev-main 2024-08-12 01:27 UTC

This package is auto-updated.

Last update: 2024-09-12 01:45:17 UTC


README

Packagist Version License

介绍

Laravel Tax Calculator 扩展包提供了一种灵活且可扩展的方式来计算不同国家的税款。它支持特定国家的税款计算,并且可以轻松扩展以包括更多国家。

特性

  • 根据特定国家的税法计算年度和月度税款。
  • 易于扩展以支持更多国家。
  • 使用策略和工厂设计模式编写干净、组织良好的代码。

安装

您可以通过Composer安装此包

composer require DrOmoh/tax-calculator

安装后,运行以下命令发布配置文件

php artisan vendor:publish --provider="YourVendorName\TaxCalculator\Providers\TaxCalculatorServiceProvider"

使用方法

要计算税款,首先为特定国家创建一个税款计算器的实例。然后,使用它来计算年度和月度税款

use YourVendorName\TaxCalculator\Factories\TaxCalculatorFactory;

$calculator = TaxCalculatorFactory::createCalculator('Nigeria');

// Sample data
$annualEarnings = 1440000.00;
$annualPen = 69120.00;
$annualNhf = 9000.00;

$annualTax = $calculator->calculateAnnualTax($annualEarnings, $annualPen, $annualNhf);
$monthlyTax = $calculator->calculateMonthlyTax($annualTax);

echo "Annual Tax: {$annualTax}\n";
echo "Monthly Tax: {$monthlyTax}\n";

测试

要运行包的测试,执行以下命令

vendor/bin/phpunit

编码规范

该包遵循PSR-2编码规范。您可以通过运行来检查代码风格

vendor/bin/phpcs --standard=PSR2 src/

静态分析

运行PHPStan以执行静态分析

vendor/bin/phpstan analyse src --level=max

贡献

欢迎贡献!请提交一个拉取请求或在GitHub上打开一个问题。

贡献步骤

  • Fork 仓库。
  • 创建一个新的分支(git checkout -b feature/new-country-tax-calculator)。
  • 进行您的更改。
  • 提交您的更改(git commit -m 'Add tax calculator for NewCountry')。
  • 将更改推送到分支(git push origin feature/new-country-tax-calculator)。
  • 打开一个拉取请求。

许可证 此包是开源软件,根据MIT许可证授权。