PHP sizeof() 函数详解

sizeof() 函数是PHP中用于获取数组元素数目的内置函数。它实际上是 count() 函数的别名，两者在功能上完全相同。在PHP编程中，sizeof()/count() 函数是处理数组时最常用的函数之一。

重要提示： sizeof() 和 count() 函数在PHP中是等价的，可以互换使用。但在实际开发中，count() 更为常用。

函数定义和用途

sizeof() 函数用于计算数组中元素的数量。它可以处理一维数组和多维数组，并支持递归计数模式。

语法

sizeof(array, mode);
参数 描述
array 必需。规定要计数的数组或可计数对象。
mode 可选。规定函数的模式。可能的值：
  • COUNT_NORMAL 或 0 - 默认。不计算多维数组中的所有元素（只计算第一层）
  • COUNT_RECURSIVE 或 1 - 递归地计算数组中元素的数目（计算多维数组中的所有元素）

技术细节

返回值： 返回数组中元素的数目。如果参数不是数组或可计数对象，则返回 1（除非参数是 NULL，此时返回 0）。
PHP 版本： 4+
更新日志：
  • PHP 7.2：增加了对可计数对象的支持
  • PHP 4.2：添加了 mode 参数

基本使用实例

实例 1：基本数组计数

使用 sizeof() 计算一维数组的元素数量。

<?php
// 一维数组示例
$fruits = array("Apple", "Banana", "Orange", "Mango");
echo "水果数组包含 " . sizeof($fruits) . " 个元素。\n";
// 输出：水果数组包含 4 个元素。

// 关联数组示例
$person = array(
    "name" => "张三",
    "age" => 25,
    "city" => "北京"
);
echo "个人信息包含 " . sizeof($person) . " 个字段。\n";
// 输出：个人信息包含 3 个字段。

// 空数组示例
$emptyArray = array();
echo "空数组包含 " . sizeof($emptyArray) . " 个元素。\n";
// 输出：空数组包含 0 个元素。
?>

实例 2：多维数组计数

演示如何使用不同的模式参数计算多维数组的元素数量。

<?php
// 多维数组示例
$cars = array(
    "Volvo" => array(
        "XC60",
        "XC90"
    ),
    "BMW" => array(
        "X3",
        "X5"
    ),
    "Toyota" => array(
        "Highlander"
    )
);

// 默认模式（只计算第一层）
echo "默认计数: " . sizeof($cars) . "\n";
// 输出：默认计数: 3

// 递归模式（计算所有元素）
echo "递归计数: " . sizeof($cars, 1) . "\n";
// 输出：递归计数: 8

// 使用常量
echo "使用COUNT_RECURSIVE: " . sizeof($cars, COUNT_RECURSIVE) . "\n";
// 输出：使用COUNT_RECURSIVE: 8

// 计算递归计数与普通计数的差值，得到子元素总数
$totalElements = sizeof($cars, COUNT_RECURSIVE) - sizeof($cars);
echo "子元素总数: " . $totalElements . "\n";
// 输出：子元素总数: 5
?>

高级应用实例

实例 3：在循环和条件判断中的应用

展示 sizeof() 在循环控制和条件判断中的实际应用。

<?php
// 使用 sizeof() 控制循环
$colors = array("Red", "Green", "Blue", "Yellow", "Purple");

echo "颜色列表:\n";
for($i = 0; $i < sizeof($colors); $i++) {
    echo ($i + 1) . ". " . $colors[$i] . "\n";
}

// 使用 sizeof() 进行条件判断
$userPreferences = array("theme" => "dark", "language" => "zh-CN");

if(sizeof($userPreferences) > 0) {
    echo "用户有 " . sizeof($userPreferences) . " 个偏好设置。\n";
} else {
    echo "用户没有设置任何偏好。\n";
}

// 检查数组是否为空
$shoppingCart = array();

if(sizeof($shoppingCart) === 0) {
    echo "购物车为空。\n";
} else {
    echo "购物车中有 " . sizeof($shoppingCart) . " 件商品。\n";
}
?>

实例 4：处理复杂数据结构

演示如何处理包含多种数据类型的复杂数组。

<?php
// 复杂数据结构示例
$companyData = array(
    "company" => "ABC科技有限公司",
    "employees" => array(
        array("name" => "张三", "department" => "技术部"),
        array("name" => "李四", "department" => "销售部"),
        array("name" => "王五", "department" => "市场部")
    ),
    "departments" => array("技术部", "销售部", "市场部", "人事部"),
    "established" => 2010
);

// 计算不同层次的元素数量
echo "公司基本信息字段: " . sizeof($companyData) . "\n";
echo "员工数量: " . sizeof($companyData['employees']) . "\n";
echo "部门数量: " . sizeof($companyData['departments']) . "\n";

// 递归计算所有元素
echo "数据结构总元素数: " . sizeof($companyData, COUNT_RECURSIVE) . "\n";

// 计算嵌套数组中的员工信息字段
$totalEmployeeFields = 0;
foreach($companyData['employees'] as $employee) {
    $totalEmployeeFields += sizeof($employee);
}
echo "员工信息字段总数: " . $totalEmployeeFields . "\n";
?>

sizeof() 与 count() 的区别

虽然 sizeof() 和 count() 在功能上完全相同，但在实际使用中还是有一些细微差别需要注意：

比较项 sizeof() count()
函数名称 来自C语言习惯 PHP原生名称
使用频率 较少使用 更常用
代码可读性 对于有C背景的开发者更直观 对于PHP开发者更直观
性能 完全相同 
<?php
// sizeof() 和 count() 的等价性演示
$numbers = array(1, 2, 3, 4, 5);

$result1 = sizeof($numbers);
$result2 = count($numbers);

echo "sizeof() 结果: " . $result1 . "\n";  // 输出 5
echo "count() 结果: " . $result2 . "\n";   // 输出 5
echo "两者相等: " . ($result1 === $result2 ? '是' : '否') . "\n"; // 输出 是
?>

常见错误和注意事项

重要提醒

  • 非数组参数： 如果对非数组变量使用 sizeof()，会返回 1（NULL 除外，返回 0）
  • 性能考虑： 在循环中多次调用 sizeof() 可能影响性能，建议将结果存储在变量中
  • 递归计数： 对非常大的多维数组使用递归模式可能导致内存问题

错误用法示例

<?php
// 对非数组使用 sizeof()
$string = "Hello World";
echo sizeof($string) . "\n"; // 输出 1，这可能不是期望的结果

$nullValue = null;
echo sizeof($nullValue) . "\n"; // 输出 0

// 正确的做法是先检查是否为数组
if(is_array($string)) {
    echo sizeof($string) . "\n";
} else {
    echo "变量不是数组\n";
}

// 避免在循环中重复调用 sizeof()
$items = array(/* 大量元素 */);
$count = sizeof($items); // 先计算并存储

for($i = 0; $i < $count; $i++) {
    // 处理每个元素，避免每次循环都调用 sizeof()
}
?>

实用技巧和最佳实践

使用技巧

  • 使用 empty() 函数结合 sizeof() 来检查数组是否为空
  • 对于多维数组计数，明确使用 COUNT_RECURSIVE 常量提高代码可读性
  • 在性能敏感的场景中，考虑使用 count() 因为它在PHP社区中更常见

实用代码片段

<?php
// 检查数组是否为空的最佳实践
$data = array();

// 不推荐的方式
if(sizeof($data) == 0) {
    echo "数组为空\n";
}

// 推荐的方式
if(empty($data)) {
    echo "数组为空\n";
}

// 或者
if(sizeof($data) === 0) {
    echo "数组为空\n";
}

// 安全地获取多维数组的尺寸
function getArrayDimensions($array) {
    if(!is_array($array)) return 0;

    $maxDepth = 1;
    foreach($array as $value) {
        if(is_array($value)) {
            $depth = getArrayDimensions($value) + 1;
            if($depth > $maxDepth) {
                $maxDepth = $depth;
            }
        }
    }
    return $maxDepth;
}

$multiArray = array(
    "level1" => array(
        "level2" => array(
            "level3" => "value"
        )
    )
);

echo "数组维度: " . getArrayDimensions($multiArray) . "\n"; // 输出 3
?>

本章总结

  • sizeof() 函数用于获取数组中元素的数量
  • 它是 count() 函数的别名，两者功能完全相同
  • 支持两种计数模式：普通模式(0)和递归模式(1/COUNT_RECURSIVE)
  • 递归模式用于计算多维数组中所有层级的元素总数
  • 在实际开发中，count() 比 sizeof() 更常用
  • 使用前应确保参数是数组，避免意外的返回值
查看完整的 PHP Array 参考手册
上一章: PHP shuffle() 函数 下一章: PHP sort() 函数