Skip to content

다국어 지원 ​

소개 ​

Administrator는 Laravel의 다국어 지원 기능을 그대로 사용합니다. 패키지 내부 번역 파일은 src/lang/{locale}/administrator.php와 src/lang/{locale}/frontend.php에 있으며, 애플리케이션의 기본 로케일과 Administrator 전역 설정의 locales 옵션에 따라 화면 언어가 결정됩니다.

기본 로케일 ​

Laravel 애플리케이션의 기본 언어는 config/app.php에서 설정합니다.

php
return array(
    'locale' => 'ko',
);

Laravel 10에서는 환경별로 관리하려면 .env와 config 값을 연결해 사용할 수 있습니다.

dotenv
APP_LOCALE=ko

관리자 언어 선택 ​

관리자 화면 우측 상단에서 언어를 선택하게 하려면 config/administrator.php의 locales에 사용할 언어를 등록합니다.

php
return array(
    'locales' => array('ko', 'en', 'ja'),
);

locales가 비어 있으면 별도 언어 선택 메뉴를 표시하지 않습니다.

설정 파일에서 번역 사용 ​

전역 설정, 모델 설정, 세팅 설정 파일에서는 Laravel 번역 함수를 그대로 사용할 수 있습니다.

php
return array(
    'title' => __('admin.users.title'),
    'single' => __('admin.users.single'),
    'model' => App\Models\User::class,
    'columns' => array(
        'name' => array(
            'title' => __('admin.users.name'),
        ),
    ),
    'edit_fields' => array(
        'name' => array(
            'title' => __('admin.users.name'),
            'type' => 'text',
        ),
    ),
);

애플리케이션 번역 파일은 Laravel 표준 위치인 lang/{locale} 또는 resources/lang/{locale} 구조를 사용하십시오. 실제 위치는 프로젝트의 Laravel 버전과 설정에 따릅니다.

지원 언어 ​

현재 패키지에 포함된 언어 디렉터리는 다음과 같습니다.

text
ar az bg ca da de en es eu fi fr hr hu it ja nb nl pl pt pt-BR ro ru se si sk sr tr uk vi zh-CN zh-TW

언어 추가 ​

새 언어를 추가하려면 src/lang/{locale}/administrator.php와 src/lang/{locale}/frontend.php를 함께 추가합니다. 기존 src/lang/en 파일을 복사해 번역하면 구조를 맞추기 쉽습니다.

text
src/lang/ko/
  administrator.php
  frontend.php

번역 개선은 GitHub 이슈 또는 Pull Request로 제안할 수 있습니다. 기여 절차는 기여하기 문서를 참고하십시오.

Released under the MIT License.