알짜게시판

다국어 웹사이트를 구축할 때, 언어에 따라 텍스트를 자동으로 변환하는 기능은 필수적이다.
이 글에서는 PHP로 간결하고 확장 가능한 다국어 번역 함수를 구현하는 방법을 소개한다.

기본 구조

아래는 예시로 작성된 번역 함수이다.

function __($str)
{
    global $meta;

    $translations = [
        '전체 카테고리' => [
            'en' => 'All Categories',
            'ja' => '全体カテゴリー',
            'zh' => '所有类别',
        ],
        '홈' => [
            'en' => 'Home',
            'ja' => 'ホーム',
            'zh' => '首页',
        ],
    ];

    $lang = $meta['lang'] ?? 'ko';

    if ($lang === 'ko') return $str;

    return $translations[$str][$lang] ?? $str;
}

이 함수는 $meta['lang'] 값에 따라 주어진 문자열 $str을 해당 언어로 변환한다.
기본 언어는 한글이며, 다른 언어로 변환이 지정되어 있지 않은 경우에는 원문을 그대로 반환한다.

$translations 배열

이 배열은 한글을 기준으로 한 번역 테이블이다.
각 한글 키에 대해 'en', 'ja', 'zh' 등 언어 코드를 지정하고 해당 번역 문자열을 매핑한다.

예를 들어 '전체 카테고리'라는 한글 문구가 있을 때, 영어에서는 "All Categories",
일본어에서는 "全体カテゴリー", 중국어에서는 "所有类别"로 변환된다.

언어를 추가할 때는 이 배열에 새로운 언어 코드와 번역을 추가하기만 하면 된다.

$meta['lang'] 설정

글로벌 변수 $meta에서 현재 페이지의 언어 설정을 가져온다.
만약 설정이 존재하지 않는다면 'ko'를 기본값으로 사용한다.

이 값은 보통 페이지 상단의 설정 파일에서 지정되며,
사용자의 선택 언어나 사이트 환경설정에 따라 동적으로 변경된다.

한국어 처리 분기

if ($lang === 'ko') return $str;

현재 언어가 한국어일 경우, 별도의 번역이 필요하지 않으므로 원문을 그대로 반환한다.
이 조건문은 빠른 종료(early return) 구조로 작성되어 불필요한 연산을 줄인다.

번역 반환 로직

return $translations[$str][$lang] ?? $str;

?? 연산자는 PHP의 null 병합 연산자이다.
해당 번역이 존재하면 그 값을 반환하고, 존재하지 않으면 $str을 그대로 반환한다.

이 구조는 키가 존재하지 않을 때 발생할 수 있는 오류를 예방하며,
불필요한 조건문을 줄여 코드 가독성을 높인다.

언어 확장 방법

언어를 추가하려면 $translations 배열에 새로운 언어 코드를 추가한다.
예를 들어 프랑스어를 지원하려면 다음과 같이 작성한다.

'홈' => [
    'en' => 'Home',
    'ja' => 'ホーム',
    'zh' => '首页',
    'fr' => 'Accueil',
],

이 방식은 다국어 확장이 용이하며, 유지보수 시에도 구조를 한눈에 파악할 수 있다.

마무리

이 함수는 구조가 단순하고 동작이 명확하다.
한글을 기준으로 각 언어의 번역을 관리하기 때문에 별도의 데이터베이스나 파일 구조가 필요하지 않다.

사이트 내에서 반복적으로 사용되는 단어를 일관된 형태로 처리하기에 적합하며,
규모가 커질 경우 $translations를 별도의 파일로 분리하거나 캐시 시스템과 연동하여 효율적으로 관리할 수 있다.