Contributions are ready for review
Hello PHP FA Documentation team,
There are contributions within the online editor queue for this language.
Please review, then commit or delete these patches.
Patches for review :
-----------------------
New file: fa/language/types/callable.xml
By: proodoo@gmail.com on 2020-04-04 12:11:48
===================================================================
--- fa/language/types/callable.xml
+++ fa/language/types/callable.xml
@@ -0,0 +1,174 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: $ -->
+<!-- EN-Revision: 341282 Maintainer: proodoo@gmail.com Status: ready -->
+<!-- Reviewed: no -->
+
+<sect1 xml:id="language.types.callable">
+ <title>کالبکها / فراخواندنیها</title>
+
+ <para>
+ از PHP 5.4 به بعد، کالبکها میتوانند با راهنمای نوع
<type>callback</type> نشان داده شوند.
+ این مستند نیز اطلاعات نوع <type>callback</type> به همین
منظور استفاده کرده است.
+ </para>
+
+ <para>
+ بعضی از توابع مانند <function>call_user_func</function> یا
+ <function>usort</function> کالبکهای تعریفشده توسط
کاربر را به عنوان پارامتر میپذیرند.
+ توابع کالبک فقط منحصر به توابع ساده نیستند بلکه
متدهای <link linkend="language.types.object">اشیا</link> نیز
قابل استفاده هستند،
+ همچنین توابع استاتیک کلاس.
+ </para>
+
+ <sect2 xml:id="language.types.callable.passing">
+ <title>پاس دادن</title>
+
+ <para>
+ یک تابع PHP توسط نامش به صورت یک رشته پاس داده میشود.
هر تابع تعریف شده در زبان
+ یا تعریف شده توسط کاربر قابل استفاده است، به جز
ساختارهای زبان مانند:
+ <function>array</function>، <function>echo</function>،
+ <function>empty</function>، <function>eval</function>،
+ <function>exit</function>، <function>isset</function>،
+ <function>list</function>، <function>print</function> یا
+ <function>unset</function>.
+ </para>
+
+ <para>
+ یک متد از یک نمونه از <link
linkend="language.types.object">شی</link> به صورت آرایهای
شامل خود شی در اندیس صفر آرایه
+ و نام تابع در اندیس دوم آرایه پاس داده میشود. دسترسی
به متدهای private و
+ protected داخل کلاس مجاز نیست.
+ </para>
+
+ <para>
+ متدهای کلاس نیز بدون لزوم ساخت یک <link
linkend="language.types.object">شی</link> نمونه از کلاس قابل
پاس دادن هستند.
+ تنها به جای خود شی، نام کلاس در اندیس صفر آرایه قرار
میگیرد.
+ با شروه از PHP 5.2.3 پاس داده به شکل
<literal>'ClassName::methodName'</literal>
+ هم ممکن شده است.
+ </para>
+
+ <para>
+ جدا از توابع تعریف شده توسط کاربر،
+ <link linkend="functions.anonymous">توابع بینام</link> نیز
میتوانند به
+ عنوان کالبک پاس داده شوند.
+ </para>
+
+ <para>
+ <example>
+ <title>
+ مثالهای تابع کالبک
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+// An example callback function
+function my_callback_function() {
+ echo 'hello world!';
+}
+
+// An example callback method
+class MyClass {
+ static function myCallbackMethod() {
+ echo 'Hello World!';
+ }
+}
+
+// نوع ۱: کالبک ساده
+call_user_func('my_callback_function');
+
+// نوع ۲: فراخوانی متد استاتیک کلاس
+call_user_func(array('MyClass', 'myCallbackMethod'));
+
+// نوع ۳: فراخوانی متد شی
+$obj = new MyClass();
+call_user_func(array($obj, 'myCallbackMethod'));
+
+// نوع ۴: فراخوانی متد استاتیک کلاس (از PHP 5.2.3 به بعد)
+call_user_func('MyClass::myCallbackMethod');
+
+// نوع ۵: فراخوانی متد استاتیک کلاس مرتبط (از PHP 5.3.0 به
بعد)
+class A {
+ public static function who() {
+ echo "An";
+ }
+}
+
+class B extends A {
+ public static function who() {
+ echo "Bn";
+ }
+}
+
+call_user_func(array('B', 'parent::who')); // A
+
+// نوع ۶: اشیایی که تابع __invoke را پیادهسازی کردهاند
میتوانند به عنوان کالبک پاس داده شوند (از PHP 5.3.0 به
بعد)
+class C {
+ public function __invoke($name) {
+ echo 'Hello ', $name, "n";
+ }
+}
+
+$c = new C();
+call_user_func($c, 'PHP!');
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>
+ مثال کالبک نوسط کلوژر
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Our closure
+$double = function($a) {
+ return $a * 2;
+};
+
+// This is our range of numbers
+$numbers = range(1, 5);
+
+// Use the closure as a callback here to
+// double the size of each element in our
+// range
+$new_numbers = array_map($double, $numbers);
+
+print implode(' ', $new_numbers);
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+2 4 6 8 10
+]]>
+ </screen>
+ </example>
+ </para>
+
+ ¬e.func-callback-exceptions;
+ </sect2>
+
+</sect1>
+
+<!-- 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:"~/.phpdoc/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
+-->
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=100049
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=100049
------------------------------------------------------------------
Modified: fa/reference/url/constants.xml
By: mahdi jowkar on 2012-11-22 05:58:18
===================================================================
--- fa/reference/url/constants.xml
+++ fa/reference/url/constants.xml
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: pedram Status: ready -->
-<!-- Reviewed: yes -->
-<!-- $Revision: 297032 $ -->
+<!-- $Revision: 323624 $ -->
<appendix xml:id="url.constants" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&extension.constants;
@@ -10,91 +8,113 @@
<function>parse_url</function> استفاده شوند و از زمان PHP 5.1.2
در دسترس هستند.
</para>
<variablelist>
- <varlistentry>
+ <varlistentry xml:id="constant.php-url-scheme">
<term>
<constant>PHP_URL_SCHEME</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
-
+
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-url-host">
<term>
<constant>PHP_URL_HOST</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
-
+
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-url-port">
<term>
<constant>PHP_URL_PORT</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
-
+
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-url-user">
<term>
<constant>PHP_URL_USER</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
-
+
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-url-pass">
<term>
<constant>PHP_URL_PASS</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
-
+
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-url-path">
<term>
<constant>PHP_URL_PATH</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
-
+
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-url-query">
<term>
<constant>PHP_URL_QUERY</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
-
+
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-url-fragment">
<term>
<constant>PHP_URL_FRAGMENT</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
-
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.php-query-rfc1738">
+ <term>
+ <constant>PHP_QUERY_RFC1738</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.php-query-rfc3986">
+ <term>
+ <constant>PHP_QUERY_RFC3986</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
</simpara>
</listitem>
</varlistentry>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=43296
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=43296
------------------------------------------------------------------
Modified: fa/reference/url/book.xml
By: mahdi jowkar on 2012-11-22 06:21:30
===================================================================
--- fa/reference/url/book.xml
+++ fa/reference/url/book.xml
@@ -1,20 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: pedram Status: ready -->
-<!-- Reviewed: yes -->
-<!-- $Revision: 297032 $ -->
-<!-- Purpose: basic.other -->
+<!-- $Revision: 326064 $ -->
<!-- Membership: core -->
<book xml:id="book.url" xmlns="http://docbook.org/ns/docbook">
- <title>URLs</title>
+ <?phpdoc extension-membership="core" ?>
+ <title>آدرس ها</title>
<preface xml:id="intro.url">
&reftitle.intro;
<para>
- کار با رشتههای URL : کدگذاری، کدگشایی و پارس.
+ کار با رشتههای URL : کدگذاری، کدگشایی و تجزيه.
</para>
</preface>
-
+
&reference.url.setup;
&reference.url.constants;
&reference.url.reference;
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=43303
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=43303
------------------------------------------------------------------
--
https://edit.php.net/
This email is send automatically by the Php Docbook Online Editor.
Thread (1 message)
- doc-fa@lists.php.net