정의 및 사용 방법

PHP 버전
7.4+

mb_str_split() 함수는
한글과 같은 multi-byte 문자열을 원하는 일정한 길이의 부분 문자열로 분할하여 배열로 변환하는 함수입니다.

반환 값은 분할된 부분 문자열을 담은 배열입니다.

str_split() 함수와 거의 동일한 기능을 하지만, 한글과 같은 multi-byte 문자열에서 안전하게 작동하는 기능을 제공한다는 큰 차이점이 있습니다.

영어, 숫자 등은 1 byte이지만, 한글이나 일본어, 중국어 등은 2 byte 이상입니다. 2 byte 이상의 바이트로 표현되는 것을 "multi-byte(멀티바이트)"라고 합니다.

PHP 7.4에서 도입된 함수로 PHP 7.4 이전의 버전에서는 호환되지 않습니다.

기본 예제

PHP 
$str = '반갑습니다!';

/* 문자열의 길이를 1만큼으로 분할하는 예
   str_split()과 mb_str_split()의 차이점 */

$arr1 = str_split($str, 1); // 한글 지원하지 않음(길이의 크기는 1 byte 기준입니다.)
print_r($arr1);
// Array ( [0] => � [1] => � [2] => � [3] => � [4] => � [5] => � [6] => � [7] => � [8] => � [9] => � [10] => � [11] => � [12] => � [13] => � [14] => � [15] => ! )

$arr2 = mb_str_split($str, 1, 'UTF-8'); // 한글과 같은 multi-byte 문자열을 지원(길이의 크기는 문자 단위 기준입니다.)
print_r($arr2);
// Array ( [0] => 반 [1] => 갑 [2] => 습 [3] => 니 [4] => 다 [5] => ! )

구문

PHP 
mb_str_split(string $string, int $length = 1, ?string $encoding = null): array

매개변수

mb_str_split() 함수의 매개변수
$string 필수. 분할할 대상 문자열입니다.
$length 옵션. 각 부분 문자열의 길이를 지정하는 매개변수입니다. 이 매개변수를 사용하지 않으면 기본값으로 각 문자를 하나의 요소로 하는 배열이 생성됩니다.
$encoding 옵션. 문자열의 인코딩을 지정합니다.
기본값은 null이며, 생략하거나 null을 전달하면 내부 문자 인코딩 값이 사용됩니다.
  • 내부 문자 인코딩이 표준 인코딩인 'UTF-8'일 경우에는 별도로 지정하지 않아도 됩니다.
  • 내부 인코딩이 다른 값이라면, 일관된 처리 결과를 위해 표준 인코딩인 'UTF-8'을 명시적으로 지정하세요.

반환 값

매개변수로 전달된 $length 길이의 부분 문자열로 분할하여 배열로 변환해서 반환합니다.

이때 길이의 크기는 문자 단위 기준입니다.

변경 이력

mb_str_split() 함수의 변경 이력
버전설명
8.0.0 PHP 8.0.0부터 $encoding 매개변수가 이제 nullable하게 변경되었습니다. 이것은 이제 encoding 매개변수를 생략하거나 null로 설정할 수 있음을 의미합니다. 이전에는 반드시 유효한 인코딩을 지정해야 했었습니다.
8.0.0 PHP 8.0.0부터 함수가 실패할 경우 더 이상 false를 반환하지 않습니다. 이전에는 함수가 실패할 때 false를 반환했지만, 이제는 실패한 경우에도 반환 값이 false가 아닙니다. 대신에 함수는 항상 배열을 반환하게 됩니다. 실패한 경우에는 빈 배열이 반환됩니다.

활용 예제

mb_str_split() 함수는 문자열을 부분 문자열로 쉽게 분할할 수 있기 때문에 여러 가지 유용한 상황에서 활용할 수 있습니다.
몇 가지 예제를 살펴보겠습니다.

문자열을 역순으로 출력하기

문자열을 역순으로 출력하려면 mb_str_split() 함수를 사용하여 문자열을 배열로 분할한 다음, array_reverse() 함수를 사용하여 배열을 역순으로 변경할 수 있습니다.

역순으로 바뀐 배열은 다시 implode() 함수를 사용해서 배열을 문자열로 변환합니다.

PHP 
$str = '환영합니다';
$array = mb_str_split($str, 1, 'UTF-8');
$reversed_array = array_reverse($array);
$reversed_string = implode('', $reversed_array);

echo $reversed_string; // 출력: '다니합영환'

코드 부연설명
array_reverse() 함수는 주어진 배열의 요소 순서를 역순(reverse)으로 반환합니다.

코드 부연설명
implode() 함수는 배열의 요소들을 하나의 문자열로 합치는(변환하는) 함수입니다.

주민등록번호 등에서 일부 정보 숨기기

주민등록번호 등의 민감한 정보에서 특정 부분을 숨기려면 mb_str_split() 함수를 사용하여 문자열을 분할한 다음 일부를 수정할 수 있습니다.

PHP 
$personal_id = '123456-1234567';
$array = mb_str_split($personal_id, 1, 'UTF-8');
$array_length = count($array);

// 뒷 자리 7자리를 *로 대체
for ($i = 7; $i < $array_length; $i++) {
    $array[$i] = '*';
}

$masked_id = implode('', $array);
echo $masked_id; // 출력: '123456-*******'

코드 부연설명
for 문은 특정 횟수나 범위만큼 반복하는 반복문입니다.

위의 예제들은 mb_str_split() 함수를 사용하여 문자열을 쉽게 다룰 수 있는 방법을 보여줍니다.
이 함수는 문자열을 부분 문자열로 나누는 데 유용하며, 이를 통해 문자열을 다양한 방식으로 가공할 수 있습니다.

참고문헌

같이 보기