在OpenCart（及通用场景）中从含税价格中准确扣除税费

<?php

/**
 * 从含税价格中反向计算净价和税费
 *
 * @param float $gross_price 含税价格
 * @param int $tax_rate 百分比税率 (例如，20 表示 20%)
 * @return array 包含 'net_price' 和 'tax_amount' 的数组
 */
function calculateNetPriceFromGross(float $gross_price, int $tax_rate): array
{
    if ($tax_rate < 0) {
        throw new InvalidArgumentException("税率不能为负数。");
    }

    // 计算除数：1 + 税率/100
    // 例如，20% 税率，除数为 (100 + 20) / 100 = 1.20
    $divisor = (100 + $tax_rate) / 100;

    // 计算净价
    // 使用 round() 函数四舍五入到两位小数，以避免浮点数精度问题
    $net_price = round($gross_price / $divisor, 2);

    // 计算税费金额
    $tax_amount = round($gross_price - $net_price, 2);

    return [
        'net_price' => $net_price,
        'tax_amount' => $tax_amount
    ];
}

// 示例 1: 20% 税率
$gross_price_1 = 150.00;
$tax_rate_1 = 20;
$result_1 = calculateNetPriceFromGross($gross_price_1, $tax_rate_1);

echo "--- 20% 税率示例 ---\n";
echo "原始含税价格: " . $gross_price_1 . "\n";
echo "计算出的净价: " . $result_1['net_price'] . "\n"; // 133.33
echo "计算出的税费: " . $result_1['tax_amount'] . "\n\n"; // 16.67

// 示例 2: 15% 税率
$gross_price_2 = 150.00;
$tax_rate_2 = 15;
$result_2 = calculateNetPriceFromGross($gross_price_2, $tax_rate_2);

echo "--- 15% 税率示例 ---\n";
echo "原始含税价格: " . $gross_price_2 . "\n";
echo "计算出的净价: " . $result_2['net_price'] . "\n"; // 130.43
echo "计算出的税费: " . $result_2['tax_amount'] . "\n\n"; // 19.57

?>

--- 20% 税率示例 ---
原始含税价格: 150
计算出的净价: 133.33
计算出的税费: 16.67

--- 15% 税率示例 ---
原始含税价格: 150
计算出的净价: 130.43
计算出的税费: 19.57

<?php

/**
 * 从包含固定税和百分比税的含税价格中反向计算净价和税费
 *
 * @param float $gross_price_with_all_taxes 包含所有税费的含税总价
 * @param float $fixed_tax_amount 固定税费金额 (例如，生态税)
 * @param int $percentage_tax_rate 百分比税率 (例如，20 表示 20% VAT)
 * @return array 包含 'net_price' 和 'total_tax_deducted' 的数组
 */
function calculateNetPriceWithComplexTax(
    float $gross_price_with_all_taxes,
    float $fixed_tax_amount,
    int $percentage_tax_rate
): array {
    if ($fixed_tax_amount < 0 || $percentage_tax_rate < 0) {
        throw new InvalidArgumentException("税费金额和税率不能为负数。");
    }

    // 步骤1: 从含税总价中减去固定税费
    $price_before_percentage_tax = $gross_price_with_all_taxes - $fixed_tax_amount;

    // 确保剩余价格不为负，避免不合理情况
    if ($price_before_percentage_tax < 0) {
        // 根据业务逻辑处理此情况，例如抛出异常或返回错误
        throw new InvalidArgumentException("扣除固定税后价格为负，请检查输入。");
    }

    // 步骤2: 对剩余金额反算百分比税费
    $divisor = (100 + $percentage_tax_rate) / 100;
    $net_price = round($price_before_percentage_tax / $divisor, 2);
    $percentage_tax_amount = round($price_before_percentage_tax - $net_price, 2);

    // 步骤3: 汇总总税费
    $total_tax_deducted = $fixed_tax_amount + $percentage_tax_amount;

    return [
        'net_price' => $net_price,
        'total_tax_deducted' => $total_tax_deducted
    ];
}

// OpenCart 示例数据
$gross_price_oc = 20.80;
$fixed_eco_tax_oc = 2.00;
$percentage_vat_rate_oc = 20; // VAT税率

try {
    $result_oc = calculateNetPriceWithComplexTax(
        $gross_price_oc,
        $fixed_eco_tax_oc,
        $percentage_vat_rate_oc
    );

    echo "--- OpenCart 复杂税制示例 ---\n";
    echo "原始含税总价: " . $gross_price_oc . "\n";
    echo "固定生态税: " . $fixed_eco_tax_oc . "\n";
    echo "增值税率: " . $percentage_vat_rate_oc . "%\n";
    echo "计算出的净价: " . $result_oc['net_price'] . "\n"; // 15.67
    echo "计算出的总税费: " . $result_oc['total_tax_deducted'] . "\n"; // 5.13 (2.00 + 3.13)
} catch (InvalidArgumentException $e) {
    echo "错误: " . $e->getMessage() . "\n";
}

?>

--- OpenCart 复杂税制示例 ---
原始含税总价: 20.8
固定生态税: 2
增值税率: 20%
计算出的净价: 15.67
计算出的总税费: 5.13