cvs: phpdoc-ru /language/oop5 reflection.xml

From: Date: Wed, 23 Apr 2008 10:49:38 +0000
Subject: cvs: phpdoc-ru /language/oop5 reflection.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-942@lists.php.net to get a copy of this message
tony2001 Wed Apr 23 10:49:38 2008 UTC Modified files: /phpdoc-ru/language/oop5 reflection.xml Log: new edition of Refleciton API translation

http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/oop5/reflection.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-ru/language/oop5/reflection.xml diff -u phpdoc-ru/language/oop5/reflection.xml:1.1 phpdoc-ru/language/oop5/reflection.xml:1.2 --- phpdoc-ru/language/oop5/reflection.xml:1.1 Tue Apr 15 20:56:54 2008 +++ phpdoc-ru/language/oop5/reflection.xml Wed Apr 23 10:49:38 2008 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> +<!-- EN-Revision: 1.34 Status: ready $ --> +<!-- $Revision: 1.2 $ --> <sect1 xml:id="language.oop5.reflection" xmlns="http://docbook.org/ns/docbook"> - <title>Рефлексия</title> + <title>Reflection</title> <sect2 xml:id="language.oop5.reflection.toc"> <title>Содержание</title> <simplelist> @@ -15,20 +16,20 @@ <member><link linkend="language.oop5.reflection.reflectionmethod">Класс ReflectionMethod</link></member> <member><link linkend="language.oop5.reflection.reflectionproperty">Класс ReflectionProperty</link></member> <member><link linkend="language.oop5.reflection.reflectionextension">Класс ReflectionExtension</link></member> - <member><link linkend="language.oop5.reflection.extending">Расширение классов рефлексии</link></member> + <member><link linkend="language.oop5.reflection.extending">Наследование классов Reflection</link></member> </simplelist> </sect2> <sect2 xml:id="language.oop5.reflection.introduction"> <title>Введение</title> <para> - PHP 5 имеет полный набор API рефлексии, который предоставляет - возможность перепроектировать классы, интерфейсы, функции и методы, в том - числе и расширения. В дополнение к этому, API рефлексии - предлагает пути восстановления комментариев для функций, классов + В PHP 5 имеется полный набор Reflection API, который предоставляет + возможность проводить реверс-инжиниринг классов, интерфейсов, функций, + методов, а также расширений. В дополнение к этому, Reflection API + предоставляет средства для извлечения комментариев для функций, классов и методов. </para> <para> - API рефлексии - это объектно-ориентированное расширение для Zend Engine, + Reflection API - это объектно-ориентированное расширение для Zend Engine, состоящее из следующих классов: </para> <informalexample> @@ -51,13 +52,12 @@ </informalexample> <note> <simpara> - Более подробно эти классы рассматриваются в следующих частях. + Более подробно эти классы рассматриваются в следующих главах. </simpara> </note> <para> - Если мы выполним код из примера ниже: <example> - <title>Основное использование API рефлексии</title> + <title>Простой пример использования Reflection API</title> <programlisting role='php'> <![CDATA[ <?php @@ -127,12 +127,11 @@ </example> </para> </sect2> - <sect2 xml:id="language.oop5.reflection.reflector"> <title><classname>Reflector</classname></title> <para> - <classname>Reflector</classname> это интерфейс, который имплементирует - все экспортируемые классы Reflection. + <classname>Reflector</classname> - это интерфейс, который реализуется + всеми экспортируемыми классами Reflection. </para> <informalexample> <programlisting role="php"> @@ -148,22 +147,19 @@ </programlisting> </informalexample> </sect2> - <sect2 xml:id="language.oop5.reflection.reflectionexception"> <title><classname>ReflectionException</classname></title> <para> - <classname>ReflectionException</classname> расширяет стандартный класс - <link linkend="language.exceptions">Exception</link> и его выбрасывает - Reflection API. Никаких специальных методов или свойств здесь не - представлено. + <classname>ReflectionException</classname> наследует стандартный класс + <link linkend="language.exceptions">Exception</link> и выбрасывается + Reflection API, он не реализует никаких специальных методов или свойств. </para> </sect2> - <sect2 xml:id="language.oop5.reflection.reflectionfunction"> <title><classname>ReflectionFunction</classname></title> <para> - Класс <classname>ReflectionFunction</classname> позволяет вам - перепроектировать функции. + Класс <classname>ReflectionFunction</classname> позволяет + проводить реверс-инжиниринг функций. </para> <informalexample> <programlisting role="php"> @@ -210,9 +206,8 @@ </simpara> </note> <para> - Анализируя функцию, сначала вы должны создать экземпляр класса - <classname>ReflectionFunction</classname>. Затем, в этом объекте вы - сможете вызывать любой из методов этого класса, упомянутых выше. + Для анализа функции необходимо создать экземпляр класса + <classname>ReflectionFunction</classname>. </para> <example> <title>Использование класса <classname>ReflectionFunction</classname></title> @@ -245,21 +240,20 @@ $func->getEndline() ); -// Печать комментария документации +// Вывод комментария документации printf("---> Документация:\n %s\n", var_export($func->getDocComment(), 1)); -// Печать статической переменной, если она существует +// Вывод статических переменных, если они есть if ($statics = $func->getStaticVariables()) { printf("---> Статическая переменная: %s\n", var_export($statics, 1)); } // Вызов функции -printf("---> Результат вызова в: "); +printf("---> Результат вызова: "); var_dump($func->invoke()); -// вы можете предпочесть для использования метод export() echo "\nReflectionFunction::export() результат:\n"; echo ReflectionFunction::export('counter'); ?> @@ -274,7 +268,6 @@ </simpara> </note> </sect2> - <sect2 xml:id="language.oop5.reflection.reflectionparameter"> <title><classname>ReflectionParameter</classname></title> <para> @@ -317,9 +310,9 @@ </para> </note> <para> - Анализируя параметры функции, сначала вы должны создать экземпляр класса + Для анализа параметров функции необходимо создать экземпляр класса <classname>ReflectionFunction</classname> или <classname>ReflectionMethod</classname> - и затем использовать их метод <function>getParameters</function> для получения + и затем использовать метод <function>getParameters</function> для получения массива параметров. </para> <example> @@ -359,12 +352,11 @@ </programlisting> </example> </sect2> - <sect2 xml:id="language.oop5.reflection.reflectionclass"> <title><classname>ReflectionClass</classname></title> <para> Класс <classname>ReflectionClass</classname> позволяет - вам перепроектировать классы и интерфейсы. + проводить реверс-инжиниринг классов и интерфейсов. </para> <informalexample> <programlisting role="php"> @@ -426,9 +418,8 @@ </simpara> </note> <para> - Анализируя класс, сначала вы должны создать экземпляр класса - <classname>ReflectionClass</classname>. Затем, вы сможете в этом объекте - вызвать любой из методов, описанных выше. + Для анализа класса необходимо создать экземпляр класса + <classname>ReflectionClass</classname>. </para> <example> <title>Использование класса <classname>ReflectionClass</classname></title> @@ -486,19 +477,19 @@ implode(' ', Reflection::getModifierNames($class->getModifiers())) ); -// Печать комментария из документации +// Вывод комментария из документации printf("---> Документация:\n %s\n", var_export($class->getDocComment(), 1)); -// Печать тех интерфейсов, которые имплементируют этот класс -printf("---> Имплементация:\n %s\n", var_export($class->getInterfaces(), 1)); +// Вывод тех интерфейсов, которые реализует этот класс +printf("---> Интерфейсы:\n %s\n", var_export($class->getInterfaces(), 1)); -// Печать констант класса +// Вывод констант класса printf("---> Константы: %s\n", var_export($class->getConstants(), 1)); -// Печать свойств класса +// Вывод свойств класса printf("---> Свойства: %s\n", var_export($class->getProperties(), 1)); -// Печать методов класса +// Вывод методов класса printf("---> Методы: %s\n", var_export($class->getMethods(), 1)); // Если есть возможность создать экземпляр класса, то создаем его @@ -530,12 +521,11 @@ </simpara> </note> </sect2> - <sect2 xml:id="language.oop5.reflection.reflectionobject"> <title><classname>ReflectionObject</classname></title> <para> Класс <classname>ReflectionObject</classname> позволяет - перепроектировать объекты. + проводить реверс-инжиниринг объектов. </para> <informalexample> <programlisting role="php"> @@ -553,12 +543,11 @@ </programlisting> </informalexample> </sect2> - <sect2 xml:id="language.oop5.reflection.reflectionmethod"> <title><classname>ReflectionMethod</classname></title> <para> Класс <classname>ReflectionMethod</classname> позволяет - перепроектировать методы. + проводить реверс-инжиниринг методов. </para> <informalexample> <programlisting role="php"> @@ -602,9 +591,8 @@ </programlisting> </informalexample> <para> - Анализируя метод, сначала вы должны создать экземпляр класса - <classname>ReflectionMethod</classname>. Затем, вы сможете в этом объекте - вызвать любой из методов, описанных выше. + Для анализа метода класса необходимо создать экземпляр класса + <classname>ReflectionMethod</classname>. </para> <example> <title>Использование класса <classname>ReflectionMethod</classname></title> @@ -654,16 +642,16 @@ implode(' ', Reflection::getModifierNames($method->getModifiers())) ); -// Печать комментария из документации +// Вывод комментария из документации printf("---> Документация:\n %s\n", var_export($method->getDocComment(), 1)); -// Печать статической переменной, если она существует +// Вывод статических переменных, если они есть if ($statics= $method->getStaticVariables()) { printf("---> Статическая переменная: %s\n", var_export($statics, 1)); } // Вызов метода -printf("---> Результат вызова в: "); +printf("---> Результат вызова: "); var_dump($method->invoke(NULL)); ?> ]]> @@ -677,18 +665,17 @@ </note> <note> <simpara> - Для статических методов, описанных выше, вы должны передать NULL в - качестве первого аргумента в <function>invoke</function>. Для - нестатических методов нужно передать экземпляр класса. + При вызове статических методов нужно передать NULL в + качестве первого аргумента <function>invoke</function>. Для + нестатических методов нужно передавать экземпляр класса. </simpara> </note> </sect2> - <sect2 xml:id="language.oop5.reflection.reflectionproperty"> <title><classname>ReflectionProperty</classname></title> <para> Класс <classname>ReflectionProperty</classname> позволяет - перепроектировать свойства класса. + проводить реверс-инжиниринг свойств класса. </para> <informalexample> <programlisting role="php"> @@ -722,9 +709,8 @@ </simpara> </note> <para> - Анализируя свойство, сначала вы должны создать экземпляр класса - <classname>ReflectionProperty</classname>. Затем, вы сможете вызвать - любой из методов, описанных выше, в этом объекте. + Для анализа свойства класса необходимо создать экземпляр класса + <classname>ReflectionProperty</classname>. </para> <example> <title>Использование класса <classname>ReflectionProperty</classname></title> @@ -739,7 +725,7 @@ // Создание экземпляра класса ReflectionProperty $prop = new ReflectionProperty('String', 'length'); -// Print out basic information +// Вывод основной информации о свойстве класса printf( "===> %s%s%s%s свойство '%s' (которое было %s)\n" . " имеет модификаторы %s\n", @@ -777,14 +763,12 @@ </simpara> </note> </sect2> - <sect2 xml:id="language.oop5.reflection.reflectionextension"> <title><classname>ReflectionExtension</classname></title> <para> - Класс <classname>ReflectionExtension</classname> позволяет вам - перепроектировать расширения. Вы можете восстановить все - загруженные расширения во время выполнения используя - <function>get_loaded_extensions</function>. + Класс <classname>ReflectionExtension</classname> позволяет + проводить реверс-инжиниринг расширений. Получить список всех загруженных + расширений можно при помощи <function>get_loaded_extensions</function>. </para> <informalexample> <programlisting role="php"> @@ -809,9 +793,9 @@ </programlisting> </informalexample> <para> - Анализируя расширение, сначала вы должны создать экземпляр класса - <classname>ReflectionExtension</classname>. Затем, вы сможете вызвать - любой из методов, описанных выше, в этом объекте. + Для анализа расширения необходимо создать экземпляр класса + <classname>ReflectionExtension</classname>. Затем вы сможете вызвать + любой из методов, описанных выше. </para> <example> <title>Использование класса <classname>ReflectionExtension</classname></title> @@ -848,17 +832,16 @@ </programlisting> </example> </sect2> - <sect2 xml:id="language.oop5.reflection.extending"> - <title>Расширение классов рефлексии</title> + <title>Наследование классов Reflection</title> <para> - В случае, когда вы захотите создать специализированные версии - встроенных классов (например, для создания подсветки HTML при - экспорте удобно иметь легкодоступные переменные взамен методов, - либо утилиты методов), вы можете пойти дальше и расширить их. + В случае, если вам требуется создать специализированные версии + встроенных классов (например, для подсветки HTML при экспорте + использовать свойства классов может быть более удобно, чем методы), + вы можете наследовать их. </para> <example> - <title>Расширение встроенных классов</title> + <title>Наследование встроенных классов</title> <programlisting role='php'> <![CDATA[ <?php @@ -901,7 +884,7 @@ <note> <simpara> Внимание! Если вы переписываете конструктор, то не забудьте вызывать - конструктор родителя _перед_ любым кодом, который вы затем вставите. + конструктор родителя _перед_ любым кодом, который вы затем добавите. В случае невыполнения этого условия результат будет следующим: <literal> Fatal error: Internal error: Failed to retrieve the reflection object
« previous php.doc.ru (#942) next »