萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 命名空間完整指南:定義、使用、別名與動態調用

PHP 命名空間核心概念與實戰技巧

命名空間解決類別/函數/常量命名衝突,並提供別名機制縮短代碼。PHP 5.3+ 正式支援,現代框架(Laravel、Symfony)皆大量使用。

1. 定義命名空間

<?php
// 必須是檔案第一個非 declare 語句,前面不能有任何輸出(含空白)
namespace MyProject;

const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
  • 同一命名空間可分散在多檔案(同 namespace MyProject; 開頭)
  • 單檔案可定義多個命名空間(用大括號或連續宣告),**不建議**
  • 全域空間寫法:namespace { ... }

2. 三種引用方式

方式語法解析規則例子
非限定名稱Foo::bar()當前命名空間下namespace A; Foo::bar() → A\Foo::bar()
限定名稱Sub\Foo::bar()相對於當前命名空間namespace A; Sub\Foo → A\Sub\Foo
完全限定名稱\Foo::bar()絕對路徑(全域空間)namespace A; \Foo → Foo

3. 函數/常量的後備機制

namespace MyApp;
strlen('abc'); // 1. 找 MyApp\strlen → 2. 找全域 \strlen
echo FOO;      // 1. 找 MyApp\FOO → 2. 找全域 FOO

類別**無後備機制**:new Foo() 只找 MyApp\Foo,找不到觸發 __autoload。

4. 導入與別名

namespace MyApp;
use Other\Long\Namespace\ClassName as ShortName;
use Other\Ns2; // 等同 use Other\Ns2 as Ns2;
use function Other\funcName;
use const Other\CONST_NAME;

new ShortName(); // 實際為 Other\Long\Namespace\ClassName

5. 動態命名空間調用

namespace MyApp;
$class = 'Foo';
new $class(); // 解析為 Foo(全域),非 MyApp\Foo

$class = 'MyApp\Foo'; // 或 '\MyApp\Foo'
new $class(); // 正確解析

// 雙引號字串需雙重轉義
$ns = \"MyApp\\Sub\";
new $ns.'Foo'();

6. 實戰技巧

  • **目錄結構對應命名空間**:src/Controller/UserController.php → namespace App\Controller;
  • **Composer PSR-4 自動載入**:「vendor/autoload.php」自動對應,無需手動 include
  • **避免在非類別檔案使用命名空間**(如獨立腳本),除非有衝突風險
copyright © 萬盛學電腦網 all rights reserved