sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-19 18:38:55 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
27570 commits 6 branches 0 tags 68 MiB
Commit graph

898 commits

Author SHA1 Message Date
Christoph M. Becker
f8b0bb4100
Fix #81620: parse_ini_file and parse_ini_string don't actually support value interpolation 2021-11-15 13:44:02 +01:00
Christoph M. Becker
8d8cd43bfc
Fix #41062: is_executable only looks at basic executables 2021-11-08 15:04:41 +01:00
Juliette
67ca0d930c
dirname(): add warning about risk of infinite loop 
Co-authored-by: jrfnl <jrfnl@users.noreply.github.com>

Closes GH-1005.
 2021-11-08 13:20:57 +01:00
Sergey Panteleev
21129de174
[PHP 8.1] Add fdatasync and fsync description (#1002) 2021-10-08 21:31:27 +03:00
Sergey Panteleev
fcbbbd9fda
[PHP 8.1] Update fputcsv and SplFileObject::fputcsv description (#978) 2021-09-28 14:18:31 +03:00
Christoph M. Becker
2f07d53d99
tempnam() issues E_NOTICE on temp dir fallback as of PHP 7.1.0 2021-09-27 14:21:32 +02:00
Martin Samesch
714d8e584c
typo 2021-09-14 19:44:23 +02:00
Márton Visnovitz
f739452fff
Add note about GLOB_BRACE flag not working in Alpine (#945) 2021-09-13 16:02:27 +01:00
Christoph M. Becker
28fa285d52
Close #917: Cannot unlink() directory symlink on Windows 2021-09-06 13:27:08 +02:00
Christoph M. Becker
5783afacad
Improve description of several $context parameters 
We're misusing the already existing `&note.context-support;` for this,
but remove the PHP 5 related info from it, and link directly to stream
contexts.
 2021-09-06 13:00:53 +02:00
Denis Ryabov
33225f7c57
Add a separate example section for escaping of characters 
See also merged PR https://github.com/php/php-src/pull/7420 (d3a6054d44)

Closes GH-898.
 2021-09-04 14:53:55 +02:00
Denis Ryabov
a453c4ff1c
Remove irrelevant paragraph 
(looks like a copy-paste from previous example)

Closes GH-886.
 2021-08-28 12:25:33 +02:00
Christoph M. Becker
0bfb0eb957
Fix #68509: Garbage collection of file pointers releases flock() locks 2021-07-26 20:27:28 +02:00
Christoph M. Becker
7d93e0fe5e
Fix #81284: str_getcsv cant parse with multibyte delimiter 
There's no fun in DRY. ;)
 2021-07-23 17:24:39 +02:00
Christoph M. Becker
70babd5faf
pathinfo() operates naively on the input string 
Closes GH-798.
 2021-07-18 14:50:48 +02:00
Christoph M. Becker
1128875883
Fix #81266: mkdir calls directories folders in example code 2021-07-16 15:00:29 +02:00
Christoph M. Becker
ff4424769d
Clarify flock() for same process/other file handle on Windows 
We may want to clean up the notes section sometime.
 2021-07-05 15:51:22 +02:00
Kamil Tekiela
9d2b858bca
Remove magic_quotes_runtime docs 
Closes GH-719.
 2021-06-25 19:27:30 +02:00
Christoph M. Becker
1f7d8b1ee9
Fix #81179: fileperms() return wrong access information 2021-06-21 15:00:16 +02:00
Sergey Panteleev
871a231f4a
Fix issues in Filesystem directory 
Part of #658
 2021-06-10 16:28:13 +03:00
Vladimir
d579464d52
shorten fopen w+ description 
make it consistent with x+, c+

Closes GH-660.
 2021-06-06 13:52:19 +02:00
Sergey Panteleev
98f2a733bc
fpassthru error description (#628) 
Fix bug #81067
 2021-05-25 11:24:07 +03:00
Sergey Panteleev
dcd6496472
Fix: mode => permissions 2021-05-24 10:03:45 +03:00
Sergey Panteleev
6240e8ba3b
Added parameter tag to permissions and directory 2021-05-24 09:55:03 +03:00
Karsten Lehmann
0867f488b5
Fix parameter names for rmdir function (#615) 2021-05-22 12:00:44 +01:00
Karsten Lehmann
4ac2306796
Fix parameter names for mkdir function 
Closes GH-614.
 2021-05-22 12:24:31 +02:00
Yoshinari Takaoka
16c0995798
followed parameter fix in the previous commit. 
ref: c1a31a1a3d
 2021-05-19 02:54:28 +09:00
Alexander Schranz
c1a31a1a3d
Fix fputcsv for php 8 to separator 
Closes GH-607.
 2021-05-18 14:00:44 +02:00
Sergey Panteleev
6a7a96ccc6
file_get_contents length parameter (#590) 
* Rename maxlen parameter to length
 2021-05-07 17:00:24 +03:00
Sergey Panteleev
f9c4a68ef4
Removed references to PHP 5, PHP 7.0 (#548) 2021-04-26 11:46:55 +03:00
Sergey Panteleev
a0ae28d3bc
Removed references to PHP 5, PHP 7.0 (#545) 2021-04-24 20:01:17 +03:00
Sergey Panteleev
aab33d6443
Removed references to PHP 5, PHP 7.0 (#544) 2021-04-23 11:35:26 +03:00
Sergey Panteleev
5fabd07880
Removed Changelog entries for PHP 5, PHP 7.0 (#543) 2021-04-22 17:52:58 +03:00
Rowan Tommins
4138897b12
Remove or rewrite examples using implode("", file(...)) (#523) 
This is a weirdly inefficient way of getting a file's content into
a string, and I'm not sure why anyone would think it was a good
idea.
 2021-04-12 22:33:56 +02:00
Eric Stern
397f37e930 Match fgetcsv parameter names to values in reflection 
The documented parameters differ from the names exposed in reflection/source code. Now that named parameters are supported in PHP 8, this discrepancy is confusing and impactful.

```
 $ php --rf fgetcsv
Function [ <internal:standard> function fgetcsv ] {

  - Parameters [5] {
    Parameter #0 [ <required> $stream ]
    Parameter #1 [ <optional> ?int $length = null ]
    Parameter #2 [ <optional> string $separator = "," ]
    Parameter #3 [ <optional> string $enclosure = "\"" ]
    Parameter #4 [ <optional> string $escape = "\\" ]
  }
  - Return [ array|false ]
}
```

Closes GH-493.
 2021-03-19 00:56:00 +01:00
Christoph M. Becker
88c1f8d6c9 Fix/clarify dirname/basename docs wrt. locales 
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)>
 2021-02-19 15:12:33 +01:00
Tyson Andre
8b7fb1d4ac Improvements to stat() - document other file types 
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.
 2021-02-15 16:37:42 +01:00
Yoshinari Takaoka
cb3e68d99d changed warning about deleted functions as of PHP 8.0.0. 2021-02-10 03:44:01 +09:00
Tomáš Fejfar
359f21684b fgets() can return false 
As described in the docs "If there is no more data to read in the file
pointer, then false is returned."

Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>

Closes GH-425.
 2021-01-28 12:41:51 +01:00
Christoph M. Becker
ef88bff8ae file_get_contents() raises warning for directories 
Closes GH-46.
 2021-01-22 14:43:22 +01:00
Yoshinari Takaoka
3a6f3a0b84 Added PHP 8 into versions.xml for filesystem based on stubs. 
Closes GH-344.
 2021-01-17 14:25:42 +01:00
Tyson Andre
b4d9a0a908 Link to SplFileInfo from is_file()/file_exists() docs 
And update the list of values that can be returned by getType based on
php 8.0 ext/standard/filestat.c

SplFileInfo is the only way to do some things, such as

1. Check for the existence of a file that may or may not be readable
   without emitting a notice
   that is caught by whatever error handler the project uses.

   (e.g. file_exists can return false for unix sockets)
2. Check for file types such as unix sockets
   (e.g. `$info->getType() === 'socket'`)

Recently, I was looking for how to check if a given path was a unix
socket and the filesystem functions didn't have any links to that
information.

Closes GH-319.
 2021-01-10 13:37:52 +01:00
Christoph Michael Becker
0c9c2dd669 Generate some standard methodsynopses based on stubs 
Cf. <https://github.com/php/doc-en/pull/289>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@352191 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-12-26 19:26:31 +00:00
Christoph Michael Becker
e41806c30b Revert revision(s) 351724 from phpdoc/en/trunk: 
Document false and null return types

Cf. <https://news-web.php.net/php.doc.cvs/17645>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351730 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-28 18:05:44 +00:00
Christoph Michael Becker
4754397753 Revert revision 351727 from phpdoc/en/trunk: 
Document false and null return types

Cf. <https://news-web.php.net/php.doc.cvs/17645>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351729 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-28 17:58:32 +00:00
Jakub Vrana
69bd53265b Document false and null return types 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351727 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-28 15:12:46 +00:00
Jakub Vrana
c80da7c04a Document false and null return types 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351724 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-28 12:54:59 +00:00
Christoph Michael Becker
cfa78d6bb9 Fix #72738: realpath() expands junction points 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351451 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-19 13:28:19 +00:00
George Peter Banyard
a9a6224ca9 Split type declarations into their dedicated page 
Remove obsolete OOP5 TypeHinting page
Document union types

Closes GH-174

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351365 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-12 18:39:19 +00:00
Christoph Michael Becker
97750f17b2 Fix #75024: glob(): Non-portable GLOB_BRACE presented without warning 
A caution or even a warning appear to be too strong for this, but moving
the note to the parameter section seems to be in order according to
<http://svn.php.net/viewvc/phpdoc/doc-base/trunk/RFC/skeletons/function.xml?view=markup#l128>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351342 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-09 17:44:11 +00:00