解決類名、函數名、常量名衝突,組織代碼結構,實現模塊化開發。PHP 5.3 引入,現代框架 (Laravel, Symfony) 基石。
| 術語 | 定義 | 示例 |
|---|---|---|
| 完全限定名稱 | 以 \ 開頭,全局唯一 | \App\Models\User |
| 限定名稱 | 包含命名空間分隔符,相對當前命名空間 | Models\User (在 App 命名空間下) |
| 非限定名稱 | 無分隔符,相對當前命名空間 | User (在 App\Models 下指 App\Models\User) |
<?php
// 必須是文件第一條語句 (除 declare 外)
namespace App\Lib1;
const MYCONST = 'AppLib1_CONST';
function myFunction() { return __FUNCTION__; }
class MyClass {
public static function whoAmI() { return __METHOD__; }
}
?>
<?php
namespace App\Lib1;
require_once 'lib1.php';
require_once 'lib2.php'; // 定義了 App\Lib2
echo MYCONST; // App\Lib1\MYCONST
echo myFunction(); // App\Lib1\myFunction
echo MyClass::whoAmI(); // App\Lib1\MyClass::whoAmI
?>
<?php
// 導入類
use App\Lib2\MyClass;
use App\Lib2\MyClass as Lib2Class; // 別名
// 導入函數 (PHP 5.6+)
use function App\Lib2\myFunction;
use function App\Lib2\myFunction as lib2Func;
// 導入常量 (PHP 5.6+)
use const App\Lib2\MYCONST;
require_once 'lib1.php';
require_once 'lib2.php';
$obj = new MyClass(); // App\Lib2\MyClass
$obj2 = new Lib2Class(); // 別名
echo myFunction(); // App\Lib2\myFunction
echo lib2Func(); // 別名函數
echo MYCONST; // App\Lib2\MYCONST
?>
<?php
use App\Lib2\{MyClass, MyInterface, MyTrait};
use function App\Lib2\{func1, func2, func3};
use const App\Lib2\{CONST1, CONST2, CONST3};
?>
use 導入規則編譯時轉換。new $class 動態實例化時,$class 必須是完全限定名稱。<?php
namespace App\Lib1;
echo __NAMESPACE__; // "App\Lib1"
// 動態實例化
$class = __NAMESPACE__ . '\MyClass';
$obj = new $class(); // 等同 new App\Lib1\MyClass()
?>
<?php
namespace App\Lib1;
class MyClass {}
$obj = new namespace\MyClass(); // 等同 new App\Lib1\MyClass()
// 類似類內的 self 關鍵字
?>
// composer.json
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}
// 運行 composer dump-autoload
// src/Lib1/MyClass.php
<?php
spl_autoload_register(function (string $class) {
$prefix = 'App\\';
$baseDir = __DIR__ . '/src/';
$len = strlen($prefix);
if (strncmp($prefix, $class, $len) !== 0) return;
$relativeClass = substr($class, $len);
$file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
if (file_exists($file)) {
require $file;
}
});
?>
<?php
namespace App\Lib1;
function strlen($str) { return 'custom'; }
echo strlen('test'); // 'custom' (當前命名空間)
echo \strlen('test'); // 4 (全局內置函數)
echo \Exception::class; // 'Exception' (全局類)
?>
<?php
namespace App;
$class = 'Lib1\MyClass';
$obj = new $class(); // 正常
$func = 'Lib1\myFunction';
$func(); // 正常
// 但在字符串拼接時需注意轉義
$class = __NAMESPACE__ . '\MyClass'; // 正確
// $class = "App\MyClass"; // 錯誤!\M 被解析為換頁符,需雙反斜線 "App\\MyClass"
?>
<?php
namespace App\Traits;
trait Loggable { public function log($msg) { echo $msg; } }
namespace App\Models;
use App\Traits\Loggable;
class User { use Loggable; }
$u = new User(); $u->log('hello');
?>
namespace,對應目錄結構 (PSR-4)。use 導入外部類/函數/常量,頂部集中管理依賴。App\Http\Controllers)。require。命名空間是現代 PHP 專業開發的基礎設施。掌握聲明、導入、別名、解析規則、自動加載機制,配合 PSR-4 與 Composer,能構建清晰、可維護、無衝突的大型應用架構。