PHP

애플리케이션 코드를 실행하지 않고 정적 PHP 로캘 배열의 문자열 리터럴을 번역합니다.

PHP 애플리케이션은 배열을 반환하는 파일에서 메시지를 불러오는 경우가 많습니다. php 파일 핸들러는 이 배열의 문자열 리터럴 값을 번역하고, 조회 키와 주석, 숫자, 주변 구문은 그대로 유지합니다. PHP를 실행하지 않고 파일을 스캔합니다.

지원하는 소스 형식 #

예를 들면 다음과 같습니다.

php
<?php
return [
    'checkout' => [
        'title' => 'Complete your order',
        'delivery' => 'Delivery within :days days',
    ],
];

텍스트 경로는 checkout.title와 checkout.delivery입니다. 대괄호로 작성한 중첩 배열과 array(...) 구문을 지원합니다. 문자열 키는 그대로 유지되므로 애플리케이션에서 동일한 식별자로 계속 조회할 수 있습니다.

메시지 값은 정적 배열에 넣어 두세요. 문자열 연결, 함수 호출, 변수에서 파생된 문자열은 평가가 필요하지만, 이 스캐너는 평가를 수행하지 않습니다. 표현식 근처에서 발견된 리터럴은 해당 표현식의 계산 결과가 아닙니다. 파일 번역으로 이런 메시지를 선택하려면 먼저 리터럴 형태의 리소스 값으로 옮기세요.

따옴표 처리와 기존 대상 값 #

핸들러는 각 소스 문자열을 감싼 작은따옴표나 큰따옴표를 유지하고, 대체 값을 해당 구분자에 맞게 이스케이프 처리합니다. 큰따옴표로 묶인 출력에서는 {$name}처럼 소스에 이미 있는 보간 토큰을 유지하고, 새로 추가된 달러 기호 시퀀스는 이스케이프 처리합니다. :days 같은 애플리케이션 플레이스홀더는 호출자가 제공하는 값을 넣어 확인하세요.

증분 비교에는 반환된 배열 내 각 리터럴의 경로를 사용합니다. 소스 메시지가 바뀌지 않았다면 승인된 대상 값을 유지할 수 있습니다. 영어 문구가 같더라도 키를 바꾸면 비교에 사용하는 식별자가 달라집니다. CLI의 키 제어 기능으로 PHP 파일의 소스 값을 잠그고, 대상 값을 유지하고, 무시된 항목을 제거할 수 있습니다.

키 단위로 재구성하는 과정에서 대상 값이 없는 미해결 연관 배열 항목이 제거될 수 있습니다. 일부만 실행한 결과를 완전한 로캘 파일로 간주하지 마세요. 중첩 구조와 애플리케이션에서 요구하는 위치 기반 값을 검토하세요.

파일 설정 및 유효성 검사 #

CLI는 .php에서 php를 추론합니다. CLI 설정 또는 GitHub를 사용해 소스 로캘 파일과 대상 위치를 선택하세요.

대상 파일에 php -l를 실행한 다음, 애플리케이션에서 해당 메시지를 불러오세요. 매개변수가 있는 문구는 호출자가 제공하는 값을 넣어 렌더링하세요. Laravel에서는 요청 로캘 선택과 대체 로캘 처리를 여전히 애플리케이션에서 설정해야 합니다. 웹 앱 현지화에서는 번역된 리소스를 이러한 단계에 연결하는 방법을 안내합니다.