PHP函数内调用array_push()追加数组元素不生效问题求助

问题原因 #

PHP的变量作用域默认是隔离的：函数内部直接访问的变量如果没有特殊声明，全部属于函数内部的局部变量，和函数外部定义的同名全局变量没有关联。
你在add_member_data函数中操作$all_members时，PHP会自动在函数内部创建一个空的局部数组$all_members，array_push的所有操作都只针对这个临时局部变量生效，函数执行结束后局部变量会直接被回收，外部定义的全局$all_members从头到尾都没有被修改，自然看不到追加的成员数据。
你在函数内部打印$all_members时也能观察到对应特征：每次打印的数组都只包含当前传入的单条$data，不会保留之前调用函数时追加的内容。

解决方案 #

方案1：使用global关键字声明引用全局变量 #

在函数内部操作$all_members前，通过global关键字明确指定要使用全局作用域下的同名变量，代码修改如下：

// 全局成员数组需定义在函数外部
$all_members = [];

function add_member_data($id, $fname, $lname) {
    // 声明引用全局变量
    global $all_members;

    $data = array(
        "ID" => $id,
        "First Name" => $fname,
        "Last Name" => $lname,
    );

    array_push($all_members, $data);

    echo "<pre>";
    var_dump($data);
    echo "</pre>";

    echo "<pre>";
    var_dump($all_members);
    echo "</pre>";
}

注意：该方案强依赖全局变量，项目逻辑复杂时很容易出现变量被意外篡改的问题，不推荐在正式项目中大规模使用。

方案2：按引用传递数组参数 #

函数定义时给数组成员参数添加&标识，代表传递参数时传入原变量的引用而非副本，函数内部的修改会直接作用于原数组：

// 函数参数增加引用类型的成员数组
function add_member_data(&$memberList, $id, $fname, $lname) {
    $data = array(
        "ID" => $id,
        "First Name" => $fname,
        "Last Name" => $lname,
    );

    array_push($memberList, $data);

    echo "<pre>";
    var_dump($data);
    echo "</pre>";

    echo "<pre>";
    var_dump($memberList);
    echo "</pre>";
}

// 调用示例
$all_members = [];
add_member_data($all_members, 1, '三', '张');
add_member_data($all_members, 2, '四', '李');

该方案不依赖全局变量，逻辑边界清晰，是实际开发中更推荐的写法。

方案3：返回修改后的数组手动赋值 #

如果不想使用引用传递，可以在函数内部完成数组追加后将结果返回，外部调用时重新赋值给原数组即可：

function add_member_data($memberList, $id, $fname, $lname) {
    $data = array(
        "ID" => $id,
        "First Name" => $fname,
        "Last Name" => $lname,
    );

    array_push($memberList, $data);

    echo "<pre>";
    var_dump($data);
    echo "</pre>";

    echo "<pre>";
    var_dump($memberList);
    echo "</pre>";

    return $memberList;
}

// 调用示例
$all_members = [];
$all_members = add_member_data($all_members, 1, '三', '张');
$all_members = add_member_data($all_members, 2, '四', '李');

内容的提问来源于stack exchange，提问作者Muhammad Awais