PHP关联数组入门教程及使用方法

PHP关联数组是开发者绕不开的核心基础——它用直观的字符串键（如$user['name']）替代晦涩的数字索引，让代码更贴近业务逻辑、更易读易维护；本文手把手教你从声明（[]或array()）、安全访问（必须加引号！）、高效遍历（foreach三大用法）到动态增删改（赋值/isset()/unset()），再到JSON转换的隐秘规则和函数传参时引用传递的关键细节，直击初学者最常踩的坑，帮你把这一看似简单却极易出错的基础结构真正用扎实、用灵活。

PHP 关联数组不是“高级功能”，而是日常写代码绕不开的基础结构——它用字符串当键，比数字索引更贴近业务逻辑，比如 $user['name'] 比 $user[0] 好懂得多。

怎么声明和访问关联数组

直接用 array() 或方括号 [] 创建，键必须是字符串（可省略引号，但带空格或特殊字符时必须加），值可以是任意类型。

$person = [
    'name' => '张三',
    'age'  => 28,
    'city' => '杭州'
];

echo $person['name']; // 输出：张三
echo $person['age'];  // 输出：28

注意：$person[name]（不加引号）会触发 Notice: Use of undefined constant name 错误，PHP 会把它当成常量去查，查不到就报错。务必写成 $person['name']。

遍历关联数组的三种常用方式

不能用 for ($i=0; $i，因为键不是连续数字。得用支持键值对的循环：

• foreach ($arr as $key => $value)：最常用，能同时拿到键和值
• foreach ($arr as $value)：只关心值，忽略键
• array_keys($arr) + foreach：需要单独处理键时用

$scores = ['math' => 92, 'english' => 87, 'science' => 95];

foreach ($scores as $subject => $score) {
    echo "$subject: $score\n";
}
// 输出：
// math: 92
// english: 87
// science: 95

修改、添加、删除元素的实际操作

关联数组是动态的，增删改都不需要重新声明：

• 添加/修改：$arr['new_key'] = 'value' 或 $arr['existing_key'] = 'new_value'
• 删除：unset($arr['key'])，注意这不是返回新数组，而是原地修改
• 检查键是否存在：isset($arr['key']) 或 array_key_exists('key', $arr)；区别在于 isset() 对 null 值返回 false，array_key_exists() 仍返回 true

$config = ['debug' => true, 'timezone' => 'Asia/Shanghai'];
$config['host'] = 'localhost';        // 添加
$config['debug'] = false;             // 修改
unset($config['timezone']);           // 删除

var_dump(isset($config['timezone']));           // bool(false)
var_dump(array_key_exists('host', $config));   // bool(true)

常见坑：JSON 转换和函数参数传递

关联数组转 JSON 是 json_encode() 的默认行为，但要注意：如果数组“看起来像索引数组”（键是连续数字 0,1,2…），PHP 会输出 JSON 数组 []；只要有一个非数字键或键不连续，就会输出 JSON 对象 {}。

传给函数时，PHP 默认按值传递数组，大数组可能影响性能；如需原地修改，得显式加 & 引用：

function addStatus(&$arr) {
    $arr['status'] = 'done';
}

$data = ['id' => 123];
addStatus($data);
var_dump($data); // ['id'=>123, 'status'=>'done'] —— 因为用了引用

没加 & 就只是副本修改，原数组不变。这个细节在写配置类或数据处理器时特别容易漏。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。