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

859 commits

Author SHA1 Message Date
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
Christoph Michael Becker
ccb1313e0c Fix #71075: Update rename() docs to mention Windows-specific permissions issues 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351270 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-05 15:49:38 +00:00
Christoph Michael Becker
46a0d3708e Fix #80300: add "unlink" in "see also" section 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351181 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-03 09:59:25 +00:00
Christoph Michael Becker
b820701969 Remove obsolete info regarding Vista/2008 
Windows Vista/2008 is required as of PHP 5.5.0 anyway; no need to mention
that requirement here.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351180 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-03 09:54:24 +00:00
Christoph Michael Becker
b95d28e6ec Fix return types 
Functions which return false on failure should state that in their
signature as well.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351135 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-02 15:52:35 +00:00
Christoph Michael Becker
86e6094e86 Use canonical type names 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351133 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-02 15:39:04 +00:00
Christoph Michael Becker
9e0f03ac35 Proper variadics instead of pseudo variadics 
We markup variadic parameters with the `rep=repeat` standard DocBook
attribute of `<methodparam>`, and use proper variable names instead of
using the old pseudo variable name `...`.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351129 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-11-02 11:17:26 +00:00
Yoshinari Takaoka
5222a1c1ed fixed typo 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351023 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-10-28 01:11:46 +00:00
Christoph Michael Becker
1017932869 Fix #80282: cannot send binary data to popen 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351021 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-10-27 22:43:26 +00:00
Christoph Michael Becker
dec1f8445a Remove safe_mode related information 
Sorry, translators, for breaking your builds again.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350871 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-10-13 22:07:26 +00:00
Christoph Michael Becker
513913468b parse_ini_file comment cleanup 
* Explain limited value interpolation of reserved characters.
* Clarify that a constant value only works for the whole value.
* Clarify path evaluation of the file.
* Note magic constants are not interpolated.
* Add security note.

Patch contributed by Larry Garfield <larry@garfieldtech.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350855 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-10-12 21:57:55 +00:00
Christoph Michael Becker
e443388d42 Remove info about SAPIs which are removed as of PHP 7.0.0 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350661 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-09-26 16:56:25 +00:00
Christoph Michael Becker
7f569e1f17 Remove more changelog entries, mostly from PHP 5.3 era 
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350655 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-09-26 14:08:59 +00:00
Christoph Michael Becker
9af43469f4 Remove more changelog entries, mostly from PHP 5.2 era 
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350654 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-09-26 13:52:31 +00:00
Christoph Michael Becker
be5b0f33a1 Remove more changelog entries, mostly from PHP 5.1 era 
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350653 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-09-26 13:45:57 +00:00
Christoph Michael Becker
1a6fa40ded GLOB_MARK adds a *back*slash on Windows 
This integrates user note 125311.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350427 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-08-31 10:37:28 +00:00
Christoph Michael Becker
5236d760ce Fix #79993: SplFileObject::flock has LOCK_NB as a valid operation 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350338 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-08-18 23:26:40 +00:00
Christoph Michael Becker
fe81a24d2e Fix #78400: Sym-linked files are not accessible 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350194 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-07-22 09:24:50 +00:00
Christoph Michael Becker
70ee71ffb4 Update inode info regarding Windows 
We also fix the markup, and an erroneous info about the device number.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350157 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-07-15 11:43:25 +00:00
Christoph Michael Becker
72bc373e47 Document dev element of stat() array on Windows 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350100 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-07-03 08:30:39 +00:00
Christoph Michael Becker
3b325dcb9a Document different behavior of readlink() on Windows 
Cf. <https://github.com/php/php-src/pull/3825#issuecomment-467837181>.

While we're at it, we also fix the order of the "returnvalues" and "changelog" sections.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350097 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-07-02 13:25:03 +00:00
Christoph Michael Becker
047e515775 Clarify meaning of negative default_socket_timeout 
Cf. <https://github.com/php/php-src/pull/5693>

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350020 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-06-09 17:13:21 +00:00
Christoph Michael Becker
0536573944 Updates regarding text/binary mode 
On Windows, 'b' is the default as of PHP 5.0.0.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350008 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-06-04 10:35:17 +00:00
Christoph Michael Becker
2c1763402c Fix return values documentation on linkinfo() function 
Patch provided by Reinard Dolleschel.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349726 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-04-30 07:13:38 +00:00
Christoph Michael Becker
cd0fe35bb9 Document that chown() and chgrp() are basically unsupported on Windows 
This integrates user note 124790 and 124791.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349320 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-03-05 13:40:22 +00:00
Christoph Michael Becker
58d190bce3 Fix #79071: Undocumented truncation of tempnam() second parameter 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349191 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-02-09 14:25:30 +00:00
Nikita Popov
74a2325f95 Remove the incorrect pattern "..." in glob() 
Patch by colshrapnel.

Closes php/doc-en#36.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349153 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-02-06 14:22:03 +00:00
Christoph Michael Becker
9c882d0b96 Remove whitespace 
Patch has been provided by Oskar Stark.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349109 c90b9560-bf6c-de11-be94-00142212c4b1
 2020-02-03 14:30:43 +00:00
Christoph Michael Becker
19822bcfa1 Fix #79017: Can delete files in use by other processes 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@348727 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-12-29 12:46:35 +00:00
Christoph Michael Becker
929cec1734 Clarify that fgetss() is stateful 
We also add related functionality in the see-also section.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@348386 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-12-01 13:03:14 +00:00
Christoph Michael Becker
4349bb7a7c allow_url_include has been deprecated 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@348373 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-11-30 14:17:30 +00:00
Karoly Negyesi
3c8132d824 documented stat mode 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@348349 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-11-26 01:44:25 +00:00
George Peter Banyard
8cb7482bf8 Typos 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@348336 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-11-24 04:27:46 +00:00
Christoph Michael Becker
2131be1bfc Fix typo 
Patch provided by anonymous user

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@347829 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-08-09 15:51:40 +00:00
George Peter Banyard
f6981153ef Fix Doc Bug #78089 
Add special characters which can be utilized in a glob pattern.

Based on http://www.delorie.com/djgpp/doc/libc/libc_426.html

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@347740 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-07-13 17:33:54 +00:00
George Peter Banyard
958d584198 Typos 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@347660 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-06-25 15:42:46 +00:00
George Peter Banyard
466005b130 Remove PHP 4 and 5.0.0 mentions. 
This is sent seperatly as apparently via the online doc editor it tells me the file is out of d


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@347578 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-06-08 15:56:14 +00:00
George Peter Banyard
43c3e5cb61 Fix Doc Bug #78104 by removing mentions of @ operator and moving E_WARNING info into Error/Exception section. 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@347576 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-06-08 15:41:06 +00:00
George Peter Banyard
b824e2b108 Remove PHP 4 and 5.0.0 mentions. 
This includes changelogs but also some paragraphs and notes which mention PHP 4.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@347555 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-06-05 17:31:34 +00:00
Sara Golemon
9e64a0aefa Reword description for delete placehold page. 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@347334 c90b9560-bf6c-de11-be94-00142212c4b1
 2019-04-24 17:07:17 +00:00