We do not xi:include core INI settings, since we want to keep
alphabetic sort order (well, roughly at least).
We do add xi:fallback elements to all xi:includes, just in case.
Except for pecl_http, the related extensions are obsolete. pecl_http
has its documentation removed from the manual quite a while ago (it is
hosted elsewhere now), so we remove the INI options as well (there
likely outdated, anyway).
* Aligned examples. OO and procedural examples where using different
variable names. An example of iterator was using different style and
data
* Improved descriptions. Some words were confusing and even wrong.
* Aligned notes. All notes are in the same place and follow similar grammar
* Removed manual error checking from examples
* Removed unnecessary LIMIT 50,5
* Added .similar to the example results
Co-authored-by: Anna Filina <afilina@gmail.com>
Closes GH-207
For basename(), we declare the behavior regarding invalid characters in
the path as being undefined, since that depends on the availability of
mblen, and also on the position of the invalid characters prior to PHP
8.0.0[1].
dirname() is actually not local-aware, but relies on an ASCII
compatible character encoding regarding the directory separator. On
Windows, it is however, dependent on the currently set codepage
(although a fallback is still in place to use the Windows ANSI codepage
of the operating system[2], if the string is not valid for the current
codepage).
Again, we declared failure to comply to these assumptions as resulting
in undefined behavior. Users should make sure to pass valid strings.
[1] <http://git.php.net/?p=php-src.git;a=commitdiff;h=90705d44e3da1d0aa7b8b4fd921ec597391eccb2>
[2] <5e01542526/win32/codepage.h (L95-L106)>
Should be 'flags' instead of 'options' because argument `$options` was renamed to `$flags`.
Closes GH-455
Signed-off-by: George Peter Banyard <girgias@php.net>
Document character device and sockets
Link to SplFileInfo.
Unlike stat(), SplFileInfo throws instead of emitting a notice,
which is convenient for avoiding the error handler.
(file_exists() returns files that exist but are unreadable)
Related to GH-319
Closes GH-322.
Months ago, PHP removed php 5 documentation and changelogs
of core functionality
- https://pecl.php.net/package/SPL_Types was last updated in 2012
and is not maintained.
- SPL_Types is easy to confuse with the SPL
- SPL_Types can cause confusion because PHP has typed properties(7.4),
and will probably also have actual enums in 8.1
https://www.php.net/spl_types
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
Closes GH-448.
In current PHP versions the Exception-class seems to allow all Throwable
values for its constructor's $previous param instead of only values of
type Exception.
Closes GH-442.
