PHP 中的 `use` 关键字完全指南

? PHP 中的 use 关键字完全指南

---

❓ 你有没有误解过 use？

很多人初学 PHP 时，看到：

use AppModelsUser;

都会以为：

错！
use 根本不会加载任何文件！

那它到底是干什么的？我们来一步步讲清楚。

---

✅ use 只有两种用途

用法	场景	作用
1️⃣ 命名空间导入	文件顶部或类外	给类、接口、函数等“起外号”
2️⃣ 闭包变量导入	匿名函数中	让闭包能访问外部变量

---

一、use 在命名空间中：给类“起外号”

? 生活比喻：公司里的“花名”

假设你公司有两个人都叫“张伟”：

• 技术部张伟
• 财务部张伟

每次点名都要说“技术部的张伟”，太麻烦。

于是你规定：

这个“规定”，就是 PHP 中的 use。

---

? 代码示例

// 文件：src/Models/User.php
namespace AppModels;

class User {
    public function getName() {
        return "Lily";
    }
}

// 文件：src/Controllers/UserController.php
namespace AppControllers;

// ? 这不是加载文件！只是说：“以后我说 User，就是指 AppModelsUser”
use AppModelsUser;

class UserController {
    public function show() {
        $user = new User(); // ✅ 简洁！不用写全名
        echo $user->getName();
    }
}

---

? use 能导入什么？

类型	示例
类	use AppModelsUser;
接口	use AppContractsCacheable;
Trait	use IlluminateSupportArr;
函数（PHP 5.6+）	use function Helpersstr_upper;
常量（PHP 5.6+）	use const ConfigAPP_ENV;

还可以批量导入：

php
深色版本
use AppModels{User, Post, Comment};
use function Helpers{str_upper, str_lower};

---

? 解决命名冲突：用 as 起别名

use AppModelsUser;
use AdminModelsUser as AdminUser; // 给管理员用户起别名

$normalUser = new User();        // 普通用户
$adminUser  = new AdminUser();   // 管理员用户

---

⚠️ 常见误区

误区	正确认识
use 会加载文件	❌ 不会！靠 Composer 自动加载
use 可以写在 if 里	❌ 必须在文件顶层，编译时解析
use 可以导入整个文件夹	❌ 不支持 use AppModels*;

---

二、use 在闭包中：导入外部变量

? 生活比喻：快递员拿钥匙

你想让快递员把包裹放进你家，但门锁着。
你把钥匙交给快递员：“这是我钥匙，你用它开门。”

这个“交钥匙”的动作，就是闭包中的 use。

---

? 代码示例

$discount = 0.9; // 打9折

// 定义一个计算价格的“闭包”（匿名函数）
$calculateFinalPrice = function($price) use ($discount) {
    return $price * $discount; // 用到了外部的 $discount
};

echo $calculateFinalPrice(100); // 输出 90

---

? 传引用：让闭包修改外部变量

默认是“值传递”，修改不影响原变量：

$count = 0;

$increment = function() use ($count) {
    $count++; // ❌ 只改了副本
};

$increment();
echo $count; // 输出 0（没变）

要用 & 传引用：

$count = 0;

$increment = function() use (&$count) { // ? 加 &
    $count++;
};

$increment();
echo $count; // 输出 1（变了！）

---

? 多变量导入

$tax = 0.1;
$fee = 5;

$finalPrice = function($price) use ($tax, $fee) {
    return $price * (1 + $tax) + $fee;
};

echo $finalPrice(100); // 输出 115

---

三、特殊情况：类中 use Trait

你可能见过：

class User {
    use Logger; // ? 这也是 use！
}

这属于命名空间层面的 use，但语义是“引入代码块”（Trait），不是导入变量。

trait Logger {
    public function log($msg) {
        echo date('Y-m-d') . ": $msgn";
    }
}

class Order {
    use Logger; // 把 log() 方法“混入”到 Order 类中
}

$order = new Order();
$order->log("订单创建"); // 输出：2025-04-05: 订单创建

---

✅ 总结：use 的两种用法对比

场景	语法	作用	是否加载文件
命名空间导入	use AppModelsUser;	给类起别名，简化调用	❌ 否
闭包变量导入	function() use ($var) { }	让闭包访问外部变量	❌ 否
Trait 引入	class A { use T; }	组合代码块	❌ 否

---

? 一句话记住

真正的文件加载，靠的是 Composer 的自动加载机制。

---

? 复习口诀（背下来！）

---

? 建议收藏：下次看到 use，就问自己：

你一定能分得清！