OpenCart中从含税价格中精确反向计算净价与税额

<?php

/**
 * 从含税价格中计算净价和税额
 *
 * 此函数适用于从一个已包含百分比税率的价格中，反向计算出商品的净价（不含税价格）及实际税额。
 *
 * @param float $grossPrice 含税价格，例如 150.00
 * @param int $taxRate 百分比税率，例如 20 代表 20%
 * @return array 包含 'net' (净价) 和 'tax' (税额) 的关联数组
 * @throws InvalidArgumentException 如果税率为负数
 */
function calculateNetAndTaxFromGross(float $grossPrice, int $taxRate): array {
    // 验证税率不能为负数
    if ($taxRate < 0) {
        throw new InvalidArgumentException("税率不能为负数。");
    }

    // 如果税率为0，则净价等于含税价格，税额为0
    if ($taxRate === 0) {
        return [
            'net' => round($grossPrice, 2), // 确保结果保留两位小数
            'tax' => 0.00
        ];
    }

    // 计算除数： (100 + 税率) / 100
    // 例如，20% 税率时，除数为 (100 + 20) / 100 = 1.2
    $divisor = (100 + $taxRate) / 100;

    // 计算净价 (不含税价格)
    $net = $grossPrice / $divisor;

    // 计算税额
    $tax = $grossPrice - $net;

    // 返回四舍五入到两位小数的结果，以符合货币表示习惯
    return [
        'net' => round($net, 2),
        'tax' => round($tax, 2)
    ];
}

// --- 示例用法 ---

// 示例 1: 20% 税率
$grossPrice1 = 150.00;
$taxRate1 = 20; // 20% 税率
$result1 = calculateNetAndTaxFromGross($grossPrice1, $taxRate1);
echo "当含税价格为 {$grossPrice1}，税率为 {$taxRate1}% 时：\n";
echo "  净价 (不含税) 为 {$result1['net']}\n"; // 预期：125.00
echo "  税额为 {$result1['tax']}\n\n";       // 预期：25.00

// 示例 2: 15% 税率
$grossPrice2 = 150.00;
$taxRate2 = 15; // 15% 税率
$result2 = calculateNetAndTaxFromGross($grossPrice2, $taxRate2);
echo "当含税价格为 {$grossPrice2}，税率为 {$taxRate2}% 时：\n";
echo "  净价 (不含税) 为 {$result2['net']}\n"; // 预期：130.43
echo "  税额为 {$result2['tax']}\n\n";       // 预期：19.57

// 示例 3: 0% 税率
$grossPrice3 = 100.00;
$taxRate3 = 0; // 0% 税率
$result3 = calculateNetAndTaxFromGross($grossPrice3, $taxRate3);
echo "当含税价格为 {$grossPrice3}，税率为 {$taxRate3}% 时：\n";
echo "  净价 (不含税) 为 {$result3['net']}\n"; // 预期：100.00
echo "  税额为 {$result3['tax']}\n\n";       // 预期：0.00

// 示例 4: 包含固定税额的复杂情况（需预处理）
// 假设含税价格 20.80 包含 2.00 的固定税和 20% 的增值税
$initialGross = 20.80;
$fixedTax = 2.00;
$percentageTaxRate = 20;

// 首先扣除固定税额
$grossAfterFixedTax = $initialGross - $fixedTax; // 20.80 - 2.00 = 18.80

// 然后对剩余金额应用百分比税率计算
$resultComplex = calculateNetAndTaxFromGross($grossAfterFixedTax, $percentageTaxRate);
echo "当初始含税价格为 {$initialGross}，包含 {$fixedTax} 固定税和 {$percentageTaxRate}% 百分比税时：\n";
echo "  预处理后的含税价格 (仅含百分比税) 为 {$grossAfterFixedTax}\n";
echo "  净价 (不含税) 为 {$resultComplex['net']}\n"; // 预期：15.67
echo "  百分比税额为 {$resultComplex['tax']}\n";     // 预期：3.13
echo "  总税额 (固定税 + 百分比税) 为 " . round($fixedTax + $resultComplex['tax'], 2) . "\n"; // 预期：5.13

当含税价格为 150，税率为 20% 时：
  净价 (不含税) 为 125.00
  税额为 25.00

当含税价格为 150，税率为 15% 时：
  净价 (不含税) 为 130.43
  税额