PHP Wiki

deprecations_php_8_6 - Add commit link for return in finally deprecation

girgias (girgias@undisclosed.example.com) — 2026-08-18T19:12:43+00:00

2026/08/16 21:17		current
Line 14:		Line 14:
	* Status: Pending Implementation (for the accepted proposals)		* Status: Pending Implementation (for the accepted proposals)
	* Implementation: 8.6		* Implementation: 8.6
-	* Deprecate returning from a finally block	+	* [[https://github.com/php/php-src/commit/e721b3fdc35dc74121ed27ed43c2f9568f321bee\|Deprecate returning from a finally block]]
	* Deprecate using let as an identifier		* Deprecate using let as an identifier
	* [[https://github.com/php/php-src/commit/c383b8cae02338f32d2fa460f003223003df1acb\|Deprecate using "namespace" as a class constant name]]		* [[https://github.com/php/php-src/commit/c383b8cae02338f32d2fa460f003223003df1acb\|Deprecate using "namespace" as a class constant name]]

array_search_range

sepehrphp (sepehrphp@undisclosed.example.com) — 2026-08-18T18:14:13+00:00

2026/08/18 16:57		current
Line 246:		Line 246:

	* 0.1 — Initial draft by Sepehr Mahmoudi.		* 0.1 — Initial draft by Sepehr Mahmoudi.
		+
		+	=====Polyfill=====
		+	<code php>
		+	if (!function_exists('array_search_range')) {
		+	function array_search_range(
		+	mixed $needle,
		+	array $haystack,
		+	int $offset = 0,
		+	?int $length = null,
		+	bool $strict = false
		+	): int\|string\|false {
		+	$count = count($haystack);
		+
		+	if ($offset < 0) {
		+	$offset = max(0, $count + $offset);
		+	}
		+
		+	if ($length === null) {
		+	$length = $count - $offset;
		+	} elseif ($length < 0) {
		+	$length = $count - $offset + $length;
		+	}
		+
		+	if ($length <= 0 \|\| $offset >= $count) {
		+	return false;
		+	}
		+
		+	$slice = array_slice($haystack, $offset, $length, true);
		+	return array_search($needle, $slice, $strict);
		+	}
		+	}
		+
		+	</code>

limit-maximum-number-of-filter-chains

sjoerd (sjoerd@undisclosed.example.com) — 2026-08-18T09:39:47+00:00

2026/08/02 13:38		current
Line 168:		Line 168:

	https://github.com/php/php-src/commit/ed34ad446c99ba0019c402dc4ff121ca37182c54		https://github.com/php/php-src/commit/ed34ad446c99ba0019c402dc4ff121ca37182c54
		+
		+	PR for PHP 8.7: https://github.com/php/php-src/pull/23344

	===== References =====		===== References =====
Line 183:		Line 185:
	* https://github.com/ambionics/wrapwrap/blob/main/wrapwrap.py		* https://github.com/ambionics/wrapwrap/blob/main/wrapwrap.py
	* https://github.com/php/php-src/issues/21983		* https://github.com/php/php-src/issues/21983
-	* https://github.com/php/php-src/pull/22036	+	* https://github.com/php/php-src/pull/22036'
		+	* https://github.com/php/php-src/pull/23344

	===== Rejected Features =====		===== Rejected Features =====

rfc - throw_error_for_invalid_characters_for_number_base

sjoerd (sjoerd@undisclosed.example.com) — 2026-08-14T10:14:55+00:00

2026/08/13 11:03		current
Line 19:		Line 19:
	This section is for RFCs that have been announced on the PHP "internals" mail list.		This section is for RFCs that have been announced on the PHP "internals" mail list.

		+	* [[rfc:throw_error_for_invalid_characters_for_number_base\|Throw ValueError for invalid characters in number base functions]] (Created 2026-08-11)
	* [[rfc:function-autoloading-five-oh\|Function Autoloading (mark 5)]] (created 2026-06-16, discussion started 2026-06-16, voting started 2026-07-30)		* [[rfc:function-autoloading-five-oh\|Function Autoloading (mark 5)]] (created 2026-06-16, discussion started 2026-06-16, voting started 2026-07-30)
	* [[rfc:reldateformatter\|IntlRelativeDateTimeFormatter]] (Created 2026-08-07, Discussion started 2026-08-07)		* [[rfc:reldateformatter\|IntlRelativeDateTimeFormatter]] (Created 2026-08-07, Discussion started 2026-08-07)
Line 79:		Line 80:
	* [[rfc:deprecations_php_8_7\|Deprecations for PHP 8.7]] (Created 2026-08-12)		* [[rfc:deprecations_php_8_7\|Deprecations for PHP 8.7]] (Created 2026-08-12)
	* [[rfc:array_search_range\|Array Search Range]] (Created 2026-08-12)		* [[rfc:array_search_range\|Array Search Range]] (Created 2026-08-12)
-	* [[rfc:throw_error_for_invalid_characters_for_number_base\|Throw ValueError for invalid characters in number base functions]] (Created 2026-08-11)
	* [[rfc:immutable_collections\|Native Immutable Collections — "vec", "set" and "tuple"]] (Created 2026-08-04)		* [[rfc:immutable_collections\|Native Immutable Collections — "vec", "set" and "tuple"]] (Created 2026-08-04)
	* [[rfc:direction_aware_property_resolution\|Direction Aware Property Resolution]] (Created 2026-07-14)		* [[rfc:direction_aware_property_resolution\|Direction Aware Property Resolution]] (Created 2026-07-14)

throw_error_for_invalid_characters_for_number_base

sjoerd (sjoerd@undisclosed.example.com) — 2026-08-14T10:09:38+00:00

2026/08/14 10:09		current
Line 86:		Line 86:
	Primary Vote requiring a 2/3 majority to accept the RFC:		Primary Vote requiring a 2/3 majority to accept the RFC:

-	<doodle title="Throw a ''ValueError'' for invalid characters in number base conversion functions?" voteType="single" closed="true" closeon="2026-01-01T15:30:00Z">	+	<doodle title="Throw a ValueError for invalid characters in number base conversion functions?" voteType="single" closed="true" closeon="2026-01-01T15:30:00Z">
	* Yes		* Yes
	* No		* No

php86 - update beta1

sergey (sergey@undisclosed.example.com) — 2026-08-13T15:14:14+00:00

2026/08/13 15:08		current
Line 18:		Line 18:
	\| Jul 30 2026 \| Alpha 3 [[https://www.php.net/archive/2026.php#2026-07-30-3\|Announce]] [[https://downloads.php.net/~mbeccati/\|Files]] \|		\| Jul 30 2026 \| Alpha 3 [[https://www.php.net/archive/2026.php#2026-07-30-3\|Announce]] [[https://downloads.php.net/~mbeccati/\|Files]] \|
	\| Aug 11 2026 \| All RFCs targeting 8.6 should have been merged, so they can be in Beta 1. \|		\| Aug 11 2026 \| All RFCs targeting 8.6 should have been merged, so they can be in Beta 1. \|
-	\| Aug 13 2026 \| Beta 1 + Soft feature freeze: all RFCs must have their voting concluded [[https://www.php.net/archive/2025.php#2025-08-14-1\|Announce]] [[https://downloads.php.net/~svpernova09/\|Files]] \|	+	\| Aug 13 2026 \| Beta 1 + Soft feature freeze: all RFCs must have their voting concluded [[https://www.php.net/archive/2026.php#2026-08-13-1\|Announce]] [[https://downloads.php.net/~svpernova09/\|Files]] \|
	\| Aug 27 2026 \| Beta 2 \|		\| Aug 27 2026 \| Beta 2 \|
	\| Sep 10 2026 \| Beta 3 \|		\| Sep 10 2026 \| Beta 3 \|

deprecations_php_8_7 - created

daniels (daniels@undisclosed.example.com) — 2026-08-12T18:45:17+00:00

2026/08/20 08:21	current
Line 1:	Line 1:
	+	====== PHP RFC: Deprecations for PHP 8.7 ======
	+	* Date: 2026-08-12
	+	* Authors:
	+	* Daniel Scherzer <daniel.e.scherzer@gmail.com>
	+	* Status: Draft
	+	* Discussion thread: Not started yet
	+	* Voting thread: tbd
	+
	+	===== Introduction =====
	+
	+	The RFC proposes to deprecate the listed functionality in PHP 8.7 and remove it in PHP 9 (except where otherwise noted).
	+
	+	The following list provides a short overview of the functionality targeted for deprecation, while more detailed explanation is provided in the Proposal section:
	+
	+	* Deprecate <php>is_a</php> with $object_or_class not being a string or object
	+	* Deprecate <php>is_subclass_of</php> with $object_or_class not being a string or object
	+
	+	===== Proposals =====
	+
	+	Each feature proposed for deprecation is voted separately and requires a 2/3 majority.
	+	All votes refer to deprecation in PHP 8.7 and removal in PHP 9 (except where otherwise noted).
	+
	+	==== Example Deprecation ====
	+
	+	* Author: Name <name@example.com>
	+
	+	Description
	+
	+	==== Deprecate is_a() with $object_or_class not being a string or object ====
	+
	+	* Author: Daniel Scherzer <daniel.e.scherzer@gmail.com>
	+
	+	<php>is_a</php> is used to check if an object or class name is an instance of some other named class/interface. The first parameter can be either an object to check, or the name of a class. It can also be something other than a string or object, in which case the function will always return false. I.e. code like <php>is_a(5, "int")</php> or <php>is_a(true, "bool")</php> will always return false.
	+
	+	Given that <php>is_a</php> always returns false when the first parameter is something other than a string or object, we propose to deprecate providing non-string non-object parameters. If the type of a parameter is not known, the <php>is_a</php> call can be preceded with a call to <php>is_object</php>.
	+
	+	If accepted, calling <php>is_a</php> with non-string non-object parameters will emit a deprecation similar to the following:
	+
	+	<blockquote>
	+	Deprecated: Calling is_a() with $object_or_class of type %s is deprecated.
	+	</blockquote>
	+
	+	==== Deprecate is_subclass_of() with $object_or_class not being a string or object ====
	+
	+	* Author: Daniel Scherzer <daniel.e.scherzer@gmail.com>
	+
	+	<php>is_subclass_of</php> is used to check if an object or class name is an instance of a subclass of some other named class, or an instance of an interface. It works similarly to <php>is_a</php>, except when an object's class is the exact same as the class to check. Like <php>is_a</php>, the first parameter can be either an object to check, or the name of a class. It can also be something other than a string or object, in which case the function will always return false. I.e. code like <php>is_subclass_of(5, "int")</php> or <php>is_subclass_of(true, "bool")</php> will always return false.
	+
	+	Given that <php>is_subclass_of</php> always returns false when the first parameter is something other than a string or object, we propose to deprecate providing non-string non-object parameters. If the type of a parameter is not known, the <php>is_subclass_of</php> call can be preceded with a call to <php>is_object</php>.
	+
	+	Unlike <php>is_a</php>, <php>is_subclass_of</php> also semantically makes no sense for non objects (or string class names) because there is no subclassing concept for non-objects.
	+
	+	If accepted, calling <php>is_subclass_of</php> with non-string non-object parameters will emit a deprecation similar to the following:
	+
	+	<blockquote>
	+	Deprecated: Calling is_subclass_of() with $object_or_class of type %s is deprecated.
	+	</blockquote>

surface3d.png - created

pajoye (pajoye@undisclosed.example.com) — 2026-07-19T13:48:10+00:00

	current

scaled_on_load_rotate.png - created

pajoye (pajoye@undisclosed.example.com) — 2026-07-17T06:47:24+00:00

	current

watermarked.png - created

pajoye (pajoye@undisclosed.example.com) — 2026-07-17T03:57:25+00:00

	current

scale_entropy_visual_check.png - created

pajoye (pajoye@undisclosed.example.com) — 2026-07-14T03:12:03+00:00

	current

textcurve.png - created

pajoye (pajoye@undisclosed.example.com) — 2026-07-10T14:08:53+00:00

1783692513	current

gradient_art.png - created

pajoye (pajoye@undisclosed.example.com) — 2026-07-06T06:32:24+00:00

	current

tiger.png - created

pajoye (pajoye@undisclosed.example.com) — 2026-07-06T06:32:03+00:00

	current

gradient_operators.png - created

pajoye (pajoye@undisclosed.example.com) — 2026-07-06T06:31:36+00:00

	current

coroutine-lifecycle.svg - created

edmond (edmond@undisclosed.example.com) — 2025-04-16T07:24:46+00:00

	current

supervisor.svg - created

edmond (edmond@undisclosed.example.com) — 2025-03-16T08:38:59+00:00

	current

exception_flow.svg - created

edmond (edmond@undisclosed.example.com) — 2025-03-16T08:38:59+00:00

	current

resume_and_notifier.svg - created

edmond (edmond@undisclosed.example.com) — 2025-02-16T08:40:05+00:00

	current

basic.svg - created

edmond (edmond@undisclosed.example.com) — 2025-02-14T19:39:22+00:00

	current

2026/08/13 11:03		current
Line 19:		Line 19:
	This section is for RFCs that have been announced on the PHP "internals" mail list.		This section is for RFCs that have been announced on the PHP "internals" mail list.

		+	* [[rfc:throw_error_for_invalid_characters_for_number_base\|Throw ValueError for invalid characters in number base functions]] (Created 2026-08-11)
	* [[rfc:function-autoloading-five-oh\|Function Autoloading (mark 5)]] (created 2026-06-16, discussion started 2026-06-16, voting started 2026-07-30)		* [[rfc:function-autoloading-five-oh\|Function Autoloading (mark 5)]] (created 2026-06-16, discussion started 2026-06-16, voting started 2026-07-30)
	* [[rfc:reldateformatter\|IntlRelativeDateTimeFormatter]] (Created 2026-08-07, Discussion started 2026-08-07)		* [[rfc:reldateformatter\|IntlRelativeDateTimeFormatter]] (Created 2026-08-07, Discussion started 2026-08-07)
Line 79:		Line 80:
	* [[rfc:deprecations_php_8_7\|Deprecations for PHP 8.7]] (Created 2026-08-12)		* [[rfc:deprecations_php_8_7\|Deprecations for PHP 8.7]] (Created 2026-08-12)
	* [[rfc:array_search_range\|Array Search Range]] (Created 2026-08-12)		* [[rfc:array_search_range\|Array Search Range]] (Created 2026-08-12)
-	* [[rfc:throw_error_for_invalid_characters_for_number_base\|Throw ValueError for invalid characters in number base functions]] (Created 2026-08-11)
	* [[rfc:immutable_collections\|Native Immutable Collections — "vec", "set" and "tuple"]] (Created 2026-08-04)		* [[rfc:immutable_collections\|Native Immutable Collections — "vec", "set" and "tuple"]] (Created 2026-08-04)
	* [[rfc:direction_aware_property_resolution\|Direction Aware Property Resolution]] (Created 2026-07-14)		* [[rfc:direction_aware_property_resolution\|Direction Aware Property Resolution]] (Created 2026-07-14)

2026/08/13 15:08		current
Line 18:		Line 18:
	\| Jul 30 2026 \| Alpha 3 [[https://www.php.net/archive/2026.php#2026-07-30-3\|Announce]] [[https://downloads.php.net/~mbeccati/\|Files]] \|		\| Jul 30 2026 \| Alpha 3 [[https://www.php.net/archive/2026.php#2026-07-30-3\|Announce]] [[https://downloads.php.net/~mbeccati/\|Files]] \|
	\| Aug 11 2026 \| All RFCs targeting 8.6 should have been merged, so they can be in Beta 1. \|		\| Aug 11 2026 \| All RFCs targeting 8.6 should have been merged, so they can be in Beta 1. \|
-	\| Aug 13 2026 \| Beta 1 + Soft feature freeze: all RFCs must have their voting concluded [[https://www.php.net/archive/2025.php#2025-08-14-1\|Announce]] [[https://downloads.php.net/~svpernova09/\|Files]] \|	+	\| Aug 13 2026 \| Beta 1 + Soft feature freeze: all RFCs must have their voting concluded [[https://www.php.net/archive/2026.php#2026-08-13-1\|Announce]] [[https://downloads.php.net/~svpernova09/\|Files]] \|
	\| Aug 27 2026 \| Beta 2 \|		\| Aug 27 2026 \| Beta 2 \|
	\| Sep 10 2026 \| Beta 3 \|		\| Sep 10 2026 \| Beta 3 \|