Skip to content

다국어 지원

소개

Administrator는 Laravel의 다국어 지원 기능을 그대로 사용합니다. 패키지 내부 번역 파일은 src/lang/{locale}/administrator.phpsrc/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.phplocales에 사용할 언어를 등록합니다.

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.phpsrc/lang/{locale}/frontend.php를 함께 추가합니다. 기존 src/lang/en 파일을 복사해 번역하면 구조를 맞추기 쉽습니다.

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

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

Released under the MIT License.