cvs: phpdoc-zh /language/oop5 abstract.xml autoload.xml basic.xml cloning.xml constants.xml decon.xml final.xml iterations.xml magic.xml
object-comparison.xml overloading.xml paamayim-nekudotayim.xml patterns.xml static.xml visibility.xml

From: Date: Sat, 13 Dec 2008 10:50:24 +0000
Subject: cvs: phpdoc-zh /language/oop5 abstract.xml autoload.xml basic.xml cloning.xml constants.xml decon.xml final.xml iterations.xml magic.xml
object-comparison.xml overloading.xml paamayim-nekudotayim.xml patterns.xml static.xml visibility.xml
Groups: php.doc.zh 
Request: Send a blank email to doc-zh+get-3054@lists.php.net to get a copy of this message
haohappy Sat Dec 13 10:50:24 2008 UTC Modified files: /phpdoc-zh/language/oop5 abstract.xml autoload.xml basic.xml cloning.xml constants.xml decon.xml final.xml iterations.xml magic.xml object-comparison.xml overloading.xml paamayim-nekudotayim.xml patterns.xml static.xml visibility.xml Log: File encoding changed from gb2312 to utf8.

http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/abstract.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/abstract.xml diff -u phpdoc-zh/language/oop5/abstract.xml:1.3 phpdoc-zh/language/oop5/abstract.xml:1.4 --- phpdoc-zh/language/oop5/abstract.xml:1.3 Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/abstract.xml Sat Dec 13 10:50:22 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.15 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.abstract" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/autoload.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-zh/language/oop5/autoload.xml diff -u phpdoc-zh/language/oop5/autoload.xml:1.4 phpdoc-zh/language/oop5/autoload.xml:1.5 --- phpdoc-zh/language/oop5/autoload.xml:1.4 Sun Jul 8 05:00:42 2007 +++ phpdoc-zh/language/oop5/autoload.xml Sat Dec 13 10:50:22 2008 @@ -1,40 +1,40 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.4 $ --> -<!-- $Author: yincheng $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> +<!-- $Author: haohappy $ --> <!-- EN-Revision: 1.8 Maintainer: dallas Status: ready --> <sect1 xml:id="language.oop5.autoload" xmlns="http://docbook.org/ns/docbook"> - <title>×Ô¶¯¼ÓÔØ¶ÔÏó</title> + <title>自动加载对象</title> <para> - ºÜ¶à¿ª·¢ÕßÐ´ÃæÏò¶ÔÏóµÄÓ¦ÓóÌÐòʱ¶Ôÿ¸öÀàµÄ¶¨Ò彨Á¢Ò»¸ö - PHP Ô´Îļþ¡£Ò»¸öºÜ´óµÄ·³ÄÕÊDz»µÃ²»ÔÚÿ¸ö½Å±¾£¨Ã¿¸öÀàÒ»¸öÎļþ£©¿ªÍ·Ð´Ò»¸ö³¤³¤µÄ°üº¬ÎļþÁÐ±í¡£ + 很多开发者写面向对象的应用程序时对每个类的定义建立一个 + PHP 源文件。一个很大的烦恼是不得不在每个脚本(每个类一个文件)开头写一个长长的包含文件列表。 </para> <para> - ÔÚ PHP 5 ÖУ¬²»ÔÙÐèÒªÕâÑùÁË¡£¿ÉÒÔ¶¨ÒåÒ»¸ö - __autoload º¯Êý£¬Ëü»áÔÚÊÔͼʹÓÃÉÐδ±»¶¨ÒåµÄÀàʱ×Ô¶¯µ÷Óá£Í¨¹ýµ÷Óô˺¯Êý£¬½Å±¾ÒýÇæÔÚ - PHP ³ö´íʧ°ÜǰÓÐÁË×îºóÒ»¸ö»ú»á¼ÓÔØËùÐèµÄÀà¡£ + 在 PHP 5 中,不再需要这样了。可以定义一个 + __autoload 函数,它会在试图使用尚未被定义的类时自动调用。通过调用此函数,脚本引擎在 + PHP 出错失败前有了最后一个机会加载所需的类。 </para> <note> <para> - ÔÚ __autoload º¯ÊýÖÐÅ׳öµÄÒì³£²»Äܱ» + 在 __autoload 函数中抛出的异常不能被 <link linkend="language.exceptions">catch</link> - Óï¾ä¿é²¶»ñ²¢µ¼ÖÂÖÂÃü´íÎó¡£ + 语句块捕获并导致致命错误。 </para> </note> <note> <para> - Èç¹ûʹÓà PHP µÄ CLI - <link linkend="features.commandline">½»»¥Ä£Ê½</link> - ʱ£¬Autoloading ²»´æÔÚ¡£ + 如果使用 PHP 的 CLI + <link linkend="features.commandline">交互模式</link> + 时,Autoloading 不存在。 </para> </note> <para> <example> - <title>Autoload Àý×Ó</title> + <title>Autoload 例子</title> <para> - ±¾Àý³¢ÊÔ·Ö±ð´Ó <filename>MyClass1.php</filename> - ºÍ <filename>MyClass2.php</filename> ÎļþÖмÓÔØ - <literal>MyClass1</literal> ºÍ - <literal>MyClass2</literal> Àà¡£ + 本例尝试分别从 <filename>MyClass1.php</filename> + 和 <filename>MyClass2.php</filename> 文件中加载 + <literal>MyClass1</literal> 和 + <literal>MyClass2</literal> 类。 </para> <programlisting role="php"> <![CDATA[ http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/basic.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-zh/language/oop5/basic.xml diff -u phpdoc-zh/language/oop5/basic.xml:1.4 phpdoc-zh/language/oop5/basic.xml:1.5 --- phpdoc-zh/language/oop5/basic.xml:1.4 Sat Jun 23 13:32:42 2007 +++ phpdoc-zh/language/oop5/basic.xml Sat Dec 13 10:50:22 2008 @@ -1,20 +1,20 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.4 $ --> -<!-- $Author: bjori $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> +<!-- $Author: haohappy $ --> <!-- EN-Revision: 1.17 Maintainer: dallas Status: ready --> <sect1 xml:id="language.oop5.basic" xmlns="http://docbook.org/ns/docbook"> - <title>»ù±¾¸ÅÄî</title> + <title>基本概念</title> <sect2 xml:id="language.oop5.basic.class"> <title>class</title> <para> - ÿ¸öÀàµÄ¶¨Òå¶¼ÒԹؼü×Ö class ¿ªÍ·£¬ºóÃæ¸ú×ÅÀàÃû£¬¿ÉÒÔÊÇÈÎºÎ·Ç - PHP <link linkend="reserved">±£Áô×Ö</link>µÄÃû×Ö¡£ºóÃæ¸ú×ÅÒ»¶Ô»¨À¨ºÅ£¬ÀïÃæ°üº¬ÓÐÀà³ÉÔ±ºÍ·½·¨µÄ¶¨Ò塣α±äÁ¿ - <varname>$this</varname> ¿ÉÒÔÔÚµ±Ò»¸ö·½·¨ÔÚ¶ÔÏóÄÚ²¿µ÷ÓÃʱʹÓá£<varname>$this</varname> - ÊÇÒ»¸öµ½µ÷ÓöÔÏó£¨Í¨³£ÊÇ·½·¨ËùÊôÓڵĶÔÏ󣬵«Ò²¿ÉÒÔÊÇÁíÒ»¸ö¶ÔÏó£¬Èç¹û¸Ã·½·¨ÊÇ´ÓµÚ¶þ¸ö¶ÔÏóÄÚ<link - linkend="language.oop5.static">¾²Ì¬</link>µ÷Óõϰ£©µÄÒýÓ᣿´ÏÂÃæÀý×Ó£º + 每个类的定义都以关键字 class 开头,后面跟着类名,可以是任何非 + PHP <link linkend="reserved">保留字</link>的名字。后面跟着一对花括号,里面包含有类成员和方法的定义。伪变量 + <varname>$this</varname> 可以在当一个方法在对象内部调用时使用。<varname>$this</varname> + 是一个到调用对象(通常是方法所属于的对象,但也可以是另一个对象,如果该方法是从第二个对象内<link + linkend="language.oop5.static">静态</link>调用的话)的引用。看下面例子: <example> - <title>ÃæÏò¶ÔÏóÓïÑÔÖÐµÄ <varname>$this</varname> ±äÁ¿</title> + <title>面向对象语言中的 <varname>$this</varname> 变量</title> <programlisting role="php"> <![CDATA[ <?php @@ -61,16 +61,16 @@ </example> </para> <example> - <title>¼òµ¥µÄÀඨÒå</title> + <title>简单的类定义</title> <programlisting role="php"> <![CDATA[ <?php class SimpleClass { - // ³ÉÔ±ÉùÃ÷ + // 成员声明 public $var = 'a default value'; - // ·½·¨ÉùÃ÷ + // 方法声明 public function displayVar() { echo $this->var; } @@ -81,13 +81,13 @@ </example> <para> <example> - <title>Àà³ÉÔ±µÄĬÈÏÖµ</title> + <title>类成员的默认值</title> <programlisting role="php"> <![CDATA[ <?php class SimpleClass { - // ÎÞЧµÄÀà³ÉÔ±¶¨Ò壺 + // 无效的类成员定义: public $var1 = 'hello '.'world'; public $var2 = <<<EOD hello world @@ -96,7 +96,7 @@ public $var4 = self::myStaticMethod(); public $var5 = $myVar; - // ÕýÈ·µÄÀà³ÉÔ±¶¨Ò壺 + // 正确的类成员定义: public $var6 = myConstant; public $var7 = self::classConstant; public $var8 = array(true, false); @@ -110,8 +110,8 @@ </para> <note> <para> - ³ý´ËÖ®Í⻹Óв»ÉÙÓÃÓÚ´¦ÀíÀàÓë¶ÔÏóµÄº¯Êý£¬ÏêÇé²Î¼û - <link linkend="ref.classobj">Àà / ¶ÔÏóº¯Êý </link> + 除此之外还有不少用于处理类与对象的函数,详情参见 + <link linkend="ref.classobj">ç±» / 对象函数 </link> </para> </note> </sect2> @@ -119,12 +119,12 @@ <sect2 xml:id="language.oop5.basic.new"> <title>new</title> <para> - Òª´´½¨Ò»¸ö¶ÔÏóµÄʵÀý£¬±ØÐë´´½¨Ò»¸öжÔÏó²¢½«Æä¸³¸øÒ»¸ö±äÁ¿¡£µ±´´½¨Ð¶ÔÏóʱ¸Ã¶ÔÏó×ÜÊDZ»¸³Öµ£¬³ý·Ç¸Ã¶ÔÏó¶¨ÒåÁË<link - linkend="language.oop5.decon">¹¹Ô캯Êý</link>²¢ÇÒÔÚ³ö´íʱÅ׳öÁËÒ»¸ö<link - linkend="language.exceptions">Òì³£</link>¡£ + 要创建一个对象的实例,必须创建一个新对象并将其赋给一个变量。当创建新对象时该对象总是被赋值,除非该对象定义了<link + linkend="language.oop5.decon">构造函数</link>并且在出错时抛出了一个<link + linkend="language.exceptions">异常</link>。 </para> <example> - <title>´´½¨Ò»¸öʵÀýe</title> + <title>创建一个实例e</title> <programlisting role="php"> <![CDATA[ <?php @@ -134,11 +134,11 @@ </programlisting> </example> <para> - µ±°ÑÒ»¸ö¶ÔÏóÒѾ­´´½¨µÄʵÀý¸³¸øÒ»¸öбäÁ¿Ê±£¬Ð±äÁ¿»á·ÃÎÊͬһ¸öʵÀý£¬¾ÍºÍÓøöÔÏó¸³ÖµÒ»Ñù¡£´ËÐÐΪºÍ¸øº¯Êý´«µÝÈëʵÀýʱһÑù¡£¿ÉÒÔÓÃ<link - linkend="language.oop5.cloning">¿Ë¡</link>¸øÒ»¸öÒÑ´´½¨µÄ¶ÔÏó½¨Á¢Ò»¸öÐÂʵÀý¡£ + 当把一个对象已经创建的实例赋给一个新变量时,新变量会访问同一个实例,就和用该对象赋值一样。此行为和给函数传递入实例时一样。可以用<link + linkend="language.oop5.cloning">克隆</link>给一个已创建的对象建立一个新实例。 </para> <example> - <title>¶ÔÏó¸³Öµ</title> + <title>对象赋值</title> <programlisting role="php"> <![CDATA[ <?php @@ -172,17 +172,17 @@ <sect2 xml:id="language.oop5.basic.extends"> <title>extends</title> <para> - Ò»¸öÀà¿ÉÒÔÔÚÉùÃ÷ÖÐÓà extends - ¹Ø¼ü×ּ̳ÐÁíÒ»¸öÀàµÄ·½·¨ºÍ³ÉÔ±¡£²»ÄÜÀ©Õ¹¶à¸öÀֻ࣬Äܼ̳ÐÒ»¸ö»ùÀà¡£ + 一个类可以在声明中用 extends + 关键字继承另一个类的方法和成员。不能扩展多个类,只能继承一个基类。 </para> <para> - ±»¼Ì³ÐµÄ·½·¨ºÍ³ÉÔ±¿ÉÒÔͨ¹ýÓÃͬÑùµÄÃû×ÖÖØÐÂÉùÃ÷±»¸²¸Ç£¬³ý·Ç¸¸ÀඨÒå·½·¨Ê±Ê¹ÓÃÁË - <link linkend="language.oop5.final">final</link> ¹Ø¼ü×Ö¡£¿ÉÒÔͨ¹ý + 被继承的方法和成员可以通过用同样的名字重新声明被覆盖,除非父类定义方法时使用了 + <link linkend="language.oop5.final">final</link> 关键字。可以通过 <link linkend="language.oop5.paamayim-nekudotayim">parent::</link> - À´·ÃÎʱ»¸²¸ÇµÄ·½·¨»ò³ÉÔ±¡£ + 来访问被覆盖的方法或成员。 </para> <example> - <title>¼òµ¥µÄÀà¼Ì³Ð</title> + <title>简单的类继承</title> <programlisting role="php"> <![CDATA[ <?php http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/cloning.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/cloning.xml diff -u phpdoc-zh/language/oop5/cloning.xml:1.3 phpdoc-zh/language/oop5/cloning.xml:1.4 --- phpdoc-zh/language/oop5/cloning.xml:1.3 Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/cloning.xml Sat Dec 13 10:50:22 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.6 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.cloning" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/constants.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/constants.xml diff -u phpdoc-zh/language/oop5/constants.xml:1.3 phpdoc-zh/language/oop5/constants.xml:1.4 --- phpdoc-zh/language/oop5/constants.xml:1.3 Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/constants.xml Sat Dec 13 10:50:22 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.17 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/decon.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-zh/language/oop5/decon.xml diff -u phpdoc-zh/language/oop5/decon.xml:1.10 phpdoc-zh/language/oop5/decon.xml:1.11 --- phpdoc-zh/language/oop5/decon.xml:1.10 Sat Jun 23 13:32:42 2007 +++ phpdoc-zh/language/oop5/decon.xml Sat Dec 13 10:50:22 2008 @@ -1,28 +1,28 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.10 $ --> -<!-- $Author: bjori $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.11 $ --> +<!-- $Author: haohappy $ --> <!-- EN-Revision: 1.12 Maintainer: lm92 Status: ready --> <sect1 xml:id="language.oop5.decon" xmlns="http://docbook.org/ns/docbook"> - <title>¹¹Ô캯ÊýºÍÎö¹¹º¯Êý</title> + <title>构造函数和析构函数</title> <sect2 xml:id="language.oop5.decon.constructor"> - <title>¹¹Ô캯Êý</title> + <title>构造函数</title> <methodsynopsis> <type>void</type><methodname>__construct</methodname> <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam> <methodparam choice="opt"><parameter>...</parameter></methodparam> </methodsynopsis> <para> - PHP 5 ÔÊÐпª·¢ÕßÔÚÒ»¸öÀàÖж¨ÒåÒ»¸ö·½·¨×÷Ϊ¹¹Ô캯Êý¡£¾ßÓй¹Ô캯ÊýµÄÀà»áÔÚÿ´Î´´½¨¶ÔÏóʱÏȵ÷Óô˷½·¨£¬ËùÒԷdz£ÊʺÏÔÚʹÓöÔÏó֮ǰ×öһЩ³õʼ»¯¹¤×÷¡£ + PHP 5 允行开发者在一个类中定义一个方法作为构造函数。具有构造函数的类会在每次创建对象时先调用此方法,所以非常适合在使用对象之前做一些初始化工作。 </para> <note> <simpara> - Èç¹û×ÓÀàÖж¨ÒåÁ˹¹Ô캯ÊýÔò²»»á°µÖе÷ÓÃÆä¸¸ÀàµÄ¹¹Ô캯Êý¡£ÒªÖ´Ðи¸ÀàµÄ¹¹Ô캯Êý£¬ÐèÒªÔÚ×ÓÀàµÄ¹¹Ô캯ÊýÖе÷Óà - <function>parent::__construct</function>¡£ + 如果子类中定义了构造函数则不会暗中调用其父类的构造函数。要执行父类的构造函数,需要在子类的构造函数中调用 + <function>parent::__construct</function>。 </simpara> </note> <example> - <title>ʹÓÃбê×¼µÄ¹¹Ô캯Êý</title> + <title>使用新标准的构造函数</title> <programlisting role="php"> <![CDATA[ <?php @@ -46,24 +46,24 @@ </programlisting> </example> <para> - ΪÁËʵÏÖÏòºó¼æÈÝÐÔ£¬Èç¹û PHP 5 ÔÚÀàÖÐÕÒ²»µ½ <function>__construct</function> - º¯Êý£¬Ëü¾Í»á³¢ÊÔѰÕÒ¾ÉʽµÄ¹¹Ô캯Êý£¬Ò²¾ÍÊǺÍÀàͬÃûµÄº¯Êý¡£Òò´ËΨһ»á²úÉú¼æÈÝÐÔÎÊÌâµÄÇé¿öÊÇ£ºÀàÖÐÒÑÓÐÒ»¸öÃûΪ - <function>__construct</function> µÄ·½·¨£¬µ«ËüÈ´ÓÖ²»Êǹ¹Ô캯Êý¡£ + 为了实现向后兼容性,如果 PHP 5 在类中找不到 <function>__construct</function> + 函数,它就会尝试寻找旧式的构造函数,也就是和类同名的函数。因此唯一会产生兼容性问题的情况是:类中已有一个名为 + <function>__construct</function> 的方法,但它却又不是构造函数。 </para> </sect2> <sect2 xml:id="language.oop5.decon.destructor"> - <title>Îö¹¹º¯Êý</title> + <title>析构函数</title> <methodsynopsis> <type>void</type><methodname>__destruct</methodname> <void /> </methodsynopsis> <para> - PHP 5 ÒýÈëÁËÎö¹¹º¯ÊýµÄ¸ÅÄÕâÀàËÆÓÚÆäËüÃæÏò¶ÔÏóµÄÓïÑÔ£¬Èç - C++¡£Îö¹¹º¯Êý»áÔÚµ½Ä³¸ö¶ÔÏóµÄËùÓÐÒýÓö¼±»É¾³ý»òÕßµ±¶ÔÏó±»ÏÔʽÏú»ÙʱִÐС£ + PHP 5 引入了析构函数的概念,这类似于其它面向对象的语言,如 + C++。析构函数会在到某个对象的所有引用都被删除或者当对象被显式销毁时执行。 </para> <example> - <title>Îö¹¹º¯ÊýʾÀý</title> + <title>析构函数示例</title> <programlisting role="php"> <![CDATA[ <?php @@ -84,17 +84,17 @@ </programlisting> </example> <para> - ºÍ¹¹Ô캯ÊýÒ»Ñù£¬¸¸ÀàµÄÎö¹¹º¯Êý²»»á±»ÒýÇæ°µÖе÷Óá£ÒªÖ´Ðи¸ÀàµÄÎö¹¹º¯Êý£¬±ØÐëÔÚ×ÓÀàµÄÎö¹¹º¯ÊýÌåÖÐÏÔʽµ÷Óà - <function>parent::__destruct</function>¡£ + 和构造函数一样,父类的析构函数不会被引擎暗中调用。要执行父类的析构函数,必须在子类的析构函数体中显式调用 + <function>parent::__destruct</function>。 </para> <note> <para> - Îö¹¹º¯ÊýÔڽű¾¹Ø±Õʱµ÷Ó㬴ËʱËùÓеÄÍ·ÐÅÏ¢ÒѾ­·¢³ö¡£ + 析构函数在脚本关闭时调用,此时所有的头信息已经发出。 </para> </note> <note> <para> - ÊÔͼÔÚÎö¹¹º¯ÊýÖÐÅ׳öÒ»¸öÒì³£»áµ¼ÖÂÖÂÃü´íÎó¡£ + 试图在析构函数中抛出一个异常会导致致命错误。 </para> </note> </sect2> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/final.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/final.xml diff -u phpdoc-zh/language/oop5/final.xml:1.3 phpdoc-zh/language/oop5/final.xml:1.4 --- phpdoc-zh/language/oop5/final.xml:1.3 Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/final.xml Sat Dec 13 10:50:22 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.6 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.final" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/iterations.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/iterations.xml diff -u phpdoc-zh/language/oop5/iterations.xml:1.3 phpdoc-zh/language/oop5/iterations.xml:1.4 --- phpdoc-zh/language/oop5/iterations.xml:1.3 Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/iterations.xml Sat Dec 13 10:50:23 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.13 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.iterations" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/magic.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/magic.xml diff -u phpdoc-zh/language/oop5/magic.xml:1.3 phpdoc-zh/language/oop5/magic.xml:1.4 --- phpdoc-zh/language/oop5/magic.xml:1.3 Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/magic.xml Sat Dec 13 10:50:23 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.20 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.magic" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/object-comparison.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-zh/language/oop5/object-comparison.xml diff -u phpdoc-zh/language/oop5/object-comparison.xml:1.4 phpdoc-zh/language/oop5/object-comparison.xml:1.5 --- phpdoc-zh/language/oop5/object-comparison.xml:1.4 Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/object-comparison.xml Sat Dec 13 10:50:23 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.4 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.6 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.object-comparison" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/overloading.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-zh/language/oop5/overloading.xml diff -u phpdoc-zh/language/oop5/overloading.xml:1.4 phpdoc-zh/language/oop5/overloading.xml:1.5 --- phpdoc-zh/language/oop5/overloading.xml:1.4 Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/overloading.xml Sat Dec 13 10:50:23 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.4 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.32 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.overloading" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/paamayim-nekudotayim.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-zh/language/oop5/paamayim-nekudotayim.xml diff -u phpdoc-zh/language/oop5/paamayim-nekudotayim.xml:1.5 phpdoc-zh/language/oop5/paamayim-nekudotayim.xml:1.6 --- phpdoc-zh/language/oop5/paamayim-nekudotayim.xml:1.5 Sat Jun 23 13:32:42 2007 +++ phpdoc-zh/language/oop5/paamayim-nekudotayim.xml Sat Dec 13 10:50:23 2008 @@ -1,28 +1,28 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.5 $ --> -<!-- $Author: bjori $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> +<!-- $Author: haohappy $ --> <!-- EN-Revision: 1.8 Maintainer: lm92 Status: ready --> <sect1 xml:id="language.oop5.paamayim-nekudotayim" xmlns="http://docbook.org/ns/docbook"> - <title>·¶Î§½âÎö²Ù×÷·û£¨::£©</title> + <title>范围解析操作符(::)</title> <para> - ·¶Î§½âÎö²Ù×÷·û£¨Ò²¿É³Æ×÷ Paamayim Nekudotayim£©»òÕ߸ü¼òµ¥µØËµÊÇÒ»¶ÔðºÅ£¬¿ÉÒÔÓÃÓÚ·ÃÎÊ<link - linkend="language.oop5.static">¾²Ì¬</link>³ÉÔ±¡¢·½·¨ºÍ<link - linkend="language.oop5.constants">³£Á¿</link>£¬»¹¿ÉÒÔÓÃÓÚ¸²¸ÇÀàÖеijÉÔ±ºÍ·½·¨¡£ + 范围解析操作符(也可称作 Paamayim Nekudotayim)或者更简单地说是一对冒号,可以用于访问<link + linkend="language.oop5.static">静态</link>成员、方法和<link + linkend="language.oop5.constants">常量</link>,还可以用于覆盖类中的成员和方法。 </para> <para> - µ±ÔÚÀàµÄÍⲿ·ÃÎÊÕâЩ¾²Ì¬³ÉÔ±¡¢·½·¨ºÍ³£Á¿Ê±£¬±ØÐëʹÓÃÀàµÄÃû×Ö¡£ + 当在类的外部访问这些静态成员、方法和常量时,必须使用类的名字。 </para> <para> - °Ñ Paamayim Nekudotayim Ñ¡×÷¸Ã²Ù×÷·ûµÄÃû×ÖËÆºõÓÐÐ©Ææ¹Ö¡£È»¶ø£¬ÕâÊÇ Zend - ¿ª·¢Ð¡×éÔÚд Zend Engine 0.5 £¨±»ÓÃÓÚ PHP 3 - ÖУ©Ê±Ëù×÷³öµÄ¾ö¶¨¡£ÊÂʵÉÏÕâ¸ö´ÊÔÚÏ£²®À³ÎľÍÊÇ˫ðºÅµÄÒâ˼¡£ + 把 Paamayim Nekudotayim 选作该操作符的名字似乎有些奇怪。然而,这是 Zend + 开发小组在写 Zend Engine 0.5 (被用于 PHP 3 + 中)时所作出的决定。事实上这个词在希伯莱文就是双冒号的意思。 </para> <example> - <title>ÔÚÀàµÄÍⲿʹÓà :: ²Ù×÷·û</title> + <title>在类的外部使用 :: 操作符</title> <programlisting role="php"> <![CDATA[ <?php @@ -37,8 +37,8 @@ </example> <para> - <varname>self</varname> ºÍ <varname>parent</varname> - ÕâÁ½¸öÌØÊâµÄ¹Ø¼ü×ÖÊÇÓÃÓÚÔÚÀàµÄÄÚ²¿¶Ô³ÉÔ±»ò·½·¨½øÐзÃÎʵġ£ + <varname>self</varname> 和 <varname>parent</varname> + 这两个特殊的关键字是用于在类的内部对成员或方法进行访问的。 </para> <example> @@ -63,15 +63,15 @@ </example> <para> - µ±Ò»¸ö×ÓÀา¸ÇÆä¸¸ÀàÖеķ½·¨Ê±£¬PHP - ²»»áÔÙÖ´Ðи¸ÀàÖÐÒѱ»¸²¸ÇµÄ·½·¨£¬Ö±µ½×ÓÀàÖе÷ÓÃÕâЩ·½·¨ÎªÖ¹¡£ÕâÖÖ»úÖÆÒ²×÷ÓÃÓÚ - <link linkend="language.oop5.decon">¹¹Ô캯ÊýºÍÎö¹¹º¯Êý</link>¡¢<link - linkend="language.oop5.overloading">ÖØÔØ</link> ¼° - <link linkend="language.oop5.magic">ħÊõ</link> º¯Êý¡£ + 当一个子类覆盖其父类中的方法时,PHP + 不会再执行父类中已被覆盖的方法,直到子类中调用这些方法为止。这种机制也作用于 + <link linkend="language.oop5.decon">构造函数和析构函数</link>、<link + linkend="language.oop5.overloading">重载</link> 及 + <link linkend="language.oop5.magic">魔术</link> 函数。 </para> <example> - <title>µ÷Óø¸ÀàµÄ·½·¨</title> + <title>调用父类的方法</title> <programlisting role="php"> <![CDATA[ <?php @@ -84,10 +84,10 @@ class OtherClass extends MyClass { - // ¸²¸Ç¸¸ÀàÖеķ½·¨ + // 覆盖父类中的方法 public function myFunc() { - // µ«ÈÔÈ»¿ÉÒÔµ÷ÓÃÒѱ»¸²¸ÇµÄ·½·¨ + // 但仍然可以调用已被覆盖的方法 parent::myFunc(); echo "OtherClass::myFunc()\n"; } http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/patterns.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-zh/language/oop5/patterns.xml diff -u phpdoc-zh/language/oop5/patterns.xml:1.1 phpdoc-zh/language/oop5/patterns.xml:1.2 --- phpdoc-zh/language/oop5/patterns.xml:1.1 Sat Dec 13 03:36:37 2008 +++ phpdoc-zh/language/oop5/patterns.xml Sat Dec 13 10:50:23 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.2 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.10 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.patterns" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/static.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/static.xml diff -u phpdoc-zh/language/oop5/static.xml:1.3 phpdoc-zh/language/oop5/static.xml:1.4 --- phpdoc-zh/language/oop5/static.xml:1.3 Sat Dec 13 03:36:37 2008 +++ phpdoc-zh/language/oop5/static.xml Sat Dec 13 10:50:23 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- $Author: haohappy $ --> <!-- EN-Revision: 1.19 Maintainer: haohappy Status: ready --> <sect1 xml:id="language.oop5.static" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/visibility.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-zh/language/oop5/visibility.xml diff -u phpdoc-zh/language/oop5/visibility.xml:1.6 phpdoc-zh/language/oop5/visibility.xml:1.7 --- phpdoc-zh/language/oop5/visibility.xml:1.6 Sat Jun 23 13:32:42 2007 +++ phpdoc-zh/language/oop5/visibility.xml Sat Dec 13 10:50:23 2008 @@ -1,23 +1,23 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.6 $ --> -<!-- $Author: bjori $ --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> +<!-- $Author: haohappy $ --> <!-- EN-Revision: 1.12 Maintainer: lm92 Status: ready --> <sect1 xml:id="language.oop5.visibility" xmlns="http://docbook.org/ns/docbook"> - <title>·ÃÎÊ¿ØÖÆ</title> + <title>访问控制</title> <para> - ¶ÔÊôÐÔ»ò·½·¨µÄ·ÃÎÊ¿ØÖÆ£¬ÊÇͨ¹ýÔÚÇ°ÃæÌí¼Ó¹Ø¼ü×Ö public¡¢protected »ò private - À´ÊµÏֵġ£ÓÉ public Ëù¶¨ÒåµÄÀà³ÉÔ±¿ÉÒÔÔÚÈκεط½±»·ÃÎÊ£»ÓÉ protected - Ëù¶¨ÒåµÄÀà³ÉÔ±Ôò¿ÉÒÔ±»ÆäËùÔÚÀàµÄ×ÓÀàºÍ¸¸Àà·ÃÎÊ£¨µ±È»£¬¸Ã³ÉÔ±ËùÔÚµÄÀàÒ²¿ÉÒÔ·ÃÎÊ£©£»¶øÓÉ - private ¶¨ÒåµÄÀà³ÉÔ±ÔòÖ»Äܱ»ÆäËùÔÚÀà·ÃÎÊ¡£ + 对属性或方法的访问控制,是通过在前面添加关键字 public、protected 或 private + 来实现的。由 public 所定义的类成员可以在任何地方被访问;由 protected + 所定义的类成员则可以被其所在类的子类和父类访问(当然,该成员所在的类也可以访问);而由 + private 定义的类成员则只能被其所在类访问。 </para> <sect2 xml:id="language.oop5.visiblity-members"> - <title>¶ÔÀà³ÉÔ±µÄ·ÃÎÊ¿ØÖÆ</title> + <title>对类成员的访问控制</title> <para> - Àà³ÉÔ±¶¼±ØÐëʹÓùؼü×Öpublic¡¢protected »ò private ½øÐж¨Òå + 类成员都必须使用关键字public、protected 或 private 进行定义 </para> <para> <example> - <title>ÉùÃ÷Àà³ÉÔ±</title> + <title>声明类成员</title> <programlisting role="php"> <![CDATA[ <?php @@ -39,10 +39,10 @@ } $obj = new MyClass(); -echo $obj->public; // ÕâÐÐÄܱ»Õý³£Ö´ÐÐ -echo $obj->protected; // ÕâÐлá²úÉúÒ»¸öÖÂÃü´íÎó -echo $obj->private; // ÕâÐÐÒ²»á²úÉúÒ»¸öÖÂÃü´íÎó -$obj->printHello(); // Êä³ö Public¡¢Protected ºÍ Private +echo $obj->public; // 这行能被正常执行 +echo $obj->protected; // 这行会产生一个致命错误 +echo $obj->private; // 这行也会产生一个致命错误 +$obj->printHello(); // 输出 Public、Protected 和 Private /** @@ -50,7 +50,7 @@ */ class MyClass2 extends MyClass { - // ¿ÉÒÔ¶Ô public ºÍ protected ½øÐÐÖØ¶¨Ò壬µ« private ¶ø²»ÄÜ + // 可以对 public 和 protected 进行重定义,但 private 而不能 protected $protected = 'Protected2'; function printHello() @@ -62,10 +62,10 @@ } $obj2 = new MyClass2(); -echo $obj->public; // ÕâÐÐÄܱ»Õý³£Ö´ÐÐ -echo $obj2->private; // 䶨Òå private -echo $obj2->protected; // ÕâÐлá²úÉúÒ»¸öÖÂÃü´íÎó -$obj2->printHello(); // Êä³ö Public¡¢Protected2£¬µ«²»»áÊä³ö Private +echo $obj->public; // 这行能被正常执行 +echo $obj2->private; // 未定义 private +echo $obj2->protected; // 这行会产生一个致命错误 +$obj2->printHello(); // 输出 Public、Protected2,但不会输出 Private class Bar { @@ -104,21 +104,21 @@ </para> <note> <simpara> - ΪÁ˼æÈÝÐÔ¿¼ÂÇ£¬ÔÚ PHP 4 ÖÐʹÓà <emphasis>var</emphasis> ¹Ø¼ü×Ö¶Ô±äÁ¿½øÐж¨ÒåµÄ·½·¨ÔÚ - PHP 5 ÖÐÈÔÈ»ÓÐЧ£¨Ö»ÊÇ×÷Ϊ public ¹Ø¼ü×ÖµÄÒ»¸ö±ðÃû£©¡£ÔÚ PHP 5.1.3 - ֮ǰµÄ°æ±¾£¬¸ÃÓï·¨»á²úÉúÒ»¸ö <constant>E_STRICT</constant> ¾¯¸æ¡£ + 为了兼容性考虑,在 PHP 4 中使用 <emphasis>var</emphasis> 关键字对变量进行定义的方法在 + PHP 5 中仍然有效(只是作为 public 关键字的一个别名)。在 PHP 5.1.3 + 之前的版本,该语法会产生一个 <constant>E_STRICT</constant> 警告。 </simpara> </note> </sect2> <sect2 xml:id="language.oop5.visiblity-methods"> - <title>¶Ô·½·¨µÄ·ÃÎÊ¿ØÖÆ</title> + <title>对方法的访问控制</title> <para> - ÀàÖеķ½·¨¶¼±ØÐëʹÓùؼü×Öpublic¡¢protected »ò private - ½øÐж¨Òå¡£Èç¹ûûÓÐÉèÖÃÕâЩ¹Ø¼ü×Ö£¬Ôò¸Ã·½·¨»á±»ÉèÖóÉĬÈ쵀 public¡£ + 类中的方法都必须使用关键字public、protected 或 private + 进行定义。如果没有设置这些关键字,则该方法会被设置成默认的 public。 </para> <para> <example> - <title>ÉùÃ÷ÀàÖеķ½·¨</title> + <title>声明类中的方法</title> <programlisting role="php"> <![CDATA[ <?php @@ -127,19 +127,19 @@ */ class MyClass { - // ¹¹Ô캯Êý±ØÐëÊÇ public + // 构造函数必须是 public public function __construct() { } - // ÉùÃ÷Ò»¸ö public µÄ·½·¨ + // 声明一个 public 的方法 public function MyPublic() { } - // ÉùÃ÷Ò»¸ö protected µÄ·½·¨ + // 声明一个 protected 的方法 protected function MyProtected() { } - // ÉùÃ÷Ò»¸ö private µÄ·½·¨ + // 声明一个 private 的方法 private function MyPrivate() { } - // Õâ¸ö·½·¨Ò²ÊÇ public µÄ + // 这个方法也是 public 的 function Foo() { $this->MyPublic(); @@ -149,10 +149,10 @@ } $myclass = new MyClass; -$myclass->MyPublic(); // ÕâÐÐÄܱ»Õý³£Ö´ÐÐ -$myclass->MyProtected(); // ÕâÐлá²úÉúÒ»¸öÖÂÃü´íÎó -$myclass->MyPrivate(); // ÕâÐлá²úÉúÒ»¸öÖÂÃü´íÎó -$myclass->Foo(); // Public¡¢Protected ºÍ Private ¶¼±»µ÷ÓÃÁË +$myclass->MyPublic(); // 这行能被正常执行 +$myclass->MyProtected(); // 这行会产生一个致命错误 +$myclass->MyPrivate(); // 这行会产生一个致命错误 +$myclass->Foo(); // Public、Protected 和 Private 都被调用了 /** @@ -165,13 +165,13 @@ { $this->MyPublic(); $this->MyProtected(); - $this->MyPrivate(); // ÕâÐлá²úÉúÒ»¸öÖÂÃü´íÎó + $this->MyPrivate(); // 这行会产生一个致命错误 } } $myclass2 = new MyClass2; -$myclass2->MyPublic(); // ÕâÐÐÄܱ»Õý³£Ö´ÐÐ -$myclass2->Foo2(); // Public ºÍ Protected ¶¼±»µ÷ÓÃÁË£¬µ« Private ²»»á±»µ÷Óà +$myclass2->MyPublic(); // 这行能被正常执行 +$myclass2->Foo2(); // Public 和 Protected 都被调用了,但 Private 不会被调用 ?> ]]> </programlisting>
« previous php.doc.zh (#3054) next »