如何在 PHP 的 json_encode 中禁用科学计数法输出小数值-php教程-PHP中文网

如何在 PHP 的 json_encode 中禁用科学计数法输出小数值

php 默认对极小浮点数（如 0.0000005）使用科学计数法（如 5.0e-7）进行 json 编码，但某些 api 要求严格保留十进制字符串格式的数值字面量。本文提供一种安全、可递归、无精度损失的解决方案，通过占位符替换+后处理实现符合要求的纯十进制浮点表示。

php 默认对极小浮点数（如 0.0000005）使用科学计数法（如 5.0e-7）进行 json 编码，但某些 api 要求严格保留十进制字符串格式的数值字面量。本文提供一种安全、可递归、无精度损失的解决方案，通过占位符替换+后处理实现符合要求的纯十进制浮点表示。

在与外部 Partner API 集成时，常遇到对 JSON 数值格式的硬性约束："amount":0.0000005 是合法的，而 "amount":5.0e-7 或 "amount":"0.0000005" 均被拒绝。这是因为 json_encode() 在内部调用 C 标准库的 sprintf() 行为，对绝对值小于 1e-4 的浮点数默认启用指数格式，且 PHP 不提供原生配置项（如 JSON_NUMERIC_PRECISION 仅控制有效位数，无法禁用 e 记法）。

直接强制类型转换（如 (string)$val）会导致 JSON 将其编码为字符串，违反 API 对 number 类型的要求；而 number_format() 等函数会引入千分位分隔符或截断精度，不可取。

✅ 推荐方案：占位符预替换 + 后处理注入
核心思路是：

递归遍历原始数组，将需格式化的浮点数（如 ）替换为唯一占位符（如 <code>"__PLACEHOLDER__0"）；
对占位符建立映射表：'"__PLACEHOLDER__0"' => '0.0000005'；
执行 json_encode() 得到含占位符的 JSON 字符串；
使用 str_replace() 批量替换占位符为无指数格式的十进制字符串。

关键难点在于 formatFloat() —— 必须将 float 精确转为不含 e 的最简十进制字符串（如 0.0000005 而非 0.00000050000000000000001）。以下为经验证的可靠实现：

private function formatFloat(float $value): string
{
    // 处理零值
    if ($value == 0.0) {
        return '0';
    }

    // 获取科学计数法字符串用于判断精度
    $sci = sprintf('%.16e', $value);
    $parts = explode('e', $sci);
    $mantissa = rtrim(rtrim($parts[0], '0'), '.');
    $exponent = (int)$parts[1];

    // 计算小数点后需保留的位数（确保无精度丢失）
    $decimalPlaces = max(0, -$exponent + strlen($mantissa) - 1);

    // 使用 sprintf 生成固定小数位数的字符串，再移除末尾零
    $formatted = rtrim(sprintf('%.' . $decimalPlaces . 'f', $value), '0');
    return $formatted === '' || $formatted === '-' ? $formatted . '0' : $formatted;
}

完整封装类如下（已集成上述 formatFloat）：

Browser Js

轻量级CDP浏览器控制，适用于AI代理。相较于内置浏览器工具，token消耗降低3‑10倍，仅在浏览时使用。

下载

class JsonMangler
{
    private const THRESHOLD = 0.0001; // 小于该值的 float 触发格式化
    private const PLACEHOLDER_PREFIX = '__JSON_MANGLE_FLOAT_';

    private array $mangledData = [];
    private array $substitutions = [];
    private int $placeholderCounter = 0;

    public function __construct(array $data) {
        $this->mangledData = $this->mangle($data);
    }

    private function mangle(array $data): array {
        $result = [];
        foreach ($data as $key => $value) {
            if (is_float($value) && abs($value) placeholderCounter++;
                $result[$key] = $placeholder;
                $this->substitutions['"' . $placeholder . '"'] = $this->formatFloat($value);
            } elseif (is_array($value)) {
                $result[$key] = $this->mangle($value);
            } else {
                $result[$key] = $value;
            }
        }
        return $result;
    }

    private function formatFloat(float $value): string { /* 如上实现 */ }

    public function getJson(int $flags = 0): string {
        $json = json_encode($this->mangledData, $flags);
        return str_replace(
            array_keys($this->substitutions),
            array_values($this->substitutions),
            $json
        );
    }
}

✅ 使用示例：

$data = [
    'amount' => 0.0000005,
    'fee' => 1.23,
    'nested' => ['rate' => 0.000042],
];

echo (new JsonMangler($data))->getJson(JSON_UNESCAPED_UNICODE);
// 输出: {"amount":0.0000005,"fee":1.23,"nested":{"rate":0.000042}}

⚠️ 注意事项：