1
0
mirror of https://github.com/php/doc-en.git synced 2026-03-23 23:32:18 +01:00
Commit Graph

31001 Commits

Author SHA1 Message Date
Christian Weiske
a4bcdd05f1 Change permissions for cloned repositories
The current user and group ID are passed passed to the docker build command
and the ownership of the cloned directories are changed to them.
This gets rid of git's "dubious ownership" error.

Without this changes I got an error:
> $ make
> docker run --rm -v :/var/www/en -w /var/www -u 1000:1000 php/doc-en
> configure.php on PHP 8.2.29, libxml 2.9.14
>
> fatal: detected dubious ownership in repository at '/var/www/doc-base'
> To add an exception for this directory, call:
>
> 	git config --global --add safe.directory /var/www/doc-base
> doc-base/temp clean up FAILED.
> make: *** [Makefile:22: xhtml] Fehler 1

Resolves: https://github.com/php/doc-en/pull/4645
2026-03-05 15:24:21 +01:00
Christian Weiske
1f3033eaee Pass full local path to docker
Passing "." as path does not work with docker 20.10.24:
> $ make
> docker run --rm -v .:/var/www/en -w /var/www -u 1000:1000 php/doc-en
> docker: Error response from daemon: create .: volume name is too short, names should be at least two alphanumeric characters.
> See 'docker run --help'.
> make: *** [Makefile:22: xhtml] Fehler 125
2026-03-05 15:24:21 +01:00
Gina Peter Banyard
ae7db14ea8 Properly revert "Fix wrong xml:id on the fieldsynopsis element of Exception::$code"
This reverts commit 6a05d92a32.

On the request of Máté to fix the build.

It might make sense to rewrite history and force push to prevent revcheck issues, but that's another debate.
2026-03-05 13:35:28 +00:00
Christian Weiske
dca2a8354f Document special handling for "&" in SimpleXml::addChild()
See the comments section for that page: https://www.php.net/manual/en/simplexmlelement.addchild.php
2026-03-05 14:33:07 +01:00
Máté Kocsis
462d2bcb3f Revert "Fix wrong xml:id on the fieldsynopsis element of Exception::$code"
This reverts commit 6a05d92a32.

The id is needed since 3c4752c0ae
2026-03-05 14:21:25 +01:00
Christian Weiske
74ef2355c5 Document ssh2_auth_pubkey() from pecl/ssh2 v1.4 (#5010)
Changelog: https://pecl.php.net/package-info.php?package=ssh2&version=1.4
2026-03-05 12:50:36 +00:00
Máté Kocsis
6a05d92a32 Fix wrong xml:id on the fieldsynopsis element of Exception::$code 2026-03-05 13:48:51 +01:00
Máté Kocsis
30bda33771 Fix missing attribute for NoDiscard 2026-03-05 13:46:32 +01:00
Michael Voříšek
28930349ca Improve SQLite createFunction example (#5374) 2026-03-02 22:55:36 +01:00
Louis-Arnaud
5b7646656e Fix return type for 5 misc functions: bool -> true (#5357)
* Fix return type for 5 functions: bool -> true

These functions always return true (or throw on error):
- finfo_close (fileinfo)
- ftp_set_option (ftp)
- libxml_set_external_entity_loader (libxml)
- shm_detach (shmop)
- array_multisort (standard)

* Add changelog entries for return type change bool -> true

* Fix changelog version: use 8.5.0 instead of entity hardcoded to 8.2.0

The &return.type.true; entity is hardcoded with version 8.2.0, but all
5 functions changed their return type from bool to true in PHP 8.5.
Replace the entity with manual changelog rows using the correct version.
2026-03-02 22:55:02 +01:00
Louis-Arnaud
7d5c74c9a5 Normalize DOM error sections to explicitly mention DOMException (#5261) 2026-03-02 22:32:36 +01:00
Daniel Scherzer
b53f03f249 DATE_ATOM: refer to RFC 3339, not 3399 (#5393)
Fixes #5386
2026-03-02 11:36:42 -08:00
Derick Rethans
1d1aad45d5 Updated to version 2026.1 (2026a) 2026-03-02 18:13:37 +00:00
dependabot[bot]
5e79ef6b69 build(deps): bump actions/upload-artifact from 6 to 7 (#5396)
Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 6 to 7.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-03-01 19:42:14 -08:00
Máté Kocsis
c8e3b2ccad Declare the namespace of ext/random classes (#5394) 2026-02-28 14:37:54 +00:00
KentarouTakeda
a7be7e9abb Fix typo: simparapara -> simpara in StreamBucket (#5395) 2026-02-28 13:51:10 +00:00
sasezaki
02bee41067 Add NoDiscard attribute (#5041)
Co-authored-by: Gina Peter Banyard <girgias@php.net>
2026-02-27 06:49:08 -08:00
Dustaboy3
1709768e97 FAQ: Mention named arguments and discourage manual escaping (#5377)
Updates the FAQ:

- Mentions named arguments in the parameter order entry.
- Adds a note discouraging manual escaping in the addslashes entry,
  recommending prepared statements and parameter binding instead.
2026-02-19 16:36:21 -08:00
Mikhail Alferov
6122a8317c setcookie.xml Arrange the versions of the change log (#5378) 2026-02-19 16:33:29 -08:00
Kamil Tekiela
1beae37b69 Clarify how multi_query works (#5380) 2026-02-18 22:58:14 +00:00
Daniel Scherzer
88eb0d53c6 property-hooks: add missing $modified declaration to example 4 (#5124) 2026-02-17 10:25:16 -08:00
AllenJB
fa98755da4 FPM Status page: Fix proxypass URL (#3145)
* FPM Status page: Fix proxypass URL

* FPM Status page: Update to use modern Apache require configuration
2026-02-17 17:48:58 +01:00
Daniel Scherzer
34bd6f08bd finfo_close: add changelog for NOP and deprecation (#5373) 2026-02-15 15:52:26 -08:00
Andreas Braun
dac7a370d3 Document new API in ext-mongodb 2.2.0 (#5370)
* Document new API in ext-mongodb 2.2.0

* Apply suggestions from code review

Co-authored-by: Jeremy Mikola <jmikola@gmail.com>

---------

Co-authored-by: Jeremy Mikola <jmikola@gmail.com>
2026-02-13 08:19:35 +01:00
Daniel Scherzer
29c3d13980 curl_share_close: add changelog for NOP and deprecation (#5249) 2026-02-11 21:07:40 -08:00
Christian Schneider
c6fb604f39 Fix parameter names to match between synopsis and description part (#5247) 2026-02-08 10:00:50 +01:00
Karoly Negyesi
31e56c25f9 add literal around getcurrent error 2026-02-06 17:33:25 +01:00
Christian Schneider
4e69a9f2b1 Remove descriptions of obsolete parameters not in synopsis (#5246)
Co-authored-by: Christian Schneider <schneider@search.ch>
2026-02-06 14:42:29 +00:00
Máté Kocsis
5e36b489fc Add some missing properties and constants (intl/soap/attribute) (#5069) 2026-02-06 14:15:34 +00:00
Louis-Arnaud
a2a3f35259 Fix rand() range constraint to use abs() for reversed parameters (#5264) 2026-02-06 13:56:19 +00:00
Samuel
53fb200fed do-while: align example code indentation (#5278) 2026-02-06 01:00:26 -08:00
MorganLOCode
b07b628d6f Fix typo (#5280)
Sometimes the spelling used is "writeable", sometimes it's "writable". Both are valid in English, but the SplFileInfo method is "isWritable".
2026-02-06 10:56:00 +08:00
Karoly Negyesi
f6406cdb5e add error message, use yoda style you should not 2026-02-05 12:30:30 +01:00
Jack Worman
f5e51d56b0 Fix description for "!" and "|" format tokens 2026-02-04 13:05:17 +01:00
Daniel Scherzer
86c8ebd19e curl_close: add changelog for NOP and deprecation (#5178) 2026-02-04 02:32:35 -08:00
Daniel Scherzer
6860e0623b Language snippets: fix odbc.changelog.connection-return (#4646)
Don't include `odbc.changelog.connection-param`, not every function that
returns a connection has a connection parameter (and, in fact, neither of the
existing uses of the connection-return entity, for `odbc_connect()` and
`odbc_pconnect()`, has such a parameter).
2026-02-03 22:39:08 -08:00
Karoly Negyesi
6fc2c24b6b no need for these see also 2026-02-02 17:24:34 +01:00
Karoly Negyesi
d74f3573b3 document getcurrent 2026-02-02 09:34:00 +01:00
Mikhail Alferov
d9cfd78e58 Fix parameter name mismatches between signature and description (#5185) 2026-01-30 10:34:46 +00:00
Louis-Arnaud
7fbb16f538 Extend Iterator::rewind note to mention NoRewindIterator (#5110) 2026-01-30 10:33:05 +00:00
Lucas Werkmeister
6bbb5b9685 Improve date format documentation a little bit (#5184)
Make it a bit more visible yet that DATE_ISO8601 is not compatible with
ISO-8601 (anyone wondering “why ‘like’?” will hopefully see the note
immediately below), and mention the standards that Atom is compatible
with (straight from RFC 4287, section 3.3; I omitted the “Date and Time
Formats” W3C note as it doesn’t seem as prominent as the others) in the
hope of encouraging more people to use it.
2026-01-30 10:31:26 +00:00
Louis-Arnaud
b731f708be Move default flag clarification to top of flags description (#4831) (#5224)
The note about PREG_PATTERN_ORDER being the default was buried at the
end of the flags list, making it easy to miss.
2026-01-30 10:29:19 +00:00
Mikhail Alferov
5a33c90d38 Remove duplicate word (#5177) 2026-01-30 10:27:24 +00:00
Louis-Arnaud
6b413423c7 Clarify REQUEST_TIME initialization timing (#5109) 2026-01-30 10:13:21 +00:00
Louis-Arnaud
577239f64b Document deprecation of SOAP_FUNCTIONS_ALL in SoapServer::addFunction (#5108) 2026-01-30 10:12:27 +00:00
Mikhail Alferov
ee94fd0c20 grapheme-str-split.xml Remove extra locale description (#5182)
Initially I thought the `locale` parameter was missing from the signature. However, `grapheme_str_split()` actually accepts only 2 arguments in PHP 8.5.2 — meaning the parameter description was added to the documentation erroneously
2026-01-30 10:09:33 +00:00
Louis-Arnaud
ec01a42be5 Document setlocale() incompatibility with integer 0 in PHP 8.5 (#5094) 2026-01-30 10:08:26 +00:00
Louis-Arnaud
b41e78e623 Fix setcookie() documentation for invalid options in PHP 8.0+ (#5104)
And move it to the usual dedicated Errors/Exception section

Co-authored-by: Gina Peter Banyard <girgias@php.net>
2026-01-30 10:06:50 +00:00
Mikhail Alferov
8108ac2a62 Fix typo: OEAP → OAEP (#5183) 2026-01-28 10:16:43 +08:00
Gina Peter Banyard
4090672541 snmp: fix XML by converting para to simpara tags via script 2026-01-26 15:34:34 +00:00