preg_replace() 함수의 사용법

preg_replace() 함수는
문자열 내에서 정규 표현식을 사용하여 특정 패턴을 찾아 다른 문자열로 바꾸는(대체하는) 함수입니다.

PHP 
$input = '안녕하세요, PHP!';
$pattern = '/안녕하세요/';  // '안녕하세요'를 찾는 정규 표현식
$replacement = '안녕';    // '안녕하세요'를 '안녕'으로 대체

$output = preg_replace($pattern, $replacement, $input);

echo "Original input: $input";  // 출력: "Original input: 안녕하세요, PHP!"
echo "Output: $output";          // 출력: "Output: 안녕, PHP!"

패턴이 아닌 정확한 문자열을 일치시키려면 이 함수 대신 str_replace() 함수를 사용하는 것이 좋습니다.

PHP str_replace() 함수 살펴보기

문자열 내에서 정규 표현식 패턴을 사용하여 일치하는 부분을 찾으려면 preg_match() 함수를 사용하세요.

PHP preg_match() 함수 살펴보기

preg_replace() 함수의 형식은 다음과 같습니다.

구문

PHP 
preg_replace(
    string|array $pattern,
    string|array $replacement,
    string|array $subject,
    int $limit = -1,
    int &$count = null
): string|array|null

// preg_replace(정규 표현식 패턴, 바꿀 문자열, 대상 문자열[, 대체 작업의 최대 횟수[, 카운트]]);

매개변수

preg_replace() 함수의 매개변수 설명
$pattern 필수. 정규 표현식 또는 패턴을 지정합니다.
문자열이거나 문자열이 있는 배열일 수 있습니다.
$replacement 필수. 찾은 패턴을 대체할 새로운 문자열 또는 문자열 배열을 지정합니다.
$subject 필수. 대상이 되는 문자열 또는 문자열 배열을 지정합니다.
여기에서 패턴을 찾아 대체 작업을 수행합니다.
$limit 옵션. 대체 작업의 최대 횟수를 지정합니다.
기본 값은 -1이며, 이 경우 모든 일치하는 부분이 대체됩니다.
$count 옵션. 대체 작업의 횟수를 저장하는 변수입니다.
기본 값은 null입니다. preg_replace() 함수가 호출될 때, 이 변수에 대체 작업 횟수가 저장됩니다. 참조 변수입니다.

반환 값

preg_replace() 함수의 반환 값은 대체 작업이 수행된 후의 문자열 또는 문자열 배열입니다. 이 함수는 입력된 대상 문자열에서 정규 표현식과 일치하는 부분을 찾아서 대체된 새로운 문자열 또는 배열을 생성하여 반환합니다.

예시 사용법

PHP 
$original_string = 'Hello, world! Hello, PHP! Hello, universe!';
$pattern = '/Hello/';
$replacement = 'Hi';

$new_string = preg_replace($pattern, $replacement, $original_string);

echo $new_string;  // 출력: 'Hi, world! Hi, PHP! Hi, universe!'

위의 예제에서 preg_replace() 함수는 "Hello"를 "Hi"로 대체하여 새로운 문자열을 생성하고, 이 새로운 문자열이 $new_string 변수에 저장됩니다. 이후 echo $new_string;을 사용하여 새로운 문자열을 출력합니다.

따라서, preg_replace() 함수를 호출한 결과인 $new_string은 대체된 문자열을 가지고 있는 새로운 문자열을 나타냅니다.

preg_replace() 함수에 배열을 이용해서 여러 개의 문자열을 대체하는 사례

PHP 
$original_string = 'Apples are red. Bananas are yellow. Apples and bananas are delicious.';
$search = ['/Apples/', '/Bananas/'];  // 정규 표현식을 배열로 지정
$replace = ['Oranges', 'Grapes'];     // 대체할 문자열을 배열로 지정

$new_string = preg_replace($search, $replace, $original_string);

echo $new_string;
// 출력: 'Oranges are red. Grapes are yellow. Oranges and bananas are delicious.'

이 예제에서는 "Apples"와 "Bananas"를 각각 "Oranges"와 "Grapes"로 대체하는 작업을 preg_replace() 함수를 사용하여 수행하였습니다. 결과적으로 "Apples"와 "Bananas"가 각각 "Oranges"와 "Grapes"로 바뀐 새로운 문자열을 확인할 수 있습니다.

$count 파라미터를 사용한 유용한 사례

$count 파라미터를 사용한 유용한 preg_replace() 함수의 예제 중 하나는 특정 패턴이나 문자열이 몇 번 나타나는지를 세는 것입니다. 이를 통해 문자열 내에서 특정 패턴의 반복 횟수를 파악할 수 있습니다.

예를 들어, 문자열 내에서 "PHP"가 몇 번 나타나는지 세어보고 싶다고 가정해보겠습니다.

PHP 
$original_string = 'PHP is a popular scripting language. PHP stands for PHP: Hypertext Preprocessor.';
$pattern = '/PHP/';
$replacement = 'PHP';

$count = 0;  // 대체 횟수를 저장할 변수 초기화

$new_string = preg_replace($pattern, $replacement, $original_string, -1, $count);

echo $new_string; // 출력: 'PHP is a popular scripting language.'
echo "The word 'PHP' appeared {$count} times.";
// 출력: "The word 'PHP' appeared 3 times."

위의 예제에서 $pattern 변수로 찾을 패턴 "PHP"를 지정하였습니다. preg_replace() 함수를 실행하면서 $count 변수도 함께 제공하였기 때문에, 대체 작업이 몇 번 이루어졌는지를 나타내는 $count 변수에 값이 저장됩니다.

따라서, "PHP"가 원래 문자열에서 3번 나타나므로 $count 값은 3이 되며, 이를 활용하여 해당 패턴의 반복 횟수를 확인할 수 있습니다.

참고문헌

같이 보기