Contributions are ready for review

Hello PHP EN Documentation team, There are contributions within the online editor queue for this language. Please review, then commit or delete these patches. Patches for review : ----------------------- Modified: en/language/predefined/closure/call.xml By: mail@akirakoyasu.net on 2015-06-23 07:03:03 =================================================================== --- en/language/predefined/closure/call.xml +++ en/language/predefined/closure/call.xml @@ -1,41 +1,38 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 337372 $ --> +<!-- $Revision: 336860 $ --> <refentry xml:id="closure.call" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Closure::call</refname> - <refpurpose>Binds and calls the closure</refpurpose> + <refpurpose>Calls the closure with the given parameters and returns the result, with $this bound to the given object $to</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> - <modifier>public</modifier> <type>mixed</type><methodname>Closure::call</methodname> - <methodparam><type>object</type><parameter>newthis</parameter></methodparam> + <modifier>public</modifier> <type>Closure</type><methodname>Closure::call</methodname> + <methodparam><type>object</type><parameter>to</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> <para> - Temporarily binds the closure to <parameter>newthis</parameter>, and calls - it with any given parameters. + Calls the closure with the given parameters and returns the result, with $this bound to the given object + <parameter>to</parameter> </para> </refsect1><!-- }}} --> <refsect1 role="parameters"><!-- {{{ --> &reftitle.parameters; <variablelist> <varlistentry> - <term><parameter>newthis</parameter></term> + <term><parameter>to</parameter></term> <listitem> <para> - The <type>object</type> to bind the closure to for the duration of the - call. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>...</parameter></term> + <term><parameter>args</parameter></term> <listitem> <para> - Zero or more parameters, which will be given as parameters to the - closure. </para> </listitem> </varlistentry> @@ -44,9 +41,29 @@ <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> - Returns the return value of the closure. </para> </refsect1><!-- }}} --> + <refsect1 role="changelog"><!-- {{{ --> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>7.0.0</entry> + <entry> + Added Closure::call + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1><!-- }}} --> <refsect1 role="examples"> &reftitle.examples; <example> @@ -54,34 +71,12 @@ <programlisting role="php"> <![CDATA[ <?php -class Value { - protected $value; - - public function __construct($value) { - $this->value = $value; - } - - public function getValue() { - return $this->value; - } -} - -$three = new Value(3); -$four = new Value(4); - -$closure = function ($delta) { var_dump($this->getValue() + $delta); }; -$closure->call($three, 4); -$closure->call($four, 4); -?> +$foo = new StdClass; +$foo->bar = 3; +$foobar = function ($qux) { var_dump($this->bar + $qux); }; +$foobar->call($foo, 4); // prints int(7) ]]> </programlisting> - &example.outputs; - <screen> -<![CDATA[ -int(7) -int(8) -]]> - </screen> </example> </refsect1> </refentry> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=63267 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=63267 ------------------------------------------------------------------ Modified: en/reference/strings/functions/htmlentities.xml By: Hans Henrik Bergan on 2015-10-26 02:52:36 =================================================================== --- en/reference/strings/functions/htmlentities.xml +++ en/reference/strings/functions/htmlentities.xml @@ -151,7 +151,7 @@ If the input <parameter>string</parameter> contains an invalid code unit sequence within the given <parameter>encoding</parameter> an empty string will be returned, unless either the <constant>ENT_IGNORE</constant> or - <constant>ENT_SUBSTITUTE</constant> flags are set. + <constant>ENT_SUBSTITUTE</constant> or <constant>ENT_DISALLOWED</constant> flags are set. </para> </refsect1> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=65273 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=65273 ------------------------------------------------------------------ Modified: en/reference/array/functions/array-filter.xml By: Jesse Donat on 2016-04-04 10:13:45 =================================================================== --- en/reference/array/functions/array-filter.xml +++ en/reference/array/functions/array-filter.xml @@ -240,6 +240,12 @@ added, deleted or unset) the behavior of this function is undefined. </para> </caution> + + <caution> + <para> + As of PHP7 the value of the callback may no longer be used by reference. + </para> + </caution> </refsect1> <refsect1 role="seealso"> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=66717 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=66717 ------------------------------------------------------------------ Modified: en/reference/apcu/apcuiterator/gettotalhits.xml By: Walt Sorensen on 2016-10-10 08:53:27 =================================================================== --- en/reference/apcu/apcuiterator/gettotalhits.xml +++ en/reference/apcu/apcuiterator/gettotalhits.xml @@ -38,7 +38,7 @@ <simplelist> <member><methodname>APCUIterator::getTotalCount</methodname></member> <member><methodname>APCUIterator::getTotalSize</methodname></member> - <member><function>apc_cache_info</function></member> + <member><function>apcu_cache_info</function></member> </simplelist> </refsect1> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69090 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69090 ------------------------------------------------------------------ Modified: en/reference/apcu/apcuiterator/gettotalcount.xml By: Walt Sorensen on 2016-10-10 08:54:02 =================================================================== --- en/reference/apcu/apcuiterator/gettotalcount.xml +++ en/reference/apcu/apcuiterator/gettotalcount.xml @@ -38,7 +38,7 @@ <simplelist> <member><methodname>APCUIterator::getTotalHits</methodname></member> <member><methodname>APCUIterator::getTotalSize</methodname></member> - <member><function>apc_cache_info</function></member> + <member><function>apcu_cache_info</function></member> </simplelist> </refsect1> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69091 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69091 ------------------------------------------------------------------ Modified: en/reference/apcu/apcuiterator/gettotalsize.xml By: Walt Sorensen on 2016-10-10 08:54:30 =================================================================== --- en/reference/apcu/apcuiterator/gettotalsize.xml +++ en/reference/apcu/apcuiterator/gettotalsize.xml @@ -38,7 +38,7 @@ <simplelist> <member><methodname>APCUIterator::getTotalCount</methodname></member> <member><methodname>APCUIterator::getTotalHits</methodname></member> - <member><function>apc_cache_info</function></member> + <member><function>apcu_cache_info</function></member> </simplelist> </refsect1> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69092 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69092 ------------------------------------------------------------------ Modified: en/reference/apcu/apcuiterator/construct.xml By: Walt Sorensen on 2016-10-10 09:07:12 =================================================================== --- en/reference/apcu/apcuiterator/construct.xml +++ en/reference/apcu/apcuiterator/construct.xml @@ -12,9 +12,9 @@ <methodsynopsis> <modifier>public</modifier> <methodname>APCUIterator::__construct</methodname> <methodparam choice="opt"><type>mixed</type><parameter>search</parameter><initializer>null</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>format</parameter><initializer>APCU_ITER_ALL</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>format</parameter><initializer>APC_ITER_ALL</initializer></methodparam> <methodparam choice="opt"><type>int</type><parameter>chunk_size</parameter><initializer>100</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>list</parameter><initializer>APCU_LIST_ACTIVE</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>list</parameter><initializer>APC_LIST_ACTIVE</initializer></methodparam> </methodsynopsis> <para> Constructs an <classname>APCUIterator</classname> <type>object</type>. @@ -40,7 +40,7 @@ <listitem> <para> The desired format, as configured with one or more of the - <link linkend="apcu.constants">APCU_ITER_*</link> constants. + <link linkend="apcu.constants">APC_ITER_*</link> constants. </para> </listitem> </varlistentry> @@ -57,8 +57,8 @@ <term><parameter>list</parameter></term> <listitem> <para> - The type to list. Either pass in <constant>APCU_LIST_ACTIVE</constant> - or <constant>APCU_LIST_DELETED</constant>. + The type to list. Either pass in <constant>APC_LIST_ACTIVE</constant> + or <constant>APC_LIST_DELETED</constant>. </para> </listitem> </varlistentry> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69093 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69093 ------------------------------------------------------------------ Modified: en/reference/apcu/constants.xml By: Walt Sorensen on 2016-10-10 09:14:09 =================================================================== --- en/reference/apcu/constants.xml +++ en/reference/apcu/constants.xml @@ -5,6 +5,21 @@ &reftitle.constants; &extension.constants; + <title>The APCu Constants</title> + <titleabbrev>APCu Constants</titleabbrev> + + <partintro> + +<!-- {{{ APCu Constants intro --> + <section xml:id="apcu.constants.intro"> + &reftitle.intro; + <para> + The APCu Constants below are the same as defined in the APC extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime. + </para> + </section> +<!-- }}} --> + </partintro> + <para> <variablelist> <varlistentry xml:id="constant.apcu-iter-all"> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69094 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69094 ------------------------------------------------------------------ Modified: en/install/windows/recommended.xml By: Walt Sorensen on 2016-10-10 14:17:00 =================================================================== --- en/install/windows/recommended.xml +++ en/install/windows/recommended.xml @@ -2,10 +2,10 @@ <!-- $Revision: 339300 $ --> <sect1 xml:id="install.windows.recommended" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Recommended Configuration on Windows systems</title> - + <sect2> <title>OpCache</title> - + <para> Highly Recommended that you enable OpCache. This extension is included with PHP for Windows. It compiles and optimizes PHP scripts and caches them in memory so that they aren't compiled every time the page is loaded. </para> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69106 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69106 ------------------------------------------------------------------ Modified: en/install/windows/manual.xml By: Walt Sorensen on 2016-10-10 14:17:12 =================================================================== --- en/install/windows/manual.xml +++ en/install/windows/manual.xml @@ -6,8 +6,8 @@ <title>Choose Web Server</title> <para> <itemizedlist spacing="compact"> - <listitem> - <para> + <listitem> + <para> IIS is builtin to Windows. On Windows Server, use Server Manager to add the IIS role. Be sure to include the CGI Role Feature. @@ -78,17 +78,17 @@ There are 4 types of PHP builds: <itemizedlist spacing="compact"> <listitem> - <para>Thread-Safe(TS) - use for single process web serves, like Apache with mod_php</para> + <para>Thread-Safe(TS) - use for single process web serves, like Apache with mod_php</para> </listitem> <listitem> - <para>Non-Thread-Safe(NTS) - use for IIS and other FastCGI web servers (Apache with mod_fastcgi) and recommended for command-line scripts</para> + <para>Non-Thread-Safe(NTS) - use for IIS and other FastCGI web servers (Apache with mod_fastcgi) and recommended for command-line scripts</para> </listitem> <listitem> - <para>x86 - production use of PHP 5.5 or 5.6 or 7.0.</para> + <para>x86 - production use of PHP 5.5 or 5.6 or 7.0.</para> </listitem> <listitem> - <para>x64 - production use of PHP 7.0+ unless its a 32-bit only version of Windows. 5.5 and 5.6 x64 are expiremental.</para> - </listitem> + <para>x64 - production use of PHP 7.0+ unless its a 32-bit only version of Windows. 5.5 and 5.6 x64 are expiremental.</para> + </listitem> </itemizedlist> </para> </sect2> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69107 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69107 ------------------------------------------------------------------ Modified: en/reference/ds/ds/hashable/hash.xml By: rjhdby on 2016-10-12 00:33:54 =================================================================== --- en/reference/ds/ds/hashable/hash.xml +++ en/reference/ds/ds/hashable/hash.xml @@ -93,7 +93,7 @@ public function equals($obj): bool { return $this->name === $obj->name - && $this->email === $obj->email; + && $this->hash() === $obj->hash(); } } ?> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69185 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69185 ------------------------------------------------------------------ Modified: en/reference/ds/ds/deque/slice.xml By: rjhdby on 2016-10-15 02:32:19 =================================================================== --- en/reference/ds/ds/deque/slice.xml +++ en/reference/ds/ds/deque/slice.xml @@ -14,7 +14,7 @@ <methodsynopsis> <modifier>public</modifier> <type>DsDeque</type><methodname>DsDeque::slice</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> Creates a sub-deque of a given range. => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69439 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69439 ------------------------------------------------------------------ Modified: en/reference/ds/ds/map/slice.xml By: rjhdby on 2016-10-15 02:32:27 =================================================================== --- en/reference/ds/ds/map/slice.xml +++ en/reference/ds/ds/map/slice.xml @@ -14,7 +14,7 @@ <methodsynopsis> <modifier>public</modifier> <type>DsMap</type><methodname>DsMap::slice</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> Returns a subset of the map defined by a starting <parameter>index</parameter> and <parameter>length</parameter>. => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69440 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69440 ------------------------------------------------------------------ Modified: en/reference/ds/ds/sequence/slice.xml By: rjhdby on 2016-10-15 02:32:37 =================================================================== --- en/reference/ds/ds/sequence/slice.xml +++ en/reference/ds/ds/sequence/slice.xml @@ -14,7 +14,7 @@ <methodsynopsis> <modifier>abstract</modifier> <modifier>public</modifier> <type>DsSequence</type><methodname>DsSequence::slice</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> Creates a sub-sequence of a given range. => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69441 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69441 ------------------------------------------------------------------ Modified: en/reference/ds/ds/set/slice.xml By: rjhdby on 2016-10-15 02:32:43 =================================================================== --- en/reference/ds/ds/set/slice.xml +++ en/reference/ds/ds/set/slice.xml @@ -14,7 +14,7 @@ <methodsynopsis> <modifier>public</modifier> <type>DsSet</type><methodname>DsSet::slice</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> Creates a sub-set of a given range. => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69442 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69442 ------------------------------------------------------------------ Modified: en/reference/ds/ds/vector/slice.xml By: rjhdby on 2016-10-15 02:32:53 =================================================================== --- en/reference/ds/ds/vector/slice.xml +++ en/reference/ds/ds/vector/slice.xml @@ -14,7 +14,7 @@ <methodsynopsis> <modifier>public</modifier> <type>DsVector</type><methodname>DsVector::slice</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <para> Creates a sub-vector of a given range. => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69443 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69443 ------------------------------------------------------------------ Modified: en/reference/gearman/gearmanclient/setcompletecallback.xml By: Michael Moussa on 2016-10-15 10:06:36 =================================================================== --- en/reference/gearman/gearmanclient/setcompletecallback.xml +++ en/reference/gearman/gearmanclient/setcompletecallback.xml @@ -14,9 +14,14 @@ <methodparam><type>callable</type><parameter>callback</parameter></methodparam> </methodsynopsis> <para> - Use to set a function to be called when a task is completed. The callback function should - accept a single argument, a <classname>GearmanTask</classname> object. + Use to set a function to be called when a <classname>GearmanTask</classname> is completed, or + when <methodname>GearmanJob::sendComplete</methodname> is invoked by a worker (whichever happens + first). </para> + <para> + This callback executes only when executing a <classname>GearmanTask</classname> using + <methodname>GearmanClient::runTasks</methodname>. It is not used for individual jobs. + </para> </refsect1> <refsect1 role="parameters"> => Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69463 => Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69463 ------------------------------------------------------------------ -- https://edit.php.net/ This email is send automatically by the Php Docbook Online Editor.