PHP中浮点数与带前导零字符串的双向安全转换：API数据处理实践

<?php

/**
 * 将浮点数转换为API所需的带前导零的固定长度字符串
 *
 * @param float $amount 原始浮点数金额，例如 100.5
 * @param int $decimalPlaces 需要保留的小数位数，例如 2
 * @param int $totalLength 目标字符串的总长度，例如 12
 * @return string 格式化后的字符串，例如 "000000010050"
 */
function formatAmountForApi(float $amount, int $decimalPlaces = 2, int $totalLength = 12): string
{
    // 步骤1: 处理浮点数精度，并确保小数位一致
    // 例如，100.5 变为 100.50
    $roundedAmount = round($amount, $decimalPlaces);

    // 步骤2: 移除小数点，将其转换为整数形式
    // 例如，100.50 * 100 = 10050
    // 注意：这里将浮点数直接乘以10的幂，PHP会自动进行类型转换，结果为整数或浮点数
    // 为了确保后续str_pad能正确处理，将其转换为字符串
    $integerValue = (string)($roundedAmount * (10 ** $decimalPlaces));

    // 步骤3: 添加前导零，填充到指定总长度
    // 例如，"10050" 填充到12位，得到 "000000010050"
    $formattedString = str_pad($integerValue, $totalLength, "0", STR_PAD_LEFT);

    return $formattedString;
}

// 示例用法
$total = 100.5;
$formattedPurchaseAmt = formatAmountForApi($total, 2, 12);
echo "原始金额: " . $total . "\n"; // 输出: 原始金额: 100.5
echo "API格式化后: " . $formattedPurchaseAmt . "\n"; // 输出: API格式化后: 000000010050

// 另一个例子
$total2 = 5.75;
$formattedPurchaseAmt2 = formatAmountForApi($total2, 2, 10);
echo "原始金额: " . $total2 . "\n"; // 输出: 原始金额: 5.75
echo "API格式化后: " . $formattedPurchaseAmt2 . "\n"; // 输出: API格式化后: 0000000575

?>