cvs: phpdoc-zh /language namespaces.xml
| From: | Gang Chen | Date: | Sat, 13 Dec 2008 06:48:33 +0000 |
| Subject: | cvs: phpdoc-zh /language namespaces.xml | ||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-3053@lists.php.net to get a copy of this message | ||
eniac2008 Sat Dec 13 06:48:33 2008 UTC
Added files:
/phpdoc-zh/language namespaces.xml
Log:
New File
http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/namespaces.xml?view=markup&rev=1.1 Index: phpdoc-zh/language/namespaces.xml +++ phpdoc-zh/language/namespaces.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- $Author: eniac2008 $ --> <!-- EN-Revision: 1.9 Maintainer: Altair Status: ready --> <chapter xml:id="language.namespaces" xmlns="http://docbook.org/ns/docbook" version="1.1"> <title>å½å空é´</title> <sect1 xml:id="language.namespaces.rationale"> <title>å½åç©ºé´æ¦è¿°</title> <simpara> ä»ä¹æ¯å½å空é´ï¼ä»å¹¿ä¹ä¸æ¥è¯´ï¼å½åç©ºé´æ¯ä¸ç§å°è£ äºç©çæ¹æ³ãå¨å¾å¤å°æ¹é½å¯ä»¥è§å°è¿ç§æ½è±¡æ¦å¿µãä¾å¦ï¼å¨æä½ç³»ç»ä¸ç®å½ç¨æ¥å°ç¸å ³æä»¶åç»ï¼å¯¹äºç®å½ä¸çæä»¶æ¥è¯´ï¼å®å°±æ®æ¼äºå½å空é´çè§è²ãå ·ä½ä¸¾ä¸ªä¾åï¼æä»¶ <literal>foo.txt</literal> å¯ä»¥åæ¶å¨ç®å½<literal>/home/greg</literal> å <literal>/home/other</literal> ä¸åå¨ï¼ä½å¨åä¸ä¸ªç®å½ä¸ä¸è½åå¨ä¸¤ä¸ª <literal>foo.txt</literal> æä»¶ãå¦å¤ï¼å¨ç®å½ <literal>/home/greg</literal> å¤è®¿é® <literal>foo.txt</literal> æä»¶æ¶ï¼æä»¬å¿ é¡»å°ç®å½å以åç®å½åé符æ¾å¨æä»¶åä¹åå¾å° <literal>/home/greg/foo.txt</literal>ãè¿ä¸ªåçåºç¨å°ç¨åºè®¾è®¡é¢åå°±æ¯å½å空é´çæ¦å¿µã </simpara> <simpara> å¨PHPä¸ï¼å½å空é´ç¨æ¥è§£å³å¨ç¼åç±»åºæåºç¨ç¨åºæ¶å建å¯éç¨ç代ç å¦ç±»æå½æ°æ¶ç¢°å°ç两类é®é¢ï¼ In the PHP world, namespaces are designed to solve two problems that authors of libraries and applications encounter when creating re-usable code elements such as classes or functions: </simpara> <para> <orderedlist> <listitem> <simpara> ç¨æ·ç¼åç代ç ä¸PHPå é¨çç±»/彿°/常éæç¬¬ä¸æ¹ç±»/彿°/常éä¹é´çååå²çªã </simpara> </listitem> <listitem> <simpara> 为å¾é¿çæ è¯ç¬¦åç§°(é常æ¯ä¸ºäºç¼è§£ç¬¬ä¸ç±»é®é¢èå®ä¹ç)å建ä¸ä¸ªå«åï¼æç®çï¼çåç§°ï¼æé«æºä»£ç çå¯è¯»æ§ã </simpara> </listitem> </orderedlist> </para> <simpara> PHP å½åç©ºé´æä¾äºä¸ç§å°ç¸å ³çç±»ã彿°å常éç»åå°ä¸èµ·çéå¾ãä¸é¢æ¯ä¸ä¸ªè¯´æ PHP å½å空é´è¯æ³ç示ä¾ï¼ </simpara> <example> <title>å½å空é´è¯æ³ç¤ºä¾</title> <programlisting role="php"> <![CDATA[ <?php namespace my\name; // åè "å®ä¹å½å空é´" å°è class MyClass {} function myfunction() {} const MYCONST = 1; $a = new MyClass; $c = new \my\name\MyClass; // åè "å ¨å±ç©ºé´" å°è $a = strlen('hi'); // åè "使ç¨å½å空é´ï¼åå¤å ¨å±å½æ°/常é" å°è $d = namespace\MYCONST; // åè "namespaceæä½ç¬¦å__NAMESPACE__常éâ å°è $d = __NAMESPACE__ . '\MYCONST'; echo constant($d); // åè "å½å空é´å卿è¯è¨ç¹å¾" å°è ?> ]]> </programlisting> </example> <simpara> PHP å¨ 5.3.0 以åççæ¬å¼å§æ¯æå½å空é´ã </simpara> </sect1> <sect1 xml:id="language.namespaces.definition"> <title>å®ä¹å½å空é´</title> <para> è½ç¶ä»»æåæ³çPHP代ç é½å¯ä»¥å å«å¨å½å空é´ä¸ï¼ä½åªæä¸ç§ç±»åç代ç åå½å空é´çå½±åï¼å®ä»¬æ¯ï¼ç±»ï¼å½æ°å常éã </para> <para> å½å空é´éè¿å ³é®å<literal>namespace</literal> æ¥å£°æã妿ä¸ä¸ªæä»¶ä¸å å«å½å空é´ï¼å®å¿ é¡»å¨å ¶å®ææä»£ç ä¹å声æå½å空é´ã <example> <title>声æå个å½å空é´</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } ?> ]]> </programlisting> </example> å¨å£°æå½å空é´ä¹åå¯ä¸åæ³çä»£ç æ¯ç¨äºå®ä¹æºæä»¶ç¼ç æ¹å¼ç <literal>declare</literal> è¯å¥ãå¦å¤ï¼ææé PHP 代ç å æ¬ç©ºç½ç¬¦é½ä¸è½åºç°å¨å½å空é´ç声æä¹åï¼ <example> <title>声æå个å½å空é´</title> <programlisting role="php"> <![CDATA[ <html> <?php namespace MyProject; // è´å½é误 -ãå½å空é´å¿ é¡»æ¯ç¨åºèæ¬çç¬¬ä¸æ¡è¯å¥ ?> ]]> </programlisting> </example> </para> <para> å¦å¤ï¼ä¸PHPå ¶å®çè¯è¨ç¹å¾ä¸åï¼åä¸ä¸ªå½å空é´å¯ä»¥å®ä¹å¨å¤ä¸ªæä»¶ä¸ï¼å³å 许å°åä¸ä¸ªå½å空é´çå 容åå²åæ¾å¨ä¸åçæä»¶ä¸ã </para> </sect1> <sect1 xml:id="language.namespaces.nested"> <title>å®ä¹åå½å空é´</title> <para> ä¸ç®å½åæä»¶çå ³ç³»å¾è±¡ï¼PHP å½å空é´ä¹å 许æå®å±æ¬¡åçå½å空é´çåç§°ãå æ¤ï¼å½å空é´çååå¯ä»¥ä½¿ç¨å屿¬¡çæ¹å¼å®ä¹ï¼ <example> <title>声æå屿¬¡çå个å½å空é´</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject\Sub\Level; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } ?> ]]> </programlisting> </example> ä¸é¢çä¾åå建äºå¸¸é<literal>MyProject\Sub\Level\CONNECT_OK</literal>ï¼ç±» <literal>MyProject\Sub\Level\Connection</literal>å彿° <literal>MyProject\Sub\Level\Connection</literal>ã </para> </sect1> <sect1 xml:id="language.namespaces.definitionmultiple"> <title>å¨åä¸ä¸ªæä»¶ä¸å®ä¹å¤ä¸ªå½å空é´</title> <para> ä¹å¯ä»¥å¨åä¸ä¸ªæä»¶ä¸å®ä¹å¤ä¸ªå½å空é´ãå¨åä¸ä¸ªæä»¶ä¸å®ä¹å¤ä¸ªå½åç©ºé´æä¸¤ç§è¯æ³å½¢å¼ã </para> <para> <example> <title>å®ä¹å¤ä¸ªå½å空é´ï¼ç®åç»åè¯æ³</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } namespace AnotherProject; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } ?> ]]> </programlisting> </example> </para> <para> ä¸å»ºè®®ä½¿ç¨è¿ç§è¯æ³å¨å个æä»¶ä¸å®ä¹å¤ä¸ªå½å空é´ã建议使ç¨ä¸é¢ç大æ¬å·å½¢å¼çè¯æ³ã </para> <para> <example> <title>å®ä¹å¤ä¸ªå½å空é´ï¼å¤§æ¬å·è¯æ³</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject { const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } } namespace AnotherProject { const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } } ?> ]]> </programlisting> </example> </para> <para> å¨å®é çç¼ç¨å®è·µä¸ï¼é叏䏿å¡å¨åä¸ä¸ªæä»¶ä¸å®ä¹å¤ä¸ªå½å空é´ãè¿ç§æ¹å¼ç主è¦ç¨äºå°å¤ä¸ª PHP èæ¬åå¹¶å¨åä¸ä¸ªæä»¶ä¸ã </para> <para> å°å ¨å±çéå½å空é´ä¸ç代ç ä¸å½å空é´ä¸ç代ç ç»åå¨ä¸èµ·ï¼åªè½ä½¿ç¨å¤§æ¬å·å½¢å¼çè¯æ³ãå ¨å±ä»£ç å¿ é¡»ç¨ä¸ä¸ªä¸å¸¦åç§°ç namespace è¯å¥å ä¸å¤§æ¬å·æ¬èµ·æ¥ï¼ä¾å¦ï¼ <example> <title>å®ä¹å¤ä¸ªå½å空é´åä¸å å«å¨å½å空é´ä¸ç代ç </title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject { const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } } namespace { // global code session_start(); $a = MyProject\connect(); echo MyProject\Connection::start(); } ?> ]]> </programlisting> </example> </para> <para> é¤äºå¼å§çdeclareè¯å¥å¤ï¼å½å空é´çæ¬å·å¤ä¸å¾æä»»ä½PHP代ç ã <example> <title>å®ä¹å¤ä¸ªå½å空é´åä¸å å«å¨å½å空é´ä¸ç代ç </title> <programlisting role="php"> <![CDATA[ <?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(); } ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.basics"> <title>使ç¨å½å空é´ï¼åºç¡</title> <para> å¨è®¨è®ºå¦ä½ä½¿ç¨å½å空é´ä¹åï¼å¿ é¡»äºè§£ PHP æ¯å¦ä½ç¥éè¦ä½¿ç¨åªä¸ä¸ªå½å空é´ä¸çå ç´ çãå¯ä»¥å° PHP å½å空é´ä¸æä»¶ç³»ç»ä½ä¸ä¸ªç®åçç±»æ¯ãå¨æä»¶ç³»ç»ä¸è®¿é®ä¸ä¸ªæä»¶æä¸ç§æ¹å¼ï¼ <orderedlist> <listitem> <simpara> ç¸å¯¹æä»¶åå½¢å¼å¦<literal>foo.txt</literal>ãå®ä¼è¢«è§£æä¸º <literal>currentdirectory/foo.txt</literal>ï¼å ¶ä¸ currentdirectory 表示å½åç®å½ãå æ¤å¦æå½åç®å½æ¯ <literal>/home/foo</literal>ï¼å该æä»¶å被解æä¸º<literal>/home/foo/foo.txt</literal>ã </simpara> </listitem> <listitem> <simpara> ç¸å¯¹è·¯å¾åå½¢å¼å¦<literal>subdirectory/foo.txt</literal>ãå®ä¼è¢«è§£æä¸º <literal>currentdirectory/subdirectory/foo.txt</literal>ã </simpara> </listitem> <listitem> <simpara> ç»å¯¹è·¯å¾åå½¢å¼å¦<literal>/main/foo.txt</literal>ãå®ä¼è¢«è§£æä¸º<literal>/main/foo.txt</literal>ã </simpara> </listitem> </orderedlist> PHP å½å空é´ä¸çå ç´ ä½¿ç¨åæ ·çåçãä¾å¦ï¼ç±»åå¯ä»¥éè¿ä¸ç§æ¹å¼å¼ç¨ï¼ <orderedlist> <listitem> <simpara> ééå®åç§°ï¼æä¸å å«åç¼çç±»åç§°ï¼ä¾å¦ <literal>$a=new foo();</literal> æ <literal>foo::staticmethod();</literal>ã妿å½åå½åç©ºé´æ¯ <literal>currentnamespace</literal>ï¼foo å°è¢«è§£æä¸º <literal>currentnamespace\foo</literal>ãå¦æä½¿ç¨ foo çä»£ç æ¯å ¨å±çï¼ä¸å å«å¨ä»»ä½å½å空é´ä¸ç代ç ï¼å foo ä¼è¢«è§£æä¸º<literal>foo</literal>ã </simpara> <simpara> è¦åï¼å¦æå½å空é´ä¸ç彿°æå¸¸éæªå®ä¹ï¼å该ééå®ç彿°åç§°æå¸¸éåç§°ä¼è¢«è§£æä¸ºå ¨å±å½æ°åç§°æå¸¸éåç§°ã详æ åè§ <link linkend="language.namespaces.fallback">使ç¨å½å空é´ï¼åå¤å ¨å±å½æ°åç§°/常éåç§°</link>ã </simpara> </listitem> <listitem> <simpara> éå®åç§°,æå å«åç¼çåç§°ï¼ä¾å¦ <literal>$a = new subnamespace\foo();</literal> æ <literal>subnamespace\foo::staticmethod();</literal>ã妿å½åçå½åç©ºé´æ¯ <literal>currentnamespace</literal>ï¼å foo ä¼è¢«è§£æä¸º <literal>currentnamespace\subnamespace\foo</literal>ãå¦æä½¿ç¨ foo çä»£ç æ¯å ¨å±çï¼ä¸å å«å¨ä»»ä½å½å空é´ä¸ç代ç ï¼foo ä¼è¢«è§£æä¸º<literal>subnamespace\foo</literal>ã </simpara> </listitem> <listitem> <simpara> å®å ¨éå®åç§°ï¼æå å«äºå ¨å±åç¼æä½ç¬¦çåç§°ï¼ä¾å¦ï¼ <literal>$a = new \currentnamespace\foo();</literal> æ <literal>\currentnamespace\foo::staticmethod();</literal>ãå¨è¿ç§æ åµä¸ï¼foo æ»æ¯è¢«è§£æä¸ºä»£ç ä¸çæåå(literal name)<literal>currentnamespace\foo</literal>ã </simpara> </listitem> </orderedlist> </para> <para> ä¸é¢æ¯ä¸ä¸ªä½¿ç¨è¿ä¸ç§æ¹å¼çå®ä¾ï¼ <informalexample> <simpara>file1.php</simpara> <programlisting role="php"> <![CDATA[ <?php namespace Foo\Bar\subnamespace; const FOO = 1; function foo() {} class foo { static function staticmethod() {} } ?> ]]> </programlisting> <simpara>file2.php</simpara> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </informalexample> </para> <para> 注æè®¿é®ä»»æå ¨å±ç±»ã彿°æå¸¸éï¼é½å¯ä»¥ä½¿ç¨å®å ¨éå®åç§°ï¼ä¾å¦ <function>\strlen</function> æ <classname>\Exception</classname> æ <literal>\INI_ALL</literal>ã <example> <title>å¨å½å空é´å é¨è®¿é®å ¨å±ç±»ã彿°å常é</title> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.dynamic"> <title>å½å空é´å卿è¯è¨ç¹å¾</title> <para> PHP å½å空é´çå®ç°åå°å ¶è¯è¨èªèº«ç卿ç¹å¾çå½±åãå æ¤ï¼å¦æè¦å°ä¸é¢ç代ç 转æ¢å°å½å空é´ä¸ï¼ <example> <title>å¨æè®¿é®å ç´ </title> <simpara>example1.php:</simpara> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> å¿ é¡»ä½¿ç¨å®å ¨éå®åç§°ï¼å æ¬å½å空é´åç¼çç±»åç§°ï¼ã注æå 为å¨å¨æçç±»åç§°ã彿°åç§°æå¸¸éåç§°ä¸ï¼éå®åç§°åå®å ¨éå®å称没æåºå«ï¼å æ¤å ¶å导çåææ æ¯ä¸å¿ è¦çã <example> <title>å¨æè®¿é®å½å空é´çå ç´ </title> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> </para> <para> 请ä¸å®å«å¿äºé 读 <link linkend="language.namespaces.faq.quote">对å符串ä¸çå½å空é´å称转ä¹ç注解</link>. </para> </sect1> <sect1 xml:id="language.namespaces.nsconstants"> <title>namespaceå ³é®åå__NAMESPACE__常é</title> <para> PHPæ¯æä¸¤ç§æ½è±¡ç访é®å½åå½å空é´å é¨å ç´ çæ¹æ³ï¼<constant>__NAMESPACE__</constant> 鿝叏éå<literal>namespace</literal>å ³é®åã </para> <para> 常é<constant>__ NAMESPACE__</constant>ç弿¯å å«å½åå½å空é´åç§°çå符串ãå¨å ¨å±çï¼ä¸å æ¬å¨ä»»ä½å½å空é´ä¸ç代ç ï¼å®å å«ä¸ä¸ªç©ºçå符串ã <example> <title>__NAMESPACE__ 示ä¾, å¨å½å空é´ä¸ç代ç </title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject; echo '"', __NAMESPACE__, '"'; // è¾åº "MyProject" ?> ]]> </programlisting> </example> <example> <title>__NAMESPACE__ 示ä¾ï¼å ¨å±ä»£ç </title> <programlisting role="php"> <![CDATA[ <?php echo '"', __NAMESPACE__, '"'; // è¾åº "" ?> ]]> </programlisting> </example> 常é <constant>__NAMESPACE__</constant> å¨å¨æå建åç§°æ¶å¾æç¨ï¼ä¾å¦ï¼ <example> <title>使ç¨__NAMESPACE__卿å建åç§°</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject; function get($classname) { $a = __NAMESPACE__ . '\\' . $classname; return new $a; } ?> ]]> </programlisting> </example> </para> <para> å ³é®å <literal>namespace</literal> å¯ç¨æ¥æ¾å¼è®¿é®å½åå½åç©ºé´æåå½å空é´ä¸çå ç´ ãå®çä»·äºç±»ä¸ç <literal>self</literal> æä½ç¬¦ã <example> <title>namespaceæä½ç¬¦ï¼å½å空é´ä¸ç代ç </title> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> <example> <title>namespaceæä½ç¬¦, å ¨å±ä»£ç </title> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.importing"> <title>使ç¨å½å空é´ï¼å«å/å¯¼å ¥</title> <para> å 许éè¿å«åå¼ç¨æå¯¼å ¥å¤é¨çå®å ¨éå®åç§°ï¼æ¯å½å空é´çä¸ä¸ªéè¦ç¹å¾ãè¿æç¹ç±»ä¼¼äºå¨ç±» unix æä»¶ç³»ç»ä¸å¯ä»¥åå»ºå¯¹å ¶å®çæä»¶æç®å½ç符å·è¿æ¥ã </para> <para> PHP å½åç©ºé´æ¯æ æä¸¤ç§ä½¿ç¨å«åæå¯¼å ¥æ¹å¼ï¼ä¸ºç±»å称使ç¨å«åï¼æä¸ºå½å空é´å称使ç¨å«åãæ³¨æPHP䏿¯æå¯¼å ¥å½æ°æå¸¸éã </para> <para> å¨PHPä¸ï¼å«åæ¯éè¿æä½ç¬¦ <literal>use</literal> æ¥å®ç°ç. ä¸é¢æ¯ä¸ä¸ªä½¿ç¨ææå¯è½çä¸ç§å¯¼å ¥æ¹å¼çä¾åï¼ <example> <title>使ç¨useæä½ç¬¦å¯¼å ¥/使ç¨å«å</title> <programlisting role="php"> <![CDATA[ <?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 对象 ?> ]]> </programlisting> </example> 注æå¯¹å½å空é´ä¸çåç§°ï¼å å«å½å空é´åé符çå®å ¨éå®åç§°å¦ <literal>Foo\Bar</literal>以åç¸å¯¹çä¸å å«å½å空é´åé符çå ¨å±åç§°å¦ <literal>FooBar</literal>ï¼æ¥è¯´ï¼å导çåææ æ¯ä¸å¿ è¦çä¹ä¸å 许æåææ ï¼å ä¸ºå¯¼å ¥çåç§°å¿ é¡»æ¯å®å ¨éå®çï¼ä¸ä¼æ ¹æ®å½åçå½å空é´ä½ç¸å¯¹è§£æã Note that for namespaced names (fully qualified namespace names containing namespace separator, such as <literal>Foo\Bar</literal> as opposed to global names that do not, such as <literal>FooBar</literal>), the leading backslash is unnecessary and not allowed, as import names must be fully qualified, and are not processed relative to the current namespace. </para> <para> 为äºç®åæä½ï¼PHPè¿æ¯æå¨ä¸è¡ä¸ä½¿ç¨å¤ä¸ªuseè¯å¥ <example> <title>éè¿useæä½ç¬¦å¯¼å ¥/使ç¨å«åï¼ä¸è¡ä¸å å«å¤ä¸ªuseè¯å¥</title> <programlisting role="php"> <![CDATA[ <?php use My\Full\Classname as Another, My\Full\NSname; $obj = new Another; // å®ä¾å My\Full\Classname 对象 NSname\subns\func(); // è°ç¨å½æ° My\Full\NSname\subns\func ?> ]]> </programlisting> </example> </para> <para> å¯¼å ¥æä½æ¯å¨ç¼è¯æ§è¡çï¼ä½å¨æçç±»åç§°ã彿°åç§°æå¸¸éåç§°å䏿¯ã Importing is performed at compile-time, and so does not affect dynamic class, function or constant names. <example> <title>å¯¼å ¥å卿åç§°</title> <programlisting role="php"> <![CDATA[ <?php use My\Full\Classname as Another, My\Full\NSname; $obj = new Another; // å®ä¾åä¸ä¸ª My\Full\Classname 对象 $a = 'Another'; $obj = new $a; // å®é åä¸ä¸ª Another 对象 ?> ]]> </programlisting> </example> </para> <para> å¦å¤ï¼å¯¼å ¥æä½åªå½±åééå®åç§°åéå®åç§°ãå®å ¨éå®åç§°ç±äºæ¯ç¡®å®çï¼æ ä¸åå¯¼å ¥çå½±åã <example> <title>å¯¼å ¥åå®å ¨éå®åç§°</title> <programlisting role="php"> <![CDATA[ <?php use My\Full\Classname as Another, My\Full\NSname; $obj = new Another; // instantiates object of class My\Full\Classname $obj = new \Another; // instantiates object of class Another $obj = new Another\thing; // instantiates object of class My\Full\Classname\thing $obj = new \Another\thing; // instantiates object of class Another\thing ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.global"> <title>å ¨å±ç©ºé´</title> <para> å¦ææ²¡æå®ä¹ä»»ä½å½å空é´ï¼ææçç±»ä¸å½æ°çå®ä¹é½æ¯å¨å ¨å±ç©ºé´ï¼ä¸ PHP å¼å ¥å½åç©ºé´æ¦å¿µå䏿 ·ãå¨åç§°åå ä¸åç¼ <literal>\</literal> 表示该åç§°æ¯å ¨å±ç©ºé´ä¸çåç§°ï¼å³ä½¿è¯¥åç§°ä½äºå ¶å®çå½å空é´ä¸æ¶ä¹æ¯å¦æ¤ã <example> <title>使ç¨å ¨å±ç©ºé´è¯´æ</title> <programlisting role="php"> <![CDATA[ <?php namespace A\B\C; /* è¿ä¸ªå½æ°æ¯ A\B\C\fopen */ function fopen() { /* ... */ $f = \fopen(...); // è°ç¨å ¨å±çfopen彿° return $f; } ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.fallback"> <title>使ç¨å½å空é´ï¼åå¤å ¨å±å½æ°/常é</title> <para> å¨ä¸ä¸ªå½å空é´ä¸ï¼å½ PHP éå°ä¸ä¸ªééå®çç±»ã彿°æå¸¸éåç§°æ¶ï¼å®ä½¿ç¨ä¸åçä¼å çç¥æ¥è§£æè¯¥åç§°ãç±»åç§°æ»æ¯è§£æå°å½åå½å空é´ä¸çåç§°ãå æ¤å¨è®¿é®ç³»ç»å 鍿ä¸å å«å¨å½å空é´ä¸çç±»åç§°æ¶ï¼å¿ 须使ç¨å®å ¨éå®åç§°ï¼ä¾å¦ï¼ <example> <title>å¨å½å空é´ä¸è®¿é®å ¨å±ç±»</title> <programlisting role="php"> <![CDATA[ <?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 ç±» ?> ]]> </programlisting> </example> </para> <para> 对äºå½æ°åå¸¸éæ¥è¯´ï¼å¦æå½åå½å空é´ä¸ä¸åå¨è¯¥å½æ°æå¸¸éï¼PHP ä¼éè使ç¨å ¨å±ç©ºé´ä¸ç彿°æå¸¸éã For functions and constants, PHP will fall back to global functions or constants if a namespaced function or constant does not exist. <example> <title>å½å空é´ä¸åå¤çå ¨å±å½æ°/常é</title> <programlisting role="php"> <![CDATA[ <?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"; } ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.rules"> <title>åç§°è§£æè§å</title> <para> å¨è¯´æåç§°è§£æè§åä¹åï¼æä»¬å çä¸äºéè¦çå®ä¹ï¼ <variablelist> <title>å½å空é´åç§°å®ä¹</title> <varlistentry> <term>ééå®åç§°Unqualified name</term> <listitem> <para> åç§°ä¸ä¸å å«å½å空é´åéç¬¦çæ è¯ç¬¦ï¼ä¾å¦ <literal>Foo</literal> </para> </listitem> </varlistentry> <varlistentry> <term>éå®åç§°Qualified name</term> <listitem> <para> åç§°ä¸å«æå½å空é´åéç¬¦çæ è¯ç¬¦ï¼ä¾å¦ <literal>Foo\Bar</literal> </para> </listitem> </varlistentry> <varlistentry> <term>å®å ¨éå®åç§°Fully qualified name</term> <listitem> <para> åç§°ä¸å å«å½å空é´åé符ï¼å¹¶ä»¥å½å空é´åé符å¼å§çæ è¯ç¬¦ï¼ä¾å¦ <literal>\Foo\Bar</literal>ã <literal>namespace\Foo</literal> 乿¯ä¸ä¸ªå®å ¨éå®åç§°ã </para> </listitem> </varlistentry> </variablelist> </para> <para> åç§°è§£æéµå¾ªä¸åè§åï¼ <orderedlist> <listitem> <simpara> 对å®å ¨éå®åç§°ç彿°ï¼ç±»å常éçè°ç¨å¨ç¼è¯æ¶è§£æãä¾å¦ <literal>new \A\B</literal> è§£æä¸ºç±» <literal>A\B</literal>ã </simpara> </listitem> <listitem> <simpara> ææçééå®åç§°åéå®åç§°ï¼éå®å ¨éå®åç§°ï¼æ ¹æ®å½åçå¯¼å ¥è§åå¨ç¼è¯æ¶è¿è¡è½¬æ¢ãä¾å¦ï¼å¦æå½åç©ºé´ <literal>A\B\C</literal> è¢«å¯¼å ¥ä¸º <literal>C</literal>ï¼é£ä¹å¯¹ <literal>C\D\e()</literal> çè°ç¨å°±ä¼è¢«è½¬æ¢ä¸º <literal>A\B\C\D\e()</literal>ã </simpara> </listitem> <listitem> <simpara> å¨å½å空é´å é¨ï¼ææçæ²¡ææ ¹æ®å¯¼å ¥è§å转æ¢çéå®åç§°åä¼å¨å ¶åé¢å ä¸å½åçå½å空é´åç§°ãä¾å¦ï¼å¨å½åç©ºé´ <literal>A\B</literal> å é¨è°ç¨ <literal>C\D\e()</literal>ï¼å <literal>C\D\e()</literal> ä¼è¢«è½¬æ¢ä¸º <literal>A\B\C\D\e()</literal> ã </simpara> </listitem> <listitem> <simpara> ééå®ç±»åæ ¹æ®å½åçå¯¼å ¥è§åå¨ç¼è¯æ¶è½¬æ¢ï¼ç¨å ¨å代æ¿ççå¯¼å ¥åç§°ï¼ãä¾å¦ï¼å¦æå½åç©ºé´ <literal>A\B\C</literal> å¯¼å ¥ä¸ºCï¼å <literal>new C()</literal> 被转æ¢ä¸º <literal>new A\B\C() </literal>ã </simpara> </listitem> <listitem> <simpara> å¨å½å空é´å é¨ï¼ä¾å¦A\Bï¼ï¼å¯¹ééå®åç§°ç彿°è°ç¨æ¯å¨è¿è¡æ¶è§£æçãä¾å¦å¯¹å½æ° <literal>foo()</literal> çè°ç¨æ¯è¿æ ·è§£æçï¼ </simpara> <orderedlist> <listitem> <simpara> å¨å½åå½å空é´ä¸æ¥æ¾å为 <literal>A\B\foo()</literal> ç彿° </simpara> </listitem> <listitem> <simpara> å°è¯æ¥æ¾å¹¶è°ç¨ <emphasis>å ¨å±(global)</emphasis> 空é´ä¸ç彿° <literal>foo()</literal>ã </simpara> </listitem> </orderedlist> </listitem> <listitem> <simpara> å¨å½å空é´ï¼ä¾å¦<literal>A\B</literal>ï¼å é¨å¯¹ééå®åç§°æéå®åç§°ç±»ï¼éå®å ¨éå®åç§°ï¼çè°ç¨æ¯å¨è¿è¡æ¶è§£æçãä¸é¢æ¯è°ç¨ <literal>new C()</literal> å <literal>new D\E()</literal> çè§£æè¿ç¨ï¼ <literal> new C()</literal>çè§£æ: </simpara> <orderedlist> <listitem> <simpara> å¨å½åå½å空é´ä¸æ¥æ¾<literal>A\B\C</literal>ç±»ã </simpara> </listitem> <listitem> <simpara> å°è¯èªå¨è£ 载类<literal>A\B\C</literal>ã </simpara> </listitem> </orderedlist> <simpara> <literal> new D\E()</literal>çè§£æ: </simpara> <orderedlist> <listitem> <simpara> å¨ç±»åç§°åé¢å ä¸å½åå½å空é´åç§°åæï¼<literal>A\B\D\E</literal>ï¼ç¶åæ¥æ¾è¯¥ç±»ã </simpara> </listitem> <listitem> <simpara> å°è¯èªå¨è£ 载类 <literal>A\B\D\E</literal>ã </simpara> </listitem> </orderedlist> <simpara> 为äºå¼ç¨å ¨å±å½å空é´ä¸çå ¨å±ç±»ï¼å¿ 须使ç¨å®å ¨éå®åç§° <literal>new \C()</literal>ã </simpara> </listitem> </orderedlist> </para> <example> <title>åç§°è§£æç¤ºä¾</title> <programlisting role="php"> <![CDATA[ <?php namespace A; use B\D, C\E as F; // 彿°è°ç¨ foo(); // é¦å å°è¯è°ç¨å®ä¹å¨å½å空é´"A"ä¸ç彿°foo() // åå°è¯è°ç¨å ¨å±å½æ° "foo" \foo(); // è°ç¨å ¨å±ç©ºé´å½æ° "foo" my\foo(); // è°ç¨å®ä¹å¨å½å空é´"A\my"ä¸å½æ° "foo" F(); // é¦å å°è¯è°ç¨å®ä¹å¨å½å空é´"A"ä¸ç彿° "F" // åå°è¯è°ç¨å ¨å±å½æ° "F" // ç±»å¼ç¨ new B(); // å建å½åç©ºé´ "A" ä¸å®ä¹çç±» "B" çä¸ä¸ªå¯¹è±¡ // å¦ææªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "A\B" new D(); // 使ç¨å¯¼å ¥è§åï¼å建å½åç©ºé´ "B" ä¸å®ä¹çç±» "D" çä¸ä¸ªå¯¹è±¡ // å¦ææªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "B\D" new F(); // 使ç¨å¯¼å ¥è§åï¼å建å½åç©ºé´ "C" ä¸å®ä¹çç±» "E" çä¸ä¸ªå¯¹è±¡ // å¦ææªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "C\E" new \B(); // å建å®ä¹å¨å ¨å±ç©ºé´ä¸çç±» "B" çä¸ä¸ªå¯¹è±¡ // 妿æªåç°ï¼åå°è¯èªå¨è£ 载类 "B" new \D(); // å建å®ä¹å¨å ¨å±ç©ºé´ä¸çç±» "D" çä¸ä¸ªå¯¹è±¡ // 妿æªåç°ï¼åå°è¯èªå¨è£ 载类 "D" new \F(); // å建å®ä¹å¨å ¨å±ç©ºé´ä¸çç±» "F" çä¸ä¸ªå¯¹è±¡ // 妿æªåç°ï¼åå°è¯èªå¨è£ 载类 "F" // è°ç¨å¦ä¸ä¸ªå½å空é´ä¸çéææ¹æ³æå½å空é´å½æ° B\foo(); // è°ç¨å½åç©ºé´ "A\B" ä¸å½æ° "foo" B::foo(); // è°ç¨å½åç©ºé´ "A" ä¸å®ä¹çç±» "B" ç "foo" æ¹æ³ // å¦ææªæ¾å°ç±» "A\B" ï¼åå°è¯èªå¨è£ 载类 "A\B" D::foo(); // 使ç¨å¯¼å ¥è§åï¼è°ç¨å½åç©ºé´ "B" ä¸å®ä¹çç±» "D" ç "foo" æ¹æ³ // å¦æç±» "B\D" æªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "B\D" \B\foo(); // è°ç¨å½åç©ºé´ "B" ä¸ç彿° "foo" \B::foo(); // è°ç¨å ¨å±ç©ºé´ä¸çç±» "B" ç "foo" æ¹æ³ // å¦æç±» "B" æªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "B" // å½åå½å空é´ä¸çéææ¹æ³æå½æ° A\B::foo(); // è°ç¨å½åç©ºé´ "A\A" ä¸å®ä¹çç±» "B" ç "foo" æ¹æ³ // å¦æç±» "A\A\B" æªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "A\A\B" \A\B::foo(); // è°ç¨å½åç©ºé´ "A\B" ä¸å®ä¹çç±» "B" ç "foo" æ¹æ³ // å¦æç±» "A\B" æªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "A\B" ?> ]]> </programlisting> </example> </sect1> <sect1 xml:id="language.namespaces.faq"> <title>FAQ: things you need to know about namespaces</title> <para> This FAQ is split into two sections: common questions, and some specifics of implementation that are helpful to understand fully. </para> <para> First, the common questions. <orderedlist> <listitem> <simpara> <link linkend="language.namespaces.faq.shouldicare">If I don't use namespaces, should I care about any of this?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.globalclass">How do I use internal or global classes in a namespace?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.innamespace">How do I use namespaces classes functions, or constants in their own namespace?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.full"> How does a name like <literal>\my\name</literal> or <literal>\name</literal> resolve? </link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.qualified">How does a name like <literal>my\name</literal> resolve?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.shortname1">How does an unqualified class name like <literal>name</literal> resolve?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.shortname2">How does an unqualified function name or unqualified constant name like <literal>name</literal> resolve?</link> </simpara> </listitem> </orderedlist> </para> <para> There are a few implementation details of the namespace implementations that are helpful to understand. <orderedlist> <listitem> <simpara> <link linkend="language.namespaces.faq.conflict">Import names cannot conflict with classes defined in the same file.</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.nested">Nested namespaces are not allowed. </link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.nofuncconstantuse">Neither functions nor constants can be imported via the <literal>use</literal> statement.</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.quote">Dynamic namespace names (quoted identifiers) should escape backslash.</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.constants">Undefined Constants referenced using any backslash die with fatal error</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.builtinconst">Cannot override special constants NULL, TRUE, FALSE, ZEND_THREAD_SAFE or ZEND_DEBUG_BUILD</link> </simpara> </listitem> </orderedlist> </para> <sect2 xml:id="language.namespaces.faq.shouldicare"> <title>If I don't use namespaces, should I care about any of this?</title> <para> No. Namespaces do not affect any existing code in any way, or any as-yet-to-be-written code that does not contain namespaces. You can write this code if you wish: </para> <para> <example> <title>Accessing global classes outside a namespace</title> <programlisting role="php"> <![CDATA[ <?php $a = new \stdClass; ]]> </programlisting> </example> </para> <para> This is functionally equivalent to: </para> <para> <example> <title>Accessing global classes outside a namespace</title> <programlisting role="php"> <![CDATA[ <?php $a = new stdClass; ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.globalclass"> <title>How do I use internal or global classes in a namespace?</title> <para> <example> <title>Accessing internal classes in namespaces</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; $a = new \stdClass; function test(\ArrayObject $typehintexample = null) {} $a = \DirectoryIterator::CURRENT_AS_FILEINFO; // extending an internal or global class class MyException extends \Exception {} ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.innamespace"> <title> How do I use namespaces classes, functions, or constants in their own namespace? </title> <para> <example> <title>Accessing internal classes, functions or constants in namespaces</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; class MyClass {} // using a class from the current namespace as a type hint function test(MyClass $typehintexample = null) {} // another way to use a class from the current namespace as a type hint function test(\foo\MyClass $typehintexample = null) {} // extending a class from the current namespace class Extended extends MyClass {} // accessing a global function $a = \globalfunc(); // accessing a global constant $b = \INI_ALL; ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.full"> <title> How does a name like <literal>\my\name</literal> or <literal>\name</literal> resolve? </title> <para> Names that begin with a <literal>\</literal> always resolve to what they look like, so <literal>\my\name</literal> is in fact <literal>my\name</literal>, and <literal>\Exception</literal> is <literal>Exception</literal>. <example> <title>Fully Qualified names</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; $a = new \my\name(); // instantiates "my\name" class echo \strlen('hi'); // calls function "strlen" $a = \INI_ALL; // $a is set to the value of constant "INI_ALL" ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.qualified"> <title>How does a name like <literal>my\name</literal> resolve?</title> <para> Names that contain a backslash but do not begin with a backslash like <literal>my\name</literal> can be resolved in 2 different ways. </para> <para> If there is an import statement that aliases another name to <literal>my</literal>, then the import alias is applied to the <literal>my</literal> in <literal>my\name</literal>. </para> <para> Otherwise, the current namespace name is prepended to <literal>my\name</literal>. </para> <para> <example> <title>Qualified names</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; use blah\blah as foo; $a = new my\name(); // instantiates "foo\my\name" class foo\bar::name(); // calls static method "name" in class "blah\blah\bar" my\bar(); // calls function "foo\my\bar" $a = my\BAR; // sets $a to the value of constant "foo\my\BAR" ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.shortname1"> <title>How does an unqualified class name like <literal>name</literal> resolve?</title> <para> Class names that do not contain a backslash like <literal>name</literal> can be resolved in 2 different ways. </para> <para> If there is an import statement that aliases another name to <literal>name</literal>, then the import alias is applied. </para> <para> Otherwise, the current namespace name is prepended to <literal>name</literal>. </para> <para> <example> <title>Unqualified class names</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; use blah\blah as foo; $a = new name(); // instantiates "foo\name" class foo::name(); // calls static method "name" in class "blah\blah" ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.shortname2"> <title> How does an unqualified function name or unqualified constant name like <literal>name</literal> resolve? </title> <para> Function or constant names that do not contain a backslash like <literal>name</literal> can be resolved in 2 different ways. </para> <para> First, the current namespace name is prepended to <literal>name</literal>. </para> <para> Finally, if the constant or function <literal>name</literal> does not exist in the current namespace, a global constant or function <literal>name</literal> is used if it exists. </para> <para> <example> <title>Unqualified function or constant names</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; use blah\blah as foo; const FOO = 1; function my() {} function foo() {} function sort(&$a) { sort($a); $a = array_flip($a); return $a; } my(); // calls "foo\my" $a = strlen('hi'); // calls global function "strlen" because "foo\strlen" does not exist $arr = array(1,3,2); $b = sort($arr); // calls function "foo\sort" $c = foo(); // calls function "foo\foo" - import is not applied $a = FOO; // sets $a to value of constant "foo\FOO" - import is not applied $b = INI_ALL; // sets $b to value of global constant "INI_ALL" ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.conflict"> <title>Import names cannot conflict with classes defined in the same file.</title> <para> The following script combinations are legal: <informalexample> <simpara>file1.php</simpara> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff; class MyClass {} ?> ]]> </programlisting> <simpara>another.php</simpara> <programlisting role="php"> <![CDATA[ <?php namespace another; class thing {} ?> ]]> </programlisting> <simpara>file2.php</simpara> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff; include 'file1.php'; include 'another.php'; use another\thing as MyClass; $a = new MyClass; // instantiates class "thing" from namespace another ?> ]]> </programlisting> </informalexample> </para> <para> There is no name conflict, even though the class <literal>MyClass</literal> exists within the <literal>my\stuff</literal> namespace, because the MyClass definition is in a separate file. However, the next example causes a fatal error on name conflict because MyClass is defined in the same file as the use statement. <informalexample> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff; use another\thing as MyClass; class MyClass {} // fatal error: MyClass conflicts with import statement $a = new MyClass; ?> ]]> </programlisting> </informalexample> </para> </sect2> <sect2 xml:id="language.namespaces.faq.nested"> <title>Nested namespaces are not allowed.</title> <para> PHP does not allow nesting namespaces <informalexample> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff { namespace nested { class foo {} } } ?> ]]> </programlisting> </informalexample> However, it is easy to simulate nested namespaces like so: <informalexample> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff\nested { class foo {} } ?> ]]> </programlisting> </informalexample> </para> </sect2> <sect2 xml:id="language.namespaces.faq.nofuncconstantuse"> <title>Neither functions nor constants can be imported via the <literal>use</literal> statement.</title> <para> The only elements that are affected by <literal>use</literal> statements are namespaces and class names. In order to shorten a long constant or function, import its containing namespace <informalexample> <programlisting role="php"> <![CDATA[ <?php namespace mine; use ultra\long\ns\name; $a = name\CONSTANT; name\func(); ?> ]]> </programlisting> </informalexample> </para> </sect2> <sect2 xml:id="language.namespaces.faq.quote"> <title>Dynamic namespace names (quoted identifiers) should escape backslash</title> <para> It is very important to realize that because the backslash is used as an escape character within strings, it should always be doubled when used inside a string. Otherwise there is a risk of unintended consequences: <example> <title>Dangers of using namespaced names inside a double-quoted string</title> <programlisting role="php"> <![CDATA[ <?php $a = new "dangerous\name"; // \n is a newline inside double quoted strings! $obj = new $a; $a = new 'not\at\all\dangerous'; // no problems here. $obj = new $a; ?> ]]> </programlisting> </example> Inside a single-quoted string, the backslash escape sequence is much safer to use, but it is still recommended practice to escape backslashes in all strings as a best practice. </para> </sect2> <sect2 xml:id="language.namespaces.faq.constants"> <title>Undefined Constants referenced using any backslash die with fatal error</title> <para> Any undefined constant that is unqualified like <literal>FOO</literal> will produce a notice explaining that PHP assumed <literal>FOO</literal> was the value of the constant. Any constant, qualified or fully qualified, that contains a backslash will produce a fatal error if not found. <example> <title>Undefined constants</title> <programlisting role="php"> <![CDATA[ <?php namespace bar; $a = FOO; // produces notice - undefined constants "FOO" assumed "FOO"; $a = \FOO; // fatal error, undefined namespace constant FOO $a = Bar\FOO; // fatal error, undefined namespace constant bar\Bar\FOO $a = \Bar\FOO; // fatal error, undefined namespace constant Bar\FOO ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.builtinconst"> <title>Cannot override special constants NULL, TRUE, FALSE, ZEND_THREAD_SAFE or ZEND_DEBUG_BUILD</title> <para> Any attempt to define a namespaced constant that is a special, built-in constant results in a fatal error <example> <title>Undefined constants</title> <programlisting role="php"> <![CDATA[ <?php namespace bar; const NULL = 0; // fatal error; const true = 'stupid'; // also fatal error; // etc. ?> ]]> </programlisting> </example> </para> </sect2> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/namespaces.xml?view=markup&rev=1.1 Index: phpdoc-zh/language/namespaces.xml +++ phpdoc-zh/language/namespaces.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- $Author: eniac2008 $ --> <!-- EN-Revision: 1.9 Maintainer: Altair Status: ready --> <chapter xml:id="language.namespaces" xmlns="http://docbook.org/ns/docbook" version="1.1"> <title>å½å空é´</title> <sect1 xml:id="language.namespaces.rationale"> <title>å½åç©ºé´æ¦è¿°</title> <simpara> ä»ä¹æ¯å½å空é´ï¼ä»å¹¿ä¹ä¸æ¥è¯´ï¼å½åç©ºé´æ¯ä¸ç§å°è£ äºç©çæ¹æ³ãå¨å¾å¤å°æ¹é½å¯ä»¥è§å°è¿ç§æ½è±¡æ¦å¿µãä¾å¦ï¼å¨æä½ç³»ç»ä¸ç®å½ç¨æ¥å°ç¸å ³æä»¶åç»ï¼å¯¹äºç®å½ä¸çæä»¶æ¥è¯´ï¼å®å°±æ®æ¼äºå½å空é´çè§è²ãå ·ä½ä¸¾ä¸ªä¾åï¼æä»¶ <literal>foo.txt</literal> å¯ä»¥åæ¶å¨ç®å½<literal>/home/greg</literal> å <literal>/home/other</literal> ä¸åå¨ï¼ä½å¨åä¸ä¸ªç®å½ä¸ä¸è½åå¨ä¸¤ä¸ª <literal>foo.txt</literal> æä»¶ãå¦å¤ï¼å¨ç®å½ <literal>/home/greg</literal> å¤è®¿é® <literal>foo.txt</literal> æä»¶æ¶ï¼æä»¬å¿ é¡»å°ç®å½å以åç®å½åé符æ¾å¨æä»¶åä¹åå¾å° <literal>/home/greg/foo.txt</literal>ãè¿ä¸ªåçåºç¨å°ç¨åºè®¾è®¡é¢åå°±æ¯å½å空é´çæ¦å¿µã </simpara> <simpara> å¨PHPä¸ï¼å½å空é´ç¨æ¥è§£å³å¨ç¼åç±»åºæåºç¨ç¨åºæ¶å建å¯éç¨ç代ç å¦ç±»æå½æ°æ¶ç¢°å°ç两类é®é¢ï¼ In the PHP world, namespaces are designed to solve two problems that authors of libraries and applications encounter when creating re-usable code elements such as classes or functions: </simpara> <para> <orderedlist> <listitem> <simpara> ç¨æ·ç¼åç代ç ä¸PHPå é¨çç±»/彿°/常éæç¬¬ä¸æ¹ç±»/彿°/常éä¹é´çååå²çªã </simpara> </listitem> <listitem> <simpara> 为å¾é¿çæ è¯ç¬¦åç§°(é常æ¯ä¸ºäºç¼è§£ç¬¬ä¸ç±»é®é¢èå®ä¹ç)å建ä¸ä¸ªå«åï¼æç®çï¼çåç§°ï¼æé«æºä»£ç çå¯è¯»æ§ã </simpara> </listitem> </orderedlist> </para> <simpara> PHP å½åç©ºé´æä¾äºä¸ç§å°ç¸å ³çç±»ã彿°å常éç»åå°ä¸èµ·çéå¾ãä¸é¢æ¯ä¸ä¸ªè¯´æ PHP å½å空é´è¯æ³ç示ä¾ï¼ </simpara> <example> <title>å½å空é´è¯æ³ç¤ºä¾</title> <programlisting role="php"> <![CDATA[ <?php namespace my\name; // åè "å®ä¹å½å空é´" å°è class MyClass {} function myfunction() {} const MYCONST = 1; $a = new MyClass; $c = new \my\name\MyClass; // åè "å ¨å±ç©ºé´" å°è $a = strlen('hi'); // åè "使ç¨å½å空é´ï¼åå¤å ¨å±å½æ°/常é" å°è $d = namespace\MYCONST; // åè "namespaceæä½ç¬¦å__NAMESPACE__常éâ å°è $d = __NAMESPACE__ . '\MYCONST'; echo constant($d); // åè "å½å空é´å卿è¯è¨ç¹å¾" å°è ?> ]]> </programlisting> </example> <simpara> PHP å¨ 5.3.0 以åççæ¬å¼å§æ¯æå½å空é´ã </simpara> </sect1> <sect1 xml:id="language.namespaces.definition"> <title>å®ä¹å½å空é´</title> <para> è½ç¶ä»»æåæ³çPHP代ç é½å¯ä»¥å å«å¨å½å空é´ä¸ï¼ä½åªæä¸ç§ç±»åç代ç åå½å空é´çå½±åï¼å®ä»¬æ¯ï¼ç±»ï¼å½æ°å常éã </para> <para> å½å空é´éè¿å ³é®å<literal>namespace</literal> æ¥å£°æã妿ä¸ä¸ªæä»¶ä¸å å«å½å空é´ï¼å®å¿ é¡»å¨å ¶å®ææä»£ç ä¹å声æå½å空é´ã <example> <title>声æå个å½å空é´</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } ?> ]]> </programlisting> </example> å¨å£°æå½å空é´ä¹åå¯ä¸åæ³çä»£ç æ¯ç¨äºå®ä¹æºæä»¶ç¼ç æ¹å¼ç <literal>declare</literal> è¯å¥ãå¦å¤ï¼ææé PHP 代ç å æ¬ç©ºç½ç¬¦é½ä¸è½åºç°å¨å½å空é´ç声æä¹åï¼ <example> <title>声æå个å½å空é´</title> <programlisting role="php"> <![CDATA[ <html> <?php namespace MyProject; // è´å½é误 -ãå½å空é´å¿ é¡»æ¯ç¨åºèæ¬çç¬¬ä¸æ¡è¯å¥ ?> ]]> </programlisting> </example> </para> <para> å¦å¤ï¼ä¸PHPå ¶å®çè¯è¨ç¹å¾ä¸åï¼åä¸ä¸ªå½å空é´å¯ä»¥å®ä¹å¨å¤ä¸ªæä»¶ä¸ï¼å³å 许å°åä¸ä¸ªå½å空é´çå 容åå²åæ¾å¨ä¸åçæä»¶ä¸ã </para> </sect1> <sect1 xml:id="language.namespaces.nested"> <title>å®ä¹åå½å空é´</title> <para> ä¸ç®å½åæä»¶çå ³ç³»å¾è±¡ï¼PHP å½å空é´ä¹å 许æå®å±æ¬¡åçå½å空é´çåç§°ãå æ¤ï¼å½å空é´çååå¯ä»¥ä½¿ç¨å屿¬¡çæ¹å¼å®ä¹ï¼ <example> <title>声æå屿¬¡çå个å½å空é´</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject\Sub\Level; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } ?> ]]> </programlisting> </example> ä¸é¢çä¾åå建äºå¸¸é<literal>MyProject\Sub\Level\CONNECT_OK</literal>ï¼ç±» <literal>MyProject\Sub\Level\Connection</literal>å彿° <literal>MyProject\Sub\Level\Connection</literal>ã </para> </sect1> <sect1 xml:id="language.namespaces.definitionmultiple"> <title>å¨åä¸ä¸ªæä»¶ä¸å®ä¹å¤ä¸ªå½å空é´</title> <para> ä¹å¯ä»¥å¨åä¸ä¸ªæä»¶ä¸å®ä¹å¤ä¸ªå½å空é´ãå¨åä¸ä¸ªæä»¶ä¸å®ä¹å¤ä¸ªå½åç©ºé´æä¸¤ç§è¯æ³å½¢å¼ã </para> <para> <example> <title>å®ä¹å¤ä¸ªå½å空é´ï¼ç®åç»åè¯æ³</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } namespace AnotherProject; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } ?> ]]> </programlisting> </example> </para> <para> ä¸å»ºè®®ä½¿ç¨è¿ç§è¯æ³å¨å个æä»¶ä¸å®ä¹å¤ä¸ªå½å空é´ã建议使ç¨ä¸é¢ç大æ¬å·å½¢å¼çè¯æ³ã </para> <para> <example> <title>å®ä¹å¤ä¸ªå½å空é´ï¼å¤§æ¬å·è¯æ³</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject { const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } } namespace AnotherProject { const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } } ?> ]]> </programlisting> </example> </para> <para> å¨å®é çç¼ç¨å®è·µä¸ï¼é叏䏿å¡å¨åä¸ä¸ªæä»¶ä¸å®ä¹å¤ä¸ªå½å空é´ãè¿ç§æ¹å¼ç主è¦ç¨äºå°å¤ä¸ª PHP èæ¬åå¹¶å¨åä¸ä¸ªæä»¶ä¸ã </para> <para> å°å ¨å±çéå½å空é´ä¸ç代ç ä¸å½å空é´ä¸ç代ç ç»åå¨ä¸èµ·ï¼åªè½ä½¿ç¨å¤§æ¬å·å½¢å¼çè¯æ³ãå ¨å±ä»£ç å¿ é¡»ç¨ä¸ä¸ªä¸å¸¦åç§°ç namespace è¯å¥å ä¸å¤§æ¬å·æ¬èµ·æ¥ï¼ä¾å¦ï¼ <example> <title>å®ä¹å¤ä¸ªå½å空é´åä¸å å«å¨å½å空é´ä¸ç代ç </title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject { const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } } namespace { // global code session_start(); $a = MyProject\connect(); echo MyProject\Connection::start(); } ?> ]]> </programlisting> </example> </para> <para> é¤äºå¼å§çdeclareè¯å¥å¤ï¼å½å空é´çæ¬å·å¤ä¸å¾æä»»ä½PHP代ç ã <example> <title>å®ä¹å¤ä¸ªå½å空é´åä¸å å«å¨å½å空é´ä¸ç代ç </title> <programlisting role="php"> <![CDATA[ <?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(); } ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.basics"> <title>使ç¨å½å空é´ï¼åºç¡</title> <para> å¨è®¨è®ºå¦ä½ä½¿ç¨å½å空é´ä¹åï¼å¿ é¡»äºè§£ PHP æ¯å¦ä½ç¥éè¦ä½¿ç¨åªä¸ä¸ªå½å空é´ä¸çå ç´ çãå¯ä»¥å° PHP å½å空é´ä¸æä»¶ç³»ç»ä½ä¸ä¸ªç®åçç±»æ¯ãå¨æä»¶ç³»ç»ä¸è®¿é®ä¸ä¸ªæä»¶æä¸ç§æ¹å¼ï¼ <orderedlist> <listitem> <simpara> ç¸å¯¹æä»¶åå½¢å¼å¦<literal>foo.txt</literal>ãå®ä¼è¢«è§£æä¸º <literal>currentdirectory/foo.txt</literal>ï¼å ¶ä¸ currentdirectory 表示å½åç®å½ãå æ¤å¦æå½åç®å½æ¯ <literal>/home/foo</literal>ï¼å该æä»¶å被解æä¸º<literal>/home/foo/foo.txt</literal>ã </simpara> </listitem> <listitem> <simpara> ç¸å¯¹è·¯å¾åå½¢å¼å¦<literal>subdirectory/foo.txt</literal>ãå®ä¼è¢«è§£æä¸º <literal>currentdirectory/subdirectory/foo.txt</literal>ã </simpara> </listitem> <listitem> <simpara> ç»å¯¹è·¯å¾åå½¢å¼å¦<literal>/main/foo.txt</literal>ãå®ä¼è¢«è§£æä¸º<literal>/main/foo.txt</literal>ã </simpara> </listitem> </orderedlist> PHP å½å空é´ä¸çå ç´ ä½¿ç¨åæ ·çåçãä¾å¦ï¼ç±»åå¯ä»¥éè¿ä¸ç§æ¹å¼å¼ç¨ï¼ <orderedlist> <listitem> <simpara> ééå®åç§°ï¼æä¸å å«åç¼çç±»åç§°ï¼ä¾å¦ <literal>$a=new foo();</literal> æ <literal>foo::staticmethod();</literal>ã妿å½åå½åç©ºé´æ¯ <literal>currentnamespace</literal>ï¼foo å°è¢«è§£æä¸º <literal>currentnamespace\foo</literal>ãå¦æä½¿ç¨ foo çä»£ç æ¯å ¨å±çï¼ä¸å å«å¨ä»»ä½å½å空é´ä¸ç代ç ï¼å foo ä¼è¢«è§£æä¸º<literal>foo</literal>ã </simpara> <simpara> è¦åï¼å¦æå½å空é´ä¸ç彿°æå¸¸éæªå®ä¹ï¼å该ééå®ç彿°åç§°æå¸¸éåç§°ä¼è¢«è§£æä¸ºå ¨å±å½æ°åç§°æå¸¸éåç§°ã详æ åè§ <link linkend="language.namespaces.fallback">使ç¨å½å空é´ï¼åå¤å ¨å±å½æ°åç§°/常éåç§°</link>ã </simpara> </listitem> <listitem> <simpara> éå®åç§°,æå å«åç¼çåç§°ï¼ä¾å¦ <literal>$a = new subnamespace\foo();</literal> æ <literal>subnamespace\foo::staticmethod();</literal>ã妿å½åçå½åç©ºé´æ¯ <literal>currentnamespace</literal>ï¼å foo ä¼è¢«è§£æä¸º <literal>currentnamespace\subnamespace\foo</literal>ãå¦æä½¿ç¨ foo çä»£ç æ¯å ¨å±çï¼ä¸å å«å¨ä»»ä½å½å空é´ä¸ç代ç ï¼foo ä¼è¢«è§£æä¸º<literal>subnamespace\foo</literal>ã </simpara> </listitem> <listitem> <simpara> å®å ¨éå®åç§°ï¼æå å«äºå ¨å±åç¼æä½ç¬¦çåç§°ï¼ä¾å¦ï¼ <literal>$a = new \currentnamespace\foo();</literal> æ <literal>\currentnamespace\foo::staticmethod();</literal>ãå¨è¿ç§æ åµä¸ï¼foo æ»æ¯è¢«è§£æä¸ºä»£ç ä¸çæåå(literal name)<literal>currentnamespace\foo</literal>ã </simpara> </listitem> </orderedlist> </para> <para> ä¸é¢æ¯ä¸ä¸ªä½¿ç¨è¿ä¸ç§æ¹å¼çå®ä¾ï¼ <informalexample> <simpara>file1.php</simpara> <programlisting role="php"> <![CDATA[ <?php namespace Foo\Bar\subnamespace; const FOO = 1; function foo() {} class foo { static function staticmethod() {} } ?> ]]> </programlisting> <simpara>file2.php</simpara> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </informalexample> </para> <para> 注æè®¿é®ä»»æå ¨å±ç±»ã彿°æå¸¸éï¼é½å¯ä»¥ä½¿ç¨å®å ¨éå®åç§°ï¼ä¾å¦ <function>\strlen</function> æ <classname>\Exception</classname> æ <literal>\INI_ALL</literal>ã <example> <title>å¨å½å空é´å é¨è®¿é®å ¨å±ç±»ã彿°å常é</title> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.dynamic"> <title>å½å空é´å卿è¯è¨ç¹å¾</title> <para> PHP å½å空é´çå®ç°åå°å ¶è¯è¨èªèº«ç卿ç¹å¾çå½±åãå æ¤ï¼å¦æè¦å°ä¸é¢ç代ç 转æ¢å°å½å空é´ä¸ï¼ <example> <title>å¨æè®¿é®å ç´ </title> <simpara>example1.php:</simpara> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> å¿ é¡»ä½¿ç¨å®å ¨éå®åç§°ï¼å æ¬å½å空é´åç¼çç±»åç§°ï¼ã注æå 为å¨å¨æçç±»åç§°ã彿°åç§°æå¸¸éåç§°ä¸ï¼éå®åç§°åå®å ¨éå®å称没æåºå«ï¼å æ¤å ¶å导çåææ æ¯ä¸å¿ è¦çã <example> <title>å¨æè®¿é®å½å空é´çå ç´ </title> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> </para> <para> 请ä¸å®å«å¿äºé 读 <link linkend="language.namespaces.faq.quote">对å符串ä¸çå½å空é´å称转ä¹ç注解</link>. </para> </sect1> <sect1 xml:id="language.namespaces.nsconstants"> <title>namespaceå ³é®åå__NAMESPACE__常é</title> <para> PHPæ¯æä¸¤ç§æ½è±¡ç访é®å½åå½å空é´å é¨å ç´ çæ¹æ³ï¼<constant>__NAMESPACE__</constant> 鿝叏éå<literal>namespace</literal>å ³é®åã </para> <para> 常é<constant>__ NAMESPACE__</constant>ç弿¯å å«å½åå½å空é´åç§°çå符串ãå¨å ¨å±çï¼ä¸å æ¬å¨ä»»ä½å½å空é´ä¸ç代ç ï¼å®å å«ä¸ä¸ªç©ºçå符串ã <example> <title>__NAMESPACE__ 示ä¾, å¨å½å空é´ä¸ç代ç </title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject; echo '"', __NAMESPACE__, '"'; // è¾åº "MyProject" ?> ]]> </programlisting> </example> <example> <title>__NAMESPACE__ 示ä¾ï¼å ¨å±ä»£ç </title> <programlisting role="php"> <![CDATA[ <?php echo '"', __NAMESPACE__, '"'; // è¾åº "" ?> ]]> </programlisting> </example> 常é <constant>__NAMESPACE__</constant> å¨å¨æå建åç§°æ¶å¾æç¨ï¼ä¾å¦ï¼ <example> <title>使ç¨__NAMESPACE__卿å建åç§°</title> <programlisting role="php"> <![CDATA[ <?php namespace MyProject; function get($classname) { $a = __NAMESPACE__ . '\\' . $classname; return new $a; } ?> ]]> </programlisting> </example> </para> <para> å ³é®å <literal>namespace</literal> å¯ç¨æ¥æ¾å¼è®¿é®å½åå½åç©ºé´æåå½å空é´ä¸çå ç´ ãå®çä»·äºç±»ä¸ç <literal>self</literal> æä½ç¬¦ã <example> <title>namespaceæä½ç¬¦ï¼å½å空é´ä¸ç代ç </title> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> <example> <title>namespaceæä½ç¬¦, å ¨å±ä»£ç </title> <programlisting role="php"> <![CDATA[ <?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 ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.importing"> <title>使ç¨å½å空é´ï¼å«å/å¯¼å ¥</title> <para> å 许éè¿å«åå¼ç¨æå¯¼å ¥å¤é¨çå®å ¨éå®åç§°ï¼æ¯å½å空é´çä¸ä¸ªéè¦ç¹å¾ãè¿æç¹ç±»ä¼¼äºå¨ç±» unix æä»¶ç³»ç»ä¸å¯ä»¥åå»ºå¯¹å ¶å®çæä»¶æç®å½ç符å·è¿æ¥ã </para> <para> PHP å½åç©ºé´æ¯æ æä¸¤ç§ä½¿ç¨å«åæå¯¼å ¥æ¹å¼ï¼ä¸ºç±»å称使ç¨å«åï¼æä¸ºå½å空é´å称使ç¨å«åãæ³¨æPHP䏿¯æå¯¼å ¥å½æ°æå¸¸éã </para> <para> å¨PHPä¸ï¼å«åæ¯éè¿æä½ç¬¦ <literal>use</literal> æ¥å®ç°ç. ä¸é¢æ¯ä¸ä¸ªä½¿ç¨ææå¯è½çä¸ç§å¯¼å ¥æ¹å¼çä¾åï¼ <example> <title>使ç¨useæä½ç¬¦å¯¼å ¥/使ç¨å«å</title> <programlisting role="php"> <![CDATA[ <?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 对象 ?> ]]> </programlisting> </example> 注æå¯¹å½å空é´ä¸çåç§°ï¼å å«å½å空é´åé符çå®å ¨éå®åç§°å¦ <literal>Foo\Bar</literal>以åç¸å¯¹çä¸å å«å½å空é´åé符çå ¨å±åç§°å¦ <literal>FooBar</literal>ï¼æ¥è¯´ï¼å导çåææ æ¯ä¸å¿ è¦çä¹ä¸å 许æåææ ï¼å ä¸ºå¯¼å ¥çåç§°å¿ é¡»æ¯å®å ¨éå®çï¼ä¸ä¼æ ¹æ®å½åçå½å空é´ä½ç¸å¯¹è§£æã Note that for namespaced names (fully qualified namespace names containing namespace separator, such as <literal>Foo\Bar</literal> as opposed to global names that do not, such as <literal>FooBar</literal>), the leading backslash is unnecessary and not allowed, as import names must be fully qualified, and are not processed relative to the current namespace. </para> <para> 为äºç®åæä½ï¼PHPè¿æ¯æå¨ä¸è¡ä¸ä½¿ç¨å¤ä¸ªuseè¯å¥ <example> <title>éè¿useæä½ç¬¦å¯¼å ¥/使ç¨å«åï¼ä¸è¡ä¸å å«å¤ä¸ªuseè¯å¥</title> <programlisting role="php"> <![CDATA[ <?php use My\Full\Classname as Another, My\Full\NSname; $obj = new Another; // å®ä¾å My\Full\Classname 对象 NSname\subns\func(); // è°ç¨å½æ° My\Full\NSname\subns\func ?> ]]> </programlisting> </example> </para> <para> å¯¼å ¥æä½æ¯å¨ç¼è¯æ§è¡çï¼ä½å¨æçç±»åç§°ã彿°åç§°æå¸¸éåç§°å䏿¯ã Importing is performed at compile-time, and so does not affect dynamic class, function or constant names. <example> <title>å¯¼å ¥å卿åç§°</title> <programlisting role="php"> <![CDATA[ <?php use My\Full\Classname as Another, My\Full\NSname; $obj = new Another; // å®ä¾åä¸ä¸ª My\Full\Classname 对象 $a = 'Another'; $obj = new $a; // å®é åä¸ä¸ª Another 对象 ?> ]]> </programlisting> </example> </para> <para> å¦å¤ï¼å¯¼å ¥æä½åªå½±åééå®åç§°åéå®åç§°ãå®å ¨éå®åç§°ç±äºæ¯ç¡®å®çï¼æ ä¸åå¯¼å ¥çå½±åã <example> <title>å¯¼å ¥åå®å ¨éå®åç§°</title> <programlisting role="php"> <![CDATA[ <?php use My\Full\Classname as Another, My\Full\NSname; $obj = new Another; // instantiates object of class My\Full\Classname $obj = new \Another; // instantiates object of class Another $obj = new Another\thing; // instantiates object of class My\Full\Classname\thing $obj = new \Another\thing; // instantiates object of class Another\thing ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.global"> <title>å ¨å±ç©ºé´</title> <para> å¦ææ²¡æå®ä¹ä»»ä½å½å空é´ï¼ææçç±»ä¸å½æ°çå®ä¹é½æ¯å¨å ¨å±ç©ºé´ï¼ä¸ PHP å¼å ¥å½åç©ºé´æ¦å¿µå䏿 ·ãå¨åç§°åå ä¸åç¼ <literal>\</literal> 表示该åç§°æ¯å ¨å±ç©ºé´ä¸çåç§°ï¼å³ä½¿è¯¥åç§°ä½äºå ¶å®çå½å空é´ä¸æ¶ä¹æ¯å¦æ¤ã <example> <title>使ç¨å ¨å±ç©ºé´è¯´æ</title> <programlisting role="php"> <![CDATA[ <?php namespace A\B\C; /* è¿ä¸ªå½æ°æ¯ A\B\C\fopen */ function fopen() { /* ... */ $f = \fopen(...); // è°ç¨å ¨å±çfopen彿° return $f; } ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.fallback"> <title>使ç¨å½å空é´ï¼åå¤å ¨å±å½æ°/常é</title> <para> å¨ä¸ä¸ªå½å空é´ä¸ï¼å½ PHP éå°ä¸ä¸ªééå®çç±»ã彿°æå¸¸éåç§°æ¶ï¼å®ä½¿ç¨ä¸åçä¼å çç¥æ¥è§£æè¯¥åç§°ãç±»åç§°æ»æ¯è§£æå°å½åå½å空é´ä¸çåç§°ãå æ¤å¨è®¿é®ç³»ç»å 鍿ä¸å å«å¨å½å空é´ä¸çç±»åç§°æ¶ï¼å¿ 须使ç¨å®å ¨éå®åç§°ï¼ä¾å¦ï¼ <example> <title>å¨å½å空é´ä¸è®¿é®å ¨å±ç±»</title> <programlisting role="php"> <![CDATA[ <?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 ç±» ?> ]]> </programlisting> </example> </para> <para> 对äºå½æ°åå¸¸éæ¥è¯´ï¼å¦æå½åå½å空é´ä¸ä¸åå¨è¯¥å½æ°æå¸¸éï¼PHP ä¼éè使ç¨å ¨å±ç©ºé´ä¸ç彿°æå¸¸éã For functions and constants, PHP will fall back to global functions or constants if a namespaced function or constant does not exist. <example> <title>å½å空é´ä¸åå¤çå ¨å±å½æ°/常é</title> <programlisting role="php"> <![CDATA[ <?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"; } ?> ]]> </programlisting> </example> </para> </sect1> <sect1 xml:id="language.namespaces.rules"> <title>åç§°è§£æè§å</title> <para> å¨è¯´æåç§°è§£æè§åä¹åï¼æä»¬å çä¸äºéè¦çå®ä¹ï¼ <variablelist> <title>å½å空é´åç§°å®ä¹</title> <varlistentry> <term>ééå®åç§°Unqualified name</term> <listitem> <para> åç§°ä¸ä¸å å«å½å空é´åéç¬¦çæ è¯ç¬¦ï¼ä¾å¦ <literal>Foo</literal> </para> </listitem> </varlistentry> <varlistentry> <term>éå®åç§°Qualified name</term> <listitem> <para> åç§°ä¸å«æå½å空é´åéç¬¦çæ è¯ç¬¦ï¼ä¾å¦ <literal>Foo\Bar</literal> </para> </listitem> </varlistentry> <varlistentry> <term>å®å ¨éå®åç§°Fully qualified name</term> <listitem> <para> åç§°ä¸å å«å½å空é´åé符ï¼å¹¶ä»¥å½å空é´åé符å¼å§çæ è¯ç¬¦ï¼ä¾å¦ <literal>\Foo\Bar</literal>ã <literal>namespace\Foo</literal> 乿¯ä¸ä¸ªå®å ¨éå®åç§°ã </para> </listitem> </varlistentry> </variablelist> </para> <para> åç§°è§£æéµå¾ªä¸åè§åï¼ <orderedlist> <listitem> <simpara> 对å®å ¨éå®åç§°ç彿°ï¼ç±»å常éçè°ç¨å¨ç¼è¯æ¶è§£æãä¾å¦ <literal>new \A\B</literal> è§£æä¸ºç±» <literal>A\B</literal>ã </simpara> </listitem> <listitem> <simpara> ææçééå®åç§°åéå®åç§°ï¼éå®å ¨éå®åç§°ï¼æ ¹æ®å½åçå¯¼å ¥è§åå¨ç¼è¯æ¶è¿è¡è½¬æ¢ãä¾å¦ï¼å¦æå½åç©ºé´ <literal>A\B\C</literal> è¢«å¯¼å ¥ä¸º <literal>C</literal>ï¼é£ä¹å¯¹ <literal>C\D\e()</literal> çè°ç¨å°±ä¼è¢«è½¬æ¢ä¸º <literal>A\B\C\D\e()</literal>ã </simpara> </listitem> <listitem> <simpara> å¨å½å空é´å é¨ï¼ææçæ²¡ææ ¹æ®å¯¼å ¥è§å转æ¢çéå®åç§°åä¼å¨å ¶åé¢å ä¸å½åçå½å空é´åç§°ãä¾å¦ï¼å¨å½åç©ºé´ <literal>A\B</literal> å é¨è°ç¨ <literal>C\D\e()</literal>ï¼å <literal>C\D\e()</literal> ä¼è¢«è½¬æ¢ä¸º <literal>A\B\C\D\e()</literal> ã </simpara> </listitem> <listitem> <simpara> ééå®ç±»åæ ¹æ®å½åçå¯¼å ¥è§åå¨ç¼è¯æ¶è½¬æ¢ï¼ç¨å ¨å代æ¿ççå¯¼å ¥åç§°ï¼ãä¾å¦ï¼å¦æå½åç©ºé´ <literal>A\B\C</literal> å¯¼å ¥ä¸ºCï¼å <literal>new C()</literal> 被转æ¢ä¸º <literal>new A\B\C() </literal>ã </simpara> </listitem> <listitem> <simpara> å¨å½å空é´å é¨ï¼ä¾å¦A\Bï¼ï¼å¯¹ééå®åç§°ç彿°è°ç¨æ¯å¨è¿è¡æ¶è§£æçãä¾å¦å¯¹å½æ° <literal>foo()</literal> çè°ç¨æ¯è¿æ ·è§£æçï¼ </simpara> <orderedlist> <listitem> <simpara> å¨å½åå½å空é´ä¸æ¥æ¾å为 <literal>A\B\foo()</literal> ç彿° </simpara> </listitem> <listitem> <simpara> å°è¯æ¥æ¾å¹¶è°ç¨ <emphasis>å ¨å±(global)</emphasis> 空é´ä¸ç彿° <literal>foo()</literal>ã </simpara> </listitem> </orderedlist> </listitem> <listitem> <simpara> å¨å½å空é´ï¼ä¾å¦<literal>A\B</literal>ï¼å é¨å¯¹ééå®åç§°æéå®åç§°ç±»ï¼éå®å ¨éå®åç§°ï¼çè°ç¨æ¯å¨è¿è¡æ¶è§£æçãä¸é¢æ¯è°ç¨ <literal>new C()</literal> å <literal>new D\E()</literal> çè§£æè¿ç¨ï¼ <literal> new C()</literal>çè§£æ: </simpara> <orderedlist> <listitem> <simpara> å¨å½åå½å空é´ä¸æ¥æ¾<literal>A\B\C</literal>ç±»ã </simpara> </listitem> <listitem> <simpara> å°è¯èªå¨è£ 载类<literal>A\B\C</literal>ã </simpara> </listitem> </orderedlist> <simpara> <literal> new D\E()</literal>çè§£æ: </simpara> <orderedlist> <listitem> <simpara> å¨ç±»åç§°åé¢å ä¸å½åå½å空é´åç§°åæï¼<literal>A\B\D\E</literal>ï¼ç¶åæ¥æ¾è¯¥ç±»ã </simpara> </listitem> <listitem> <simpara> å°è¯èªå¨è£ 载类 <literal>A\B\D\E</literal>ã </simpara> </listitem> </orderedlist> <simpara> 为äºå¼ç¨å ¨å±å½å空é´ä¸çå ¨å±ç±»ï¼å¿ 须使ç¨å®å ¨éå®åç§° <literal>new \C()</literal>ã </simpara> </listitem> </orderedlist> </para> <example> <title>åç§°è§£æç¤ºä¾</title> <programlisting role="php"> <![CDATA[ <?php namespace A; use B\D, C\E as F; // 彿°è°ç¨ foo(); // é¦å å°è¯è°ç¨å®ä¹å¨å½å空é´"A"ä¸ç彿°foo() // åå°è¯è°ç¨å ¨å±å½æ° "foo" \foo(); // è°ç¨å ¨å±ç©ºé´å½æ° "foo" my\foo(); // è°ç¨å®ä¹å¨å½å空é´"A\my"ä¸å½æ° "foo" F(); // é¦å å°è¯è°ç¨å®ä¹å¨å½å空é´"A"ä¸ç彿° "F" // åå°è¯è°ç¨å ¨å±å½æ° "F" // ç±»å¼ç¨ new B(); // å建å½åç©ºé´ "A" ä¸å®ä¹çç±» "B" çä¸ä¸ªå¯¹è±¡ // å¦ææªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "A\B" new D(); // 使ç¨å¯¼å ¥è§åï¼å建å½åç©ºé´ "B" ä¸å®ä¹çç±» "D" çä¸ä¸ªå¯¹è±¡ // å¦ææªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "B\D" new F(); // 使ç¨å¯¼å ¥è§åï¼å建å½åç©ºé´ "C" ä¸å®ä¹çç±» "E" çä¸ä¸ªå¯¹è±¡ // å¦ææªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "C\E" new \B(); // å建å®ä¹å¨å ¨å±ç©ºé´ä¸çç±» "B" çä¸ä¸ªå¯¹è±¡ // 妿æªåç°ï¼åå°è¯èªå¨è£ 载类 "B" new \D(); // å建å®ä¹å¨å ¨å±ç©ºé´ä¸çç±» "D" çä¸ä¸ªå¯¹è±¡ // 妿æªåç°ï¼åå°è¯èªå¨è£ 载类 "D" new \F(); // å建å®ä¹å¨å ¨å±ç©ºé´ä¸çç±» "F" çä¸ä¸ªå¯¹è±¡ // 妿æªåç°ï¼åå°è¯èªå¨è£ 载类 "F" // è°ç¨å¦ä¸ä¸ªå½å空é´ä¸çéææ¹æ³æå½å空é´å½æ° B\foo(); // è°ç¨å½åç©ºé´ "A\B" ä¸å½æ° "foo" B::foo(); // è°ç¨å½åç©ºé´ "A" ä¸å®ä¹çç±» "B" ç "foo" æ¹æ³ // å¦ææªæ¾å°ç±» "A\B" ï¼åå°è¯èªå¨è£ 载类 "A\B" D::foo(); // 使ç¨å¯¼å ¥è§åï¼è°ç¨å½åç©ºé´ "B" ä¸å®ä¹çç±» "D" ç "foo" æ¹æ³ // å¦æç±» "B\D" æªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "B\D" \B\foo(); // è°ç¨å½åç©ºé´ "B" ä¸ç彿° "foo" \B::foo(); // è°ç¨å ¨å±ç©ºé´ä¸çç±» "B" ç "foo" æ¹æ³ // å¦æç±» "B" æªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "B" // å½åå½å空é´ä¸çéææ¹æ³æå½æ° A\B::foo(); // è°ç¨å½åç©ºé´ "A\A" ä¸å®ä¹çç±» "B" ç "foo" æ¹æ³ // å¦æç±» "A\A\B" æªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "A\A\B" \A\B::foo(); // è°ç¨å½åç©ºé´ "A\B" ä¸å®ä¹çç±» "B" ç "foo" æ¹æ³ // å¦æç±» "A\B" æªæ¾å°ï¼åå°è¯èªå¨è£ 载类 "A\B" ?> ]]> </programlisting> </example> </sect1> <sect1 xml:id="language.namespaces.faq"> <title>FAQ: things you need to know about namespaces</title> <para> This FAQ is split into two sections: common questions, and some specifics of implementation that are helpful to understand fully. </para> <para> First, the common questions. <orderedlist> <listitem> <simpara> <link linkend="language.namespaces.faq.shouldicare">If I don't use namespaces, should I care about any of this?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.globalclass">How do I use internal or global classes in a namespace?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.innamespace">How do I use namespaces classes functions, or constants in their own namespace?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.full"> How does a name like <literal>\my\name</literal> or <literal>\name</literal> resolve? </link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.qualified">How does a name like <literal>my\name</literal> resolve?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.shortname1">How does an unqualified class name like <literal>name</literal> resolve?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.shortname2">How does an unqualified function name or unqualified constant name like <literal>name</literal> resolve?</link> </simpara> </listitem> </orderedlist> </para> <para> There are a few implementation details of the namespace implementations that are helpful to understand. <orderedlist> <listitem> <simpara> <link linkend="language.namespaces.faq.conflict">Import names cannot conflict with classes defined in the same file.</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.nested">Nested namespaces are not allowed. </link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.nofuncconstantuse">Neither functions nor constants can be imported via the <literal>use</literal> statement.</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.quote">Dynamic namespace names (quoted identifiers) should escape backslash.</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.constants">Undefined Constants referenced using any backslash die with fatal error</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.builtinconst">Cannot override special constants NULL, TRUE, FALSE, ZEND_THREAD_SAFE or ZEND_DEBUG_BUILD</link> </simpara> </listitem> </orderedlist> </para> <sect2 xml:id="language.namespaces.faq.shouldicare"> <title>If I don't use namespaces, should I care about any of this?</title> <para> No. Namespaces do not affect any existing code in any way, or any as-yet-to-be-written code that does not contain namespaces. You can write this code if you wish: </para> <para> <example> <title>Accessing global classes outside a namespace</title> <programlisting role="php"> <![CDATA[ <?php $a = new \stdClass; ]]> </programlisting> </example> </para> <para> This is functionally equivalent to: </para> <para> <example> <title>Accessing global classes outside a namespace</title> <programlisting role="php"> <![CDATA[ <?php $a = new stdClass; ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.globalclass"> <title>How do I use internal or global classes in a namespace?</title> <para> <example> <title>Accessing internal classes in namespaces</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; $a = new \stdClass; function test(\ArrayObject $typehintexample = null) {} $a = \DirectoryIterator::CURRENT_AS_FILEINFO; // extending an internal or global class class MyException extends \Exception {} ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.innamespace"> <title> How do I use namespaces classes, functions, or constants in their own namespace? </title> <para> <example> <title>Accessing internal classes, functions or constants in namespaces</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; class MyClass {} // using a class from the current namespace as a type hint function test(MyClass $typehintexample = null) {} // another way to use a class from the current namespace as a type hint function test(\foo\MyClass $typehintexample = null) {} // extending a class from the current namespace class Extended extends MyClass {} // accessing a global function $a = \globalfunc(); // accessing a global constant $b = \INI_ALL; ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.full"> <title> How does a name like <literal>\my\name</literal> or <literal>\name</literal> resolve? </title> <para> Names that begin with a <literal>\</literal> always resolve to what they look like, so <literal>\my\name</literal> is in fact <literal>my\name</literal>, and <literal>\Exception</literal> is <literal>Exception</literal>. <example> <title>Fully Qualified names</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; $a = new \my\name(); // instantiates "my\name" class echo \strlen('hi'); // calls function "strlen" $a = \INI_ALL; // $a is set to the value of constant "INI_ALL" ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.qualified"> <title>How does a name like <literal>my\name</literal> resolve?</title> <para> Names that contain a backslash but do not begin with a backslash like <literal>my\name</literal> can be resolved in 2 different ways. </para> <para> If there is an import statement that aliases another name to <literal>my</literal>, then the import alias is applied to the <literal>my</literal> in <literal>my\name</literal>. </para> <para> Otherwise, the current namespace name is prepended to <literal>my\name</literal>. </para> <para> <example> <title>Qualified names</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; use blah\blah as foo; $a = new my\name(); // instantiates "foo\my\name" class foo\bar::name(); // calls static method "name" in class "blah\blah\bar" my\bar(); // calls function "foo\my\bar" $a = my\BAR; // sets $a to the value of constant "foo\my\BAR" ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.shortname1"> <title>How does an unqualified class name like <literal>name</literal> resolve?</title> <para> Class names that do not contain a backslash like <literal>name</literal> can be resolved in 2 different ways. </para> <para> If there is an import statement that aliases another name to <literal>name</literal>, then the import alias is applied. </para> <para> Otherwise, the current namespace name is prepended to <literal>name</literal>. </para> <para> <example> <title>Unqualified class names</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; use blah\blah as foo; $a = new name(); // instantiates "foo\name" class foo::name(); // calls static method "name" in class "blah\blah" ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.shortname2"> <title> How does an unqualified function name or unqualified constant name like <literal>name</literal> resolve? </title> <para> Function or constant names that do not contain a backslash like <literal>name</literal> can be resolved in 2 different ways. </para> <para> First, the current namespace name is prepended to <literal>name</literal>. </para> <para> Finally, if the constant or function <literal>name</literal> does not exist in the current namespace, a global constant or function <literal>name</literal> is used if it exists. </para> <para> <example> <title>Unqualified function or constant names</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; use blah\blah as foo; const FOO = 1; function my() {} function foo() {} function sort(&$a) { sort($a); $a = array_flip($a); return $a; } my(); // calls "foo\my" $a = strlen('hi'); // calls global function "strlen" because "foo\strlen" does not exist $arr = array(1,3,2); $b = sort($arr); // calls function "foo\sort" $c = foo(); // calls function "foo\foo" - import is not applied $a = FOO; // sets $a to value of constant "foo\FOO" - import is not applied $b = INI_ALL; // sets $b to value of global constant "INI_ALL" ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.conflict"> <title>Import names cannot conflict with classes defined in the same file.</title> <para> The following script combinations are legal: <informalexample> <simpara>file1.php</simpara> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff; class MyClass {} ?> ]]> </programlisting> <simpara>another.php</simpara> <programlisting role="php"> <![CDATA[ <?php namespace another; class thing {} ?> ]]> </programlisting> <simpara>file2.php</simpara> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff; include 'file1.php'; include 'another.php'; use another\thing as MyClass; $a = new MyClass; // instantiates class "thing" from namespace another ?> ]]> </programlisting> </informalexample> </para> <para> There is no name conflict, even though the class <literal>MyClass</literal> exists within the <literal>my\stuff</literal> namespace, because the MyClass definition is in a separate file. However, the next example causes a fatal error on name conflict because MyClass is defined in the same file as the use statement. <informalexample> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff; use another\thing as MyClass; class MyClass {} // fatal error: MyClass conflicts with import statement $a = new MyClass; ?> ]]> </programlisting> </informalexample> </para> </sect2> <sect2 xml:id="language.namespaces.faq.nested"> <title>Nested namespaces are not allowed.</title> <para> PHP does not allow nesting namespaces <informalexample> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff { namespace nested { class foo {} } } ?> ]]> </programlisting> </informalexample> However, it is easy to simulate nested namespaces like so: <informalexample> <programlisting role="php"> <![CDATA[ <?php namespace my\stuff\nested { class foo {} } ?> ]]> </programlisting> </informalexample> </para> </sect2> <sect2 xml:id="language.namespaces.faq.nofuncconstantuse"> <title>Neither functions nor constants can be imported via the <literal>use</literal> statement.</title> <para> The only elements that are affected by <literal>use</literal> statements are namespaces and class names. In order to shorten a long constant or function, import its containing namespace <informalexample> <programlisting role="php"> <![CDATA[ <?php namespace mine; use ultra\long\ns\name; $a = name\CONSTANT; name\func(); ?> ]]> </programlisting> </informalexample> </para> </sect2> <sect2 xml:id="language.namespaces.faq.quote"> <title>Dynamic namespace names (quoted identifiers) should escape backslash</title> <para> It is very important to realize that because the backslash is used as an escape character within strings, it should always be doubled when used inside a string. Otherwise there is a risk of unintended consequences: <example> <title>Dangers of using namespaced names inside a double-quoted string</title> <programlisting role="php"> <![CDATA[ <?php $a = new "dangerous\name"; // \n is a newline inside double quoted strings! $obj = new $a; $a = new 'not\at\all\dangerous'; // no problems here. $obj = new $a; ?> ]]> </programlisting> </example> Inside a single-quoted string, the backslash escape sequence is much safer to use, but it is still recommended practice to escape backslashes in all strings as a best practice. </para> </sect2> <sect2 xml:id="language.namespaces.faq.constants"> <title>Undefined Constants referenced using any backslash die with fatal error</title> <para> Any undefined constant that is unqualified like <literal>FOO</literal> will produce a notice explaining that PHP assumed <literal>FOO</literal> was the value of the constant. Any constant, qualified or fully qualified, that contains a backslash will produce a fatal error if not found. <example> <title>Undefined constants</title> <programlisting role="php"> <![CDATA[ <?php namespace bar; $a = FOO; // produces notice - undefined constants "FOO" assumed "FOO"; $a = \FOO; // fatal error, undefined namespace constant FOO $a = Bar\FOO; // fatal error, undefined namespace constant bar\Bar\FOO $a = \Bar\FOO; // fatal error, undefined namespace constant Bar\FOO ?> ]]> </programlisting> </example> </para> </sect2> <sect2 xml:id="language.namespaces.faq.builtinconst"> <title>Cannot override special constants NULL, TRUE, FALSE, ZEND_THREAD_SAFE or ZEND_DEBUG_BUILD</title> <para> Any attempt to define a namespaced constant that is a special, built-in constant results in a fatal error <example> <title>Undefined constants</title> <programlisting role="php"> <![CDATA[ <?php namespace bar; const NULL = 0; // fatal error; const true = 'stupid'; // also fatal error; // etc. ?> ]]> </programlisting> </example> </para> </sect2> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->