PHP Wiki

throw_error_for_invalid_characters_for_number_base

sjoerd (sjoerd@undisclosed.example.com) — 2026-08-28T08:19:43+00:00

2026/08/14 10:09		current
Line 3:		Line 3:
	* Date: 2026-08-11		* Date: 2026-08-11
	* Author: Sjoerd Langkemper <sjoerd-php@linuxonly.nl>		* Author: Sjoerd Langkemper <sjoerd-php@linuxonly.nl>
-	* Status: Draft	+	* Status: Under discussion
	* Implementation: https://github.com/php/php-src/pull/22365		* Implementation: https://github.com/php/php-src/pull/22365
	* Earlier RFC: [[https://wiki.php.net/rfc/php86_valueerror_conversions#throw_error_for_invalid_characters_for_number_base\|Grouped ValueError Conversions for PHP 8.6, Throw error for invalid characters for number base]]		* Earlier RFC: [[https://wiki.php.net/rfc/php86_valueerror_conversions#throw_error_for_invalid_characters_for_number_base\|Grouped ValueError Conversions for PHP 8.6, Throw error for invalid characters for number base]]

array_str_contains

sepehrphp (sepehrphp@undisclosed.example.com) — 2026-08-27T11:15:38+00:00

2026/08/24 16:20		current
Line 1:		Line 1:
-	====== RFC: array_str_contain ======	+	====== RFC: array_str_contains ======
	* Author: Sepehr Mahmoudi, sepehrphpr@gmail.com		* Author: Sepehr Mahmoudi, sepehrphpr@gmail.com
	* Status: Draft		* Status: Draft
Line 9:		Line 9:
	Finding elements in an array that contain a specific substring is a very common task in PHP. Currently, developers must rely on ''array_filter()'' combined with a userland closure and ''str_contains()'', or write a custom ''foreach'' loop.		Finding elements in an array that contain a specific substring is a very common task in PHP. Currently, developers must rely on ''array_filter()'' combined with a userland closure and ''str_contains()'', or write a custom ''foreach'' loop.

-	Executing a userland callback for every element in a large array using ''array_filter()'' introduces unnecessary performance overhead. This RFC proposes a native C function, ''array_str_contain()'', to perform this task efficiently, eliminating the closure overhead and providing a much cleaner, more readable syntax.	+	Executing a userland callback for every element in a large array using ''array_filter()'' introduces unnecessary performance overhead. This RFC proposes a native C function, ''array_str_contains()'', to perform this task efficiently, eliminating the closure overhead and providing a much cleaner, more readable syntax.

	===== Proposal =====		===== Proposal =====
Line 15:		Line 15:

	<code php>		<code php>
-	function array_str_contain(	+	function array_str_contains(
	array $haystack,		array $haystack,
	string $needle		string $needle
Line 41:		Line 41:
	Why a native function instead of array_filter?		Why a native function instead of array_filter?

-	While the same result can be achieved using ''array_filter()'' combined with a closure and ''str_contains()'', a native ''array_str_contain()'' function provides better ergonomics and cleaner syntax. Furthermore, a native C implementation eliminates the overhead of repeatedly calling closures and context switching for each array element, which can be highly beneficial when processing large arrays or performing heavy log and data analysis.	+	While the same result can be achieved using ''array_filter()'' combined with a closure and ''str_contains()'', a native ''array_str_contains()'' function provides better ergonomics and cleaner syntax. Furthermore, a native C implementation eliminates the overhead of repeatedly calling closures and context switching for each array element, which can be highly beneficial when processing large arrays or performing heavy log and data analysis.

	===== Examples =====		===== Examples =====
Line 56:		Line 56:
	];		];

-	$result = array_str_contain($urls, 'products');	+	$result = array_str_contains($urls, 'products');

	/*		/*
Line 77:		Line 77:
	];		];

-	$errors = array_str_contain($logs, 'ERROR:');	+	$errors = array_str_contains($logs, 'ERROR:');

	print_r($errors);		print_r($errors);
Line 101:		Line 101:
	];		];

-	$matches = array_str_contain($data, '100');	+	$matches = array_str_contains($data, '100');

	print_r($matches);		print_r($matches);
Line 125:		Line 125:
	];		];

-	$japanese_matches = array_str_contain($messages, 'こんにちは');	+	$japanese_matches = array_str_contains($messages, 'こんにちは');
	/*		/*
	Returns:		Returns:
Line 134:		Line 134:
	*/		*/

-	$emoji_matches = array_str_contain($messages, '🌍');	+	$emoji_matches = array_str_contains($messages, '🌍');
	/*		/*
	Returns:		Returns:
Line 149:		Line 149:
	<code php>		<code php>
	<?php		<?php
-	function array_str_contain(array $haystack, string $needle): array {	+	function array_str_contains(array $haystack, string $needle): array {
	$result = [];		$result = [];
	foreach ($haystack as $key => $value) {		foreach ($haystack as $key => $value) {

uri_followup

kocsismate (kocsismate@undisclosed.example.com) — 2026-08-26T20:45:08+00:00

2026/08/09 12:08		current
Line 705:		Line 705:
	===== Implementation =====		===== Implementation =====

-	* https://github.com/kocsismate/php-src/commit/1bf64cee9387bec1fdee84e57ff74bea79311aad	+	* https://github.com/php/php-src/commit/1bf64cee9387bec1fdee84e57ff74bea79311aad
-	* https://github.com/kocsismate/php-src/commit/d8a5aec1cc93e0fd41e8641091c32aace2a73059	+	* https://github.com/php/php-src/commit/d8a5aec1cc93e0fd41e8641091c32aace2a73059
	* https://github.com/php/php-src/commit/3f285f41fcaa4eee6ecd1afccccf555232b3a906		* https://github.com/php/php-src/commit/3f285f41fcaa4eee6ecd1afccccf555232b3a906
		+	* https://github.com/php/php-src/commit/bce6e73122972cd54a0a8ce2abeb48de425764cf

	===== References =====		===== References =====

deprecations_php_8_6 - Add commit link for SplFileObject CSV method deprecation

girgias (girgias@undisclosed.example.com) — 2026-08-25T10:11:30+00:00

2026/08/18 19:12		current
Line 42:		Line 42:
	* [[https://github.com/php/php-src/commit/6214a2165936af4c9d03f3ff083d0a2afd67a4d3\|Deprecate spl_classes()]]		* [[https://github.com/php/php-src/commit/6214a2165936af4c9d03f3ff083d0a2afd67a4d3\|Deprecate spl_classes()]]
	* [[https://github.com/php/php-src/commit/2c1c61de07953f901d95fd93e3ce79b50032e65c\|Deprecate spl_object_hash()]]		* [[https://github.com/php/php-src/commit/2c1c61de07953f901d95fd93e3ce79b50032e65c\|Deprecate spl_object_hash()]]
-	* Deprecate SplFileObject CSV methods	+	* [[https://github.com/php/php-src/commit/ac3ff655ea806994b6856893f0042e270755e2e0\|Deprecate SplFileObject CSV methods]]
	* [[https://github.com/php/php-src/commit/fd8706c64e2975116aae0bef6f129755b6d27dc5\|Deprecate mysqli_stmt_init]]		* [[https://github.com/php/php-src/commit/fd8706c64e2975116aae0bef6f129755b6d27dc5\|Deprecate mysqli_stmt_init]]
	* [[https://github.com/php/php-src/commit/d5ecbe1d93694497bd46483bdbb169f2ec8655b4\|Deprecate mysqli_get_charset()]]		* [[https://github.com/php/php-src/commit/d5ecbe1d93694497bd46483bdbb169f2ec8655b4\|Deprecate mysqli_get_charset()]]

rfc - pack/unpack RFC moved to "Implemented"

alexandredaubois (alexandredaubois@undisclosed.example.com) — 2026-08-25T07:11:12+00:00

2026/08/25 07:11		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:end_pear_endorsement\|End PEAR Project Endorsement]] (Created 2026-08-27)
	* [[rfc:throw_error_for_invalid_characters_for_number_base\|Throw ValueError for invalid characters in number base functions]] (Created 2026-08-11)		* [[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)

stream_errors - Move to implemented

ilutov (ilutov@undisclosed.example.com) — 2026-08-24T10:11:36+00:00

2026/05/20 21:25		current
Line 3:		Line 3:
	* Date: 2025-11-18		* Date: 2025-11-18
	* Author: Jakub Zelenka, bukka@php.net		* Author: Jakub Zelenka, bukka@php.net
-	* Status: Accepted	+	* Status: Implemented

	===== Introduction =====		===== Introduction =====

array_match - created

sepehrphp (sepehrphp@undisclosed.example.com) — 2026-08-21T23:18:04+00:00

2026/08/29 13:43	current
Line 1:	Line 1:
	+	====== PHP RFC: array_match ======
	+
	+	* Version: 0.1
	+	* Date: 2026-08-22
	+	* Author: Sepehr Mahmoudi, sepehrphpr@gmail.com
	+	* Status: Draft
	+	* Target Version: PHP 8.7
	+	* Implementation: In Progress (TBD)
	+
	+	===== Introduction =====
	+	Searching for a specific substring within an array of strings is a very common operation in PHP applications. Currently, developers must rely on ''array_filter()'' combined with a closure containing ''strpos()'' or ''str_contains()''. This approach, while functional, introduces significant overhead due to the execution of userland closures for every element in the array.
	+
	+	This RFC proposes the introduction of a new function, ''array_match()'', which performs this operation natively in C. This provides a simpler, more readable syntax and significantly improves performance by avoiding userland function call overhead.
	+
	+	===== Proposal =====
	+	Introduce a new standard library function ''array_match()''.
	+
	+	==== Function Signature ====
	+	<code php>
	+	function array_match(
	+	array $array,
	+	string $needle,
	+	bool $ignore_case = false
	+	): array {}
	+	</code>
	+
	+	==== Parameters ====
	+	* $array: The input array to be searched.
	+	* $needle: The substring to search for within the array values.
	+	* $ignore_case: If set to ''true'', the search will be case-insensitive (similar to ''stripos''). If ''false'' (default), the search is case-sensitive (similar to ''strpos'').
	+
	+	Note: The function preserves the original keys of the array in the returned result. Non-string values in the array are safely cast to strings during the evaluation, or can be skipped depending on the final internal implementation choice.
	+
	+	===== Use Cases =====
	+	The primary use cases for ''array_match()'' revolve around developer experience (DX) and performance:
	+
	+	* Log Filtering: Quickly extracting relevant log messages containing a specific error code or keyword from a large array of log lines.
	+	* File/Directory Searches: Filtering an array of filenames or paths by a specific extension or partial name (e.g., finding all ".php" files in a scanned directory array).
	+	* Data Processing: Searching through user inputs, database text dumps, or API responses where data is represented as an array of strings.
	+	* Performance Optimization: Replacing heavily iterated ''array_filter'' + closure combinations in performance-critical loops with a single, highly optimized native C function.
	+
	+	===== Examples =====
	+
	+	==== Example 1: Case-sensitive search ====
	+	<code php>
	+	$files = [
	+	'doc1.txt',
	+	'image.PNG',
	+	'script.php',
	+	'index.PHP',
	+	'readme.md'
	+	];
	+
	+	$result = array_match(
	+	$files,
	+	'.php'
	+	);
	+
	+	print_r($result);
	+	/* Output:
	+	Array
	+	(
	+	[2] => script.php
	+	)
	+	*/
	+	</code>
	+	In this example, the function searches for the exact string ''.php''. Since the ''$ignore_case'' parameter is ''false'' by default, it performs a case-sensitive search. It only matches ''script.php'' and ignores ''index.PHP''.
	+
	+	==== Example 2: Case-insensitive search ====
	+	<code php>
	+	$files = [
	+	'doc1.txt',
	+	'image.PNG',
	+	'script.php',
	+	'index.PHP',
	+	'readme.md'
	+	];
	+
	+	$result = array_match(
	+	$files,
	+	'.php',
	+	true
	+	);
	+
	+	print_r($result);
	+	/* Output:
	+	Array
	+	(
	+	[2] => script.php
	+	[3] => index.PHP
	+	)
	+	*/
	+	</code>
	+	By setting the ''$ignore_case'' parameter to ''true'', the function performs a case-insensitive search. It successfully matches both ''.php'' and ''.PHP'', returning both ''script.php'' and ''index.PHP'' while preserving their original array keys.
	+
	+	===== Polyfill / Userland Equivalent =====
	+	To demonstrate the exact behavior and to show how developers achieve this currently (without closure overhead), here is the userland equivalent using a ''foreach'' loop.
	+
	+	This polyfill highlights why a native implementation is beneficial: it removes the need for developers to write boilerplate loops for such a trivial and common task.
	+
	+	<code php>
	+	function array_match_polyfill(
	+	array $array,
	+	string $needle,
	+	bool $ignore_case = false
	+	): array {
	+	$result = [];
	+
	+	foreach ($array as $key => $value) {
	+	// Cast to string to ensure safe searching
	+	$stringValue = (string) $value;
	+
	+	if ($ignore_case) {
	+	if (stripos($stringValue, $needle) !== false) {
	+	$result[$key] = $value;
	+	}
	+	} else {
	+	if (strpos($stringValue, $needle) !== false) {
	+	$result[$key] = $value;
	+	}
	+	}
	+	}
	+
	+	return $result;
	+	}
	+	</code>

end_pear_endorsement - created

nicksdot (nicksdot@undisclosed.example.com) — 2026-08-21T15:35:55+00:00

2026/08/21 15:35		current
Line 1:		Line 1:
-	====== PHP RFC: End PEAR Project Endorsement======	+	====== PHP RFC: End PEAR Project Endorsement ======

-	* Version: 0.1	+	* Version: 0.9
-	* Date: 2026-06-24	+	* Date: 2026-08-27
	* Author: Nick Sdot, php@nicksdot.dev		* Author: Nick Sdot, php@nicksdot.dev
-	* Status: Draft	+	* Status: Discussion
-	* Implementation: https://github.com/NickSdot/pear; https://nicksdot.github.io/pear	+	* Implementation: https://github.com/NickSdot/pear; https://nicksdot.github.io/pear (PoC)
-	* Discussion thread: TBD	+	* Discussion thread: https://news-web.php.net/php.internals/132358
		+	* First Published at: https://wiki.php.net/rfc/end_pear_endorsement

	===== Introduction =====		===== Introduction =====
Line 66:		Line 67:

	<doodle		<doodle
-	title="Stop endorsing independent PEAR project?"	+	title="Stop endorsing PEAR?"
	voteType="single"		voteType="single"
	closed="true"		closed="true"
Line 86:		Line 87:
	===== Changelog =====		===== Changelog =====

		+	* 2026-08-27: Moved to discussion.
	* 2026-06-24: Initial.		* 2026-06-24: Initial.

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

2026/08/18 19:12		current
Line 42:		Line 42:
	* [[https://github.com/php/php-src/commit/6214a2165936af4c9d03f3ff083d0a2afd67a4d3\|Deprecate spl_classes()]]		* [[https://github.com/php/php-src/commit/6214a2165936af4c9d03f3ff083d0a2afd67a4d3\|Deprecate spl_classes()]]
	* [[https://github.com/php/php-src/commit/2c1c61de07953f901d95fd93e3ce79b50032e65c\|Deprecate spl_object_hash()]]		* [[https://github.com/php/php-src/commit/2c1c61de07953f901d95fd93e3ce79b50032e65c\|Deprecate spl_object_hash()]]
-	* Deprecate SplFileObject CSV methods	+	* [[https://github.com/php/php-src/commit/ac3ff655ea806994b6856893f0042e270755e2e0\|Deprecate SplFileObject CSV methods]]
	* [[https://github.com/php/php-src/commit/fd8706c64e2975116aae0bef6f129755b6d27dc5\|Deprecate mysqli_stmt_init]]		* [[https://github.com/php/php-src/commit/fd8706c64e2975116aae0bef6f129755b6d27dc5\|Deprecate mysqli_stmt_init]]
	* [[https://github.com/php/php-src/commit/d5ecbe1d93694497bd46483bdbb169f2ec8655b4\|Deprecate mysqli_get_charset()]]		* [[https://github.com/php/php-src/commit/d5ecbe1d93694497bd46483bdbb169f2ec8655b4\|Deprecate mysqli_get_charset()]]