PHP preg_replace(): 정규식 치환과 역참조

preg_replace($pattern, $replacement, $subject)는 문자열에서 정규 표현식의 모든 일치를 찾아 바꿉니다. preg_replace('/\s+/', ' ', $text)는 연속된 공백, 탭, 줄바꿈을 모두 공백 하나로 바꿉니다.

<?php
$text = "Too    many \t spaces\n\nand   lines";
echo preg_replace('/\s+/', ' ', $text), "\n";

// Remove every digit
echo preg_replace('/\d/', '', 'R2-D2 and C-3PO'), "\n";

// Case-insensitive, whole words only
echo preg_replace('/\bcat\b/i', 'dog', 'Cat, cats and a CAT.'), "\n";

원래 문자열은 바뀌지 않으며, preg_replace()는 새 문자열을 반환합니다. \b는 단어 경계를 나타내므로 cats는 그대로 남습니다.

역참조: $1,${1}, \1

치환 문자열에서 $1은 첫 번째 캡처 그룹이 일치한 것을, $2는 두 번째를, $0은 전체 일치를 뜻합니다. 일치한 텍스트를 재배열할 때 쓰세요.

<?php
// 2026-03-14 to 14/03/2026
echo preg_replace('/(\d{4})-(\d{2})-(\d{2})/', '$3/$2/$1', 'Due: 2026-03-14'), "\n";

// "Lovelace, Ada" to "Ada Lovelace"
echo preg_replace('/^(\w+), (\w+)$/', '$2 $1', 'Lovelace, Ada'), "\n";

// $0 is the whole match: wrap every number in brackets
echo preg_replace('/\d+/', '[$0]', 'Rooms 12 and 305'), "\n";

// ${1} when a digit follows the reference
echo preg_replace('/(\d+)/', '${1}0', 'Multiply 5 and 7 by ten'), "\n";

치환 문자열은 작은따옴표로 쓰세요. 큰따옴표 안에서 "\1"은 8진 이스케이프(바이트 0x01)가 되고, "${1}"은 정의되지 않은 1이라는 변수로 읽히며 PHP 8.2부터 폐지 예정인 문자열 문법을 씁니다. 작은따옴표 안의 '\1'은 '$1'과 똑같이 동작하지만, 일반적인 표기는 $1입니다.

영숫자가 아닌 문자 제거하기

부정 문자 클래스 [^...]는 나열되지 않은 모든 것과 일치합니다. 이를 ''로 바꾸면 제거됩니다. 다른 언어의 텍스트에는 u 수식어와 함께 유니코드 클래스 \p{L}(모든 문자)과 \p{N}(모든 숫자)을 쓰세요. 그렇지 않으면 é, ü와 모든 일본어 문자가 지워집니다.

<?php
$s = 'Héllo, wörld! 日本語 #2026';

echo preg_replace('/[^a-zA-Z0-9]/', '', $s), "\n";           // ASCII only
echo preg_replace('/[^a-zA-Z0-9 ]/', '', $s), "\n";          // keep spaces
echo preg_replace('/[^\p{L}\p{N}]/u', '', $s), "\n";         // any language
echo preg_replace('/[^\p{L}\p{N}\s]/u', '', $s), "\n";       // and spaces

// Digits only, for a phone number typed with spaces and dashes
echo preg_replace('/\D/', '', '+1 (555) 123-4567'), "\n";

URL 슬러그 만들기

패턴 여러 개를 이어 쓰면 제목이 URL 슬러그가 됩니다. 먼저 소문자로 바꾸고, 영숫자가 아닌 문자의 연속을 하이픈 하나로 바꾼 다음, 양 끝의 하이픈을 제거하세요.

<?php
function slugify(string $title): string
{
    $slug = mb_strtolower($title);
    $slug = preg_replace('/[^\p{L}\p{N}]+/u', '-', $slug);
    return trim($slug, '-');
}

echo slugify('PHP preg_replace(): A Quick Guide!'), "\n";
echo slugify('  10 Tips & Tricks for 2026  '), "\n";
echo slugify('Café au lait'), "\n";

여러 패턴, limit과 count

$pattern과 $replacement는 배열일 수 있습니다. 각 패턴이 같은 인덱스의 치환값으로 차례로 바뀝니다. 네 번째 인수는 패턴당 치환 횟수를 제한하고(-1은 제한 없음), 다섯 번째 인수는 치환한 횟수를 받습니다.

<?php
$text = 'Call 555-1234 or email me at ana@example.com';

$patterns = ['/\d{3}-\d{4}/', '/\S+@\S+/'];
$replacements = ['[phone]', '[email]'];
echo preg_replace($patterns, $replacements, $text), "\n";

// Only the first match
echo preg_replace('/\d+/', '#', 'a1 b2 c3', 1), "\n";

// Count the replacements
$clean = preg_replace('/\s{2,}/', ' ', 'a  b   c d', -1, $count);
echo "$clean ($count replacements)\n";

preg_replace_callback으로 치환값 계산하기

치환값이 일치한 내용에 따라 달라진다면 preg_replace_callback()을 쓰세요. 일치마다 $matches 배열과 함께 함수를 한 번 호출하고, 함수가 반환한 것을 삽입합니다. 짧은 콜백은 화살표 함수로 한 줄에 쓸 수 있습니다.

<?php
// Add 10% tax to every price
$menu = 'Coffee $3.50, Cake $4.00, Tea $2.80';
echo preg_replace_callback(
    '/\$(\d+\.\d{2})/',
    fn($m) => '$' . number_format($m[1] * 1.10, 2),
    $menu
), "\n";

// snake_case to camelCase
echo preg_replace_callback('/_([a-z])/', fn($m) => strtoupper($m[1]), 'user_first_name'), "\n";

// Fill {placeholders} from an array, leave unknown ones alone
$vars = ['name' => 'Ada', 'count' => 3];
$template = 'Hi {name}, you have {count} messages. {unknown}';
echo preg_replace_callback(
    '/\{(?<key>\w+)\}/',
    fn($m) => $vars[$m['key']] ?? $m[0],
    $template
), "\n";

여러 패턴에 각각 다른 함수가 필요하다면 preg_replace_callback_array()가 pattern => callback 쌍의 배열을 받습니다.

변수에서 온 치환 텍스트

치환 문자열의 $나 백슬래시는 의미가 있으므로, 사용자나 데이터베이스에서 온 치환값이 망가질 수 있습니다. $10이라는 가격은 존재하지 않는 10번 그룹의 참조로 읽혀 빈 값이 됩니다.

<?php
$price = '$10';

// Wrong: "$10" is read as backreference 10
echo preg_replace('/PRICE/', $price, 'Only PRICE today'), "\n";

// Right: the callback's return value is used as is
echo preg_replace_callback('/PRICE/', fn() => $price, 'Only PRICE today'), "\n";

// Or, for fixed text, no regex at all
echo str_replace('PRICE', $price, 'Only PRICE today'), "\n";

찾는 텍스트도 치환값도 패턴이 아니라면 str_replace()가 더 간단하고 빠른 선택입니다. 아무것도 바꾸기 전에 패턴을 시험하려면 preg_match()를 참고하세요.