PHP intdiv() 函数（完整指南）

PHP intdiv() 函数：整数除法的精准之选

在日常开发中，我们经常需要进行除法运算。虽然 PHP 提供了 / 运算符，但它的结果是浮点数，这在某些场景下并不理想。比如，当我们要计算“每组多少人”或“分成几组”时，结果必须是整数。这时候，intdiv() 函数就派上了用场。

PHP intdiv() 函数 专门用于执行整数除法，它会自动向下取整，确保返回值始终是整数。这不仅避免了浮点数精度问题，也让代码逻辑更清晰、更安全。尤其在处理用户分组、数据分页、资源分配等场景时，intdiv() 是一个非常实用且推荐使用的工具。

什么是 PHP intdiv() 函数？

intdiv() 是 PHP 8.0 版本引入的一个内置函数，它的作用是执行两个整数之间的除法，并返回向下取整的整数结果。

简单来说，intdiv(a, b) 就是计算 a ÷ b 的整数部分，忽略小数部分，不进行四舍五入，而是直接“截断”向零方向取整。

✅ 注意：intdiv() 只接受整数参数，如果传入浮点数，会自动转换为整数，但若转换后发生溢出或类型错误，会抛出 TypeError。

我们来看一个基本示例：

<?php
// 计算 10 除以 3 的整数部分
$result = intdiv(10, 3);

// 输出结果：3
echo $result; // 3

💡 中文注释：intdiv(10, 3) 表示 10 ÷ 3，结果是 3.333...，但 intdiv() 会向下取整为 3，不进行四舍五入。

与普通除法运算符 / 的区别

很多人会问：“我直接用 / 不也行吗？为什么还要用 intdiv()？”

关键在于：/ 返回的是浮点数，而 intdiv() 返回的是整数。

我们通过对比来理解：

<?php
$a = 10;
$b = 3;

// 普通除法：返回浮点数
$normal_div = $a / $b;
echo "普通除法结果：$normal_div\n"; // 输出：3.3333333333333

// intdiv()：返回整数（向下取整）
$int_div = intdiv($a, $b);
echo "intdiv() 结果：$int_div\n";   // 输出：3

💡 中文注释：/ 运算符返回的是 float 类型，适合需要精度的计算；而 intdiv() 返回的是 int 类型，适合需要整数结果的场景，比如分组、分页等。

对比总结

使用场景：真实项目中的应用

分组分配问题

假设你有 25 个用户，需要分成每组 6 人，问最多能分成几组？

<?php
$total_users = 25;
$group_size = 6;

// 使用 intdiv 计算最大分组数
$groups = intdiv($total_users, $group_size);

echo "最多可以分成 $groups 组。\n"; // 输出：最多可以分成 4 组。

💡 中文注释：25 ÷ 6 = 4.166...，intdiv() 会直接取整为 4，符合“最多能分几组”的业务逻辑。

分页计算

在分页系统中，我们需要计算总页数。例如，每页显示 10 条数据，总共有 103 条数据，应显示多少页？

<?php
$total_items = 103;
$items_per_page = 10;

// 用 intdiv 计算页数（注意：这里需要加 1 来处理余数）
$pages = intdiv($total_items, $items_per_page);

// 如果有余数，说明还要多一页
if ($total_items % $items_per_page !== 0) {
    $pages += 1;
}

echo "总页数为：$pages\n"; // 输出：总页数为：11

💡 中文注释：intdiv(103, 10) 返回 10，但因为还有 3 条数据未显示，所以需要额外加一页。这种“整除 + 余数判断”是分页中的常见模式。

错误处理与异常机制

intdiv() 是一个“严格”的函数，它不接受非整数参数，也不允许除以 0。

除以 0 会抛出异常

<?php
try {
    intdiv(10, 0);
} catch (DivisionByZeroError $e) {
    echo "错误：不能除以 0。" . $e->getMessage();
}

💡 中文注释：当除数为 0 时，intdiv() 会抛出 DivisionByZeroError 异常，这是 PHP 8+ 新增的异常类型，比老版本更清晰。

传入浮点数会自动转整数，但可能出错

<?php
// 浮点数会被转换为整数（向零截断）
$result = intdiv(10.9, 3);
echo $result; // 输出：3

// 但若数值过大，可能超出整数范围
$result = intdiv(1e18, 1);
// 如果超出 PHP int 范围，会抛出 TypeError

💡 中文注释：intdiv() 内部会自动将浮点数转为整数（如 10.9 → 10），但如果数值太大（如超过 PHP 的整数最大值），就会触发 TypeError。

性能与可读性优势

相比手动使用 floor($a / $b) 或 (int)($a / $b)，intdiv() 有三大优势：

1. 语义更清晰：intdiv(10, 3) 明确表示“整数除法”，比 (int)(10 / 3) 更易读。
2. 性能略优：intdiv() 是原生函数，底层优化更好，避免了类型转换开销。
3. 错误更明确：遇到除以 0 或非法参数时，会抛出具体异常，便于调试。

比较写法

<?php
$a = 10;
$b = 3;

// 方法 1：使用 intdiv（推荐）
$result1 = intdiv($a, $b); // 3

// 方法 2：手动强制类型转换（不推荐）
$result2 = (int)($a / $b); // 3

// 方法 3：使用 floor（逻辑等价，但不直观）
$result3 = floor($a / $b); // 3

💡 中文注释：虽然 floor($a / $b) 在数值上与 intdiv() 一致，但 intdiv() 更符合“整数除法”的语义，且在除法逻辑上更安全。

实用技巧：结合模运算做余数判断

在很多业务逻辑中，我们需要判断是否能“完全整除”。比如，判断一个数是否能被另一个数整除。

<?php
function is_divisible($a, $b) {
    return intdiv($a, $b) * $b === $a;
}

// 测试
var_dump(is_divisible(15, 3)); // true
var_dump(is_divisible(14, 3)); // false

💡 中文注释：intdiv($a, $b) * $b 会还原整除部分，若等于原数，则说明能整除。这是一种高效且安全的判断方式。

总结：为什么你应该使用 PHP intdiv() 函数？

PHP intdiv() 函数 是一个设计精巧、语义明确、性能优良的工具。它解决了“整数除法”这一常见需求，避免了浮点数精度问题，提升了代码的可读性和安全性。

• 当你只需要整数结果时，优先使用 intdiv()。
• 当你需要分组、分页、资源分配时，它是理想选择。
• 它的异常机制让错误更易发现，避免隐藏 bug。
• 它是 PHP 8+ 的重要特性，体现了语言对“类型安全”和“语义清晰”的追求。

无论你是初学者还是中级开发者，掌握 intdiv() 都能让你的代码更专业、更健壮。下次写除法逻辑时，别再用 (int)($a / $b) 了，试试 intdiv()，它会让你的代码更“有质感”。

最后提醒：如果项目仍在使用 PHP 7.x，intdiv() 不可用。建议尽早升级到 PHP 8.0 或更高版本，以获得更强大的语言特性支持。