|string $search * @param array|string $replace * @param array|string $subject * @return array|string|false */ public static function mbReplace( array | string $search, array | string $replace, array | string $subject, int &$count = 0, ): array | string | false { if (is_array($subject)) { return self::mbReplaceInArraySubject($search, $replace, $subject, $count); } return self::mbReplaceScalar($search, $replace, $subject, $count); } /** * Dispatch for scalar subject. * Returns false when $replace is array but $search is a scalar string. * * @param array|string $search * @param array|string $replace */ private static function mbReplaceScalar( array | string $search, array | string $replace, string $subject, int &$count = 0, ): string | false { if (! is_array($search) && is_array($replace)) { return false; } if (is_array($search)) { return self::mbReplaceWithSearchArray($search, $replace, $subject, $count); } if (! is_string($replace)) { throw new \InvalidArgumentException('Replace must be a string when search is a string.'); } return self::mbReplaceSingle($search, $replace, $subject, $count); } /** * @param string[]|string $search * @param string[]|string $replace * @param array $subject * @return array */ public static function mbReplaceInArraySubject(array | string $search, array | string $replace, array $subject, int &$count = 0): array { foreach ($subject as &$value) { if (is_array($value)) { $value = self::mbReplaceInArraySubject($search, $replace, $value, $count); } elseif (is_array($search) && is_string($value)) { $value = self::mbReplaceWithSearchArray($search, $replace, $value, $count); } elseif (! is_array($replace) && is_string($value)) { $value = self::mbReplaceSingle($search, $replace, $value, $count); } } unset($value); return $subject; } /** * @param string[] $search * @param array|string $replace */ public static function mbReplaceWithSearchArray(array $search, array | string $replace, string $subject, int &$count = 0): string { if (! is_array($replace)) { foreach ($search as $searchItem) { $subject = (string) self::mbReplaceSingle($searchItem, $replace, $subject, $count); } return $subject; } $iterations = max(count($search), count($replace)); $searchItem = reset($search); $replaceItem = reset($replace); while ($iterations--) { $subject = (string) self::mbReplaceSingle((string) $searchItem, (string) $replaceItem, $subject, $count); $searchItem = next($search); $replaceItem = next($replace); } return $subject; } public static function mbReplaceSingle(string $search, string $replace, string $subject, int &$count = 0): string { $parts = mb_split(preg_quote($search), $subject) ?: []; $count = count($parts) - 1; return implode($replace, $parts); } }