PHP 네임스페이스

PHP 네임스페이스(네임스페이스)는 PHP 5.3에서 추가되었습니다. C#과 Java를 공부했다면 네임스페이스는 새로운 것이 아닙니다. 그러나 이는 PHP에서 여전히 매우 중요한 의미를 갖습니다.

PHP 네임스페이스는 다음 두 가지 유형의 문제를 해결할 수 있습니다.

사용자가 작성한 코드와 PHP 내부 클래스/함수/상수 또는 타사 클래스/함수/ 상수 이름 충돌.

매우 긴 식별자 이름(일반적으로 첫 번째 유형의 문제를 완화하기 위해 정의됨)에 대한 별칭(또는 짧은) 이름을 만들어 소스 코드의 가독성을 높입니다.

네임스페이스 정의

기본적으로 모든 상수, 클래스 및 함수 이름은 PHP가 네임스페이스를 지원하기 전과 마찬가지로 전역 공간에 배치됩니다.

스페이스 이름을 지정할 때 일반적으로 회사, 기업, 개인의 이름이나 약어를 식별자로 사용합니다. 첫 글자는 대문자여야 하며 숫자로 시작할 수 없습니다. 네임스페이스는 키워드 네임스페이스 문으로 식별됩니다. 파일에 네임스페이스가 포함되어 있으면 다른 모든 코드보다 먼저 네임스페이스를 선언해야 합니다. 구문 형식은 다음과 같습니다.

<?php

// 코드는 'MyProject' 네임스페이스
MyProject;에 정의되어 있습니다. .. code..

?>


다음과 같이 동일한 파일에 서로 다른 네임스페이스 코드를 정의할 수도 있습니다.

< ?php

namespace MyProject1;// MyProject1 네임스페이스의 PHP 코드
namespace MyProject2
// MyProject2 네임스페이스의 PHP 코드

// 또 다른 구문

namespace MyProject3 {
// MyProject3 네임스페이스의 PHP 코드

}

?>


네임스페이스를 선언하기 전의 코드는 소스 파일의 인코딩을 정의하는 선언문입니다. 공백을 포함하여 PHP가 아닌 코드는 네임스페이스 선언 앞에 나타날 수 없습니다.

<?php
declare(encoding='UTF-8'); //定义多个命名空间和不包含在命名空间中的代码 
namespace MyProject { 
const CONNECT_OK = 1; 
class Connection { /* ... */ } 
function connect() { /* ... */ } 
} 
namespace { // 全局代码 
session_start(); 
$a = MyProject\connect(); 
echo MyProject\Connection::start(); 
} 
?>

다음 코드에는 구문 오류가 있습니다.

<?php

namespace MyProject; 네임스페이스 html>"은 치명적인 오류를 발생시킵니다. 네임스페이스는 프로그램 스크립트

?>

하위 네임스페이스

의 첫 번째 문이어야 합니다. 하위 네임스페이스 선언은 다음과 같습니다. 이전 예와 똑같습니다. 유일한 차이점은 네임스페이스와 하위 네임스페이스를 구분하기 위해 기호를 추가한다는 것입니다. 하위 네임스페이스는 기능별로 명확하게 구분할 수 있는 한 어떤 수준으로도 나눌 수 있습니다.

<?php

namespace MyProjectSubLevel; //계층적 단일 네임스페이스 선언

const CONNECT_OK = 1;

class Connection { /* ... */ }

function Connect() { /* .. . */ }
}

?>

위의 예에서는 MyProjectSubLevelCONNECT_OK 상수, MyProjectSubLevelConnection 클래스 및 MyProjectSubLevelConnect 함수를 만듭니다.


네임스페이스 사용

PHP 네임스페이스의 클래스 이름은 세 가지 방법으로 참조할 수 있습니다.

정규화되지 않은 이름 또는 접두사가 없는 클래스 이름(예: $a=new foo(); 또는 foo::staticmethod();) 현재 네임스페이스가 currentnamespace이면 foo는 currentnamespacefoo로 확인됩니다. foo를 사용하는 코드가 전역 코드이고 어떤 네임스페이스에도 코드를 포함하지 않는 경우 foo는 foo로 확인됩니다. 경고: 네임스페이스의 함수 또는 상수가 정의되지 않은 경우 정규화되지 않은 함수 또는 상수 이름은 전역 함수 또는 상수 이름으로 확인됩니다.

정규화된 이름 또는 접두사가 포함된 이름(예: $a = new subnamespacefoo(); 또는 subnamespacefoo::staticmethod();) 현재 네임스페이스가 currentnamespace이면 foo는 currentnamespacesubnamespacefoo로 확인됩니다. foo를 사용하는 코드가 전역 코드인 경우, 어떤 네임스페이스에도 포함되지 않은 코드인 foo는 subnamespacefoo로 확인됩니다.

정규화된 이름 또는 전역 접두사 연산자가 포함된 이름(예: $a = new currentnamespacefoo(); 또는 currentnamespacefoo::staticmethod();). 이 경우 foo는 항상 코드에서 리터럴 이름 currentnamespacefoo로 확인됩니다.

다음은 이 세 가지 방법을 사용한 예입니다.

file1.php 파일 코드

<?php
namespace Foo\Bar\subnamespace; 
const FOO = 1; 
function foo() {} 
class foo 
{ 
static function staticmethod() {} 
} 
?>

file2.php 파일 코드

<?php
namespace Foo\Bar; 
include 'file1.php'; 
const FOO = 2; 
function foo() {} 
class foo 
{ 
static function staticmethod() {} 
} 
/* 非限定名称 */ 
foo(); // 解析为 Foo\Bar\foo resolves to function Foo\Bar\foo 
foo::staticmethod(); 
// 解析为类 Foo\Bar\foo的静态方法staticmethod。resolves to class Foo\Bar\foo, method staticmethod 
echo FOO; // resolves to constant Foo\Bar\FOO 
/* 限定名称 */ 
subnamespace\foo(); // 解析为函数 Foo\Bar\subnamespace\foo 
subnamespace\foo::staticmethod(); // 解析为类 Foo\Bar\subnamespace\foo, 
// 以及类的方法 staticmethod 
echo subnamespace\FOO; // 解析为常量 Foo\Bar\subnamespace\FOO 
/* 完全限定名称 */ 
\Foo\Bar\foo(); // 解析为函数 Foo\Bar\foo 
\Foo\Bar\foo::staticmethod(); // 解析为类 Foo\Bar\foo, 以及类的方法 staticmethod 
echo \Foo\Bar\FOO; // 解析为常量 Foo\Bar\FOO 
?>

주의하세요 전역 클래스, 함수 또는 상수에 액세스하려면 strlen(), Exception 또는 INI_ALL과 같은 정규화된 이름을 사용할 수 있습니다.

네임스페이스 내의 전역 클래스, 함수 및 상수에 액세스:

<?php
namespace Foo;
function strlen() {} 
const INI_ALL = 3; 
class Exception {} 
$a = \strlen('hi'); // 调用全局函数strlen 
$b = \INI_ALL; // 访问全局常量 INI_ALL
$c = new \Exception('error'); // 实例化全局类 Exception 
?>

네임스페이스 및 동적 언어 기능

PHP 네임스페이스 구현은 다음의 영향을 받습니다. 언어 자체의 역동적인 특성의 영향. 따라서 아래 코드를 네임스페이스로 변환하려면 해당 요소에 동적으로 액세스하세요.

example1.php 파일 코드:

<?php
class classname 
{ 
function __construct() 
{ 
echo __METHOD__,"\n"; 
} 
} 
function funcname() 
{ 
echo __FUNCTION__,"\n"; 
} 
const constname = "global"; 
$a = 'classname'; 
$obj = new $a; // prints classname::__construct 
$b = 'funcname'; 
$b(); // prints funcname 
echo constant('constname'), "\n"; // prints global 
?>

정규화된 이름(네임스페이스 접두사를 포함한 클래스 이름)을 사용해야 합니다. 동적 클래스 이름, 함수 이름 또는 상수 이름에서는 정규화된 이름과 정규화된 이름 사이에 차이가 없으므로 앞에 백슬래시가 필요하지 않습니다.

네임스페이스 요소에 대한 동적 액세스

<?php
namespace namespacename; 
class classname 
{ 
function __construct() 
{ 
echo __METHOD__,"\n"; 
} 
} 
function funcname() 
{ 
echo __FUNCTION__,"\n"; 
}
const constname = "namespaced"; 
include 'example1.php'; 
$a = 'classname'; 
$obj = new $a; // prints classname::__construct 
$b = 'funcname'; 
$b(); // prints funcname 
echo constant('constname'), "\n"; // prints global 
/* note that if using double quotes, " \namespacename\classname" must be used */ 
$a = '\namespacename\classname'; 
$obj = new $a; // prints namespacename\classname::__construct 
$a = 'namespacename\classname'; 
$obj = new $a; // also prints namespacename\classname::__construct 
$b = 'namespacename\funcname'; 
$b(); // prints namespacename\funcname 
$b = '\namespacename\funcname'; 
$b(); // also prints namespacename\funcname 
echo constant('\namespacename\constname'), "\n"; // prints namespaced 
echo constant('namespacename\constname'), "\n"; // also prints namespaced 
?>

네임스페이스 키워드 및 __NAMESPACE__ 상수

PHP는 현재 네임스페이스 요소 메서드의 내부에 액세스하기 위해 두 가지 추상화를 지원합니다. __NAMESPACE__ 매직 상수 및 네임스페이스 키워드.

상수 __NAMESPACE__의 값은 현재 네임스페이스의 이름을 포함하는 문자열입니다. 네임스페이스에 포함되지 않은 전역 코드에는 빈 문자열이 포함됩니다.

__NAMESPACE__ 예, 네임스페이스의 코드

<?php

namespace MyProject;

echo '"' , __NAMESPACE__, '"'; // "MyProject" 출력

?>

__NAMESPACE__ 예시, 전역 코드

<?php

echo '"', __NAMESPACE__, '"'; // "" 출력

?>

상수 __NAMESPACE__는 이름을 동적으로 생성할 때 유용합니다. 예:

__NAMESPACE__를 사용하여 동적으로 이름 만들기

<?php

네임스페이스 MyProject;

function get($classname)
{
$a = __NAMESPACE__
return new $a
}

?>

키워드 네임스페이스를 사용하여 현재 네임스페이스 또는 하위 네임스페이스의 요소에 명시적으로 액세스할 수 있습니다. 클래스의 self 연산자와 동일합니다.

네임스페이스 연산자, 네임스페이스의 코드

<?php
namespace MyProject; 
use blah\blah as mine; // see "Using namespaces: importing/aliasing" 
blah\mine(); // calls function blah\blah\mine() 
namespace\blah\mine(); // calls function MyProject\blah\mine() 
namespace\func(); // calls function MyProject\func() 
namespace\sub\func(); // calls function MyProject\sub\func() 
namespace\cname::method(); // calls static method "method" of class MyProject\cname 
$a = new namespace\sub\cname(); // instantiates object of class MyProject\sub\cname 
$b = namespace\CONSTANT; // assigns value of constant MyProject\CONSTANT to $b 
?>

네임스페이스 연산자, 전역 코드

<?php
namespace\func(); // calls function func() 
namespace\sub\func(); // calls function sub\func() 
namespace\cname::method(); // calls static method "method" of class cname 
$a = new namespace\sub\cname(); // instantiates object of class sub\cname 
$b = namespace\CONSTANT; // assigns value of constant CONSTANT to $b 
?>

네임스페이스 사용: alias/import

PHP 네임스페이스는 별칭 또는 가져오기를 사용하는 두 가지 방법, 즉 클래스 이름에 별칭을 사용하거나 네임스페이스 이름에 별칭을 사용하는 방법을 지원합니다. PHP는 가져온 함수나 상수를 지원하지 않습니다.

PHP에서 별칭은 연산자 사용을 통해 구현됩니다. 다음은 가능한 세 가지 가져오기 방법을 모두 사용하는 예입니다.

1 별칭을 가져오거나 사용하려면 사용 연산자를 사용하세요.

<?php
namespace foo; 
use My\Full\Classname as Another; 
// 下面的例子与 use My\Full\NSname as NSname 相同 
use My\Full\NSname; 
// 导入一个全局类 
use \ArrayObject; 
$obj = new namespace\Another; // 实例化 foo\Another 对象 
$obj = new Another; // 实例化 My\Full\Classname　对象 
NSname\subns\func(); // 调用函数 My\Full\NSname\subns\func 
$a = new ArrayObject(array(1)); // 实例化 ArrayObject 对象 
// 如果不使用 "use \ArrayObject" ，则实例化一个 foo\ArrayObject 对象 
?>

2. 한 줄에 여러 개의 use 문이 포함되어 있습니다.

<?php
use My\Full\Classname as Another, My\Full\NSname; 
$obj = new Another; // 实例化 My\Full\Classname 对象 
NSname\subns\func(); // 调用函数 My\Full\NSname\subns\func 
?>

컴파일 중에 가져오기 작업이 실행되지만 동적 클래스 이름, 함수 이름 또는 상수 이름은 실행되지 않습니다.

3. 가져오기 및 동적 이름

<?php
use My\Full\Classname as Another, My\Full\NSname; 
$obj = new Another; // 实例化一个 My\Full\Classname 对象 
$a = 'Another'; 
$obj = new $a; // 实际化一个 Another 对象 
?>

또한 가져오기 작업은 정규화되지 않은 이름과 정규화된 이름에만 영향을 미칩니다. 정규화된 이름은 결정적이므로 가져오기의 영향을 받지 않습니다.

4. 가져오기 및 정규화된 이름

<?php
use My\Full\Classname as Another, My\Full\NSname; 
$obj = new Another; // 实例化对象的类 My\Full\Classname 
$obj = new \Another; // instantiates object of class Another 
$obj = new Another\thing; // 实例化对象的类 My\Full\Classname\thing 
$obj = new \Another\thing; // instantiates object of class Another\thing 
?>

사용 키워드 사용법:

은 PHP 파일의 맨 위에 있어야 합니다. 즉, PHP < ?php 또는 네임스페이스 선언 다음에는 코드를 가져오기 위한 use 키워드가 옵니다.

use 키워드를 사용하여 코드를 가져올 때 PHP는 가져온 네임스페이스가 정규화된 것으로 가정하므로 클래스 이름 시작 부분에 기호를 추가할 필요가 없습니다.

use 키워드는 전역 범위에서 사용해야 합니다. 즉, 클래스나 함수에서는 사용할 수 없습니다.

use 키워드는 네임스페이스 선언 아래에 배치할 수 있습니다. 다른 네임스페이스의 코드.

네임스페이스 사용: 대체 전역 함수/상수

네임스페이스에서 PHP가 정규화되지 않은 클래스, 함수 또는 상수 이름을 발견하면 다른 우선 순위 전략을 사용하여 다음을 수행합니다. 이름을 해결하세요. 클래스 이름은 항상 현재 네임스페이스의 이름으로 확인됩니다. 따라서 시스템 내부 또는 네임스페이스에 포함되지 않은 클래스 이름에 액세스하는 경우 다음과 같이 정규화된 이름을 사용해야 합니다.

1. 네임스페이스

<?php
namespace A\B\C; 
class Exception extends \Exception {} 
$a = new Exception('hi'); // $a 是类 A\B\C\Exception 的一个对象 
$b = new \Exception('hi'); // $b 是类 Exception 的一个对象 
$c = new ArrayObject; // 致命错误, 找不到 A\B\C\ArrayObject 类 
?>

의 전역 클래스에 액세스합니다. 상수의 경우 함수나 상수가 현재 네임스페이스에 존재하지 않으면 PHP는 전역 공간의 함수나 상수를 사용하게 됩니다.

2. 네임스페이스에 전역 함수/상수 백업

<?php
namespace A\B\C; 
const E_ERROR = 45; 
function strlen($str) 
{ 
return \strlen($str) - 1; 
} 
echo E_ERROR, "\n"; // 输出 "45" 
echo INI_ALL, "\n"; // 输出 "7" - 使用全局常量 INI_ALL 
echo strlen('hi'), "\n"; // 输出 "1" 
if (is_array('hi')) { // 输出 "is not array" 
echo "is array\n"; 
} else { 
echo "is not array\n"; 
} ?>

전역 공간

네임스페이스가 정의되지 않으면 모든 클래스와 함수가 전역적으로 정의됩니다. PHP에 네임스페이스 개념이 도입되기 전이었습니다. 이름 접두어는 이름이 다른 네임스페이스에 있더라도 이름이 전역 공간에 있음을 나타냅니다.

전역 공간 사용 지침

전역 네임스페이스를 사용하려면 클래스 이름 앞에 기호만 추가하면 됩니다. 예: throw new Exception();

<?php
namespace A\B\C; 
/* 这个函数是 A\B\C\fopen */ 
function fopen() { 
/* ... */ 
$f = \fopen(...); // 调用全局的fopen函数 
return $f; 
?>

네임스페이스 순서

네임스페이스 도입 이후 가장 오류가 발생하기 쉬운 것은 클래스를 사용할 때 이 클래스에 대한 검색 경로가 무엇인지입니다.

<?php

네임스페이스 A;
BD, CE를 F로 사용

// 함수 호출

foo(); / 먼저 네임스페이스 "A"에 정의된 foo() 함수를 호출해 보세요.
// 그런 다음 전역 함수 "foo"를 호출해 보세요.

foo() // 전역 공간 함수 호출 " foo"

myfoo(); // "Amy" 네임스페이스에 정의된 "foo" 함수 호출

F(); // 먼저 "Amy" 네임스페이스에 정의된 함수 호출을 시도합니다. A" F"

// 전역 함수 "F"를 다시 호출해 보세요.

// 클래스 참조

new B() // 정의된 네임스페이스를 만듭니다. 네임스페이스 "A" 클래스 "B"의 객체
// 찾을 수 없는 경우 클래스 "AB" 자동 로드를 시도합니다.

new D() // 가져오기 규칙을 사용하여 네임스페이스에 정의된 객체를 생성합니다. "B" 클래스 "D"의 객체
// 찾을 수 없는 경우 클래스 "BD" 자동 로드를 시도합니다.

new F() // 가져오기 규칙을 사용하여 네임스페이스에 정의된 객체를 생성합니다. C" 클래스 "E"의 객체
// 찾을 수 없으면 클래스 "CE" 자동 로드를 시도합니다.

new B(); // 전역 변수에 정의된 클래스 "B"의 객체를 생성합니다. space Object
// 찾을 수 없으면 클래스 "B"를 자동으로 로드합니다.

new D() // 전역 공간에 정의된 클래스 "D"의 개체를 만듭니다.
// 찾을 수 없으면 클래스 "D"를 자동으로 로드합니다.

new F(); // 전역 공간에 정의된 클래스 "F"의 개체를 만듭니다.
// 찾을 수 없으면 클래스 자동 로드를 시도합니다. "F"

// 다른 네임스페이스에서 정적 메서드 또는 네임스페이스 함수 호출

Bfoo() // "AB" 네임스페이스에서 "foo" 함수 호출

B ::foo(); // "A" 네임스페이스에 정의된 "B" 클래스의 "foo" 메서드를 호출합니다.
// "AB" 클래스가 없으면 자동으로 로드를 시도합니다. "AB" 클래스

D::foo(); // 가져오기 규칙을 사용하여 네임스페이스 "B"에 정의된 클래스 "D"의 "foo" 메서드를 호출합니다.
// 클래스 "BD"가 없으면 다음을 시도합니다. "BD" 클래스를 자동으로 로드합니다.

Bfoo(); // "B" 네임스페이스에서 "foo" 함수를 호출합니다.

B::foo(); 전역 공간에서 "B" 클래스의 " 메서드
// "B" 클래스를 찾을 수 없으면 "B" 클래스를 자동으로 로드하려고 합니다.

// 현재 네임스페이스에서 정적 메서드 또는 함수

AB::foo(); // "AA" 네임스페이스에 정의된 "B" 클래스의 "foo" 메서드를 호출합니다.
// "AAB" 클래스가 없으면 "AAB" 클래스를 자동 로드해 보세요. AAB"

AB::foo(); // "AB" 네임스페이스에 정의된 "B" 클래스의 "foo" 메서드 호출
// "AB" 클래스가 없으면 자동으로 "AB" 클래스 로드를 시도합니다.

?>

이름 확인은 다음 규칙을 따릅니다.

1. 정규화된 이름을 가진 함수, 클래스 및 상수에 대한 호출은 컴파일 타임에 확인됩니다. 예를 들어 새 AB는 클래스 AB로 확인됩니다.

2. 모든 정규화되지 않은 이름과 정규화된 이름(정규화되지 않은 이름)은 현재 가져오기 규칙에 따라 컴파일 타임에 변환됩니다. 예를 들어 네임스페이스 ABC를 C로 가져온 경우 CDe()에 대한 호출은 ABCDe()로 변환됩니다.

3. 네임스페이스 내에서 가져오기 규칙에 따라 변환되지 않은 모든 정규화된 이름 앞에는 현재 네임스페이스 이름이 옵니다. 예를 들어, CDe()가 네임스페이스 AB 내에서 호출되면 CDe()는 ABCDe()로 변환됩니다.

4. 정규화되지 않은 클래스 이름은 현재 가져오기 규칙에 따라 컴파일 타임에 변환됩니다(짧은 가져오기 이름 대신 전체 이름이 사용됨). 예를 들어 네임스페이스 ABC를 C로 가져온 경우 new C()는 new ABC()로 변환됩니다.

5. 네임스페이스(예: AB) 내에서 정규화되지 않은 이름에 대한 함수 호출은 런타임에 해결됩니다. 예를 들어 foo() 함수에 대한 호출은 다음과 같이 구문 분석됩니다.

현재 네임스페이스에서 ABfoo()라는 함수를 찾습니다.

전역 공간 foo에서 함수를 찾아 호출해 보세요. ().

6. 네임스페이스(예: AB) 내에서 정규화되지 않은 이름 또는 정규화된 이름 클래스(완전히 정규화되지 않은 이름)에 대한 호출은 런타임에 해결됩니다. new C()와 new DE()를 호출하는 파싱 과정은 다음과 같다. new C() 파싱: new DE() 파싱: 글로벌 네임스페이스에서 글로벌 클래스를 참조하기 위해 정규화된 이름인 new C()를 사용해야 합니다.

클래스 이름 앞에 현재 네임스페이스 이름을 추가하여 ABDE가 되도록 한 다음 클래스를 검색합니다.

ABDE 클래스를 자동 로드해 보세요.

현재 네임스페이스에서 ABC 클래스를 찾습니다.

ABC 클래스를 자동 로드해 보세요.

다음 섹션