1
0
mirror of https://github.com/php/doc-en.git synced 2026-04-23 23:38:13 +02:00
Commit Graph

505 Commits

Author SHA1 Message Date
Tim Düsterhus 6e69d9342e Use FQCN for native attributes (#2137)
* Use FQCN for native attributes

For attributes, it's non-obvious that they need to be imported with `use` or
referenced with their FQCN, because applying a non-existent attribute is not an
error.

Make the examples copy-and-paste safe by adding the leading backslash, as
already done for `#[\SensitiveParameterValue]`.
2023-01-04 16:20:00 +00:00
Máté Kocsis 601f6f4ce5 Update ext/session role attributes (#1987) 2022-12-11 16:06:18 +01:00
Tim Düsterhus 2ab45105b4 Stop referring to openssl_random_pseudo_bytes() outside of ext/openssl (#1967)
* random: Remove openssl_random_pseudo_bytes() from caution.cryptographically-insecure

The `random_bytes()` and `random_int()` alternatives are available since since
PHP 7.0, are available by default and directly map to the OS' CSPRNG and thus
are likely more secure.

Thus this commit stops mentioning `openssl_random_pseudo_bytes()` as a possible
option any more to keep things simple for the reader.

* random: Remove `openssl_random_pseudo_bytes()` from “See Also” sections for ext/random

The reasoning as with the previous commit applies.

* hash: Replace `openssl_random_pseudo_bytes()` by `random_bytes()`

* session: Replace `openssl_random_pseudo_bytes()` by `random_bytes()`
2022-11-10 14:08:01 +01:00
George Peter Banyard 8a152ef592 Rewrite outdated note for session_unset() (#1940)
This was meant to be used when $HTTP_SESSION_VARS was still around
2022-11-04 14:22:58 +00:00
Martin Samesch 6d1ca753fb [skip-revcheck] Fix typos 2022-09-02 15:20:37 +02:00
Martin Samesch 281d618901 [skip-revcheck] Fix typo 2022-08-26 14:20:50 +02:00
php4fan aaabaa98a8 Added gc_maxlifetime default value to description (#1592)
For consistency with all other constants, where the default value is also mentioned in the description so you don't have to go back to the table to look it up.
2022-07-08 18:08:49 +01:00
Jordi Boggiano 6b0ab29716 Fix ini name
Closes GH-1376.
2022-02-04 17:04:39 +01:00
Christoph M. Becker e8fbdb2fe6 Update defaults of session.cookie_secure and .cookie_httponly
That's rather a cosmetic change, but we still should strive to be
precise.
2022-01-11 15:43:31 +01:00
Máté Kocsis 591a6aa1de Display SessionUpdateTimestampHandlerInterface as an interface rather than a class
Closes GH-1107.
2021-12-15 18:33:43 +01:00
Máté Kocsis 4eb60e8132 [skip-revcheck] Generate ext/session class synopses from stubs 2021-12-15 18:32:56 +01:00
Christoph M. Becker d1c3de7ae6 Update sessionhandlerinterface example for PHP 8.1
We require suitable return types or the ReturnTypeWillChange attribute
as of PHP 8.1.0.  We specify the return types where supported as of PHP
7.0.0, but go with the attribute for the union types.

Cf. <https://github.com/php/doc-en/issues/1090>.
2021-11-15 17:05:31 +01:00
Máté Kocsis b0b19b6618 Generate methodsynopses based on stubs for recent changes (#903) 2021-10-01 17:23:05 +02:00
Máté Kocsis 35b57d9df0 Remove some unnecessary abstract modifier from methodsynopses (#914) 2021-09-14 12:43:32 +01:00
Máté Kocsis ab57ab6849 Mark a few interfaces as oointerface rather than ooclass (#818) 2021-07-30 17:01:16 +02:00
othercorey 04a6d30dc1 Update return type for SessionHandlerInterface::gc() (#704)
The type is `int|false` but documented as `int|bool`.
2021-07-11 18:23:12 +01:00
Sergey Panteleev 35b95a56cc Fix issues in Session directory
Part of #658
2021-06-09 12:05:20 +03:00
Máté Kocsis 80446d37cb Fix return value description of SessionHandlerInterface::read()
Closes GH-654.
2021-06-04 11:07:29 +02:00
Máté Kocsis 1367cac761 Update the methodsynopsis of some recently changed stubs
Closes GH-625.
2021-05-24 23:29:02 +02:00
Sergey Panteleev 184f3f7bd4 Remove PHP 5, 7 references (#565) 2021-05-12 14:49:16 +03:00
Yoshinari Takaoka e5d4a8419d remove already deleted session function on PHP 5.4.0 (#583) 2021-05-03 23:44:04 +09: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
Christoph M. Becker 3e08a8aae6 Remove obsolete PHP 5 related info from ini.core and related pages 2021-02-24 14:32:08 +01:00
Christoph M. Becker 7dc5a6466b Fix #80677: session.cookie_samesite missing from INI list
We should not duplicate the info in the general INI list, but rather
include it from the session configuration.

While we're at it, we remove obsolete changelog entries, fix the
wording ("as of" instead of "since"), and remove the url_rewriter.tags
entry from the session configuration page.
2021-01-28 12:05:05 +01:00
Christoph M. Becker b41704883c Remove irrelevant entries from session/versions.xml
`session_register()` and friends are removed as of PHP 5.4.0.
`sessionhandler::updatetimestamp()` and `sessionhandler::validateid()`
did never exist; these are methods of `sessionupdatetimestamphandlerinterface`.
2021-01-18 13:29:02 +01:00
Yoshinari Takaoka ac2a89fe0f Added PHP 8 into versions.xml for session based on stubs.
Closes GH-355.
2021-01-18 13:26:14 +01:00
George Peter Banyard 4a7ddddc27 Remove some mentions of register globals 2021-01-16 11:30:04 +00:00
George Peter Banyard f3d6ada615 Remove information about session.bug_compat_* INI setting
This has been removed in PHP 5.4.0
2021-01-16 10:44:21 +00:00
George Peter Banyard 37be0e0626 Mimic 'Alternative signature' prompt for setcookie in other functions which set cookies
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@352083 c90b9560-bf6c-de11-be94-00142212c4b1
2020-12-14 23:19:07 +00:00
George Peter Banyard c35c07ab6a Changelog section should be before examples section
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@352082 c90b9560-bf6c-de11-be94-00142212c4b1
2020-12-14 23:14:55 +00:00
Yoshinari Takaoka 89b952c4b8 fixed invalid parameter name.
maybe, copy-and-pasted.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351762 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-30 01:26:22 +00:00
Christoph Michael Becker 151e61773c Generate session methodsynopses based on stubs
Closes GH-236.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351750 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-29 15:51:04 +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
Christoph Michael Becker 88848833f7 Fix #80356: Incorrect function return type
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351369 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-12 23:47:30 +00:00
Christoph Michael Becker 260d3a35b2 Fix #80317: Incorrect function return type
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351222 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-04 16:30:06 +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
Christoph Michael Becker 6cd5d527ff Fix #80252: Incorrect description of session_cache_expire()
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350930 c90b9560-bf6c-de11-be94-00142212c4b1
2020-10-17 21:46:08 +00:00
Christoph Michael Becker 60fc9f497a Remove some PHP 5 specific info
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350863 c90b9560-bf6c-de11-be94-00142212c4b1
2020-10-13 16:31:50 +00:00
Christoph Michael Becker 3e15d2894f Remove more changelog entries, mostly from PHP 5.4 era
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350656 c90b9560-bf6c-de11-be94-00142212c4b1
2020-09-26 14:15:17 +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 53bdffa6b9 Removed some of the PHP5 changelogs
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350645 c90b9560-bf6c-de11-be94-00142212c4b1
2020-09-26 12:32:19 +00:00
Christoph Michael Becker 418de44708 Fix #76977: include session.save_path in session.security.ini.php
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350307 c90b9560-bf6c-de11-be94-00142212c4b1
2020-08-13 13:22:47 +00:00
Christoph Michael Becker 4aab798782 Remove out-dated Windows related info
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350234 c90b9560-bf6c-de11-be94-00142212c4b1
2020-07-28 09:42:44 +00:00
Christoph Michael Becker 6ec0096178 Fix #79892: session.use_strict_mode and SessionHandlerInterface mismatch
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350221 c90b9560-bf6c-de11-be94-00142212c4b1
2020-07-27 15:36:20 +00:00
Christoph Michael Becker aebf045bfb Fix miscellaneous typos
Detected by codespell

Patch provided by tandre@php.net.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349708 c90b9560-bf6c-de11-be94-00142212c4b1
2020-04-27 06:43:55 +00:00