本文详细讲解在 PHP 多文件项目中（如 file1.php 与 functions.php 分离）如何安全、正确地将数组作为参数传入自定义函数，并解决因参数顺序错误、变量作用域或语法疏漏导致的 NULL 值问题。
本文详细讲解在 php 多文件项目中（如 `file1.php` 与 `functions.php` 分离）如何安全、正确地将数组作为参数传入自定义函数，并解决因参数顺序错误、变量作用域或语法疏漏导致的 `null` 值问题。
在 PHP 开发中，跨文件传递数组是常见需求，但初学者常因参数顺序、变量定义时机或语法错误导致接收端得到 NULL。以你的场景为例：file1.php 中构造了 $idsArr = ['1', '2', '3', '4']，调用 calculate_users($year, $idsArr)；而 functions.php 中函数签名却为 function calculate_users($idsArr, $year) —— 参数顺序不匹配是首要原因：你传入的是 ($year, $idsArr)，但函数期望 ($idsArr, $year)，导致 $idsArr 实际接收到 $year 的值（可能未定义或为空），从而 var_dump($idsArr) 输出 NULL。
✅ 正确做法是保持调用与声明的参数顺序严格一致。推荐修改如下：
file1.php（调用端）：
if ($_GET['page'] === 'index') {
if ($user_id) {
$idsArr = ['1', '2', '3', '4'];
$year = date('Y'); // 示例：确保 $year 已定义
$users = calculate_users($idsArr, $year); // ✅ 先数组，后 year
$smarty->assign('users', $users);
}
}functions.php（定义端）：
立即学习“PHP免费学习笔记（深入）”；
function calculate_users($idsArr, $year) {
global $DB;
$results = []; // 用于收集查询结果
// ✅ 关键修复：循环中使用 $ids（当前元素），而非未定义的 ids
foreach ($idsArr as $id) {
$st = $DB->prepare('SELECT * FROM users WHERE id = ?');
$st->execute([$id]); // ✅ 注意：execute() 需传入数组，且变量名正确（$id，非 ids）
$user = $st->fetch();
if ($user) {
$results[] = $user;
}
}
return $results; // ✅ 别忘了返回结果供模板使用
}⚠️ 其他关键注意事项：
- 确保 functions.php 已被正确引入：在 file1.php 顶部添加 require_once 'functions.php'; 或通过自动加载机制包含。
- 避免 global $DB 的隐式依赖：更健壮的方式是将数据库连接作为参数注入，或使用依赖注入容器。
- SQL 安全性：当前单条查询效率较低，若 ID 数量大，建议改用 WHERE id IN (?, ?, ?) 预处理批量查询（需动态绑定参数）。
- 错误处理：生产环境应检查 $st->execute() 是否成功，并捕获 PDOException。
总结：传递数组本身无特殊限制，核心在于参数顺序一致性、变量命名准确性、执行上下文完整性及返回值明确性。调试时优先 var_dump(get_defined_vars()) 检查函数内各参数实际值，可快速定位 NULL 根源。
