异常教程

PHP fmod() 函数（保姆级教程）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
  • 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在 PHP 编程中，数值运算始终是核心能力之一。当开发者需要处理浮点数的余数计算时，fmod() 函数便成为了一个不可或缺的工具。与普通的取模运算符 % 不同，fmod() 特别针对浮点数设计，能更精准地处理小数点后的余数问题。无论是开发需要精确计算的金融系统，还是实现游戏中的循环逻辑，理解 fmod() 的工作原理都至关重要。本文将从基础语法到实际案例，逐步解析这一函数的用法与技巧。

一、基础语法与核心概念

1.1 函数定义与参数说明

fmod() 函数的语法如下：

float fmod ( float $x , float $y )

其中：

  • $x 是被除数（dividend）
  • $y 是除数（divisor）
    函数返回 $x 除以 $y 的余数，结果保留浮点数类型。

示例代码

echo fmod(5.5, 2); // 输出 1.5  
echo fmod(7, 3.2); // 输出 0.6

1.2 与普通取模运算符 % 的区别

PHP 的 % 运算符虽然也能计算余数，但它仅适用于整数运算。当涉及浮点数时，fmod() 的表现更符合数学定义：

  • 浮点精度支持：fmod() 可处理小数位的余数计算
  • 负数处理差异：fmod() 的余数符号与被除数 $x 一致，而 % 的余数符号与除数 $y 一致

对比表格

（注意：此表格与上下文间空一行）

输入参数fmod(5.5, 2)5.5 % 2
结果1.51.5
负数示例 fmod(-5.5, 2)-1.50.5

二、核心功能详解与应用场景

2.1 浮点数余数的精确计算

当需要处理非整数的余数时，fmod() 能避免 % 运算符的精度问题。例如计算蛋糕分切场景：

案例：蛋糕分切问题
假设蛋糕长 8.7 米，每块分 2.3 米，计算剩余长度：

$remaining = fmod(8.7, 2.3);  
echo "剩余长度：$remaining 米"; // 输出 1.5 米

此时若使用 8.7 % 2.3，由于 PHP 自动转换为整数运算，结果会是 0，显然不符合实际需求。

2.2 负数场景的灵活处理

fmod() 对负数的处理逻辑更接近数学定义：余数的符号始终与被除数一致。例如：

echo fmod(-7.5, 3); // 输出 -1.5（与 -7.5 同符号）  
echo -7.5 % 3;      // 输出 1.5（与 3 同符号）

这一特性在处理周期性问题（如时间计算）时特别有用。

2.3 实际开发中的典型应用场景

场景 1：分页系统

在实现分页功能时，可通过 fmod() 判断是否有下一页：

$total = 25;       // 总记录数  
$per_page = 10;    // 每页显示数量  
$pages = ceil($total / $per_page);  
if (fmod($total, $per_page) == 0) {  
    $last_page_count = $per_page;  
} else {  
    $last_page_count = fmod($total, $per_page);  
}  
echo "最后一页有 $last_page_count 条记录"; // 输出 5

场景 2：游戏开发中的循环坐标

在游戏开发中，物体沿坐标轴移动时可利用 fmod() 实现无限循环：

$x = 1000;         // 当前X坐标  
$screen_width = 800;  
$new_x = fmod($x, $screen_width);  
echo "新坐标：$new_x"; // 输出 200（超出部分循环显示）

三、进阶技巧与常见问题

3.1 处理除数为 0 的异常

当 $y 为 0 时，fmod() 会返回 NAN（非数值），需通过条件判断避免：

$divisor = 0;  
if ($divisor == 0) {  
    throw new Exception("除数不能为零");  
} else {  
    echo fmod(5, $divisor);  
}

3.2 与 floor() 的结合使用

通过 floor() 可将浮点运算结果转化为整数场景：

// 计算 100 元购买单价 3.5 元的物品能买多少个  
$quantity = floor(100 / 3.5);  
$remaining = fmod(100, 3.5);  
echo "可购买 $quantity 件，剩余 $remaining 元";  
// 输出：可购买 28 件，剩余 1.0 元

四、常见误区与解决方案

4.1 精度丢失问题

由于浮点数在计算机中的二进制存储特性，极端情况下可能出现微小误差：

echo fmod(0.1 + 0.2, 0.3); // 可能输出 -1.1102230246252e-16 而非 0

此时可通过 round() 函数进行四舍五入处理：

$result = round(fmod(0.1 + 0.2, 0.3), 10); // 输出 0

4.2 混淆 fmod() 与 modf()

modf() 是 PHP 的另一个函数，用于分离浮点数的整数和小数部分，与 fmod() 功能完全不同。需注意区分：

list($integer, $decimal) = modf(3.14); // 整数部分 3，小数部分 0.14

五、总结与扩展建议

通过本文，我们系统梳理了 PHP fmod() 函数的核心功能、使用场景及进阶技巧。对于初学者，建议通过以下方式加深理解：

  1. 动手实践：尝试用 fmod() 实现分页系统或坐标循环
  2. 对比学习：将 fmod() 与 %、modf() 等函数进行对比实验
  3. 阅读源码：查看 PHP 内核中 fmod() 的实现逻辑（位于 Zend/zend_operators.c）

掌握 PHP fmod() 函数不仅能提升数值运算的精准度，更能为开发复杂业务逻辑奠定基础。在实际项目中，合理结合浮点数运算与条件判断，可显著提升代码的健壮性和功能性。

最新发布

查看更多文章