From 0a10abc50524fcbb21807b5e6ebffb3b86d45907 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Fri, 15 Jan 2021 15:45:42 +0100 Subject: [PATCH 01/85] Fix #75073: date_default_timezone_set() doesn't reflect removal --- .../datetime/functions/date-default-timezone-set.xml | 9 --------- 1 file changed, 9 deletions(-) diff --git a/reference/datetime/functions/date-default-timezone-set.xml b/reference/datetime/functions/date-default-timezone-set.xml index e19f97495e..8ba1471693 100644 --- a/reference/datetime/functions/date-default-timezone-set.xml +++ b/reference/datetime/functions/date-default-timezone-set.xml @@ -17,15 +17,6 @@ date_default_timezone_set sets the default timezone used by all date/time functions. - - - Since PHP 5.1.0 (when the date/time functions were rewritten), every call - to a date/time function will generate a E_NOTICE if - the timezone isn't valid, and/or a E_WARNING message - if using the system settings or the TZ environment - variable. - - Instead of using this function to set the default timezone in your script, you can also use the INI setting Date: Fri, 15 Jan 2021 23:32:34 +0100 Subject: [PATCH 02/85] Remove obsolete Judy documentation This extension is unmaintained for more than seven years, and is not compatible with PHP 7. --- appendices/extensions.xml | 2 - reference/judy/book.xml | 55 ------- reference/judy/configure.xml | 101 ------------ reference/judy/functions/judy-type.xml | 66 -------- reference/judy/functions/judy-version.xml | 56 ------- reference/judy/judy.xml | 180 ---------------------- reference/judy/judy/bycount.xml | 65 -------- reference/judy/judy/construct.xml | 65 -------- reference/judy/judy/count.xml | 74 --------- reference/judy/judy/destruct.xml | 56 ------- reference/judy/judy/first.xml | 65 -------- reference/judy/judy/firstempty.xml | 65 -------- reference/judy/judy/free.xml | 58 ------- reference/judy/judy/gettype.xml | 57 ------- reference/judy/judy/last.xml | 65 -------- reference/judy/judy/lastempty.xml | 65 -------- reference/judy/judy/memoryusage.xml | 56 ------- reference/judy/judy/next.xml | 65 -------- reference/judy/judy/nextempty.xml | 65 -------- reference/judy/judy/offsetexists.xml | 65 -------- reference/judy/judy/offsetget.xml | 65 -------- reference/judy/judy/offsetset.xml | 74 --------- reference/judy/judy/offsetunset.xml | 65 -------- reference/judy/judy/prev.xml | 65 -------- reference/judy/judy/prevempty.xml | 65 -------- reference/judy/judy/size.xml | 58 ------- reference/judy/reference.xml | 30 ---- reference/judy/setup.xml | 47 ------ reference/judy/versions.xml | 55 ------- 29 files changed, 1870 deletions(-) delete mode 100644 reference/judy/book.xml delete mode 100644 reference/judy/configure.xml delete mode 100644 reference/judy/functions/judy-type.xml delete mode 100644 reference/judy/functions/judy-version.xml delete mode 100644 reference/judy/judy.xml delete mode 100644 reference/judy/judy/bycount.xml delete mode 100644 reference/judy/judy/construct.xml delete mode 100644 reference/judy/judy/count.xml delete mode 100644 reference/judy/judy/destruct.xml delete mode 100644 reference/judy/judy/first.xml delete mode 100644 reference/judy/judy/firstempty.xml delete mode 100644 reference/judy/judy/free.xml delete mode 100644 reference/judy/judy/gettype.xml delete mode 100644 reference/judy/judy/last.xml delete mode 100644 reference/judy/judy/lastempty.xml delete mode 100644 reference/judy/judy/memoryusage.xml delete mode 100644 reference/judy/judy/next.xml delete mode 100644 reference/judy/judy/nextempty.xml delete mode 100644 reference/judy/judy/offsetexists.xml delete mode 100644 reference/judy/judy/offsetget.xml delete mode 100644 reference/judy/judy/offsetset.xml delete mode 100644 reference/judy/judy/offsetunset.xml delete mode 100644 reference/judy/judy/prev.xml delete mode 100644 reference/judy/judy/prevempty.xml delete mode 100644 reference/judy/judy/size.xml delete mode 100644 reference/judy/reference.xml delete mode 100644 reference/judy/setup.xml delete mode 100644 reference/judy/versions.xml diff --git a/appendices/extensions.xml b/appendices/extensions.xml index be88e3221e..54e6bc245f 100644 --- a/appendices/extensions.xml +++ b/appendices/extensions.xml @@ -75,7 +75,6 @@ - @@ -352,7 +351,6 @@ - diff --git a/reference/judy/book.xml b/reference/judy/book.xml deleted file mode 100644 index e62047d893..0000000000 --- a/reference/judy/book.xml +++ /dev/null @@ -1,55 +0,0 @@ - - - - - Judy Arrays - Judy - - - &reftitle.intro; - -PHP Judy is a PECL extension for the -Judy C library -implementing dynamic sparse arrays. - - -A Judy array is a complex but very fast associative array data structure for -storing and looking up values using integer or string keys. Unlike normal -arrays, Judy arrays may be sparse; that is, they may have large ranges of -unassigned indices. - - -A Judy array consumes memory only when populated yet can grow to take advantage -of all available memory. Judy's key benefits are: scalability, performance, -memory efficiency, and ease of use. Judy arrays are designed to grow without -tuning into the peta-element range, scaling near O(log-base-256) -- 1 more RAM -access at 256 X population. - - - - &reference.judy.setup; - &reference.judy.judy; - &reference.judy.reference; - - - - diff --git a/reference/judy/configure.xml b/reference/judy/configure.xml deleted file mode 100644 index 194e70d2b8..0000000000 --- a/reference/judy/configure.xml +++ /dev/null @@ -1,101 +0,0 @@ - - - -
- &reftitle.install; - - - &pecl.moved; - - - - &pecl.info; - &url.pecl.package;judy - - -
- Installation on Linux Systems -
- From sources - - Download and install libJudy, then : - - phpize - ./configure --with-judy[=DIR] - make - make test - make install - - -
-
- Ubuntu/Debian - - libJudy can be installed with apt-get : - - apt-get install libjudydebian1 libjudy-dev - - Then by installing the Judy extension from PECL or from the sources. - -
-
- -
- Installation on Windows Systems - - Download libJudy, then - extract the sources and open the Visual Studio command prompt and navigate to - the source directory. Then execute : - build - This creates "Judy.lib", copy this into the php-sdk library folder and name it - "libJudy.lib" Then copy the include file "judy.h" into the php-sdk includes folder. - - - Next, the PHP Judy extension can be installed from PECL or from the sources by - extracting the pecl/judy into your build folder where the build scripts will be - able to pick it up, e.g.: - - C:\php\pecl\judy\ - - If your source of PHP is located in: - - C:\php\src\ - - The rest of the steps is pretty straight forward, like any other external extension: - - buildconf - configure --with-judy=shared - nmake - - -
- -
- Installation on macOS - - Download and install libJudy. - Then install the Judy extension from PECL or from the sources. - -
- -
- diff --git a/reference/judy/functions/judy-type.xml b/reference/judy/functions/judy-type.xml deleted file mode 100644 index de350cc736..0000000000 --- a/reference/judy/functions/judy-type.xml +++ /dev/null @@ -1,66 +0,0 @@ - - - - - - judy_type - Return the type of a Judy array - - - - &reftitle.description; - - intjudy_type - Judyarray - - - judy_type return an integer corresponding to the Judy - type of the specified Judy array. - - - - - - &reftitle.parameters; - - - array - - - The Judy Array to test. - - - - - - - - &reftitle.returnvalues; - - Return an integer corresponding to a Judy type. - - - - - - - diff --git a/reference/judy/functions/judy-version.xml b/reference/judy/functions/judy-version.xml deleted file mode 100644 index e84ba5efae..0000000000 --- a/reference/judy/functions/judy-version.xml +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - judy_version - Return or print the current PHP Judy version - - - - &reftitle.description; - - stringjudy_version - - - - Return a string of the PHP Judy version. If the return value is not used, the string will be printed. - - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - Return a string of the PHP Judy version. - - - - - - - diff --git a/reference/judy/judy.xml b/reference/judy/judy.xml deleted file mode 100644 index 020f9af3c4..0000000000 --- a/reference/judy/judy.xml +++ /dev/null @@ -1,180 +0,0 @@ - - - - - - The <classname>Judy</classname> class - Judy - - - - -
- &reftitle.intro; - -The Judy class implements the ArrayAccess -interface and the Iterator interface. -This class, once instantiated, can be accessed like a PHP -array. - - -A PHP Judy object (or Judy Array) can be one of the following type : - - Judy::BITSET - Judy::INT_TO_INT - Judy::INT_TO_MIXED - Judy::STRING_TO_INT - Judy::STRING_TO_MIXED - - - - - Judy array example - - -]]> - - - -
- - -
- &reftitle.classsynopsis; - - - - Judy - - - - - Judy - - - - ArrayAccess - - - Iterator - - - - Constants - - const - int - Judy::BITSET - 1 - - - const - int - Judy::INT_TO_INT - 2 - - - const - int - Judy::INT_TO_MIXED - 3 - - - const - int - Judy::STRING_TO_INT - 4 - - - const - int - Judy::STRING_TO_MIXED - 5 - - - &Methods; - - - - -
- - -
- &reftitle.constants; - - - - Judy::BITSET - - Define the Judy Array as a Bitset with keys as Integer and Values as a Boolean - - - - - Judy::INT_TO_INT - - Define the Judy Array with key/values as Integer, and Integer only. - - - - - Judy::INT_TO_MIXED - - Define the Judy Array with keys as Integer and Values of any type. - - - - - Judy::STRING_TO_INT - - Define the Judy Array with keys as a String and Values as Integer, and Integer only. - - - - - Judy::STRING_TO_MIXED - - Define the Judy Array with keys as a String and Values of any type. - - - - -
- - - - - - &reference.judy.entities.judy; - - - - diff --git a/reference/judy/judy/bycount.xml b/reference/judy/judy/bycount.xml deleted file mode 100644 index bcd987dfcb..0000000000 --- a/reference/judy/judy/bycount.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::byCount - Locate the Nth index present in the Judy array - - - - &reftitle.description; - - public intJudy::byCount - intnth_index - - - Locate the Nth index present in the Judy array. - - - - - - &reftitle.parameters; - - - nth_index - - - Nth index to return. If nth_index equal 1, then it will return the first index in the array. - - - - - - - - &reftitle.returnvalues; - - Return the index at the given Nth position. - - - - - - - diff --git a/reference/judy/judy/construct.xml b/reference/judy/judy/construct.xml deleted file mode 100644 index fce32fc242..0000000000 --- a/reference/judy/judy/construct.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::__construct - Construct a new Judy object - - - - &reftitle.description; - - public Judy::__construct - intjudy_type - - - Construct a new Judy object. A Judy object can be accessed like a PHP Array. - - - - - - &reftitle.parameters; - - - judy_type - - - The Judy type to be used. - - - - - - - - &reftitle.returnvalues; - - Return the new Judy instance. - - - - - - - diff --git a/reference/judy/judy/count.xml b/reference/judy/judy/count.xml deleted file mode 100644 index af2546d332..0000000000 --- a/reference/judy/judy/count.xml +++ /dev/null @@ -1,74 +0,0 @@ - - - - - - Judy::count - Count the number of elements in the Judy array - - - - &reftitle.description; - - public intJudy::count - intindex_start0 - intindex_end-1 - - - Count the number of elements in the Judy array. - - - - - - &reftitle.parameters; - - - index_start - - - Start counting from the given index. Default is first index. - - - - - index_end - - - Stop counting when reaching this index. Default is last index. - - - - - - - - &reftitle.returnvalues; - - Return the number of elements. - - - - - - - diff --git a/reference/judy/judy/destruct.xml b/reference/judy/judy/destruct.xml deleted file mode 100644 index 1e12409c95..0000000000 --- a/reference/judy/judy/destruct.xml +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - Judy::__destruct - Destruct a Judy object - - - - &reftitle.description; - - public voidJudy::__destruct - - - - Destruct a Judy object. - - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - - - - - - - - diff --git a/reference/judy/judy/first.xml b/reference/judy/judy/first.xml deleted file mode 100644 index f8464d9aeb..0000000000 --- a/reference/judy/judy/first.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::first - Search for the first index in the Judy array - - - - &reftitle.description; - - public mixedJudy::first - mixedindex - - - Search (inclusive) for the first index present that is equal to or greater than the passed Index. - - - - - - &reftitle.parameters; - - - index - - - The index can be an integer or a string corresponding to the index where to start the search. - - - - - - - - &reftitle.returnvalues; - - Return the corresponding index in the array. - - - - - - - diff --git a/reference/judy/judy/firstempty.xml b/reference/judy/judy/firstempty.xml deleted file mode 100644 index 014e4169a1..0000000000 --- a/reference/judy/judy/firstempty.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::firstEmpty - Search for the first absent index in the Judy array - - - - &reftitle.description; - - public intJudy::firstEmpty - mixedindex0 - - - Search (inclusive) for the first absent index that is equal to or greater than the passed Index. - - - - - - &reftitle.parameters; - - - index - - - The index can be an integer or a string corresponding to the index where to start the search. - - - - - - - - &reftitle.returnvalues; - - Return the corresponding index in the array. - - - - - - - diff --git a/reference/judy/judy/free.xml b/reference/judy/judy/free.xml deleted file mode 100644 index 6161d6ca5e..0000000000 --- a/reference/judy/judy/free.xml +++ /dev/null @@ -1,58 +0,0 @@ - - - - - - Judy::free - Free the entire Judy array - - - - &reftitle.description; - - public intJudy::free - - - - Free the entire Judy array. - - - &warn.undocumented.func; - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - - - - - - - - diff --git a/reference/judy/judy/gettype.xml b/reference/judy/judy/gettype.xml deleted file mode 100644 index 48ff65b166..0000000000 --- a/reference/judy/judy/gettype.xml +++ /dev/null @@ -1,57 +0,0 @@ - - - - - - Judy::getType - Return the type of the current Judy array - - - - &reftitle.description; - - public intJudy::getType - - - - Return an integer corresponding to the Judy type - of the current object. - - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - Return an integer corresponding to a Judy type. - - - - - - - diff --git a/reference/judy/judy/last.xml b/reference/judy/judy/last.xml deleted file mode 100644 index b2995f2500..0000000000 --- a/reference/judy/judy/last.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::last - Search for the last index in the Judy array - - - - &reftitle.description; - - public voidJudy::last - stringindex - - - Search (inclusive) for the last index present that is equal to or less than the passed Index. - - - - - - &reftitle.parameters; - - - index - - - The index can be an integer or a string corresponding to the index where to start the search. - - - - - - - - &reftitle.returnvalues; - - Return the corresponding index in the array. - - - - - - - diff --git a/reference/judy/judy/lastempty.xml b/reference/judy/judy/lastempty.xml deleted file mode 100644 index 053ba84c15..0000000000 --- a/reference/judy/judy/lastempty.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::lastEmpty - Search for the last absent index in the Judy array - - - - &reftitle.description; - - public intJudy::lastEmpty - intindex-1 - - - Search (inclusive) for the last absent index that is equal to or less than the passed Index. - - - - - - &reftitle.parameters; - - - index - - - The index can be an integer or a string corresponding to the index where to start the search. - - - - - - - - &reftitle.returnvalues; - - Return the corresponding index in the array. - - - - - - - diff --git a/reference/judy/judy/memoryusage.xml b/reference/judy/judy/memoryusage.xml deleted file mode 100644 index 61d00bfd01..0000000000 --- a/reference/judy/judy/memoryusage.xml +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - Judy::memoryUsage - Return the memory used by the Judy array - - - - &reftitle.description; - - public intJudy::memoryUsage - - - - Return the memory used by the Judy array. - - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - Return the memory used in bytes. - - - - - - - diff --git a/reference/judy/judy/next.xml b/reference/judy/judy/next.xml deleted file mode 100644 index 29f13347f6..0000000000 --- a/reference/judy/judy/next.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::next - Search for the next index in the Judy array - - - - &reftitle.description; - - public mixedJudy::next - mixedindex - - - Search (exclusive) for the next index present that is greater than the passed Index. - - - - - - &reftitle.parameters; - - - index - - - The index can be an integer or a string corresponding to the index where to start the search. - - - - - - - - &reftitle.returnvalues; - - Return the corresponding index in the array. - - - - - - - diff --git a/reference/judy/judy/nextempty.xml b/reference/judy/judy/nextempty.xml deleted file mode 100644 index 7bb03b0225..0000000000 --- a/reference/judy/judy/nextempty.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::nextEmpty - Search for the next absent index in the Judy array - - - - &reftitle.description; - - public intJudy::nextEmpty - intindex - - - Search (exclusive) for the next absent index that is greater than the passed Index. - - - - - - &reftitle.parameters; - - - index - - - The index can be an integer or a string corresponding to the index where to start the search. - - - - - - - - &reftitle.returnvalues; - - Return the corresponding index in the array. - - - - - - - diff --git a/reference/judy/judy/offsetexists.xml b/reference/judy/judy/offsetexists.xml deleted file mode 100644 index 03ccc52904..0000000000 --- a/reference/judy/judy/offsetexists.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::offsetExists - Whether a offset exists - - - - &reftitle.description; - - public boolJudy::offsetExists - mixedoffset - - - Whether or not an offset exists. - - - - - - &reftitle.parameters; - - - offset - - - An offset to check for. - - - - - - - - &reftitle.returnvalues; - - Returns &true; on success or &false; on failure. - - - - - - - diff --git a/reference/judy/judy/offsetget.xml b/reference/judy/judy/offsetget.xml deleted file mode 100644 index 3b1473c5ca..0000000000 --- a/reference/judy/judy/offsetget.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::offsetGet - Offset to retrieve - - - - &reftitle.description; - - public mixedJudy::offsetGet - mixedoffset - - - Returns the value at specified offset. - - - - - - &reftitle.parameters; - - - offset - - - The offset to retrieve. - - - - - - - - &reftitle.returnvalues; - - Can return all value types. - - - - - - - diff --git a/reference/judy/judy/offsetset.xml b/reference/judy/judy/offsetset.xml deleted file mode 100644 index 7b197913a3..0000000000 --- a/reference/judy/judy/offsetset.xml +++ /dev/null @@ -1,74 +0,0 @@ - - - - - - Judy::offsetSet - Offset to set - - - - &reftitle.description; - - public boolJudy::offsetSet - mixedoffset - mixedvalue - - - Assigns a value to the specified offset. - - - - - - &reftitle.parameters; - - - offset - - - The offset to assign the value to. - - - - - value - - - The value to set. - - - - - - - - &reftitle.returnvalues; - - No value is returned. - - - - - - - diff --git a/reference/judy/judy/offsetunset.xml b/reference/judy/judy/offsetunset.xml deleted file mode 100644 index 4ef18300bd..0000000000 --- a/reference/judy/judy/offsetunset.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::offsetUnset - Offset to unset - - - - &reftitle.description; - - public boolJudy::offsetUnset - mixedoffset - - - Unsets an offset. - - - - - - &reftitle.parameters; - - - offset - - - The offset to unset. - - - - - - - - &reftitle.returnvalues; - - No value is returned. - - - - - - - diff --git a/reference/judy/judy/prev.xml b/reference/judy/judy/prev.xml deleted file mode 100644 index 234ac2495e..0000000000 --- a/reference/judy/judy/prev.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::prev - Search for the previous index in the Judy array - - - - &reftitle.description; - - public mixedJudy::prev - mixedindex - - - Search (exclusive) for the previous index present that is less than the passed Index. - - - - - - &reftitle.parameters; - - - index - - - The index can be an integer or a string corresponding to the index where to start the search. - - - - - - - - &reftitle.returnvalues; - - Return the corresponding index in the array. - - - - - - - diff --git a/reference/judy/judy/prevempty.xml b/reference/judy/judy/prevempty.xml deleted file mode 100644 index f1fe91a3f5..0000000000 --- a/reference/judy/judy/prevempty.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - Judy::prevEmpty - Search for the previous absent index in the Judy array - - - - &reftitle.description; - - public intJudy::prevEmpty - mixedindex - - - Search (exclusive) for the previous index absent that is less than the passed Index. - - - - - - &reftitle.parameters; - - - index - - - The index can be an integer or a string corresponding to the index where to start the search. - - - - - - - - &reftitle.returnvalues; - - Return the corresponding index in the array. - - - - - - - diff --git a/reference/judy/judy/size.xml b/reference/judy/judy/size.xml deleted file mode 100644 index f5056773ef..0000000000 --- a/reference/judy/judy/size.xml +++ /dev/null @@ -1,58 +0,0 @@ - - - - - - Judy::size - Return the size of the current Judy array - - - - &reftitle.description; - - public voidJudy::size - - - - &info.method.alias; Judy::count. - - - &warn.undocumented.func; - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - Return an integer. - - - - - - - diff --git a/reference/judy/reference.xml b/reference/judy/reference.xml deleted file mode 100644 index f0ccb1abf5..0000000000 --- a/reference/judy/reference.xml +++ /dev/null @@ -1,30 +0,0 @@ - - - - - Judy &Functions; - - &reference.judy.entities.functions; - - - - diff --git a/reference/judy/setup.xml b/reference/judy/setup.xml deleted file mode 100644 index d75a3d8c80..0000000000 --- a/reference/judy/setup.xml +++ /dev/null @@ -1,47 +0,0 @@ - - - - - &reftitle.setup; - -
- &reftitle.required; - - This extension require the Judy C library. - -
- - &reference.judy.configure; - -
- &reftitle.runtime; - &no.config; -
- -
- &reftitle.resources; - &no.resource; -
- - - - diff --git a/reference/judy/versions.xml b/reference/judy/versions.xml deleted file mode 100644 index e17a2e8993..0000000000 --- a/reference/judy/versions.xml +++ /dev/null @@ -1,55 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - From 7f0509200ee5ac73b301069fd430ef732e82cd7d Mon Sep 17 00:00:00 2001 From: Goran Grbic Date: Sat, 16 Jan 2021 00:53:04 +0100 Subject: [PATCH 03/85] Added PHP 8 into revision version set for var functions Closes GH-333. --- reference/var/versions.xml | 68 +++++++++++++++++++------------------- 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/reference/var/versions.xml b/reference/var/versions.xml index 6c32a7a5c0..7c71cbd568 100644 --- a/reference/var/versions.xml +++ b/reference/var/versions.xml @@ -5,42 +5,42 @@ --> - + - - - - + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - When overriding methods, the parameter signature should remain the same or - PHP will generate an E_STRICT level error. This does - not apply to the constructor, which allows overriding with different - parameters. - Simple Class Inheritance @@ -405,6 +398,169 @@ a default value ]]> + + + Signature compatibility rules + + When overriding a method, its signature must be compatible with the parent + method. Otherwise, a fatal error is emitted, or, prior to PHP 8.0.0, an + E_WARNING level error is generated. + A signature is compatible if it respects the + variance rules, makes a + mandatory parameter optional, and if any new parameters are optional. + This is known as the Liskov Substitution Principle, or LSP for short. + The constructor, + and private methods are exempt from these signature + compatibility rules, and thus won't emit a fatal error in case of a + signature mismatch. + + + Compatible child methods + +foo(); +$extended2 = new Extend2(); +$extended2->foo(1); +]]> + + &example.outputs; + + + + + + + The following examples demonstrate that a child method which removes a parameter, or makes an optional + parameter mandatory, is not compatible with the parent method. + + + Fatal error when a child method removes a parameter + + + + &example.outputs.8.similar; + + + + + + Fatal error when a child method makes an optional parameter mandatory + + + + &example.outputs.8.similar; + + + + + + + + Renaming a method's parameter in a child class is not a signature + incompatibility. However, this is discouraged as it will result in a + runtime Error if + named arguments + are used. + + + Error when using named arguments and parameters were renamed in a child class + +test(foo: "foo", bar: "bar"); // ERROR! +]]> + + &example.outputs.similar; + + + + + + diff --git a/language/oop5/decon.xml b/language/oop5/decon.xml index 8e6a27071d..8263257ecd 100644 --- a/language/oop5/decon.xml +++ b/language/oop5/decon.xml @@ -61,10 +61,10 @@ $obj = new OtherSubClass(); - Unlike with other methods, PHP will not generate an - E_STRICT level error message when - __construct() is overridden with different parameters - than the parent __construct() method has. + Unlike other methods, __construct() + is exempt from the usual + signature compatibility rules + when being extended. Constructors are ordinary methods which are called during the instantiation of their diff --git a/language/oop5/interfaces.xml b/language/oop5/interfaces.xml index 20594d5aa3..6936406c9b 100644 --- a/language/oop5/interfaces.xml +++ b/language/oop5/interfaces.xml @@ -43,11 +43,10 @@ - The class implementing the interface must use a method signatures - which is compatible with LSP (Liskov Substitution Principle). - Not doing so will result in a fatal error. - - + The class implementing the interface must declare a method which has a + compatible signature. + + From f029b664b8728bd5cbb697cb9a4409aea07cb36c Mon Sep 17 00:00:00 2001 From: George Peter Banyard Date: Sat, 16 Jan 2021 10:39:39 +0000 Subject: [PATCH 05/85] Remove magic quote mentions --- faq/using.xml | 25 +- .../info/functions/get-magic-quotes-gpc.xml | 46 +--- security/magicquotes.xml | 237 ------------------ 3 files changed, 3 insertions(+), 305 deletions(-) delete mode 100644 security/magicquotes.xml diff --git a/faq/using.xml b/faq/using.xml index 9dd430579d..f0eb3eb303 100644 --- a/faq/using.xml +++ b/faq/using.xml @@ -78,6 +78,7 @@ if (empty($empty)) { + I need to convert all single-quotes (') to a backslash @@ -96,32 +97,8 @@ if (empty($empty)) { stripslashes functions, that are more common with older PHP code. - - ¬e.magicquotes.gpc; - - - - - - All my " turn into \" and my ' turn into \', how do I get rid of all - these unwanted backslashes? How and why did they get there? - - - - - Most likely the backslashes magically exist because the PHP directive - magic_quotes_gpc is on. - This is an old feature of PHP, and should be disabled and not relied - upon. Also, the PHP function stripslashes may be - used to strip the backslashes from the string. - - - ¬e.magicquotes.gpc; - - - diff --git a/reference/info/functions/get-magic-quotes-gpc.xml b/reference/info/functions/get-magic-quotes-gpc.xml index d5ed0a2093..91211ac5c2 100644 --- a/reference/info/functions/get-magic-quotes-gpc.xml +++ b/reference/info/functions/get-magic-quotes-gpc.xml @@ -17,24 +17,14 @@ - Returns the current configuration setting of magic_quotes_gpc - - - Keep in mind that attempting to set - magic_quotes_gpc at runtime will not work. - - - For more information about magic_quotes, see this - security section. + Always returns &false;. &reftitle.returnvalues; - Returns 0 if magic_quotes_gpc is off, 1 otherwise. - Or always returns &false; as of PHP 5.4.0. + Always returns &false;. @@ -62,38 +52,6 @@ - - &reftitle.examples; - - - <function>get_magic_quotes_gpc</function> example - - -]]> - - - - - &reftitle.seealso; diff --git a/security/magicquotes.xml b/security/magicquotes.xml deleted file mode 100644 index 6ce33844b0..0000000000 --- a/security/magicquotes.xml +++ /dev/null @@ -1,237 +0,0 @@ - - - - Magic Quotes - &warn.deprecated.feature-5-3-0.removed-5-4-0; - - Magic Quotes is a process that automagically escapes incoming data to the - PHP script. It's preferred to code with magic quotes off and to instead - escape the data at runtime, as needed. - - - - What are Magic Quotes - &warn.deprecated.feature-5-3-0.removed-5-4-0; - - When on, all ' (single-quote), " - (double quote), \ (backslash) and NULL - characters are escaped with a backslash automatically. This is identical - to what addslashes does. - - - There are three magic quote directives: - - - - - magic_quotes_gpc - - - Affects HTTP Request data (GET, POST, and COOKIE). Cannot be set at - runtime, and defaults to on in PHP. - - - See also get_magic_quotes_gpc. - - - - - magic_quotes_runtime - - - If enabled, most functions that return data from an external source, - including databases and text files, will have quotes escaped with a - backslash. Can be set at runtime, and defaults to off - in PHP. - - - See also set_magic_quotes_runtime and - get_magic_quotes_runtime. - - - - - magic_quotes_sybase - - - If enabled, a single-quote is escaped with a single-quote instead of a - backslash. If on, it completely overrides - magic_quotes_gpc. Having - both directives enabled means only single quotes are escaped as - ''. Double quotes, backslashes and NULL's will - remain untouched and unescaped. - - - See also ini_get for retrieving its value. - - - - - - - Why did we use Magic Quotes - &warn.deprecated.feature-5-3-0.removed-5-4-0; - - - - There is no reason to use magic quotes because they are no longer - a supported part of PHP. However, they did exist and did help a - few beginners blissfully and unknowingly write better (more secure) - code. But, when dealing with code that relies upon this behavior - it's better to update the code instead of turning magic quotes on. - - - So why did this feature exist? Simple, to help prevent - SQL Injection. - Today developers are better aware of security and end up using - database specific escaping mechanisms and/or prepared statements - instead of relying upon features like magical quotes. - - - - - - - Why not to use Magic Quotes - &warn.deprecated.feature-5-3-0.removed-5-4-0; - - - - Portability - - - Assuming it to be on, or off, affects portability. Use - get_magic_quotes_gpc to check for this, and code - accordingly. - - - - - Performance - - - Because not every piece of escaped data is inserted into a - database, there is a performance loss for escaping all this data. - Simply calling on the escaping functions (like - addslashes) at runtime is more efficient. - - - Although php.ini-development enables these directives - by default, php.ini-production disables it. - This recommendation is mainly due to performance reasons. - - - - - Inconvenience - - - Because not all data needs escaping, it's often annoying to see escaped - data where it shouldn't be. For example, emailing from a form, and - seeing a bunch of \' within the email. To fix, this may require - excessive use of stripslashes. - - - - - - - Disabling Magic Quotes - - The magic_quotes_gpc - directive may only be disabled at the system level, and not at - runtime. In otherwords, use of ini_set is not - an option. - - - - Disabling magic quotes server side - - An example that sets the value of these directives to - Off in &php.ini;. For additional details, read the - manual section titled How to - change configuration settings. - - - - - - If access to the server configuration is unavailable, use of - .htaccess is also an option. For example: - - - - - - - - In the interest of writing portable code (code that works in any - environment), like if setting at the server level is not possible, - here's an example to disable - magic_quotes_gpc at runtime. This method is inefficient so - it's preferred to instead set the appropriate directives elsewhere. - - - - Disabling magic quotes at runtime - - $v) { - unset($process[$key][$k]); - if (is_array($v)) { - $process[$key][stripslashes($k)] = $v; - $process[] = &$process[$key][stripslashes($k)]; - } else { - $process[$key][stripslashes($k)] = stripslashes($v); - } - } - } - unset($process); -} -?> -]]> - - - - - - - - From f3d6ada6156b28791a28efebe2e5c070159c3a94 Mon Sep 17 00:00:00 2001 From: George Peter Banyard Date: Sat, 16 Jan 2021 10:44:21 +0000 Subject: [PATCH 06/85] Remove information about session.bug_compat_* INI setting This has been removed in PHP 5.4.0 --- appendices/ini.list.xml | 12 -------- reference/session/ini.xml | 59 --------------------------------------- 2 files changed, 71 deletions(-) diff --git a/appendices/ini.list.xml b/appendices/ini.list.xml index 5131045da8..87de465804 100644 --- a/appendices/ini.list.xml +++ b/appendices/ini.list.xml @@ -1946,18 +1946,6 @@ PHP_INI_PERDIR PHP_INI_ALL in PHP <= 5.4.19 and in PHP <= 5.5.1. - - session.bug_compat_42 - "1" - PHP_INI_ALL - Removed in PHP 5.4.0. - - - session.bug_compat_warn - "1" - PHP_INI_ALL - Removed in PHP 5.4.0. - session.cache_expire "180" diff --git a/reference/session/ini.xml b/reference/session/ini.xml index 83f0a6ef95..7d623a9dd1 100644 --- a/reference/session/ini.xml +++ b/reference/session/ini.xml @@ -238,18 +238,6 @@ PHP_INI_ALL Removed in PHP 7.1.0 - - session.bug_compat_42 - "1" - PHP_INI_ALL - Removed in PHP 5.4.0. - - - session.bug_compat_warn - "1" - PHP_INI_ALL - Removed in PHP 5.4.0. - @@ -804,53 +792,6 @@ - - - - session.bug_compat_42 - bool - - - - PHP versions 4.2.3 and lower have an undocumented feature/bug that - allows you to initialize a session variable in the global scope, - albeit register_globals - is disabled. PHP 4.3.0 and later will warn you, if this feature is - used, and if - session.bug_compat_warn is also enabled. This feature/bug can be - disabled by disabling this directive. - - - - Removed in PHP 5.4.0. - - - - - - - - session.bug_compat_warn - bool - - - - PHP versions 4.2.3 and lower have an undocumented feature/bug that - allows you to initialize a session variable in the global scope, - albeit register_globals - is disabled. PHP 4.3.0 and later will warn you, if this feature is - used by enabling both - session.bug_compat_42 - and - session.bug_compat_warn. - - - - Removed in PHP 5.4.0. - - - - From 4a7ddddc27271967b616ad3400cfbe2a9b48212b Mon Sep 17 00:00:00 2001 From: George Peter Banyard Date: Sat, 16 Jan 2021 11:26:56 +0000 Subject: [PATCH 07/85] Remove some mentions of register globals --- language/variables.xml | 6 +- reference/array/functions/extract.xml | 87 +---------------------- reference/network/functions/setcookie.xml | 8 --- reference/session/examples.xml | 5 -- reference/strings/functions/parse-str.xml | 8 --- 5 files changed, 3 insertions(+), 111 deletions(-) diff --git a/language/variables.xml b/language/variables.xml index ad0b57fad9..34d1da6bf7 100644 --- a/language/variables.xml +++ b/language/variables.xml @@ -168,10 +168,8 @@ var_dump($unset_obj); Relying on the default value of an uninitialized variable is problematic in the case of including one file into another which uses the same - variable name. It is also a major security risk with register_globals turned on. E_NOTICE level error is issued in case of + variable name. + E_NOTICE level error is issued in case of working with uninitialized variables, however not in the case of appending elements to the uninitialized array. isset language construct can be used to detect if a variable has been already initialized. diff --git a/reference/array/functions/extract.xml b/reference/array/functions/extract.xml index 23091c2508..446b8bacab 100644 --- a/reference/array/functions/extract.xml +++ b/reference/array/functions/extract.xml @@ -219,9 +219,7 @@ blue, large, sphere, medium Do not use extract on untrusted data, like user input (i.e. $_GET, $_FILES, etc.). - If you do, for example if you want to temporarily run old code that - relied on register_globals, - make sure you use one of the non-overwriting + If you do, make sure you use one of the non-overwriting flags values such as EXTR_SKIP and be aware that you should extract in the same order that's defined in @@ -229,89 +227,6 @@ blue, large, sphere, medium &php.ini;. - - - If you still - have register_globals - and it is turned on, if you use extract - on $_FILES and - specify EXTR_SKIP, you may be surprised at - the results. - - - - This is not recommended practice and is only documented here for - completeness. The use - of register_globals is - deprecated and calling extract on untrusted - data such as $_FILES is, as noted above, a - potential security risk. If you encounter this issue, it means - that you are using at least two poor coding practices. - - - - -]]> - - - You might expect to see something like the following: - - - - string(10) "somefile.txt" - ["type"]=> - string(24) "application/octet-stream" - ["tmp_name"]=> - string(14) "/tmp/phpgCCPX8" - ["error"]=> - int(0) - ["size"]=> - int(4208) -} -string(14) "/tmp/phpgCCPX8" -]]> - - - However, you would instead see something like this: - - - - - - This is due to the fact that - since register_globals is - turned on, $testfile already exists in the - global scope when extract is called. And - since EXTR_SKIP is - specified, $testfile is not overwritten with - the contents of the $_FILES array - so $testfile remains a string. - Because strings may - be accessed using array syntax and the non-numeric string - tmp_name is interpreted - as 0, PHP - sees $testfile['tmp_name'] - as $testfile[0]. - - &reftitle.seealso; diff --git a/reference/network/functions/setcookie.xml b/reference/network/functions/setcookie.xml index 94e7bedc17..00c8aa51b0 100644 --- a/reference/network/functions/setcookie.xml +++ b/reference/network/functions/setcookie.xml @@ -334,14 +334,6 @@ one : cookieone &php.ini; or server configuration files. - - - If the PHP directive register_globals - is set to on then cookie values will also be made into - variables. In our examples below, $TestCookie will - exist. It's recommended to use $_COOKIE. - - Common Pitfalls: diff --git a/reference/session/examples.xml b/reference/session/examples.xml index ed3f62499a..8f3c442598 100644 --- a/reference/session/examples.xml +++ b/reference/session/examples.xml @@ -83,11 +83,6 @@ unset($_SESSION['count']); to restore a reference to another variable. - - - register_globals will overwrite variables in the global scope whose names are shared with session variables. Please see Using Register Globals for details. - - File based sessions (the default in PHP) lock the session file once a diff --git a/reference/strings/functions/parse-str.xml b/reference/strings/functions/parse-str.xml index a571c66066..3fd56e3942 100644 --- a/reference/strings/functions/parse-str.xml +++ b/reference/strings/functions/parse-str.xml @@ -45,14 +45,6 @@ Using this function without the result parameter is highly DISCOURAGED and DEPRECATED as of PHP 7.2. - - Dynamically setting variables in function's scope suffers from exactly same problems - as register_globals. - - - Read section on security of Using Register Globals - explaining why it is dangerous. - From 0aeef38a9cb30ab6b7a5fa787e11713db9481829 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Sat, 16 Jan 2021 22:11:38 +0900 Subject: [PATCH 08/85] Added PHP 8 into versions.xml for strings functions --- reference/strings/versions.xml | 190 ++++++++++++++++----------------- 1 file changed, 95 insertions(+), 95 deletions(-) diff --git a/reference/strings/versions.xml b/reference/strings/versions.xml index d04b0b7896..c302a4cf76 100644 --- a/reference/strings/versions.xml +++ b/reference/strings/versions.xml @@ -4,107 +4,107 @@ Do NOT translate this file --> - - - - - - + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - - - - + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + - - - - - - - - + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + From 755faca201b5ba15e23735f21ed056b47d954398 Mon Sep 17 00:00:00 2001 From: Goran Grbic Date: Sun, 17 Jan 2021 02:34:37 +0100 Subject: [PATCH 10/85] Added version PHP 8 into array functions' version. Also slight improvements to related examples. Closes GH-337. --- reference/array/functions/array-walk.xml | 2 +- reference/array/functions/each.xml | 2 +- reference/array/functions/key.xml | 2 +- reference/array/functions/range.xml | 7 + reference/array/versions.xml | 160 +++++++++++------------ 5 files changed, 90 insertions(+), 83 deletions(-) diff --git a/reference/array/functions/array-walk.xml b/reference/array/functions/array-walk.xml index e5e24d141e..f042383e54 100644 --- a/reference/array/functions/array-walk.xml +++ b/reference/array/functions/array-walk.xml @@ -116,7 +116,7 @@ function test_alter(&$item1, $key, $prefix) function test_print($item2, $key) { - echo "$key. $item2
\n"; + echo "$key. $item2\n"; } echo "Before ...:\n"; diff --git a/reference/array/functions/each.xml b/reference/array/functions/each.xml index 9b0705e6fb..014019f996 100644 --- a/reference/array/functions/each.xml +++ b/reference/array/functions/each.xml @@ -7,7 +7,7 @@ - &warn.deprecated.function-7-2-0; + &warn.deprecated.function-7-2-0.removed-8-0-0; diff --git a/reference/array/functions/key.xml b/reference/array/functions/key.xml index b62cc5327a..5a1c098c1e 100644 --- a/reference/array/functions/key.xml +++ b/reference/array/functions/key.xml @@ -86,7 +86,7 @@ $array = array( // key where value equals "apple" while ($fruit_name = current($array)) { if ($fruit_name == 'apple') { - echo key($array).'
'; + echo key($array), "\n"; } next($array); } diff --git a/reference/array/functions/range.xml b/reference/array/functions/range.xml index 58ed2f2890..360603bf11 100644 --- a/reference/array/functions/range.xml +++ b/reference/array/functions/range.xml @@ -72,17 +72,24 @@ foreach (range(0, 12) as $number) { echo $number; } +echo "\n"; + // The step parameter // array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100) foreach (range(0, 100, 10) as $number) { echo $number; } +echo "\n"; + // Usage of character sequences // array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i'); foreach (range('a', 'i') as $letter) { echo $letter; } + +echo "\n"; + // array('c', 'b', 'a'); foreach (range('c', 'a') as $letter) { echo $letter; diff --git a/reference/array/versions.xml b/reference/array/versions.xml index 4c73c28dfe..61b6f1e43e 100644 --- a/reference/array/versions.xml +++ b/reference/array/versions.xml @@ -4,87 +4,87 @@ Do NOT translate this file --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - + + + + - - + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - + + + + + + + + - - - - - - - - - - - - - + + + + + + + + + + + + + - - + + - - + + - - - - - - - + + + + + + + - - - + + + - - - - - - + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file +--> From c969df2ecef915c94fd528df676a5fcbea78cc84 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Sun, 17 Jan 2021 23:29:25 +0900 Subject: [PATCH 19/85] Added PHP 8 into versions.xml for pcre based on stubs. Closes GH-347. --- reference/pcre/versions.xml | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/reference/pcre/versions.xml b/reference/pcre/versions.xml index 204e32c7ce..06a0a14d6d 100644 --- a/reference/pcre/versions.xml +++ b/reference/pcre/versions.xml @@ -4,17 +4,17 @@ Do NOT translate this file --> - - - - - - - - - - - + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - + + + + + + + - - - + + + \ No newline at end of file +--> From 407e4b50b77b0983334b2a026b31230e237235f0 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Sun, 17 Jan 2021 23:51:55 +0900 Subject: [PATCH 21/85] Added PHP 8 into versions.xml for pcntl based on stubs. Closes GH-349. --- reference/pcntl/versions.xml | 46 ++++++++++++++++++------------------ 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/reference/pcntl/versions.xml b/reference/pcntl/versions.xml index 4baf6e9aa0..9a1221e913 100644 --- a/reference/pcntl/versions.xml +++ b/reference/pcntl/versions.xml @@ -4,29 +4,29 @@ Do NOT translate this file --> - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + GearmanClient::wait + Wait for I/O activity on all connections in a client + + + + &reftitle.description; + + public boolGearmanClient::wait + + + + This waits for activity from any one of the connected servers. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &true; on success &false; on an error. + + + + + &reftitle.seealso; + + + GearmanWorker::wait + + + + + + + diff --git a/reference/gearman/versions.xml b/reference/gearman/versions.xml index 6ab6c22a96..ebd0d4f34e 100644 --- a/reference/gearman/versions.xml +++ b/reference/gearman/versions.xml @@ -81,6 +81,7 @@ Example entries: + @@ -143,6 +144,7 @@ Example entries: + From bd9ceed9a81de43564a84b969bee619fd2b33e14 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Mon, 18 Jan 2021 13:54:16 +0900 Subject: [PATCH 23/85] added trailing comma after "PHP 8". --- reference/json/versions.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/json/versions.xml b/reference/json/versions.xml index 30aa46cfbb..061749a6b2 100644 --- a/reference/json/versions.xml +++ b/reference/json/versions.xml @@ -4,8 +4,8 @@ Do NOT translate this file --> - - + + From 982a2bc5aa3f3c6c244c6066c68ea66efdbea2ec Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Mon, 18 Jan 2021 19:48:51 +0900 Subject: [PATCH 24/85] Added PHP 8 into versions.xml for pgsql based on stubs. Closes GH-351. --- reference/pgsql/versions.xml | 181 +++++++++++++++++------------------ 1 file changed, 90 insertions(+), 91 deletions(-) diff --git a/reference/pgsql/versions.xml b/reference/pgsql/versions.xml index 80911c8644..ae18b2fe60 100644 --- a/reference/pgsql/versions.xml +++ b/reference/pgsql/versions.xml @@ -4,97 +4,96 @@ Do NOT translate this file --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - + + + + - - - - - - - - - + + + + + + + + + \ No newline at end of file +--> From a44e325fda99629cdfd64e819d00248bf48c9537 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Mon, 18 Jan 2021 20:10:18 +0900 Subject: [PATCH 26/85] Added PHP 8 into versions.xml for stream based on stubs. Closes GH-353. --- reference/stream/versions.xml | 152 +++++++++++++++++----------------- 1 file changed, 76 insertions(+), 76 deletions(-) diff --git a/reference/stream/versions.xml b/reference/stream/versions.xml index a96532e2c7..aa972b3555 100644 --- a/reference/stream/versions.xml +++ b/reference/stream/versions.xml @@ -4,84 +4,84 @@ Do NOT translate this file --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - + + + + + + + + + + + \ No newline at end of file +--> From 57232e0ad8146634b748769c29a8e83fc7e0f85f Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Mon, 18 Jan 2021 21:00:25 +0900 Subject: [PATCH 30/85] Added PHP 8 into versions.xml for sqlite3 based on stubs. Closes GH-357. --- reference/sqlite3/versions.xml | 78 +++++++++++++++++----------------- 1 file changed, 39 insertions(+), 39 deletions(-) diff --git a/reference/sqlite3/versions.xml b/reference/sqlite3/versions.xml index 84240be045..906381c9b2 100644 --- a/reference/sqlite3/versions.xml +++ b/reference/sqlite3/versions.xml @@ -5,48 +5,48 @@ --> - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + - + - - - - - - - - - - + + + + + + + + + + - - - - - - - + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - + + + - - - - - - + + + + + + - - - - - - - - - - - + + + + + + + + + + + - - - - - - - - + + + + + + + + - - + + - - - + + + - - - - - + + + + + - - - - - + + + + + - + - - - - - - - - - - - + + + + + + + + + + + - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + From e85adf32e118bba770f1940d5a34e708ece8d4b5 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Mon, 18 Jan 2021 21:30:49 +0900 Subject: [PATCH 35/85] Added PHP 8 into versions.xml for bcmath based on stubs. Closes GH-360. --- reference/bc/versions.xml | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/reference/bc/versions.xml b/reference/bc/versions.xml index 337906ecbd..2a8865130f 100644 --- a/reference/bc/versions.xml +++ b/reference/bc/versions.xml @@ -4,16 +4,16 @@ Do NOT translate this file --> - - - - - - - - - - + + + + + + + + + + \ No newline at end of file +--> From c2120bd346716d6b7fc7cf777a2b0717f7b45f5f Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Mon, 18 Jan 2021 19:45:28 +0100 Subject: [PATCH 36/85] Update some methodsynopses Cf. , . --- reference/datetime/datetimeinterface/diff.xml | 6 ++--- reference/zlib/functions/gzgets.xml | 26 ++++++++++++++++++- 2 files changed, 28 insertions(+), 4 deletions(-) diff --git a/reference/datetime/datetimeinterface/diff.xml b/reference/datetime/datetimeinterface/diff.xml index 647abfd950..dc6467a927 100644 --- a/reference/datetime/datetimeinterface/diff.xml +++ b/reference/datetime/datetimeinterface/diff.xml @@ -13,17 +13,17 @@ &reftitle.description; &style.oop; - public DateIntervalfalseDateTime::diff + public DateIntervalDateTime::diff DateTimeInterfacetargetObject boolabsolute&false; - public DateIntervalfalseDateTimeImmutable::diff + public DateIntervalDateTimeImmutable::diff DateTimeInterfacetargetObject boolabsolute&false; - public DateIntervalfalseDateTimeInterface::diff + public DateIntervalDateTimeInterface::diff DateTimeInterfacetargetObject boolabsolute&false; diff --git a/reference/zlib/functions/gzgets.xml b/reference/zlib/functions/gzgets.xml index 39cf77a629..27516c6813 100644 --- a/reference/zlib/functions/gzgets.xml +++ b/reference/zlib/functions/gzgets.xml @@ -10,7 +10,7 @@ stringfalsegzgets resourcestream - intlength1024 + intnulllength&null; Gets a (uncompressed) string of up to length - 1 bytes read from the given @@ -48,6 +48,30 @@ The uncompressed string, or &false; on error. + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + length is nullable now; + previously, the default was 1024. + + + + + + + &reftitle.examples; From a41128675051f3b8ea0fc722a243455611087e55 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= Date: Mon, 18 Jan 2021 22:55:15 +0100 Subject: [PATCH 37/85] Generate methodsynopses based on recently updated stubs Co-authored-by: Christoph M. Becker Closes GH-362. --- reference/com/compersisthelper/construct.xml | 2 +- reference/datetime/functions/date-sunrise.xml | 4 ++-- reference/datetime/functions/date-sunset.xml | 4 ++-- reference/ffi/ffi/arraytype.xml | 4 +--- reference/ldap/functions/ldap-exop-whoami.xml | 2 +- reference/pcre/functions/preg-match-all.xml | 2 +- 6 files changed, 8 insertions(+), 10 deletions(-) diff --git a/reference/com/compersisthelper/construct.xml b/reference/com/compersisthelper/construct.xml index 4cf7be16a7..ee08cb1a2c 100644 --- a/reference/com/compersisthelper/construct.xml +++ b/reference/com/compersisthelper/construct.xml @@ -10,7 +10,7 @@ &reftitle.description; public COMPersistHelper::__construct - variantnullvariant + variantnullvariant&null; Constructs a persistence helper object, usually associated with a diff --git a/reference/datetime/functions/date-sunrise.xml b/reference/datetime/functions/date-sunrise.xml index a78729f52c..41ea1cc6cb 100644 --- a/reference/datetime/functions/date-sunrise.xml +++ b/reference/datetime/functions/date-sunrise.xml @@ -15,7 +15,7 @@ floatnulllatitude&null; floatnulllongitude&null; floatnullzenith&null; - floatnullutcOffset0 + floatnullutcOffset&null; date_sunrise returns the sunrise time for a given @@ -177,7 +177,7 @@ 8.0.0 latitude, longitude, - zenith and latitude are nullable now. + zenith and utcOffset are nullable now. diff --git a/reference/datetime/functions/date-sunset.xml b/reference/datetime/functions/date-sunset.xml index 848330153f..7641976bec 100644 --- a/reference/datetime/functions/date-sunset.xml +++ b/reference/datetime/functions/date-sunset.xml @@ -17,7 +17,7 @@ floatnulllatitude&null; floatnulllongitude&null; floatnullzenith&null; - floatnullutcOffset0 + floatnullutcOffset&null; date_sunset returns the sunset time for a given @@ -179,7 +179,7 @@ 8.0.0 latitude, longitude, - zenith and latitude are nullable now. + zenith and utcOffset are nullable now. diff --git a/reference/ffi/ffi/arraytype.xml b/reference/ffi/ffi/arraytype.xml index e1efe5c0d6..f6dc2a606d 100644 --- a/reference/ffi/ffi/arraytype.xml +++ b/reference/ffi/ffi/arraytype.xml @@ -1,6 +1,5 @@ - FFI::arrayType @@ -12,7 +11,7 @@ public static FFI\CTypeFFI::arrayType FFI\CTypetype - array dimensions + arraydimensions Dynamically constructs a new C array type with elements of type defined by type, @@ -62,7 +61,6 @@ $t2 = FFI::arrayType(FFI::type("int"), [2, 3]); - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + From fab81eeee3a207e5aff7ac42c56d89607abaab27 Mon Sep 17 00:00:00 2001 From: Lucas Werkmeister Date: Wed, 20 Jan 2021 11:41:25 +0100 Subject: [PATCH 44/85] Add floats without exponent to numeric string grammar The formal grammar for numeric strings included integers, and floating-point numbers (decimals) with a mandatory exponent, but not decimal numbers without exponent. Closes GH-368 --- language/types/numeric-strings.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/language/types/numeric-strings.xml b/language/types/numeric-strings.xml index 473362348c..2f09626adc 100644 --- a/language/types/numeric-strings.xml +++ b/language/types/numeric-strings.xml @@ -19,7 +19,7 @@ LNUM [0-9]+ DNUM ([0-9]*)[\.]{LNUM}) | ({LNUM}[\.][0-9]*) EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM}) INT_NUM_STRING {WHITESPACES} [+-]? {LNUM} {WHITESPACES} -FLOAT_NUM_STRING {WHITESPACES} [+-]? {EXPONENT_DNUM} {WHITESPACES} +FLOAT_NUM_STRING {WHITESPACES} [+-]? ({DNUM} | {EXPONENT_DNUM}) {WHITESPACES} NUM_STRING ({INT_NUM_STRING} | {FLOAT_NUM_STRING}) ]]> From ffbe6525350c91d58e1d5b7a52c46c911035c8e0 Mon Sep 17 00:00:00 2001 From: USAMI Kenta Date: Wed, 20 Jan 2021 12:22:09 +0100 Subject: [PATCH 45/85] require_once and include are expressions, not statements Closes GH-369. --- language/control-structures/include.xml | 2 +- language/control-structures/require-once.xml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/language/control-structures/include.xml b/language/control-structures/include.xml index 3d4534b340..97805b7a72 100644 --- a/language/control-structures/include.xml +++ b/language/control-structures/include.xml @@ -5,7 +5,7 @@ include - The include statement includes and evaluates + The include expression includes and evaluates the specified file. diff --git a/language/control-structures/require-once.xml b/language/control-structures/require-once.xml index eccd7400bb..9ca6194abe 100644 --- a/language/control-structures/require-once.xml +++ b/language/control-structures/require-once.xml @@ -5,7 +5,7 @@ require_once - The require_once statement is identical to + The require_once expression is identical to require except PHP will check if the file has already been included, and if so, not include (require) it again. From ab9c95affa258e0e81157b5528e9b4574c01a06c Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Wed, 20 Jan 2021 15:07:36 +0100 Subject: [PATCH 46/85] liip is deprecated This integrates user note 125701. --- install/macos/packages.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/install/macos/packages.xml b/install/macos/packages.xml index fa16936086..779107d135 100644 --- a/install/macos/packages.xml +++ b/install/macos/packages.xml @@ -45,6 +45,7 @@ Liip: &url.mac.liip; + (PHP 5.3 - PHP 7.3; deprecated) From 6fadea3dfa2365f52bcb4146e955e4a4baa5ab82 Mon Sep 17 00:00:00 2001 From: Martin Samesch Date: Thu, 21 Jan 2021 13:24:08 +0100 Subject: [PATCH 47/85] fix parameter --- reference/uodbc/functions/odbc-execute.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/uodbc/functions/odbc-execute.xml b/reference/uodbc/functions/odbc-execute.xml index 9709020ce0..727508e1b5 100644 --- a/reference/uodbc/functions/odbc-execute.xml +++ b/reference/uodbc/functions/odbc-execute.xml @@ -34,13 +34,13 @@ params - Parameters in parameter_array will be + Parameters in params will be substituted for placeholders in the prepared statement in order. Elements of this array will be converted to strings by calling this function. - Any parameters in parameter_array which + Any parameters in params which start and end with single quotes will be taken as the name of a file to read and send to the database server as the data for the appropriate placeholder. From 6e30ba482b992c476f4646168a082ee45fe2d0c0 Mon Sep 17 00:00:00 2001 From: Remi Collet Date: Thu, 21 Jan 2021 17:31:16 +0100 Subject: [PATCH 48/85] rpminfo: new constant --- reference/rpminfo/constants.xml | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/reference/rpminfo/constants.xml b/reference/rpminfo/constants.xml index ba2c6ffb16..0292f6528c 100644 --- a/reference/rpminfo/constants.xml +++ b/reference/rpminfo/constants.xml @@ -1711,6 +1711,17 @@ + + + RPMTAG_PAYLOADDIGESTALT + (int) + + + + Since librpm >= 4.16. + + + RPMTAG_PAYLOADDIGESTALGO From 923fbe06539286e2a9261ea9982e788b4157ad48 Mon Sep 17 00:00:00 2001 From: Lucas Werkmeister Date: Fri, 22 Jan 2021 12:19:26 +0100 Subject: [PATCH 49/85] explode: update reference to implode param order The legacy order was deprecated in 7.4 and removed in 8.0. Closes GH-372. --- reference/strings/functions/explode.xml | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/reference/strings/functions/explode.xml b/reference/strings/functions/explode.xml index 569d33fa10..0bfc73ec4f 100644 --- a/reference/strings/functions/explode.xml +++ b/reference/strings/functions/explode.xml @@ -62,9 +62,8 @@ - Although implode can, for historical reasons, - accept its parameters in either order, - explode cannot. You must ensure that the + Prior to PHP 8.0, implode accepted its parameters in either order. + explode has never supported this: you must ensure that the separator argument comes before the string argument. From 61f5c7a1f513709b01295cdef5444be4d6bf4ba6 Mon Sep 17 00:00:00 2001 From: Ayesh Karunaratne Date: Fri, 22 Jan 2021 05:02:34 +0700 Subject: [PATCH 50/85] Fix `CURLOPT_MAXREDIRS`/`FOLLOWLOCATION` descriptions Currently, the description for `CURLOPT_FOLLOWLOCATION` and `CURLOPT_MAXREDIRS` indicates that unless a `CURLOPT_MAXREDIRS` value is set, Curl will do an infinite loop. However, this is not the case, because PHP internally sets a default value of 20. Please see: - [`ext/curl/interface.c`](https://github.com/php/php-src/blob/d0e3fb495ff77ec0aa8bc052c15a3899e9da7899/ext/curl/interface.c#L1806) - [PHP Curl Security Hardening: Infinite loops](https://php.watch/articles/php-curl-security-hardening#infinite-redirects) - [Libcurl: CURLOPT_MAXREDIRS.html](https://curl.se/libcurl/c/CURLOPT_MAXREDIRS.html) The default libcurl behavior is indeed to not limit the number of redirects, which enables infinite loops, but I think we probably should keep the PHP's sane default of 20, and update the documentation instead. Closes GH-371. --- reference/curl/functions/curl-setopt.xml | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/reference/curl/functions/curl-setopt.xml b/reference/curl/functions/curl-setopt.xml index f4b28c68b1..680e8d2273 100644 --- a/reference/curl/functions/curl-setopt.xml +++ b/reference/curl/functions/curl-setopt.xml @@ -203,9 +203,8 @@ &true; to follow any "Location: " header that the server sends as - part of the HTTP header (note this is recursive, PHP will follow as - many "Location: " headers that it is sent, - unless CURLOPT_MAXREDIRS is set). + part of the HTTP header. + See also CURLOPT_MAXREDIRS. @@ -831,6 +830,9 @@ The maximum amount of HTTP redirections to follow. Use this option alongside CURLOPT_FOLLOWLOCATION. + Default value of 20 is set to prevent infinite redirects. + Setting to -1 allows inifinite redirects, and 0 + refuses all redirects. From 572c672502a7fef380483aaf843c7515fcc81b71 Mon Sep 17 00:00:00 2001 From: grimskin Date: Fri, 22 Jan 2021 01:07:16 +0100 Subject: [PATCH 51/85] Small grammar fix for the Attributes docs - using `is` instead of `are` with singular noun - typo fix in word `separated` Closes GH-370. --- language/attributes.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/language/attributes.xml b/language/attributes.xml index 78bfec0db1..cc2e172180 100644 --- a/language/attributes.xml +++ b/language/attributes.xml @@ -108,11 +108,11 @@ executeAction($copyAction); Attribute syntax - There are several parts to the attributes syntax. First, attribute - declaration are always enclosed with a starting + There are several parts to the attributes syntax. First, an attribute + declaration is always enclosed with a starting #[ and a corresponding ending ]. Inside, one or many attributes are listed, - seperated by comma. The attribute name is an unqualified, qualified + separated by comma. The attribute name is an unqualified, qualified or fully-qualified name as described in Using Namespaces Basics. Arguments to the attribute are optional, but are enclosed in the usual parenthesis (). Arguments to attributes can only be literal values or constant expressions. Both positional and From e64ea89bbe0bd2cc28d48adfb3723f9ed5720fd1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=B4me=20Chilliet?= Date: Thu, 14 Jan 2021 10:52:05 +0100 Subject: [PATCH 52/85] Remove PHP4 constructors from ext/soap documentation Contructors were still documented as aliases to classname::classname with the real documentation in classname::classname. Closes GH-332. --- reference/soap/functions/is-soap-fault.xml | 10 +- reference/soap/soapclient/construct.xml | 212 ++++++++++++++++- reference/soap/soapclient/getfunctions.xml | 2 +- reference/soap/soapclient/gettypes.xml | 2 +- reference/soap/soapclient/setlocation.xml | 4 +- reference/soap/soapclient/soapcall.xml | 10 +- reference/soap/soapclient/soapclient.xml | 252 --------------------- reference/soap/soapfault/construct.xml | 117 +++++++++- reference/soap/soapfault/soapfault.xml | 162 ------------- reference/soap/soapheader/construct.xml | 86 ++++++- reference/soap/soapheader/soapheader.xml | 130 ----------- reference/soap/soapparam/construct.xml | 59 ++++- reference/soap/soapparam/soapparam.xml | 99 -------- reference/soap/soapserver/addfunction.xml | 2 +- reference/soap/soapserver/construct.xml | 104 ++++++++- reference/soap/soapserver/fault.xml | 2 +- reference/soap/soapserver/getfunctions.xml | 6 +- reference/soap/soapserver/handle.xml | 4 +- reference/soap/soapserver/setclass.xml | 6 +- reference/soap/soapserver/soapserver.xml | 144 ------------ reference/soap/soapvar/construct.xml | 97 +++++++- reference/soap/soapvar/soapvar.xml | 141 ------------ 22 files changed, 693 insertions(+), 958 deletions(-) delete mode 100644 reference/soap/soapclient/soapclient.xml delete mode 100644 reference/soap/soapfault/soapfault.xml delete mode 100644 reference/soap/soapheader/soapheader.xml delete mode 100644 reference/soap/soapparam/soapparam.xml delete mode 100644 reference/soap/soapserver/soapserver.xml delete mode 100644 reference/soap/soapvar/soapvar.xml diff --git a/reference/soap/functions/is-soap-fault.xml b/reference/soap/functions/is-soap-fault.xml index 92474baacf..36b371602c 100644 --- a/reference/soap/functions/is-soap-fault.xml +++ b/reference/soap/functions/is-soap-fault.xml @@ -15,11 +15,11 @@ This function is useful to check if the SOAP call failed, but - without using exceptions. To use it, create a + without using exceptions. To use it, create a SoapClient object with the exceptions option set to zero or &false;. - In this case, the SOAP method will return a special - SoapFault object which encapsulates the fault + In this case, the SOAP method will return a special + SoapFault object which encapsulates the fault details (faultcode, faultstring, faultactor and faultdetails). @@ -93,8 +93,8 @@ try { &reftitle.seealso; - SoapClient::SoapClient - SoapFault::SoapFault + SoapClient::__construct + SoapFault::__construct diff --git a/reference/soap/soapclient/construct.xml b/reference/soap/soapclient/construct.xml index 3a3d5390a5..4b56a8148d 100644 --- a/reference/soap/soapclient/construct.xml +++ b/reference/soap/soapclient/construct.xml @@ -14,11 +14,221 @@ arrayoptions[] - &info.function.alias; SoapClient::SoapClient + This constructor creates SoapClient objects + in WSDL or non-WSDL mode. + + + + + &reftitle.parameters; + + + + wsdl + + + URI of the WSDL file or &null; if working in + non-WSDL mode. + + + + During development, WSDL caching may be disabled by the + use of the soap.wsdl_cache_ttl &php.ini; setting + otherwise changes made to the WSDL file will have no effect until + soap.wsdl_cache_ttl is expired. + + + + + + options + + + An array of options. If working in WSDL mode, this parameter is optional. + If working in non-WSDL mode, the location and + uri options must be set, where location + is the URL of the SOAP server to send the request to, and uri + is the target namespace of the SOAP service. + + + The style and use options only work in + non-WSDL mode. In WSDL mode, they come from the WSDL file. + + + The soap_version option should be one of either + SOAP_1_1 or SOAP_1_2 to + select SOAP 1.1 or 1.2, respectively. If omitted, 1.1 is used. + + + For HTTP authentication, the login and + password options can be used to supply credentials. + For making an HTTP connection through + a proxy server, the options proxy_host, + proxy_port, proxy_login + and proxy_password are also available. + For HTTPS client certificate authentication use + local_cert and passphrase options. An + authentication may be supplied in the authentication + option. The authentication method may be either + SOAP_AUTHENTICATION_BASIC (default) or + SOAP_AUTHENTICATION_DIGEST. + + + The compression option allows to use compression + of HTTP SOAP requests and responses. + + + The encoding option defines internal character + encoding. This option does not change the encoding of SOAP requests (it is + always utf-8), but converts strings into it. + + + The trace option enables tracing of request so faults + can be backtraced. This defaults to &false; + + + The classmap option can be used to map some WSDL + types to PHP classes. This option must be an array with WSDL types + as keys and names of PHP classes as values. + + + Setting the boolean trace option enables use of the + methods + SoapClient->__getLastRequest, + + SoapClient->__getLastRequestHeaders, + + SoapClient->__getLastResponse and + + SoapClient->__getLastResponseHeaders. + + + The exceptions option is a boolean value defining whether + soap errors throw exceptions of type + SoapFault. + + + The connection_timeout option defines a timeout in seconds + for the connection to the SOAP service. This option does not define a timeout + for services with slow responses. To limit the time to wait for calls to finish the + default_socket_timeout setting + is available. + + + The typemap option is an array of type mappings. + Type mapping is an array with keys type_name, + type_ns (namespace URI), from_xml + (callback accepting one string parameter) and to_xml + (callback accepting one object parameter). + + + The cache_wsdl option is one of + WSDL_CACHE_NONE, + WSDL_CACHE_DISK, + WSDL_CACHE_MEMORY or + WSDL_CACHE_BOTH. + + + The user_agent option specifies string to use in + User-Agent header. + + + The stream_context option is a resource + for context. + + + The features option is a bitmask of + SOAP_SINGLE_ELEMENT_ARRAYS, + SOAP_USE_XSI_ARRAY_TYPE, + SOAP_WAIT_ONE_WAY_CALLS. + + + The keep_alive option is a boolean value defining whether + to send the Connection: Keep-Alive header or + Connection: close. + + + The ssl_method option is one of + SOAP_SSL_METHOD_TLS, + SOAP_SSL_METHOD_SSLv2, + SOAP_SSL_METHOD_SSLv3 or + SOAP_SSL_METHOD_SSLv23. + + + + + + + + + &reftitle.errors; + + SoapClient::__construct will generate an + E_ERROR error if the location and + uri options aren't provided in non-WSDL mode. + + + A SoapFault exception will be thrown if the + wsdl URI cannot be loaded. + + + + + &reftitle.examples; + + + <function>SoapClient::__construct</function> example + + SOAP_1_2)); + +$client = new SoapClient("some.wsdl", array('login' => "some_name", + 'password' => "some_password")); + +$client = new SoapClient("some.wsdl", array('proxy_host' => "localhost", + 'proxy_port' => 8080)); + +$client = new SoapClient("some.wsdl", array('proxy_host' => "localhost", + 'proxy_port' => 8080, + 'proxy_login' => "some_name", + 'proxy_password' => "some_password")); + +$client = new SoapClient("some.wsdl", array('local_cert' => "cert_key.pem")); + +$client = new SoapClient(null, array('location' => "http://localhost/soap.php", + 'uri' => "http://test-uri/")); + +$client = new SoapClient(null, array('location' => "http://localhost/soap.php", + 'uri' => "http://test-uri/", + 'style' => SOAP_DOCUMENT, + 'use' => SOAP_LITERAL)); + +$client = new SoapClient("some.wsdl", + array('compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP)); + +$client = new SoapClient("some.wsdl", array('encoding'=>'ISO-8859-1')); + +class MyBook { + public $title; + public $author; +} + +$client = new SoapClient("books.wsdl", array('classmap' => array('book' => "MyBook"))); + +?> +]]> + + + - - - - SoapClient::SoapClient - SoapClient constructor - - - - &reftitle.description; - - public SoapClient::SoapClient - mixedwsdl - arrayoptions - - - This constructor creates SoapClient objects - in WSDL or non-WSDL mode. - - - - - &reftitle.parameters; - - - - wsdl - - - URI of the WSDL file or &null; if working in - non-WSDL mode. - - - - During development, WSDL caching may be disabled by the - use of the soap.wsdl_cache_ttl &php.ini; setting - otherwise changes made to the WSDL file will have no effect until - soap.wsdl_cache_ttl is expired. - - - - - - options - - - An array of options. If working in WSDL mode, this parameter is optional. - If working in non-WSDL mode, the location and - uri options must be set, where location - is the URL of the SOAP server to send the request to, and uri - is the target namespace of the SOAP service. - - - The style and use options only work in - non-WSDL mode. In WSDL mode, they come from the WSDL file. - - - The soap_version option should be one of either - SOAP_1_1 or SOAP_1_2 to - select SOAP 1.1 or 1.2, respectively. If omitted, 1.1 is used. - - - For HTTP authentication, the login and - password options can be used to supply credentials. - For making an HTTP connection through - a proxy server, the options proxy_host, - proxy_port, proxy_login - and proxy_password are also available. - For HTTPS client certificate authentication use - local_cert and passphrase options. An - authentication may be supplied in the authentication - option. The authentication method may be either - SOAP_AUTHENTICATION_BASIC (default) or - SOAP_AUTHENTICATION_DIGEST. - - - The compression option allows to use compression - of HTTP SOAP requests and responses. - - - The encoding option defines internal character - encoding. This option does not change the encoding of SOAP requests (it is - always utf-8), but converts strings into it. - - - The trace option enables tracing of request so faults - can be backtraced. This defaults to &false; - - - The classmap option can be used to map some WSDL - types to PHP classes. This option must be an array with WSDL types - as keys and names of PHP classes as values. - - - Setting the boolean trace option enables use of the - methods - SoapClient->__getLastRequest, - - SoapClient->__getLastRequestHeaders, - - SoapClient->__getLastResponse and - - SoapClient->__getLastResponseHeaders. - - - The exceptions option is a boolean value defining whether - soap errors throw exceptions of type - SoapFault. - - - The connection_timeout option defines a timeout in seconds - for the connection to the SOAP service. This option does not define a timeout - for services with slow responses. To limit the time to wait for calls to finish the - default_socket_timeout setting - is available. - - - The typemap option is an array of type mappings. - Type mapping is an array with keys type_name, - type_ns (namespace URI), from_xml - (callback accepting one string parameter) and to_xml - (callback accepting one object parameter). - - - The cache_wsdl option is one of - WSDL_CACHE_NONE, - WSDL_CACHE_DISK, - WSDL_CACHE_MEMORY or - WSDL_CACHE_BOTH. - - - The user_agent option specifies string to use in - User-Agent header. - - - The stream_context option is a resource - for context. - - - The features option is a bitmask of - SOAP_SINGLE_ELEMENT_ARRAYS, - SOAP_USE_XSI_ARRAY_TYPE, - SOAP_WAIT_ONE_WAY_CALLS. - - - The keep_alive option is a boolean value defining whether - to send the Connection: Keep-Alive header or - Connection: close. - - - The ssl_method option is one of - SOAP_SSL_METHOD_TLS, - SOAP_SSL_METHOD_SSLv2, - SOAP_SSL_METHOD_SSLv3 or - SOAP_SSL_METHOD_SSLv23. - - - - - - - - - &reftitle.errors; - - SoapClient::SoapClient will generate an - E_ERROR error if the location and - uri options aren't provided in non-WSDL mode. - - - A SoapFault exception will be thrown if the - wsdl URI cannot be loaded. - - - - - &reftitle.examples; - - - <function>SoapClient::SoapClient</function> example - - SOAP_1_2)); - -$client = new SoapClient("some.wsdl", array('login' => "some_name", - 'password' => "some_password")); - -$client = new SoapClient("some.wsdl", array('proxy_host' => "localhost", - 'proxy_port' => 8080)); - -$client = new SoapClient("some.wsdl", array('proxy_host' => "localhost", - 'proxy_port' => 8080, - 'proxy_login' => "some_name", - 'proxy_password' => "some_password")); - -$client = new SoapClient("some.wsdl", array('local_cert' => "cert_key.pem")); - -$client = new SoapClient(null, array('location' => "http://localhost/soap.php", - 'uri' => "http://test-uri/")); - -$client = new SoapClient(null, array('location' => "http://localhost/soap.php", - 'uri' => "http://test-uri/", - 'style' => SOAP_DOCUMENT, - 'use' => SOAP_LITERAL)); - -$client = new SoapClient("some.wsdl", - array('compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP)); - -$client = new SoapClient("some.wsdl", array('encoding'=>'ISO-8859-1')); - -class MyBook { - public $title; - public $author; -} - -$client = new SoapClient("books.wsdl", array('classmap' => array('book' => "MyBook"))); - -?> -]]> - - - - - - - - diff --git a/reference/soap/soapfault/construct.xml b/reference/soap/soapfault/construct.xml index cdfd80eb4e..5db23bb9b4 100644 --- a/reference/soap/soapfault/construct.xml +++ b/reference/soap/soapfault/construct.xml @@ -18,12 +18,127 @@ mixedheaderFault&null; - &info.function.alias; SoapFault::SoapFault + This class is used to send SOAP fault responses from the PHP handler. + faultcode, faultstring, + faultactor and detail are + standard elements of a SOAP Fault. + + &reftitle.parameters; + + + + faultcode + + + The error code of the SoapFault. + + + + + faultstring + + + The error message of the SoapFault. + + + + + faultactor + + + A string identifying the actor that caused the error. + + + + + detail + + + More details about the cause of the error. + + + + + faultname + + + Can be used to select the proper fault encoding from WSDL. + + + + + headerfault + + + Can be used during SOAP header handling to report an error in the + response header. + + + + + + + + + &reftitle.examples; + + + Some examples + + "http://test-uri/")); +$server->addFunction("test"); +$server->handle(); +?> +]]> + + + + + It is possible to use PHP exception mechanism to throw SOAP Fault. + + + + Some examples + + "http://test-uri/")); +$server->addFunction("test"); +$server->handle(); +?> +]]> + + + + + + + &reftitle.seealso; + + + SoapServer::fault + is_soap_fault + + + + - - - - SoapFault::SoapFault - SoapFault constructor - - - - &reftitle.description; - - SoapFault::SoapFault - stringfaultcode - stringfaultstring - stringfaultactor - stringdetail - stringfaultname - stringheaderfault - - - This class is used to send SOAP fault responses from the PHP handler. - faultcode, faultstring, - faultactor and detail are - standard elements of a SOAP Fault. - - - - - &reftitle.parameters; - - - - faultcode - - - The error code of the SoapFault. - - - - - faultstring - - - The error message of the SoapFault. - - - - - faultactor - - - A string identifying the actor that caused the error. - - - - - detail - - - More details about the cause of the error. - - - - - faultname - - - Can be used to select the proper fault encoding from WSDL. - - - - - headerfault - - - Can be used during SOAP header handling to report an error in the - response header. - - - - - - - - - &reftitle.examples; - - - Some examples - - "http://test-uri/")); -$server->addFunction("test"); -$server->handle(); -?> -]]> - - - - - It is possible to use PHP exception mechanism to throw SOAP Fault. - - - - Some examples - - "http://test-uri/")); -$server->addFunction("test"); -$server->handle(); -?> -]]> - - - - - - - &reftitle.seealso; - - - SoapServer::fault - is_soap_fault - - - - - - - diff --git a/reference/soap/soapheader/construct.xml b/reference/soap/soapheader/construct.xml index 566555e30d..9ced6cf601 100644 --- a/reference/soap/soapheader/construct.xml +++ b/reference/soap/soapheader/construct.xml @@ -18,7 +18,91 @@ stringactor - &info.function.alias; SoapHeader::SoapHeader + Constructs a new SoapHeader object. + + + + + &reftitle.parameters; + + + + namespace + + + The namespace of the SOAP header element. + + + + + name + + + The name of the SoapHeader object. + + + + + data + + + A SOAP header's content. It can be a PHP value or a + SoapVar object. + + + + + mustUnderstand + + + Value of the mustUnderstand attribute of the SOAP + header element. + + + + + actor + + + Value of the actor attribute of the SOAP header + element. + + + + + + + + + &reftitle.examples; + + + <function>SoapHeader::__construct</function> example + + "http://localhost/soap.php", + 'uri' => "http://test-uri/")); +$client->__soapCall("echoVoid", null, null, + new SoapHeader('http://soapinterop.org/echoheader/', + 'echoMeStringRequest', + 'hello world')); +?> +]]> + + + + + + + &reftitle.seealso; + + + SoapClient::__soapCall + SoapVar::__construct + SoapParam::__construct + SoapServer::addSoapHeader + diff --git a/reference/soap/soapheader/soapheader.xml b/reference/soap/soapheader/soapheader.xml deleted file mode 100644 index 5aa40bfe9e..0000000000 --- a/reference/soap/soapheader/soapheader.xml +++ /dev/null @@ -1,130 +0,0 @@ - - - - - - SoapHeader::SoapHeader - SoapHeader constructor - - - - &reftitle.description; - - SoapHeader::SoapHeader - stringnamespace - stringname - mixeddata - boolmustunderstand&false; - stringactor - - - Constructs a new SoapHeader object. - - - - - &reftitle.parameters; - - - - namespace - - - The namespace of the SOAP header element. - - - - - name - - - The name of the SoapHeader object. - - - - - data - - - A SOAP header's content. It can be a PHP value or a - SoapVar object. - - - - - mustUnderstand - - - Value of the mustUnderstand attribute of the SOAP - header element. - - - - - actor - - - Value of the actor attribute of the SOAP header - element. - - - - - - - - - &reftitle.examples; - - - <function>SoapHeader::SoapHeader</function> example - - "http://localhost/soap.php", - 'uri' => "http://test-uri/")); -$client->__soapCall("echoVoid", null, null, - new SoapHeader('http://soapinterop.org/echoheader/', - 'echoMeStringRequest', - 'hello world')); -?> -]]> - - - - - - - &reftitle.seealso; - - - SoapClient::__soapCall - SoapVar::SoapVar - SoapParam::SoapParam - SoapServer::addSoapHeader - - - - - - - diff --git a/reference/soap/soapparam/construct.xml b/reference/soap/soapparam/construct.xml index f9768e2b12..24d28a1108 100644 --- a/reference/soap/soapparam/construct.xml +++ b/reference/soap/soapparam/construct.xml @@ -14,11 +14,68 @@ stringname - &info.function.alias; SoapParam::SoapParam + Constructs a new SoapParam object. + + + + + &reftitle.parameters; + + + + data + + + The data to pass or return. This parameter can be passed directly as PHP + value, but in this case it will be named as paramN and + the SOAP service may not understand it. + + + + + name + + + The parameter name. + + + + + + + + + &reftitle.examples; + + + <function>SoapParam::__construct</function> example + + "http://localhost/soap.php", + 'uri' => "http://test-uri/")); +$client->SomeFunction(new SoapParam($a, "a"), + new SoapParam($b, "b"), + new SoapParam($c, "c")); +?> +]]> + + + + + + + &reftitle.seealso; + + + SoapClient::__soapCall + SoapVar::__construct + + - - - - SoapParam::SoapParam - SoapParam constructor - - - - &reftitle.description; - - SoapParam::SoapParam - mixeddata - stringname - - - Constructs a new SoapParam object. - - - - - &reftitle.parameters; - - - - data - - - The data to pass or return. This parameter can be passed directly as PHP - value, but in this case it will be named as paramN and - the SOAP service may not understand it. - - - - - name - - - The parameter name. - - - - - - - - - &reftitle.examples; - - - <function>SoapParam::SoapParam</function> example - - "http://localhost/soap.php", - 'uri' => "http://test-uri/")); -$client->SomeFunction(new SoapParam($a, "a"), - new SoapParam($b, "b"), - new SoapParam($c, "c")); -?> -]]> - - - - - - - &reftitle.seealso; - - - SoapClient::__soapCall - SoapVar::SoapVar - - - - - - - diff --git a/reference/soap/soapserver/addfunction.xml b/reference/soap/soapserver/addfunction.xml index e55acd7215..5becd9c515 100644 --- a/reference/soap/soapserver/addfunction.xml +++ b/reference/soap/soapserver/addfunction.xml @@ -91,7 +91,7 @@ $server->addFunction(SOAP_FUNCTIONS_ALL); &reftitle.seealso; - SoapServer::SoapServer + SoapServer::__construct SoapServer::setClass diff --git a/reference/soap/soapserver/construct.xml b/reference/soap/soapserver/construct.xml index 907e3613d0..0cdb7732f8 100644 --- a/reference/soap/soapserver/construct.xml +++ b/reference/soap/soapserver/construct.xml @@ -14,11 +14,113 @@ arrayoptions[] - &info.function.alias; SoapServer::SoapServer + This constructor allows the creation of SoapServer + objects in WSDL or non-WSDL mode. + + + + + &reftitle.parameters; + + + + wsdl + + + To use the SoapServer in WSDL mode, pass the URI of a WSDL file. + Otherwise, pass &null; and set the uri option to the + target namespace for the server. + + + + + options + + + Allow setting a default SOAP version (soap_version), + internal character encoding (encoding), + and actor URI (actor). + + + The classmap option can be used to map some WSDL + types to PHP classes. This option must be an array with WSDL types + as keys and names of PHP classes as values. + + + The typemap option is an array of type mappings. + Type mapping is an array with keys type_name, + type_ns (namespace URI), from_xml + (callback accepting one string parameter) and to_xml + (callback accepting one object parameter). + + + The cache_wsdl option is one of + WSDL_CACHE_NONE, + WSDL_CACHE_DISK, + WSDL_CACHE_MEMORY or + WSDL_CACHE_BOTH. + + + There is also a features option which can be set to + SOAP_WAIT_ONE_WAY_CALLS, + SOAP_SINGLE_ELEMENT_ARRAYS, + SOAP_USE_XSI_ARRAY_TYPE. + + + The send_errors option can be set to &false; to sent a + generic error message ("Internal error") instead of the specific error + message sent otherwise. + + + + + + + + + &reftitle.examples; + + + <function>SoapServer::__construct</function> example + + SOAP_1_2)); + +$server = new SoapServer("some.wsdl", array('actor' => "http://example.org/ts-tests/C")); + +$server = new SoapServer("some.wsdl", array('encoding'=>'ISO-8859-1')); + +$server = new SoapServer(null, array('uri' => "http://test-uri/")); + +class MyBook { + public $title; + public $author; +} + +$server = new SoapServer("books.wsdl", array('classmap' => array('book' => "MyBook"))); + +?> +]]> + + + + + + + &reftitle.seealso; + + + SoapClient::__construct + + - - - - SoapServer::SoapServer - SoapServer constructor - - - - &reftitle.description; - - public SoapServer::SoapServer - mixedwsdl - arrayoptions - - - This constructor allows the creation of SoapServer - objects in WSDL or non-WSDL mode. - - - - - &reftitle.parameters; - - - - wsdl - - - To use the SoapServer in WSDL mode, pass the URI of a WSDL file. - Otherwise, pass &null; and set the uri option to the - target namespace for the server. - - - - - options - - - Allow setting a default SOAP version (soap_version), - internal character encoding (encoding), - and actor URI (actor). - - - The classmap option can be used to map some WSDL - types to PHP classes. This option must be an array with WSDL types - as keys and names of PHP classes as values. - - - The typemap option is an array of type mappings. - Type mapping is an array with keys type_name, - type_ns (namespace URI), from_xml - (callback accepting one string parameter) and to_xml - (callback accepting one object parameter). - - - The cache_wsdl option is one of - WSDL_CACHE_NONE, - WSDL_CACHE_DISK, - WSDL_CACHE_MEMORY or - WSDL_CACHE_BOTH. - - - There is also a features option which can be set to - SOAP_WAIT_ONE_WAY_CALLS, - SOAP_SINGLE_ELEMENT_ARRAYS, - SOAP_USE_XSI_ARRAY_TYPE. - - - The send_errors option can be set to &false; to sent a - generic error message ("Internal error") instead of the specific error - message sent otherwise. - - - - - - - - - &reftitle.examples; - - - <function>SoapServer::SoapServer</function> example - - SOAP_1_2)); - -$server = new SoapServer("some.wsdl", array('actor' => "http://example.org/ts-tests/C")); - -$server = new SoapServer("some.wsdl", array('encoding'=>'ISO-8859-1')); - -$server = new SoapServer(null, array('uri' => "http://test-uri/")); - -class MyBook { - public $title; - public $author; -} - -$server = new SoapServer("books.wsdl", array('classmap' => array('book' => "MyBook"))); - -?> -]]> - - - - - - - &reftitle.seealso; - - - SoapClient::SoapClient - - - - - - - diff --git a/reference/soap/soapvar/construct.xml b/reference/soap/soapvar/construct.xml index a6c5ae40a1..d30b02e2fb 100644 --- a/reference/soap/soapvar/construct.xml +++ b/reference/soap/soapvar/construct.xml @@ -18,11 +18,106 @@ stringnodeNamespace"" - &info.function.alias; SoapVar::SoapVar + Constructs a new SoapVar object. + + + + + &reftitle.parameters; + + + + data + + + The data to pass or return. + + + + + encoding + + + The encoding ID, one of the XSD_... constants. + + + + + type_name + + + The type name. + + + + + type_namespace + + + The type namespace. + + + + + node_name + + + The XML node name. + + + + + node_namespace + + + The XML node namespace. + + + + + + + + + &reftitle.examples; + + + <function>SoapVar::__construct</function> example + +varString = $s; + $this->varInt = $i; + $this->varFloat = $f; + } +} +$client = new SoapClient(null, array('location' => "http://localhost/soap.php", + 'uri' => "http://test-uri/")); +$struct = new SOAPStruct('arg', 34, 325.325); +$soapstruct = new SoapVar($struct, SOAP_ENC_OBJECT, "SOAPStruct", "http://soapinterop.org/xsd"); +$client->echoStruct(new SoapParam($soapstruct, "inputStruct")); +?> +]]> + + + + + + + &reftitle.seealso; + + + SoapClient::__soapCall + SoapParam::__construct + + - - - - SoapVar::SoapVar - SoapVar constructor - - - - &reftitle.description; - - SoapVar::SoapVar - mixeddata - stringencoding - stringtype_name - stringtype_namespace - stringnode_name - stringnode_namespace - - - Constructs a new SoapVar object. - - - - - &reftitle.parameters; - - - - data - - - The data to pass or return. - - - - - encoding - - - The encoding ID, one of the XSD_... constants. - - - - - type_name - - - The type name. - - - - - type_namespace - - - The type namespace. - - - - - node_name - - - The XML node name. - - - - - node_namespace - - - The XML node namespace. - - - - - - - - - &reftitle.examples; - - - <function>SoapVar::SoapVar</function> example - -varString = $s; - $this->varInt = $i; - $this->varFloat = $f; - } -} -$client = new SoapClient(null, array('location' => "http://localhost/soap.php", - 'uri' => "http://test-uri/")); -$struct = new SOAPStruct('arg', 34, 325.325); -$soapstruct = new SoapVar($struct, SOAP_ENC_OBJECT, "SOAPStruct", "http://soapinterop.org/xsd"); -$client->echoStruct(new SoapParam($soapstruct, "inputStruct")); -?> -]]> - - - - - - - &reftitle.seealso; - - - SoapClient::__soapCall - SoapParam::SoapParam - - - - - - - From ef88bff8ae0e1c35d577aaca6f812ca06b6f26d3 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Fri, 22 Jan 2021 14:43:22 +0100 Subject: [PATCH 53/85] file_get_contents() raises warning for directories Closes GH-46. --- reference/filesystem/functions/file-get-contents.xml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/reference/filesystem/functions/file-get-contents.xml b/reference/filesystem/functions/file-get-contents.xml index afb223947f..773eee5234 100644 --- a/reference/filesystem/functions/file-get-contents.xml +++ b/reference/filesystem/functions/file-get-contents.xml @@ -116,6 +116,11 @@ An E_WARNING level error is generated if filename cannot be found, maxlength is less than zero, or if seeking to the specified offset in the stream fails. + + When file_get_contents is called on a directory, + an E_WARNING level error is generated on Windows, + and as of PHP 7.4 on other operating systems as well. + From 4206843127f9a72a283b63ac82c0155a598506b1 Mon Sep 17 00:00:00 2001 From: Philip Olson Date: Fri, 22 Jan 2021 14:46:42 -0800 Subject: [PATCH 54/85] Added informaltable ids as needed by the docs at mysql.com --- reference/mysql/changelog.xml | 2 +- reference/mysql/functions/mysql-connect.xml | 2 +- reference/mysql/functions/mysql-db-name.xml | 2 +- reference/mysql/functions/mysql-list-tables.xml | 2 +- reference/mysql/functions/mysql-pconnect.xml | 2 +- reference/mysql/functions/mysql-tablename.xml | 2 +- .../mysql_xdevapi/mysql_xdevapi/rowresult/getcolumncount.xml | 2 +- .../mysql_xdevapi/sqlstatementresult/getcolumncount.xml | 2 +- reference/mysqlinfo/set.xml | 4 ++-- 9 files changed, 10 insertions(+), 10 deletions(-) diff --git a/reference/mysql/changelog.xml b/reference/mysql/changelog.xml index 3d82a8bee0..31307a45cb 100644 --- a/reference/mysql/changelog.xml +++ b/reference/mysql/changelog.xml @@ -18,7 +18,7 @@ The following is a list of changes to the entire ext/mysql extension. - + diff --git a/reference/mysql/functions/mysql-connect.xml b/reference/mysql/functions/mysql-connect.xml index 1d5e32479e..62733f7b52 100644 --- a/reference/mysql/functions/mysql-connect.xml +++ b/reference/mysql/functions/mysql-connect.xml @@ -117,7 +117,7 @@ &reftitle.changelog; - + diff --git a/reference/mysql/functions/mysql-db-name.xml b/reference/mysql/functions/mysql-db-name.xml index 665a4a34df..552590e69c 100644 --- a/reference/mysql/functions/mysql-db-name.xml +++ b/reference/mysql/functions/mysql-db-name.xml @@ -73,7 +73,7 @@ &reftitle.changelog; - + diff --git a/reference/mysql/functions/mysql-list-tables.xml b/reference/mysql/functions/mysql-list-tables.xml index 9ba7c431db..10317f8105 100644 --- a/reference/mysql/functions/mysql-list-tables.xml +++ b/reference/mysql/functions/mysql-list-tables.xml @@ -64,7 +64,7 @@ &reftitle.changelog; - + diff --git a/reference/mysql/functions/mysql-pconnect.xml b/reference/mysql/functions/mysql-pconnect.xml index c82204d6b3..8a1e7599a1 100644 --- a/reference/mysql/functions/mysql-pconnect.xml +++ b/reference/mysql/functions/mysql-pconnect.xml @@ -125,7 +125,7 @@ &reftitle.changelog; - + diff --git a/reference/mysql/functions/mysql-tablename.xml b/reference/mysql/functions/mysql-tablename.xml index 8d40277545..b89954b96a 100644 --- a/reference/mysql/functions/mysql-tablename.xml +++ b/reference/mysql/functions/mysql-tablename.xml @@ -72,7 +72,7 @@ &reftitle.changelog; - + diff --git a/reference/mysql_xdevapi/mysql_xdevapi/rowresult/getcolumncount.xml b/reference/mysql_xdevapi/mysql_xdevapi/rowresult/getcolumncount.xml index 8033710e8e..c52e404899 100644 --- a/reference/mysql_xdevapi/mysql_xdevapi/rowresult/getcolumncount.xml +++ b/reference/mysql_xdevapi/mysql_xdevapi/rowresult/getcolumncount.xml @@ -32,7 +32,7 @@ &reftitle.changelog; - + diff --git a/reference/mysql_xdevapi/mysql_xdevapi/sqlstatementresult/getcolumncount.xml b/reference/mysql_xdevapi/mysql_xdevapi/sqlstatementresult/getcolumncount.xml index 87d2feac71..d4b3eef8a4 100644 --- a/reference/mysql_xdevapi/mysql_xdevapi/sqlstatementresult/getcolumncount.xml +++ b/reference/mysql_xdevapi/mysql_xdevapi/sqlstatementresult/getcolumncount.xml @@ -35,7 +35,7 @@ &reftitle.changelog; - + diff --git a/reference/mysqlinfo/set.xml b/reference/mysqlinfo/set.xml index 7136414b90..30a65cda67 100644 --- a/reference/mysqlinfo/set.xml +++ b/reference/mysqlinfo/set.xml @@ -198,7 +198,7 @@ echo htmlentities($row['_message']); fraction of the total run time of a PHP web request. Often, the impact is as low as 0.1%. - + @@ -338,7 +338,7 @@ $ ./configure --with-mysqli=/path/to/mysql_config --with-pdo-mysql=/path/to/mysq library instead of the MySQL Client Server library (libmysqlclient). Both libraries are supported and constantly being improved. - + From bef1a3a8eecf744643d3df9a7e77abe441813e85 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Sat, 23 Jan 2021 09:23:07 +0900 Subject: [PATCH 55/85] fixed XPointer evaluation failed build warning, related to soap constructor fix. These soap class do not have any methods except for constructor. XPointer evaluation failed: #xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.soapparam')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')]) --- reference/soap/soapheader.xml | 3 --- reference/soap/soapparam.xml | 3 --- reference/soap/soapvar.xml | 3 --- 3 files changed, 9 deletions(-) diff --git a/reference/soap/soapheader.xml b/reference/soap/soapheader.xml index b2f54ebad7..07676f2471 100644 --- a/reference/soap/soapheader.xml +++ b/reference/soap/soapheader.xml @@ -36,9 +36,6 @@ - - - diff --git a/reference/soap/soapparam.xml b/reference/soap/soapparam.xml index 37adca498c..21265ecd5f 100644 --- a/reference/soap/soapparam.xml +++ b/reference/soap/soapparam.xml @@ -36,9 +36,6 @@ - - - diff --git a/reference/soap/soapvar.xml b/reference/soap/soapvar.xml index 35725e0188..3cbddb6f03 100644 --- a/reference/soap/soapvar.xml +++ b/reference/soap/soapvar.xml @@ -36,9 +36,6 @@ - - - From adb98b5a8fd3fc92f8ba950f1b1e0f7578254f93 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Sun, 24 Jan 2021 12:39:35 +0900 Subject: [PATCH 56/85] Added PHP 8 into versions.xml for uodbc based on stubs. Co-authored-by: Christoph M. Becker Closes GH-386. --- reference/uodbc/versions.xml | 91 ++++++++++++++++++------------------ 1 file changed, 45 insertions(+), 46 deletions(-) diff --git a/reference/uodbc/versions.xml b/reference/uodbc/versions.xml index ded8ca37ec..b2d54fc59d 100644 --- a/reference/uodbc/versions.xml +++ b/reference/uodbc/versions.xml @@ -4,52 +4,51 @@ Do NOT translate this file --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + \ No newline at end of file +--> From 9b78a35818ad249375e0fcb902d23d6e965fe25c Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Sun, 24 Jan 2021 12:17:57 +0900 Subject: [PATCH 61/85] Added PHP 8 into versions.xml for bzip2 based on stubs. Closes GH-382. --- reference/bzip2/versions.xml | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/reference/bzip2/versions.xml b/reference/bzip2/versions.xml index c9d325d6ae..22a985753e 100644 --- a/reference/bzip2/versions.xml +++ b/reference/bzip2/versions.xml @@ -4,16 +4,16 @@ Do NOT translate this file --> - - - - - - - - - - + + + + + + + + + + - - - - - - + + + + + + - - - - - - - + + + + + + + - - - - - - - - - - - - - + + + + + + + + + + + + + - - - - - - - + + + + + + + - - - - - - + + + + + + - - - - - - - - - - - - - - + + + + + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - + + + + - - - - - - - - + + + + + + + + - - - + + + - - - - - + + + + + - - - - + + + + @@ -112,7 +112,7 @@ - + @@ -124,19 +124,19 @@ - - + + - - + + - + - - + + @@ -151,44 +151,44 @@ - + - - - - - - - - + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + - - + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - + + + + + + + - + - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + \ No newline at end of file +--> From 4bc958f8079c665210d019d576545448ac345861 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Sun, 24 Jan 2021 22:12:26 +0900 Subject: [PATCH 70/85] Added PHP 8 into versions.xml for xml based on stubs. Closes GH-390. --- reference/xml/versions.xml | 48 +++++++++++++++++++------------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/reference/xml/versions.xml b/reference/xml/versions.xml index 771d522a13..21916e7af0 100644 --- a/reference/xml/versions.xml +++ b/reference/xml/versions.xml @@ -4,30 +4,30 @@ Do NOT translate this file --> - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + From 7848f358bea8506ec8eb847775db9d3261a0639f Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Sun, 24 Jan 2021 22:16:17 +0900 Subject: [PATCH 71/85] Added PHP 8 into versions.xml for readline based on stubs. Closes GH-391. --- reference/readline/versions.xml | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/reference/readline/versions.xml b/reference/readline/versions.xml index f4c322f508..c0346558ef 100644 --- a/reference/readline/versions.xml +++ b/reference/readline/versions.xml @@ -4,19 +4,19 @@ Do NOT translate this file --> - - - - - - - - - - - - - + + + + + + + + + + + + + - - - - - - - - - - - - - - + + + + + + + + + + + + + + - - - - - - - - + + + + + + + + - + - - - - - - - - - + + + + + + + + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file +--> From 0697c1fd36ac297fd3f7346a3976cbd67d99f287 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Sun, 24 Jan 2021 23:22:49 +0900 Subject: [PATCH 75/85] Added PHP 8 into versions.xml for csprng based on stubs. Closes GH-394. --- reference/csprng/versions.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/csprng/versions.xml b/reference/csprng/versions.xml index b723e89959..764cdf851a 100644 --- a/reference/csprng/versions.xml +++ b/reference/csprng/versions.xml @@ -5,8 +5,8 @@ --> - - + + - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - + + From e8755dd8099b300f62fd7fad2e88a32d2996beab Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Mon, 25 Jan 2021 00:39:52 +0900 Subject: [PATCH 81/85] Added PHP 8 into versions.xml for snmp based on stubs. Closes GH-399. --- reference/snmp/versions.xml | 70 ++++++++++++++++++------------------- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/reference/snmp/versions.xml b/reference/snmp/versions.xml index df93fe266b..d020b82736 100644 --- a/reference/snmp/versions.xml +++ b/reference/snmp/versions.xml @@ -4,46 +4,46 @@ Do NOT translate this file --> - - - - - - - - + + + + + + + + - - - - - - + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - + - - - - - - - - - - - - - + + + + + + + + + + + + + - - - - + + + + - - - - - - - + + + + From 004ab8efdbb738c6b0cc7bbb4e7bb2a46da0d472 Mon Sep 17 00:00:00 2001 From: Yoshinari Takaoka Date: Mon, 25 Jan 2021 01:21:12 +0900 Subject: [PATCH 83/85] Added PHP 8 into versions.xml for url based on stubs. Closes GH-401. --- reference/url/versions.xml | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/reference/url/versions.xml b/reference/url/versions.xml index 8ecdca5cb6..14b6b2d05c 100644 --- a/reference/url/versions.xml +++ b/reference/url/versions.xml @@ -4,16 +4,16 @@ Do NOT translate this file --> - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - + + + + + + + + + + + \ No newline at end of file +--> From 516e504ab18c5d2f8da91f47220bcb119ed76540 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sun, 24 Jan 2021 17:53:37 +0100 Subject: [PATCH 85/85] Credit Yoshinari Takaoka For months now, he's constantly cleaning up behind myself and others, besides generally fixing and improving the manual. --- contributors.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/contributors.xml b/contributors.xml index 2b9bf14566..661cde303f 100644 --- a/contributors.xml +++ b/contributors.xml @@ -58,6 +58,7 @@ Sascha Schumann, Dan Scott, Masahiro Takagi, + Yoshinari Takaoka, Yannick Torres, Michael Wallner, Lars Torben Wilson,