Ver3.0 ๐ PHP ๋ค๊ตญ์ด ์ง์๊ณผ gettext๋ฅผ ํ์ฉํ ๊ตญ์ ํ ๊ตฌํ

๐ PHP ๋ค๊ตญ์ด ์ง์๊ณผ gettext๋ฅผ ํ์ฉํ ๊ตญ์ ํ ๊ตฌํ
์ ์ธ๊ณ ์ฌ์ฉ์๋ฅผ ์ํ ์น ์ ํ๋ฆฌ์ผ์ด์ ๋ง๋ค๊ธฐ ๐
๐ฏ ์ ๋ค๊ตญ์ด ์ง์์ด ํ์ํ ๊น?
์ผ, ๋ ํน์ ์น์ฌ์ดํธ ๋ง๋ค๋ค๊ฐ "์ด๊ฑฐ ์์ด๋ก๋ ๋ณด์ฌ์ค์ผ ํ๋๋ฐ..."๋ผ๋ ์๊ฐ ํด๋ณธ ์ ์์ด? ๐
์์ฆ ์ธ์์ ์น ์ ํ๋ฆฌ์ผ์ด์
ํ๋ ๋ง๋ค๋ฉด ์ ์ธ๊ณ ์ฌ๋๋ค์ด ๋ค ๋ณผ ์ ์์์? ๊ทธ๋ฐ๋ฐ ํ๊ตญ์ด๋ก๋ง ๋์ด ์์ผ๋ฉด ์ธ๊ตญ์ธ๋ค์ ๋ญ ์๋ฆฐ์ง ํ๋๋ ๋ชจ๋ฅด๊ฒ ์ง.
์ค์ ๋ก ๊ธ๋ก๋ฒ ์์ฅ์ ํ๊ฒ์ผ๋ก ํ๋ ์๋น์ค๋ผ๋ฉด ๋ค๊ตญ์ด ์ง์์ ์ ํ์ด ์๋๋ผ ํ์์ผ. ์๋ง์กด, ๋ทํ๋ฆญ์ค, ์์ด๋น์ค๋น ๊ฐ์ ์๋น์ค๋ค ๋ณด๋ฉด ๋ค ์ฌ๋ฌ ์ธ์ด๋ฅผ ์ง์ํ์์? ๊ทธ๊ฒ ๋ฐ๋ก ๊ตญ์ ํ(Internationalization, ์ค์ฌ์ i18n)์ ํ์ด์ผ! ๐
๊ทธ๋ฐ๋ฐ ๋ค๊ตญ์ด ์ง์์ ์ด๋ป๊ฒ ๊ตฌํํ ๊น? ๐ค
๊ฐ์ฅ ๋จ์ํ๊ฒ ์๊ฐํ๋ฉด ์ด๋ ๊ฒ ํ ์ ์์ด:
<?php
if ($language == 'ko') {
echo "์๋
ํ์ธ์";
} elseif ($language == 'en') {
echo "Hello";
} elseif ($language == 'ja') {
echo "ใใใซใกใฏ";
}
?>
๊ทผ๋ฐ ์ด๋ ๊ฒ ํ๋ฉด... ์ง์ง ๋ฏธ์น๋ ๊ฑฐ์ผ ๐ฑ
์น์ฌ์ดํธ์ ํ
์คํธ๊ฐ ์๋ฐฑ, ์์ฒ ๊ฐ์ธ๋ฐ ์ด๊ฑธ ๋ค if๋ฌธ์ผ๋ก ์ฒ๋ฆฌํ๋ค๊ณ ? ์ฝ๋๊ฐ ์์ ์คํ๊ฒํฐ๊ฐ ๋๊ฒ ์ง. ์ ์ง๋ณด์๋ ์ง์ฅ์ด๊ณ .
๊ทธ๋์ ๋ฑ์ฅํ ๊ฒ ๋ฐ๋ก gettext๋ผ๋ ์น๊ตฌ์ผ! ๐
๐ gettext๊ฐ ๋ญ๋ฐ?
gettext๋ GNU ํ๋ก์ ํธ์์ ๋ง๋ ๊ตญ์ ํ ๋ฐ ์ง์ญํ ์์คํ
์ด์ผ.
์ฝ๊ฒ ๋งํ๋ฉด, ํ๋ก๊ทธ๋จ ์ฝ๋์ ๋ฒ์ญ ํ
์คํธ๋ฅผ ์์ ํ ๋ถ๋ฆฌํด์ ๊ด๋ฆฌํ ์ ์๊ฒ ํด์ฃผ๋ ๋๊ตฌ์ง.
gettext์ ํต์ฌ ๊ฐ๋
์ ์ด๊ฑฐ์ผ:
2๏ธโฃ ๋ฒ์ญ์ด ํ์ํ ํ ์คํธ๋ฅผ ํน๋ณํ ํจ์๋ก ๊ฐ์ธ๊ธฐ
3๏ธโฃ ๋ฒ์ญ ํ์ผ(.po)์ ๊ฐ ์ธ์ด๋ณ ๋ฒ์ญ์ ์ ์ฅ
4๏ธโฃ ์คํ ์์ ์ ์ฌ์ฉ์ ์ธ์ด์ ๋ง๋ ๋ฒ์ญ์ ์๋์ผ๋ก ๋ถ๋ฌ์ค๊ธฐ
์๋ฅผ ๋ค์ด๋ณผ๊ฒ. ์ฝ๋๋ ์ด๋ ๊ฒ ์์ฑํ๋ ๊ฑฐ์ผ:
<?php
echo _("Welcome to our website!");
?>
๊ทธ๋ผ ํ๊ตญ์ด ์ฌ์ฉ์์๊ฒ๋ "์ฐ๋ฆฌ ์น์ฌ์ดํธ์ ์ค์ ๊ฒ์ ํ์ํฉ๋๋ค!"๋ก ๋ณด์ด๊ณ ,
์ผ๋ณธ์ด ์ฌ์ฉ์์๊ฒ๋ "็งใใกใฎใฆใงใใตใคใใธใใใใ!"๋ก ๋ณด์ด๋ ๊ฑฐ์ง.
์ฝ๋๋ ํ๋์ธ๋ฐ ์ธ์ด๋ง ๋ฐ๋๋ ๋ง๋ฒ! โจ
| ์ฅ์ | ์ค๋ช |
|---|---|
| ์ฝ๋ ๋ถ๋ฆฌ | ํ๋ก๊ทธ๋จ ๋ก์ง๊ณผ ๋ฒ์ญ ํ ์คํธ๊ฐ ์์ ํ ๋ถ๋ฆฌ๋์ด ๊ด๋ฆฌ๊ฐ ์ฌ์์ |
| ํ์คํ | ์ ๊ณ ํ์ค์ผ๋ก ๋ง์ ๋๊ตฌ์ ํ๋ซํผ์์ ์ง์ํด์ |
| ๋ฒ์ญ๊ฐ ์นํ์ | ๊ฐ๋ฐ์๊ฐ ์๋ ๋ฒ์ญ๊ฐ๋ ์ฝ๊ฒ ๋ฒ์ญ ์์ ์ ํ ์ ์์ด์ |
| ์ฑ๋ฅ | ์ปดํ์ผ๋ .mo ํ์ผ์ ์ฌ์ฉํด์ ๋น ๋ฅธ ์๋๋ฅผ ์๋ํด์ |
| ๋ณต์ํ ์ฒ๋ฆฌ | ์ธ์ด๋ณ๋ก ๋ค๋ฅธ ๋ณต์ํ ๊ท์น์ ์๋์ผ๋ก ์ฒ๋ฆฌํด์ค์ |
๐ ๏ธ PHP์์ gettext ์ค์ ํ๊ธฐ
์, ์ด์ ๋ณธ๊ฒฉ์ ์ผ๋ก PHP์์ gettext๋ฅผ ์ด๋ป๊ฒ ์ฌ์ฉํ๋์ง ์์๋ณด์! ๐
๋จผ์ ์์คํ
์ gettext๊ฐ ์ค์น๋์ด ์์ด์ผ ํด. ๋๋ถ๋ถ์ ๋ฆฌ๋
์ค ์์คํ
์๋ ๊ธฐ๋ณธ์ผ๋ก ์ค์น๋์ด ์์ง๋ง, ํ์ธํด๋ณด์:
# ๋ฆฌ๋
์ค/๋งฅ
which gettext
# ์๋ค๋ฉด ์ค์น
# Ubuntu/Debian
sudo apt-get install gettext
# CentOS/RHEL
sudo yum install gettext
# macOS (Homebrew)
brew install gettext
PHP์์๋ gettext ํ์ฅ์ด ํ์ฑํ๋์ด ์์ด์ผ ํด. phpinfo()๋ฅผ ์คํํด์ ํ์ธํด๋ณด๊ฑฐ๋, ์ด๋ ๊ฒ ์ฒดํฌํ ์ ์์ด:
<?php
if (function_exists('gettext')) {
echo "gettext ์ฌ์ฉ ๊ฐ๋ฅ! ๐";
} else {
echo "gettext ํ์ฅ์ ํ์ฑํํด์ผ ํด์ ๐ข";
}
?>
gettext๋ฅผ ์ฌ์ฉํ๋ ค๋ฉด ํน์ ํ ๋๋ ํ ๋ฆฌ ๊ตฌ์กฐ๊ฐ ํ์ํด. ๋ณดํต ์ด๋ฐ ์์ผ๋ก ๊ตฌ์ฑํด:
project/
โโโ index.php
โโโ locale/
โ โโโ ko_KR/
โ โ โโโ LC_MESSAGES/
โ โ โโโ messages.po
โ โ โโโ messages.mo
โ โโโ en_US/
โ โ โโโ LC_MESSAGES/
โ โ โโโ messages.po
โ โ โโโ messages.mo
โ โโโ ja_JP/
โ โโโ LC_MESSAGES/
โ โโโ messages.po
โ โโโ messages.mo
โโโ includes/
โโโ i18n.php
์ฌ๊ธฐ์ ์ค์ํ ํฌ์ธํธ๋ค์ ์ง์ด๋ณผ๊ฒ:
๐๏ธ locale ํด๋: ๋ชจ๋ ๋ฒ์ญ ํ์ผ์ด ๋ค์ด๊ฐ๋ ๊ณณ
๐ ko_KR, en_US ๋ฑ: ๋ก์ผ์ผ ์ฝ๋ (์ธ์ด_๊ตญ๊ฐ ํ์)
๐ LC_MESSAGES: gettext์ ํ์ค ๋๋ ํ ๋ฆฌ๋ช
๐ .po ํ์ผ: ์ฌ๋์ด ์ฝ๊ณ ํธ์งํ ์ ์๋ ๋ฒ์ญ ํ์ผ
โก .mo ํ์ผ: .po๋ฅผ ์ปดํ์ผํ ๋ฐ์ด๋๋ฆฌ ํ์ผ (์ค์ ๋ก ์ฌ์ฉ๋จ)
๐ป ๊ธฐ๋ณธ ์ฌ์ฉ๋ฒ - ์ฝ๋ ์์ฑํ๊ธฐ
์ด์ ์ค์ ๋ก ์ฝ๋๋ฅผ ์์ฑํด๋ณด์! ๋จผ์ ๊ตญ์ ํ ์ค์ ์ ์ด๊ธฐํํ๋ ํ์ผ์ ๋ง๋ค์ด์ผ ํด.
includes/i18n.php ํ์ผ์ ์ด๋ ๊ฒ ์์ฑํด๋ด:
<?php
// ์ฌ์ฉ์ ์ธ์ด ๊ฐ์ง (์ฌ๋ฌ ๋ฐฉ๋ฒ ์ค ํ๋)
function detectLanguage() {
// 1. ์ธ์
์ ์ ์ฅ๋ ์ธ์ด
if (isset($_SESSION['language'])) {
return $_SESSION['language'];
}
// 2. ์ฟ ํค์ ์ ์ฅ๋ ์ธ์ด
if (isset($_COOKIE['language'])) {
return $_COOKIE['language'];
}
// 3. ๋ธ๋ผ์ฐ์ ์ธ์ด ์ค์
if (isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])) {
$lang = substr($_SERVER['HTTP_ACCEPT_LANGUAGE'], 0, 2);
switch ($lang) {
case 'ko': return 'ko_KR';
case 'ja': return 'ja_JP';
case 'zh': return 'zh_CN';
default: return 'en_US';
}
}
// 4. ๊ธฐ๋ณธ๊ฐ
return 'en_US';
}
// ์ธ์ด ์ค์
$language = detectLanguage();
$domain = 'messages';
$locale_path = __DIR__ . '/../locale';
// gettext ์ค์
putenv("LANG=$language");
putenv("LANGUAGE=$language");
setlocale(LC_ALL, $language);
// ๋ฒ์ญ ๋๋ฉ์ธ ๋ฐ์ธ๋ฉ
bindtextdomain($domain, $locale_path);
bind_textdomain_codeset($domain, 'UTF-8');
textdomain($domain);
// ํธ์ ํจ์ ์ ์
function __($text) {
return gettext($text);
}
function _n($singular, $plural, $number) {
return ngettext($singular, $plural, $number);
}
?>
์, ์ฝ๋๊ฐ ์ข ๊ธธ์ง? ๐
ํ๋์ฉ ์ค๋ช
ํด์ค๊ฒ:
1๏ธโฃ detectLanguage(): ์ฌ์ฉ์์ ์ธ์ด๋ฅผ ๊ฐ์งํ๋ ํจ์์ผ. ์ธ์
โ ์ฟ ํค โ ๋ธ๋ผ์ฐ์ ์ค์ ์์ผ๋ก ํ์ธํ๊ณ , ์์ผ๋ฉด ์์ด๋ฅผ ๊ธฐ๋ณธ๊ฐ์ผ๋ก ์ฌ์ฉํด.
2๏ธโฃ putenv()์ setlocale(): ์์คํ
๋ ๋ฒจ์์ ๋ก์ผ์ผ์ ์ค์ ํ๋ ๊ฑฐ์ผ. ์ด๊ฒ ์์ด์ผ gettext๊ฐ ์ ๋๋ก ์๋ํด.
3๏ธโฃ bindtextdomain(): ๋ฒ์ญ ํ์ผ์ด ์ด๋ ์๋์ง ์๋ ค์ฃผ๋ ๊ฑฐ์ผ.
4๏ธโฃ textdomain(): ์ด๋ค ๋๋ฉ์ธ(๋ฒ์ญ ํ์ผ ์ธํธ)์ ์ฌ์ฉํ ์ง ์ง์ ํด.
5๏ธโฃ __()์ _n(): ํธ์ ํจ์๋ค์ด์ผ. ๋งค๋ฒ gettext()๋ผ๊ณ ์ฐ๊ธฐ ๊ท์ฐฎ์ผ๋๊น ์งง๊ฒ ๋ง๋ ๊ฑฐ์ง!
์ด์ ์ค์ ํ์ด์ง์์ ์ฌ์ฉํด๋ณด์. index.php:
<?php
session_start();
require_once 'includes/i18n.php';
?>
<!DOCTYPE html>
<html lang="<?php echo substr($language, 0, 2); ?>">
<head>
<meta charset="UTF-8">
<title><?php echo __("Welcome"); ?></title>
</head>
<body>
<h1><?php echo __("Hello, World!"); ?></h1>
<p><?php echo __("This is a multilingual website."); ?></p>
<?php
$itemCount = 5;
echo sprintf(
_n("You have %d item", "You have %d items", $itemCount),
$itemCount
);
?>
<div>
<a href="?lang=ko_KR">ํ๊ตญ์ด</a> |
<a href="?lang=en_US">English</a> |
<a href="?lang=ja_JP">ๆฅๆฌ่ช</a>
</div>
</body>
</html>
๋ณด์ด์ง? __() ํจ์๋ก ๋ฒ์ญ์ด ํ์ํ ํ
์คํธ๋ฅผ ๊ฐ์ธ๊ธฐ๋ง ํ๋ฉด ๋ผ! ๐
๋ณต์ํ ์ฒ๋ฆฌ๋ _n() ํจ์๋ฅผ ์ฌ์ฉํ๊ณ .
๐ ๋ฒ์ญ ํ์ผ ๋ง๋ค๊ธฐ (.po ํ์ผ)
์, ์ด์ ๊ฐ์ฅ ์ค์ํ ๋ฒ์ญ ํ์ผ์ ๋ง๋ค์ด์ผ ํด! ๐จ
๋จผ์ ์์ค ์ฝ๋์์ ๋ฒ์ญ ๊ฐ๋ฅํ ๋ฌธ์์ด์ ์ถ์ถํด์ผ ํ๋๋ฐ, ์ด๊ฑธ ์๋์ผ๋ก ํด์ฃผ๋ ๋๊ตฌ๊ฐ ์์ด:
# ํ๋ก์ ํธ ๋ฃจํธ์์ ์คํ
xgettext --from-code=UTF-8 -o locale/messages.pot *.php includes/*.php
# ๋๋ ๋ ์์ธํ๊ฒ
xgettext --language=PHP \
--from-code=UTF-8 \
--keyword=__ \
--keyword=_n:1,2 \
--output=locale/messages.pot \
--add-comments=TRANSLATORS \
*.php includes/*.php
์ด ๋ช
๋ น์ด๋ PHP ํ์ผ๋ค์ ์ค์บํด์ __()์ _n() ํจ์๋ก ๊ฐ์ผ ๋ฌธ์์ด๋ค์ ์ฐพ์๋ด์ .pot ํ์ผ(ํ
ํ๋ฆฟ ํ์ผ)์ ๋ง๋ค์ด์ค.
์์ฑ๋ messages.pot ํ์ผ์ ์ด๋ฐ ๋ชจ์ต์ด์ผ:
# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Language: \n"
msgid "Hello, World!"
msgstr ""
msgid "This is a multilingual website."
msgstr ""
msgid "You have %d item"
msgid_plural "You have %d items"
msgstr[0] ""
msgstr[1] ""
์ด์ ์ด ํ
ํ๋ฆฟ์ ๊ฐ ์ธ์ด๋ณ๋ก ๋ณต์ฌํด์ ๋ฒ์ญํ๋ฉด ๋ผ!
ํ๊ตญ์ด ๋ฒ์ญ ํ์ผ์ ๋ง๋ค์ด๋ณด์. locale/ko_KR/LC_MESSAGES/messages.po:
# Korean translations for PACKAGE package.
msgid ""
msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Language: ko_KR\n"
"Plural-Forms: nplurals=1; plural=0;\n"
msgid "Hello, World!"
msgstr "์๋
ํ์ธ์, ์ธ์!"
msgid "This is a multilingual website."
msgstr "์ด๊ฒ์ ๋ค๊ตญ์ด ์น์ฌ์ดํธ์
๋๋ค."
msgid "You have %d item"
msgid_plural "You have %d items"
msgstr[0] "์์ดํ
์ด %d๊ฐ ์์ต๋๋ค"
msgstr: ๋ฒ์ญ๋ ํ ์คํธ
msgid_plural: ๋ณต์ํ ์๋ณธ
msgstr[n]: ๋ณต์ํ ๋ฒ์ญ (์ธ์ด๋ง๋ค ๊ฐ์๊ฐ ๋ค๋ฆ!)
Plural-Forms: ํด๋น ์ธ์ด์ ๋ณต์ํ ๊ท์น
์ผ๋ณธ์ด ๋ฒ์ ๋ ๋ง๋ค์ด๋ณผ๊น? locale/ja_JP/LC_MESSAGES/messages.po:
# Japanese translations for PACKAGE package.
msgid ""
msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Language: ja_JP\n"
"Plural-Forms: nplurals=1; plural=0;\n"
msgid "Hello, World!"
msgstr "ใใใซใกใฏใไธ็๏ผ"
msgid "This is a multilingual website."
msgstr "ใใใฏๅค่จ่ชใฆใงใใตใคใใงใใ"
msgid "You have %d item"
msgid_plural "You have %d items"
msgstr[0] "%dๅใฎใขใคใใ ใใใใพใ"
์์ด๋ ๋ณต์ํ์ด 2๊ฐ์ง๋ง, ํ๊ตญ์ด์ ์ผ๋ณธ์ด๋ 1๊ฐ๋ง ์๋ค๋ ๊ฑธ ์ ์ ์์ง? ๐ค
์ด๊ฒ ๋ฐ๋ก Plural-Forms์ ํ์ด์ผ!
์ธ์ด๋ง๋ค ๋ณต์ํ ๊ท์น์ด ์์ ๋ฌ๋ผ. ๋ช ๊ฐ์ง ์๋ฅผ ๋ณด์:
| ์ธ์ด | ๋ณต์ํ ๊ฐ์ | Plural-Forms |
|---|---|---|
| ํ๊ตญ์ด, ์ผ๋ณธ์ด, ์ค๊ตญ์ด | 1๊ฐ | nplurals=1; plural=0; |
| ์์ด, ๋ ์ผ์ด, ์คํ์ธ์ด | 2๊ฐ | nplurals=2; plural=(n != 1); |
| ํ๋์ค์ด | 2๊ฐ | nplurals=2; plural=(n > 1); |
| ๋ฌ์์์ด, ์ฐํฌ๋ผ์ด๋์ด | 3๊ฐ | nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2); |
| ํด๋๋์ด | 3๊ฐ | nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2); |
๋ฌ์์์ด ๋ณต์ํ ๊ท์น ๋ดค์ด? ์์ ๋ณต์กํ์ง? ๐ฑ
์ด๋ฐ ๊ฑธ ์ผ์ผ์ด ์ฝ๋๋ก ์ฒ๋ฆฌํ๋ค๊ณ ์๊ฐํด๋ด... gettext๊ฐ ์ผ๋ง๋ ๊ณ ๋ง์ด ์กด์ฌ์ธ์ง ์๊ฒ ์ง?
โ๏ธ .mo ํ์ผ ์ปดํ์ผํ๊ธฐ
.po ํ์ผ์ ๋ง๋ค์์ผ๋ฉด ์ด์ ์ปดํ์ผํด์ผ ํด! ๐ช
gettext๋ ์ค์ ๋ก ๋ฐ์ด๋๋ฆฌ ํ์์ธ .mo ํ์ผ์ ์ฌ์ฉํ๊ฑฐ๋ . ์๋๊ฐ ํจ์ฌ ๋น ๋ฅด๊ฑฐ๋ !
# ํ๊ตญ์ด ์ปดํ์ผ
msgfmt locale/ko_KR/LC_MESSAGES/messages.po \
-o locale/ko_KR/LC_MESSAGES/messages.mo
# ์ผ๋ณธ์ด ์ปดํ์ผ
msgfmt locale/ja_JP/LC_MESSAGES/messages.po \
-o locale/ja_JP/LC_MESSAGES/messages.mo
# ์์ด ์ปดํ์ผ
msgfmt locale/en_US/LC_MESSAGES/messages.po \
-o locale/en_US/LC_MESSAGES/messages.mo
๋๋ ํ ๋ฒ์ ๋ชจ๋ ์ธ์ด๋ฅผ ์ปดํ์ผํ๋ ์คํฌ๋ฆฝํธ๋ฅผ ๋ง๋ค ์๋ ์์ด:
#!/bin/bash
# compile_translations.sh
for dir in locale/*/LC_MESSAGES; do
if [ -f "$dir/messages.po" ]; then
echo "Compiling $dir/messages.po..."
msgfmt "$dir/messages.po" -o "$dir/messages.mo"
fi
done
echo "All translations compiled! โ
"
๐จ ๊ณ ๊ธ ๊ธฐ๋ฅ๋ค
๊ฐ์ ๋จ์ด๋ผ๋ ๋ฌธ๋งฅ์ ๋ฐ๋ผ ๋ค๋ฅด๊ฒ ๋ฒ์ญํด์ผ ํ ๋๊ฐ ์์ด.
์๋ฅผ ๋ค์ด "Post"๋ผ๋ ๋จ์ด๋ "๊ฒ์๋ฌผ"์ผ ์๋ ์๊ณ "์ฐํธ"์ผ ์๋ ์์์?
์ด๋ด ๋ pgettext() ํจ์๋ฅผ ์ฌ์ฉํด:
<?php
// ์ปจํ
์คํธ๋ฅผ ํฌํจํ ๋ฒ์ญ ํจ์
function _x($text, $context) {
return pgettext($context, $text);
}
// ์ฌ์ฉ ์์
echo _x("Post", "noun - blog post"); // "๊ฒ์๋ฌผ"
echo _x("Post", "verb - to mail"); // "์ฐํธ ๋ณด๋ด๋ค"
?>
.po ํ์ผ์์๋ ์ด๋ ๊ฒ ํํํด:
msgctxt "noun - blog post"
msgid "Post"
msgstr "๊ฒ์๋ฌผ"
msgctxt "verb - to mail"
msgid "Post"
msgstr "์ฐํธ ๋ณด๋ด๋ค"
๋ฒ์ญ ๋ฌธ์์ด์ ๋ณ์๋ฅผ ๋ฃ์ด์ผ ํ ๋๋ sprintf()๋ printf()๋ฅผ ํจ๊ป ์ฌ์ฉํด:
<?php
$username = "์ฒ ์";
$points = 1500;
// ๋ฐฉ๋ฒ 1: sprintf
echo sprintf(__("Welcome, %s! You have %d points."), $username, $points);
// ๋ฐฉ๋ฒ 2: printf (๋ฐ๋ก ์ถ๋ ฅ)
printf(__("Welcome, %s! You have %d points."), $username, $points);
// ๋ฐฉ๋ฒ 3: ๋ช
๋ช
๋ ํ๋ ์ด์คํ๋ (๋ ๋ช
ํํจ!)
function __f($text, $args) {
$translated = __($text);
foreach ($args as $key => $value) {
$translated = str_replace('{' . $key . '}', $value, $translated);
}
return $translated;
}
echo __f("Welcome, {name}! You have {points} points.", [
'name' => $username,
'points' => $points
]);
?>
.po ํ์ผ:
msgid "Welcome, %s! You have %d points."
msgstr "%s๋ ํ์ํฉ๋๋ค! %d ํฌ์ธํธ๋ฅผ ๋ณด์ ํ๊ณ ๊ณ์ญ๋๋ค."
# ๋๋ ๋ช
๋ช
๋ ํ๋ ์ด์คํ๋
msgid "Welcome, {name}! You have {points} points."
msgstr "{name}๋ ํ์ํฉ๋๋ค! {points} ํฌ์ธํธ๋ฅผ ๋ณด์ ํ๊ณ ๊ณ์ญ๋๋ค."
์: ์์ด๋ "Welcome, John!"์ด์ง๋ง ์ผ๋ณธ์ด๋ "Johnใใใใใใใ!"์ฒ๋ผ ์์๊ฐ ๋ฐ๋ ์ ์๊ฑฐ๋ .
๋ ์ง์ ์๊ฐ ํ์๋ ๋๋ผ๋ง๋ค ๋ฌ๋ผ. gettext์ ํจ๊ป strftime()์ ์ฌ์ฉํ๋ฉด ์ฝ๊ฒ ์ฒ๋ฆฌํ ์ ์์ด:
<?php
// ๋ก์ผ์ผ ์ค์ ํ
setlocale(LC_TIME, $language);
// ํ์งํ๋ ๋ ์ง ์ถ๋ ฅ
echo strftime(__("%A, %B %d, %Y"), time());
// ํ๊ตญ์ด: "2024๋
1์ 15์ผ ์์์ผ"
// ์์ด: "Monday, January 15, 2024"
// ์ผ๋ณธ์ด: "2024ๅนด1ๆ15ๆฅ ๆๆๆฅ"
?>
๋ ํ๋์ ์ธ ๋ฐฉ๋ฒ์ผ๋ก๋ IntlDateFormatter๋ฅผ ์ฌ์ฉํ ์๋ ์์ด:
<?php
$formatter = new IntlDateFormatter(
$language,
IntlDateFormatter::LONG,
IntlDateFormatter::SHORT
);
echo $formatter->format(time());
?>
์ซ์์ ํตํ ํ์๋ ๋๋ผ๋ง๋ค ๋ค๋ฅด์ง. ํ๊ตญ์ "1,234,567์"์ด์ง๋ง ๋ฏธ๊ตญ์ "$1,234,567"์ด์์?
<?php
// ์ซ์ ํ์
$formatter = new NumberFormatter($language, NumberFormatter::DECIMAL);
echo $formatter->format(1234567.89);
// ํ๊ตญ์ด: 1,234,567.89
// ๋
์ผ์ด: 1.234.567,89
// ํตํ ํ์
$formatter = new NumberFormatter($language, NumberFormatter::CURRENCY);
echo $formatter->formatCurrency(1234567.89, 'USD');
// ํ๊ตญ์ด: US$1,234,567.89
// ์์ด: $1,234,567.89
?>
๐ง ์ค์ ํ๊ณผ ๋ฒ ์คํธ ํ๋ํฐ์ค
โข ๋ฌธ๋งฅ์ ์ดํดํ ์ ์๋๋ก ์ถฉ๋ถํ ์ ๋ณด ์ ๊ณต
โข ์ฃผ์์ผ๋ก ๋ฒ์ญ๊ฐ์๊ฒ ํํธ ์ฃผ๊ธฐ
โข ์ผ๊ด๋ ์ฉ์ด ์ฌ์ฉํ๊ธฐ
โข HTML ํ๊ทธ๋ฅผ ๋ฒ์ญ ๋ฌธ์์ด์ ํฌํจ์ํค์ง ๋ง๊ธฐ (๊ฐ๋ฅํ ํ)
โข ํ๋์ฝ๋ฉ๋ ๊ฐ ๋ฃ์ง ๋ง๊ธฐ
โข ๋๋ฌด ๊ธด ๋ฌธ์ฅ์ ํผํ๊ธฐ
๋์ ์์ ๐ฑ:
<?php
// โ ๋์ ์: ๋ฌธ์์ด ์กฐ๊ฐ๋ด๊ธฐ
echo __("Welcome") . ", " . $username . "! " . __("You have") . " " . $points . " " . __("points");
// โ ๋์ ์: HTML ํฌํจ
echo __("<h1>Welcome to our site</h1>");
// โ ๋์ ์: ํ๋์ฝ๋ฉ
echo __("Call us at 02-1234-5678");
?>
์ข์ ์์ ๐:
<?php
// โ
์ข์ ์: ์์ ํ ๋ฌธ์ฅ
echo sprintf(__("Welcome, %s! You have %d points."), $username, $points);
// โ
์ข์ ์: HTML ๋ถ๋ฆฌ
echo "<h1>" . __("Welcome to our site") . "</h1>";
// โ
์ข์ ์: ๋ณ์ ์ฌ์ฉ
$phoneNumber = getConfigValue('contact_phone');
echo sprintf(__("Call us at %s"), $phoneNumber);
// โ
์ข์ ์: ์ฃผ์ ์ถ๊ฐ
// TRANSLATORS: This message appears when user successfully logs in
echo __("Login successful!");
?>
gettext๋ ์ฑ๋ฅ์ ์ํด ๋ฒ์ญ์ ์บ์ฑํ๋๋ฐ, ๊ฐ๋ฐ ์ค์๋ ์ด๊ฒ ์คํ๋ ค ๋ถํธํ ์ ์์ด.
๋ฒ์ญ์ ์
๋ฐ์ดํธํ๋๋ฐ ๋ฐ์์ด ์ ๋๋ ๊ฒฝ์ฐ๊ฐ ์๊ฑฐ๋ . ํด๊ฒฐ ๋ฐฉ๋ฒ๋ค:
<?php
// ๋ฐฉ๋ฒ 1: Apache ์ฌ์์
// sudo service apache2 restart
// ๋ฐฉ๋ฒ 2: PHP-FPM ์ฌ์์
// sudo service php-fpm restart
// ๋ฐฉ๋ฒ 3: ๋ก์ผ์ผ ์ด๋ฆ์ ํ์์คํฌํ ์ถ๊ฐ (๊ฐ๋ฐ ํ๊ฒฝ)
if (defined('DEVELOPMENT_MODE') && DEVELOPMENT_MODE) {
$language = $language . '.' . time();
}
setlocale(LC_ALL, $language);
// ๋ฐฉ๋ฒ 4: ์บ์ ๋ฌดํจํ (Opcache ์ฌ์ฉ ์)
if (function_exists('opcache_reset')) {
opcache_reset();
}
?>
๋ฒ์ญ์ด ์์ ๋๋ฅผ ๋๋นํ ์ ๋ต๋ ํ์ํด:
<?php
function safeTranslate($text, $fallback = null) {
$translated = __($text);
// ๋ฒ์ญ์ด ์์ผ๋ฉด ์๋ณธ์ด ๊ทธ๋๋ก ๋ฐํ๋จ
if ($translated === $text && $fallback !== null) {
return $fallback;
}
return $translated;
}
// ์ฌ์ฉ ์์
echo safeTranslate("Some new feature", "์๋ก์ด ๊ธฐ๋ฅ");
?>
์๋์ผ๋ก .po ํ์ผ์ ํธ์งํ๋ ๊ฒ๋ ์ข์ง๋ง, ์ ๋ฌธ ๋๊ตฌ๋ฅผ ์ฌ์ฉํ๋ฉด ํจ์ฌ ํธํด:
โข ๊ฐ์ฅ ์ธ๊ธฐ ์๋ .po ํ์ผ ํธ์ง๊ธฐ
โข ํฌ๋ก์ค ํ๋ซํผ (Windows, Mac, Linux)
โข ์๋ ๋ฒ์ญ ์ ์ ๊ธฐ๋ฅ
โข ๋ฌด๋ฃ ๋ฒ์ ๋ ์ถฉ๋ถํ ๊ฐ๋ ฅํจ
Lokalize ๐ง
โข KDE ํ๋ก์ ํธ์ ๋ฒ์ญ ๋๊ตฌ
โข ๋ฆฌ๋ ์ค์์ ํนํ ์ข์
โข ๋ฒ์ญ ๋ฉ๋ชจ๋ฆฌ ๊ธฐ๋ฅ
Weblate ๐
โข ์น ๊ธฐ๋ฐ ๋ฒ์ญ ํ๋ซํผ
โข ํ์ ์ ์ต์ ํ
โข Git ํตํฉ
โข ์คํ์์ค ํ๋ก์ ํธ๋ ๋ฌด๋ฃ
Crowdin ๐ฅ
โข ํด๋ผ์ฐ๋ ๊ธฐ๋ฐ ๋ฒ์ญ ๊ด๋ฆฌ
โข ํฌ๋ผ์ฐ๋์์ฑ ๋ฒ์ญ ์ง์
โข API ์ ๊ณต
gettext๋ ์ด๋ฏธ ๋น ๋ฅด์ง๋ง, ๋ ์ต์ ํํ ์ ์๋ ๋ฐฉ๋ฒ๋ค:
<?php
// 1. Opcache ํ์ฑํ (php.ini)
// opcache.enable=1
// opcache.memory_consumption=128
// opcache.max_accelerated_files=10000
// 2. ๋ฒ์ญ ์บ์ฑ ๋ํผ
class TranslationCache {
private static $cache = [];
public static function get($text) {
if (!isset(self::$cache[$text])) {
self::$cache[$text] = gettext($text);
}
return self::$cache[$text];
}
}
// 3. APCu ์ฌ์ฉ (๊ฐ๋ฅํ ๊ฒฝ์ฐ)
function cachedGettext($text) {
$key = 'trans_' . md5($text . '_' . $GLOBALS['language']);
if (function_exists('apcu_fetch')) {
$cached = apcu_fetch($key);
if ($cached !== false) {
return $cached;
}
}
$translated = gettext($text);
if (function_exists('apcu_store')) {
apcu_store($key, $translated, 3600); // 1์๊ฐ ์บ์
}
return $translated;
}
?>
๐ ์ค์ ํ๋ก์ ํธ ์์
์, ์ด์ ๋ฐฐ์ด ๊ฑธ ๋ค ํฉ์ณ์ ์ค์ ๋ก ๋์ํ๋ ๊ฐ๋จํ ๋ค๊ตญ์ด ๋ธ๋ก๊ทธ๋ฅผ ๋ง๋ค์ด๋ณด์! ๐
multilingual-blog/
โโโ index.php
โโโ post.php
โโโ config.php
โโโ includes/
โ โโโ i18n.php
โ โโโ functions.php
โ โโโ header.php
โโโ locale/
โ โโโ ko_KR/LC_MESSAGES/
โ โโโ en_US/LC_MESSAGES/
โ โโโ ja_JP/LC_MESSAGES/
โโโ assets/
โ โโโ style.css
โโโ compile_translations.sh
config.php - ๊ธฐ๋ณธ ์ค์ :
<?php
define('SITE_NAME', 'Multilingual Blog');
define('DEFAULT_LANGUAGE', 'en_US');
define('SUPPORTED_LANGUAGES', [
'ko_KR' => ['name' => 'ํ๊ตญ์ด', 'flag' => '๐ฐ๐ท'],
'en_US' => ['name' => 'English', 'flag' => '๐บ๐ธ'],
'ja_JP' => ['name' => 'ๆฅๆฌ่ช', 'flag' => '๐ฏ๐ต']
]);
// ๋ฐ์ดํฐ๋ฒ ์ด์ค ์ค์ (์ค์ ๋ก๋ DB ์ฌ์ฉ)
define('DB_HOST', 'localhost');
define('DB_NAME', 'blog');
define('DB_USER', 'root');
define('DB_PASS', '');
?>
includes/functions.php - ์ ํธ๋ฆฌํฐ ํจ์๋ค:
<?php
function getCurrentLanguage() {
if (isset($_GET['lang']) && array_key_exists($_GET['lang'], SUPPORTED_LANGUAGES)) {
$_SESSION['language'] = $_GET['lang'];
return $_GET['lang'];
}
if (isset($_SESSION['language'])) {
return $_SESSION['language'];
}
return DEFAULT_LANGUAGE;
}
function getLanguageSwitcher() {
$current = getCurrentLanguage();
$html = '<div class="language-switcher">';
foreach (SUPPORTED_LANGUAGES as $code => $info) {
$active = ($code === $current) ? 'active' : '';
$html .= sprintf(
'<a href="?lang=%s" class="lang-btn %s">%s %s</a>',
$code,
$active,
$info['flag'],
$info['name']
);
}
$html .= '</div>';
return $html;
}
function formatDate($timestamp) {
$language = getCurrentLanguage();
setlocale(LC_TIME, $language);
// PHP 8.1+ ์์๋ IntlDateFormatter ์ฌ์ฉ ๊ถ์ฅ
if (class_exists('IntlDateFormatter')) {
$formatter = new IntlDateFormatter(
$language,
IntlDateFormatter::LONG,
IntlDateFormatter::NONE
);
return $formatter->format($timestamp);
}
return strftime('%Y๋
%m์ %d์ผ', $timestamp);
}
// ์ํ ๋ธ๋ก๊ทธ ํฌ์คํธ (์ค์ ๋ก๋ DB์์ ๊ฐ์ ธ์ด)
function getBlogPosts() {
return [
[
'id' => 1,
'title' => __('Getting Started with PHP'),
'excerpt' => __('Learn the basics of PHP programming language.'),
'date' => strtotime('-7 days'),
'author' => 'John Doe'
],
[
'id' => 2,
'title' => __('Web Development Best Practices'),
'excerpt' => __('Essential tips for modern web development.'),
'date' => strtotime('-3 days'),
'author' => 'Jane Smith'
],
[
'id' => 3,
'title' => __('Introduction to Internationalization'),
'excerpt' => __('Make your website accessible to global audience.'),
'date' => strtotime('-1 day'),
'author' => 'Mike Johnson'
]
];
}
?>
index.php - ๋ฉ์ธ ํ์ด์ง:
<?php
session_start();
require_once 'config.php';
require_once 'includes/i18n.php';
require_once 'includes/functions.php';
$posts = getBlogPosts();
?>
<!DOCTYPE html>
<html lang="<?php echo substr(getCurrentLanguage(), 0, 2); ?>">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title><?php echo __(SITE_NAME); ?></title>
<link rel="stylesheet" href="assets/style.css">
</head>
<body>
<header>
<h1><?php echo __(SITE_NAME); ?></h1>
<?php echo getLanguageSwitcher(); ?>
</header>
<main>
<h2><?php echo __("Latest Posts"); ?></h2>
<?php foreach ($posts as $post): ?>
<article class="post-card">
<h3><?php echo $post['title']; ?></h3>
<p class="post-meta">
<?php
printf(
__("By %s on %s"),
$post['author'],
formatDate($post['date'])
);
?>
</p>
<p><?php echo $post['excerpt']; ?></p>
<a href="post.php?id=<?php echo $post['id']; ?>" class="read-more">
<?php echo __("Read more"); ?> โ
</a>
</article>
<?php endforeach; ?>
<div class="post-count">
<?php
$count = count($posts);
echo sprintf(
_n("Showing %d post", "Showing %d posts", $count),
$count
);
?>
</div>
</main>
<footer>
<p><?php echo __("ยฉ 2024 All rights reserved"); ?></p>
</footer>
</body>
</html>
์ด์ ๋ฒ์ญ ํ์ผ์ ๋ง๋ค์ด์ผ๊ฒ ์ง? locale/ko_KR/LC_MESSAGES/messages.po:
msgid ""
msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Language: ko_KR\n"
"Plural-Forms: nplurals=1; plural=0;\n"
msgid "Multilingual Blog"
msgstr "๋ค๊ตญ์ด ๋ธ๋ก๊ทธ"
msgid "Latest Posts"
msgstr "์ต์ ๊ฒ์๋ฌผ"
msgid "Getting Started with PHP"
msgstr "PHP ์์ํ๊ธฐ"
msgid "Learn the basics of PHP programming language."
msgstr "PHP ํ๋ก๊ทธ๋๋ฐ ์ธ์ด์ ๊ธฐ์ด๋ฅผ ๋ฐฐ์๋ณด์ธ์."
msgid "Web Development Best Practices"
msgstr "์น ๊ฐ๋ฐ ๋ชจ๋ฒ ์ฌ๋ก"
msgid "Essential tips for modern web development."
msgstr "ํ๋ ์น ๊ฐ๋ฐ์ ์ํ ํ์ ํ๋ค."
msgid "Introduction to Internationalization"
msgstr "๊ตญ์ ํ ์
๋ฌธ"
msgid "Make your website accessible to global audience."
msgstr "์ ์ธ๊ณ ์ฌ์ฉ์๊ฐ ์ ๊ทผํ ์ ์๋ ์น์ฌ์ดํธ๋ฅผ ๋ง๋์ธ์."
msgid "By %s on %s"
msgstr "%s ์์ฑ ยท %s"
msgid "Read more"
msgstr "๋ ๋ณด๊ธฐ"
msgid "Showing %d post"
msgid_plural "Showing %d posts"
msgstr[0] "%d๊ฐ์ ๊ฒ์๋ฌผ ํ์ ์ค"
msgid "ยฉ 2024 All rights reserved"
msgstr "ยฉ 2024 ๋ชจ๋ ๊ถ๋ฆฌ ๋ณด์ "
์ปดํ์ผํ๊ณ ์คํํ๋ฉด... ์ง์! ๐
์ธ์ด๋ฅผ ๋ฐ๊ฟ ๋๋ง๋ค ๋ชจ๋ ํ
์คํธ๊ฐ ์๋์ผ๋ก ๋ฒ์ญ๋๋ ๊ฑธ ๋ณผ ์ ์์ด!
๐ ํํ ๋ฌธ์ ์ ํด๊ฒฐ๋ฒ
- โ .po ํ์ผ์ .mo๋ก ์ปดํ์ผํ๋์?
- โ ํ์ผ ๊ฒฝ๋ก๊ฐ ์ ํํ๊ฐ์?
- โ ๋ก์ผ์ผ ์ด๋ฆ์ด ์์คํ ์์ ์ง์๋๋์? (locale -a๋ก ํ์ธ)
- โ ์น ์๋ฒ๋ฅผ ์ฌ์์ํ๋์?
- โ ํ์ผ ๊ถํ์ด ์ฌ๋ฐ๋ฅธ๊ฐ์? (์ฝ๊ธฐ ๊ถํ ํ์)
- โ textdomain()์ ์ฌ๋ฐ๋ฅด๊ฒ ์ค์ ํ๋์?
<?php
// ๋๋ฒ๊น
์ฝ๋
echo "Current locale: " . setlocale(LC_ALL, 0) . "<br>";
echo "Domain path: " . bindtextdomain('messages', './locale') . "<br>";
echo "Current domain: " . textdomain(NULL) . "<br>";
// .mo ํ์ผ ์กด์ฌ ํ์ธ
$moFile = "./locale/ko_KR/LC_MESSAGES/messages.mo";
echo "MO file exists: " . (file_exists($moFile) ? "Yes" : "No") . "<br>";
echo "MO file readable: " . (is_readable($moFile) ? "Yes" : "No") . "<br>";
?>
์ด๊ฑด ๋ณดํต ์ด๋ฐ ์ด์ ๋ค ๋๋ฌธ์ด์ผ:
<?php
// โ ์๋ชป๋ ์: ๋ณ์๋ฅผ ์ง์ ๋ฒ์ญํ๋ ค๊ณ ํจ
$text = "Hello";
echo __($text); // ์๋ ์ ํจ!
// โ
์ฌ๋ฐ๋ฅธ ์: ๋ฆฌํฐ๋ด ๋ฌธ์์ด ์ฌ์ฉ
echo __("Hello");
// โ ์๋ชป๋ ์: ๋์ ์ผ๋ก ์์ฑ๋ ๋ฌธ์์ด
echo __("Welcome " . $username);
// โ
์ฌ๋ฐ๋ฅธ ์: sprintf ์ฌ์ฉ
echo sprintf(__("Welcome %s"), $username);
?>
gettext๋ ์ปดํ์ผ ํ์์ ๋ฌธ์์ด์ ์ถ์ถํ๊ธฐ ๋๋ฌธ์, ๋ณ์๋ ๋์ ๋ฌธ์์ด์ ์ธ์ํ์ง ๋ชปํด!
Windows๋ ๋ก์ผ์ผ ์ด๋ฆ์ด ์ข ๋ฌ๋ผ. ์ด๋ ๊ฒ ํด๊ฒฐํด:
<?php
function setLocaleWindows($language) {
$localeMap = [
'ko_KR' => ['korean', 'kor', 'ko_KR.UTF-8', 'ko_KR'],
'en_US' => ['english', 'eng', 'en_US.UTF-8', 'en_US'],
'ja_JP' => ['japanese', 'jpn', 'ja_JP.UTF-8', 'ja_JP']
];
if (isset($localeMap[$language])) {
foreach ($localeMap[$language] as $locale) {
if (setlocale(LC_ALL, $locale) !== false) {
return true;
}
}
}
return false;
}
// ์ฌ์ฉ
if (!setLocaleWindows($language)) {
// ํด๋ฐฑ ์ฒ๋ฆฌ
error_log("Failed to set locale: $language");
}
?>
๋ณต์ํ ๊ท์น์ ์ ํํ ์ค์ ํ๋์ง ํ์ธํด:
# ์์ด (2๊ฐ ํํ)
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# ํ๊ตญ์ด (1๊ฐ ํํ)
"Plural-Forms: nplurals=1; plural=0;\n"
# ๋ฌ์์์ด (3๊ฐ ํํ)
"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
๊ทธ๋ฆฌ๊ณ ์ฝ๋์์๋ ๋ฐ๋์ ngettext()๋ฅผ ์ฌ์ฉํด์ผ ํด:
<?php
$count = 5;
// โ ์๋ชป๋ ์
if ($count == 1) {
echo __("You have 1 message");
} else {
echo __("You have messages");
}
// โ
์ฌ๋ฐ๋ฅธ ์
echo sprintf(
ngettext("You have %d message", "You have %d messages", $count),
$count
);
?>
๐ ํ๋ ์์ํฌ์์ ํตํฉ
์ค์ ํ๋ก์ ํธ์์๋ ํ๋ ์์ํฌ๋ฅผ ์ฌ์ฉํ๋ ๊ฒฝ์ฐ๊ฐ ๋ง์ง? ์ฃผ์ ํ๋ ์์ํฌ๋ค๊ณผ gettext๋ฅผ ์ด๋ป๊ฒ ํตํฉํ๋์ง ์์๋ณด์!
Laravel์ ์์ฒด ๋ฒ์ญ ์์คํ ์ด ์์ง๋ง, gettext๋ฅผ ์ฌ์ฉํ๊ณ ์ถ๋ค๋ฉด:
// composer.json
{
"require": {
"xinax/laravel-gettext": "^6.0"
}
}
// config/app.php
'providers' => [
Xinax\LaravelGettext\LaravelGettextServiceProvider::class,
],
// .env
LOCALE=en_US
SUPPORTED_LOCALES=en_US,ko_KR,ja_JP
// ์ฌ์ฉ
{{ _("Welcome to our site") }}
{{ _n("You have %d item", "You have %d items", $count) }}
Symfony๋ Translation ์ปดํฌ๋ํธ๊ฐ gettext๋ฅผ ์ง์ํด:
// config/packages/translation.yaml
framework:
translator:
default_path: '%kernel.project_dir%/translations'
fallbacks: ['en']
providers:
gettext:
class: Symfony\Component\Translation\Loader\PoFileLoader
// ์ปจํธ๋กค๋ฌ์์
public function index(TranslatorInterface $translator)
{
$translated = $translator->trans('Hello, World!');
return new Response($translated);
}
WordPress๋ ์ฒ์๋ถํฐ gettext๋ฅผ ์ฌ์ฉํ๋๋ก ์ค๊ณ๋์์ด! ๐
<?php
// ํ
๋ง๋ ํ๋ฌ๊ทธ์ธ์์
function my_theme_setup() {
load_theme_textdomain('my-theme', get_template_directory() . '/languages');
}
add_action('after_setup_theme', 'my_theme_setup');
// ์ฌ์ฉ
echo __('Hello, World!', 'my-theme');
echo _n('%d comment', '%d comments', $count, 'my-theme');
echo _x('Post', 'noun', 'my-theme');
?>
๐ผ ์ค๋ฌด์์์ ์ํฌํ๋ก์ฐ
์ค์ ํ๋ก์ ํธ์์ ๋ค๊ตญ์ด ์ง์์ ์ด๋ป๊ฒ ๊ด๋ฆฌํ๋์ง ์ํฌํ๋ก์ฐ๋ฅผ ์๊ฐํ ๊ฒ! ๐
<?php
// ๊ฐ๋ฐ ์ค์๋ ํญ์ ์์ด(๋๋ ๊ธฐ๋ณธ ์ธ์ด)๋ก ์์ฑ
echo __("User registration successful");
echo sprintf(__("Welcome back, %s!"), $username);
echo _n("%d file uploaded", "%d files uploaded", $count);
// ์ฃผ์์ผ๋ก ๋ฒ์ญ๊ฐ์๊ฒ ํํธ ์ ๊ณต
// TRANSLATORS: This appears on the login page
echo __("Please enter your credentials");
?>
#!/bin/bash
# extract_strings.sh
echo "Extracting translatable strings..."
xgettext --language=PHP \
--from-code=UTF-8 \
--keyword=__ \
--keyword=_n:1,2 \
--keyword=_x:1,2c \
--add-comments=TRANSLATORS \
--output=locale/messages.pot \
--package-name="My Project" \
--package-version="1.0" \
--msgid-bugs-address="dev@example.com" \
$(find . -name "*.php")
echo "Updating existing .po files..."
for po in locale/*/LC_MESSAGES/messages.po; do
echo "Updating $po..."
msgmerge --update --backup=none $po locale/messages.pot
done
echo "Done! โ
"
์ด ๋จ๊ณ์์๋ ์ ๋ฌธ ๋ฒ์ญ๊ฐ๋ ๋ฒ์ญ ์๋น์ค๋ฅผ ํ์ฉํด.
์ฌ๋ฅ๋ท ๊ฐ์ ํ๋ซํผ์์ ์ ๋ฌธ ๋ฒ์ญ๊ฐ๋ฅผ ์ฐพ์ ์๋ ์์ด! ์ค์ ๋ก ๋ง์ ๊ฐ๋ฐ์๋ค์ด ์ฌ๋ฅ๋ท์์ ๋ฒ์ญ ์ฌ๋ฅ์ ๊ฐ์ง ๋ถ๋ค๊ณผ ํ์
ํ๊ณ ์๊ฑฐ๋ . ๐
โข ์คํฌ๋ฆฐ์ท ์ฒจ๋ถ: ํ ์คํธ๊ฐ ์ด๋์ ํ์๋๋์ง ๋ณด์ฌ์ฃผ๊ธฐ
โข ๋ฌธ์ ์ ์ ํ: UI ๊ณต๊ฐ ์ ์ฝ์ด ์๋ค๋ฉด ๋ช ์
โข ํค์ค๋งค๋: ๊ฒฉ์์ฒด/๋ฐ๋ง์ฒด ๋ฑ ์คํ์ผ ๊ฐ์ด๋ ์ ๊ณต
โข ๊ฒํ ํ๋ก์ธ์ค: ๋ค์ดํฐ๋ธ ์คํผ์ปค์ ์ต์ข ๊ฒํ
#!/bin/bash
# build_translations.sh
echo "๐จ Building translations..."
# ๋ชจ๋ .po ํ์ผ ์ปดํ์ผ
for po in locale/*/LC_MESSAGES/*.po; do
mo="${po%.po}.mo"
echo "Compiling $po โ $mo"
msgfmt -o "$mo" "$po"
# ์๋ฌ ์ฒดํฌ
if [ $? -ne 0 ]; then
echo "โ Error compiling $po"
exit 1
fi
done
# ํต๊ณ ์ถ๋ ฅ
echo ""
echo "๐ Translation Statistics:"
for po in locale/*/LC_MESSAGES/messages.po; do
lang=$(echo $po | cut -d'/' -f2)
stats=$(msgfmt --statistics "$po" 2>&1)
echo " $lang: $stats"
done
echo ""
echo "โ
All translations compiled successfully!"
GitHub Actions ์์:
# .github/workflows/translations.yml
name: Build Translations
on:
push:
paths:
- 'locale/**/*.po'
pull_request:
paths:
- 'locale/**/*.po'
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Install gettext
run: sudo apt-get install -y gettext
- name: Compile translations
run: |
chmod +x build_translations.sh
./build_translations.sh
- name: Check for errors
run: |
for po in locale/*/LC_MESSAGES/*.po; do
msgfmt -c -v -o /dev/null "$po"
done
- name: Commit compiled files
if: github.event_name == 'push'
run: |
git config --local user.email "action@github.com"
git config --local user.name "GitHub Action"
git add locale/**/*.mo
git commit -m "Update compiled translations" || echo "No changes"
git push
๐ ๊ณ ๊ธ ํ ํฌ๋
ํ์ด์ง ์๋ก๊ณ ์นจ ์์ด ์ธ์ด๋ฅผ ๋ฐ๊พธ๊ณ ์ถ๋ค๋ฉด? AJAX๋ฅผ ํ์ฉํด๋ณด์:
<?php
// api/translate.php
session_start();
require_once '../includes/i18n.php';
header('Content-Type: application/json');
if (isset($_POST['lang'])) {
$_SESSION['language'] = $_POST['lang'];
// ๋ก์ผ์ผ ์ฌ์ค์
setupLocale($_POST['lang']);
// ๋ฒ์ญ๋ ํ
์คํธ๋ค ๋ฐํ
$translations = [
'welcome' => __("Welcome"),
'about' => __("About Us"),
'contact' => __("Contact"),
// ... ํ์ํ ๋ชจ๋ ํ
์คํธ
];
echo json_encode([
'success' => true,
'translations' => $translations
]);
} else {
echo json_encode(['success' => false]);
}
?>
// JavaScript
async function changeLanguage(lang) {
const response = await fetch('api/translate.php', {
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
},
body: `lang=${lang}`
});
const data = await response.json();
if (data.success) {
// DOM ์
๋ฐ์ดํธ
document.querySelectorAll('[data-i18n]').forEach(el => {
const key = el.getAttribute('data-i18n');
if (data.translations[key]) {
el.textContent = data.translations[key];
}
});
}
}
<?php
class TranslationCache {
private $cache = [];
private $cacheFile;
public function __construct($language) {
$this->cacheFile = sys_get_temp_dir() . "/trans_cache_{$language}.php";
$this->load();
}
public function get($text) {
if (isset($this->cache[$text])) {
return $this->cache[$text];
}
$translated = gettext($text);
$this->cache[$text] = $translated;
return $translated;
}
private function load() {
if (file_exists($this->cacheFile)) {
$this->cache = include $this->cacheFile;
}
}
public function save() {
$export = var_export($this->cache, true);
file_put_contents($this->cacheFile, "<?php return {$export};");
}
public function clear() {
$this->cache = [];
if (file_exists($this->cacheFile)) {
unlink($this->cacheFile);
}
}
}
// ์ฌ์ฉ
$transCache = new TranslationCache($language);
echo $transCache->get("Hello, World!");
// ์คํฌ๋ฆฝํธ ์ข
๋ฃ ์ ์ ์ฅ
register_shutdown_function([$transCache, 'save']);
?>
์๋์ด๋ ํ๋ธ๋ฆฌ์ด ๊ฐ์ RTL ์ธ์ด๋ฅผ ์ง์ํ๋ ค๋ฉด:
<?php
function isRTL($language) {
$rtlLanguages = ['ar', 'he', 'fa', 'ur'];
$langCode = substr($language, 0, 2);
return in_array($langCode, $rtlLanguages);
}
$direction = isRTL($language) ? 'rtl' : 'ltr';
?>
<html dir="<?php echo $direction; ?>" lang="<?php echo substr($language, 0, 2); ?>">
<head>
<?php if ($direction === 'rtl'): ?>
<link rel="stylesheet" href="assets/style-rtl.css">
<?php else: ?>
<link rel="stylesheet" href="assets/style.css">
<?php endif; ?>
</head>
<?php
class TranslationMonitor {
private static $missing = [];
public static function track($text) {
$translated = gettext($text);
// ๋ฒ์ญ์ด ์์ผ๋ฉด ์๋ณธ์ด ๊ทธ๋๋ก ๋ฐํ๋จ
if ($translated === $text) {
self::$missing[] = $text;
}
return $translated;
}
public static function report() {
if (empty(self::$missing)) {
return;
}
$unique = array_unique(self::$missing);
error_log("Missing translations: " . count($unique));
foreach ($unique as $text) {
error_log(" - " . $text);
}
}
}
// ๊ฐ๋ฐ ํ๊ฒฝ์์๋ง ์ฌ์ฉ
if (DEVELOPMENT_MODE) {
function __($text) {
return TranslationMonitor::track($text);
}
register_shutdown_function([TranslationMonitor::class, 'report']);
}
?>
๐ ์ฑ๋ฅ ์ธก์ ๊ณผ ์ต์ ํ
๋ค๊ตญ์ด ์ง์์ด ์ฑ๋ฅ์ ๋ฏธ์น๋ ์ํฅ์ ์ธก์ ํ๊ณ ์ต์ ํํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์! ๐
<?php
class I18nBenchmark {
public static function run($iterations = 10000) {
$results = [];
// 1. ์ง์ ๋ฌธ์์ด (๊ธฐ์ค์ )
$start = microtime(true);
for ($i = 0; $i < $iterations; $i++) {
$text = "Hello, World!";
}
$results['direct'] = microtime(true) - $start;
// 2. gettext
$start = microtime(true);
for ($i = 0; $i < $iterations; $i++) {
$text = gettext("Hello, World!");
}
$results['gettext'] = microtime(true) - $start;
// 3. ์บ์๋ gettext
$cache = [];
$start = microtime(true);
for ($i = 0; $i < $iterations; $i++) {
$key = "Hello, World!";
if (!isset($cache[$key])) {
$cache[$key] = gettext($key);
}
$text = $cache[$key];
}
$results['cached'] = microtime(true) - $start;
// ๊ฒฐ๊ณผ ์ถ๋ ฅ
echo "Benchmark Results ({$iterations} iterations):\n";
foreach ($results as $method => $time) {
printf(" %s: %.4f seconds\n", $method, $time);
}
return $results;
}
}
I18nBenchmark::run();
?>
โข PHP์ ๋ฐ์ดํธ์ฝ๋ ์บ์ฑ
โข .mo ํ์ผ ๋ก๋ฉ ์๋ ํฅ์
2. APCu ์ฌ์ฉ
โข ๋ฒ์ญ ๊ฒฐ๊ณผ ๋ฉ๋ชจ๋ฆฌ ์บ์ฑ
โข ์ฌ๋ฌ ์์ฒญ ๊ฐ ๊ณต์
3. .mo ํ์ผ ์ต์ ํ
โข ๋ถํ์ํ ์ฃผ์ ์ ๊ฑฐ
โข ์ฌ์ฉํ์ง ์๋ ๋ฒ์ญ ์ ๋ฆฌ
4. ์ง์ฐ ๋ก๋ฉ
โข ํ์ํ ๋๋ฉ์ธ๋ง ๋ก๋
โข ํ์ด์ง๋ณ ๋ฒ์ญ ํ์ผ ๋ถ๋ฆฌ
5. CDN ํ์ฉ
โข ์ ์ ๋ฒ์ญ ํ์ผ CDN ๋ฐฐํฌ
โข ์ง์ญ๋ณ ์ฃ์ง ์๋ฒ ํ์ฉ
<?php
// ์ต์ ํ๋ ๋ฒ์ญ ์์คํ
class OptimizedTranslation {
private static $instance = null;
private $cache;
private $loaded = [];
private function __construct() {
if (function_exists('apcu_fetch')) {
$this->cache = 'apcu';
} else {
$this->cache = 'memory';
$this->memoryCache = [];
}
}
public static function getInstance() {
if (self::$instance === null) {
self::$instance = new self();
}
return self::$instance;
}
public function translate($text, $domain = 'messages') {
$cacheKey = "{$domain}:{$text}:" . $GLOBALS['language'];
// ์บ์ ํ์ธ
if ($this->cache === 'apcu') {
$cached = apcu_fetch($cacheKey);
if ($cached !== false) {
return $cached;
}
} elseif (isset($this->memoryCache[$cacheKey])) {
return $this->memoryCache[$cacheKey];
}
// ๋๋ฉ์ธ ๋ก๋ (ํ์์)
if (!isset($this->loaded[$domain])) {
textdomain($domain);
$this->loaded[$domain] = true;
}
// ๋ฒ์ญ
$translated = dgettext($domain, $text);
// ์บ์ ์ ์ฅ
if ($this->cache === 'apcu') {
apcu_store($cacheKey, $translated, 3600);
} else {
$this->memoryCache[$cacheKey] = $translated;
}
return $translated;
}
}
// ์ ์ญ ํจ์๋ก ๋ํ
function __($text) {
return OptimizedTranslation::getInstance()->translate($text);
}
?>
๐ ๋ง๋ฌด๋ฆฌํ๋ฉฐ
์! ์ฌ๊ธฐ๊น์ง ์ฝ์๋ค๋ฉด ์ ๋ง ๋๋จํด! ๐
PHP์์ gettext๋ฅผ ํ์ฉํ ๋ค๊ตญ์ด ์ง์์ ๋ํด ๊ฑฐ์ ๋ชจ๋ ๊ฑธ ๋ค๋ค์ด.
ํต์ฌ ๋ด์ฉ์ ์ ๋ฆฌํ์๋ฉด:
โข ์ฝ๋์ ๋ฒ์ญ์ ์๋ฒฝํ ๋ถ๋ฆฌ
โข ์ ๊ณ ํ์ค ๋๊ตฌ
โข ๊ฐ๋ ฅํ ๋ณต์ํ ์ฒ๋ฆฌ
โข ๋ฐ์ด๋ ์ฑ๋ฅ
2. ๊ธฐ๋ณธ ์ํฌํ๋ก์ฐ
โข ์ฝ๋์์ ๋ฒ์ญ ํจ์๋ก ํ ์คํธ ๊ฐ์ธ๊ธฐ
โข xgettext๋ก ๋ฌธ์์ด ์ถ์ถ
โข .po ํ์ผ์์ ๋ฒ์ญ ์์
โข msgfmt๋ก .mo ํ์ผ ์ปดํ์ผ
3. ์ค์ ํ
โข ์์ ํ ๋ฌธ์ฅ ๋จ์๋ก ๋ฒ์ญ
โข ์ปจํ ์คํธ ์ ๋ณด ์ ๊ณต
โข ์๋ํ ์คํฌ๋ฆฝํธ ํ์ฉ
โข ๋ฒ์ญ ํ์ง ๊ด๋ฆฌ
โข ์ฑ๋ฅ ์ต์ ํ
4. ์ฃผ์์ฌํญ
โข ๋ณ์๊ฐ ์๋ ๋ฆฌํฐ๋ด ๋ฌธ์์ด ์ฌ์ฉ
โข .po ์์ ํ ๋ฐ๋์ ์ปดํ์ผ
โข ๋ก์ผ์ผ ์ค์ ํ์ธ
โข ์บ์ฑ ์ด์ ๋์
๋ค๊ตญ์ด ์ง์์ ์ฒ์์๋ ๋ณต์กํด ๋ณด์ด์ง๋ง, ํ ๋ฒ ์ ๋๋ก ๊ตฌ์ถํด๋๋ฉด ์ ๋ง ๊ฐ๋ ฅํ ๋ฌด๊ธฐ๊ฐ ๋ผ. ๐ก๏ธ
์ ์ธ๊ณ ์ฌ์ฉ์๋ค์ด ์์ ์ ์ธ์ด๋ก ์๋น์ค๋ฅผ ์ด์ฉํ ์ ์๋ค๋ ๊ฑด ์์ฒญ๋ ๊ฒฝ์๋ ฅ์ด๊ฑฐ๋ !
ํนํ ์์ฆ์ฒ๋ผ ๊ธ๋ก๋ฒ ์์ฅ์ด ์ค์ํ ์๋์๋ ๋๋์ฑ ๊ทธ๋.
์์ ์คํํธ์
์ด๋ผ๋ ์ฒ์๋ถํฐ ๋ค๊ตญ์ด๋ฅผ ๊ณ ๋ คํด์ ๊ฐ๋ฐํ๋ฉด, ๋์ค์ ํด์ธ ์ง์ถํ ๋ ํจ์ฌ ์์ํ์ง.
๊ทธ๋ฆฌ๊ณ ๊ธฐ์ตํด! ๋ฒ์ญ์ ๋จ์ํ ๋จ์ด๋ฅผ ๋ฐ๊พธ๋ ๊ฒ ์๋์ผ. ๐
๋ฌธํ์ ๋งฅ๋ฝ, ํ์ง ๊ด์ต, ์ฌ์ฉ์ ๊ฒฝํ๊น์ง ๊ณ ๋ คํด์ผ ์ง์ง ์ข์ ๋ค๊ตญ์ด ์๋น์ค๊ฐ ๋๋ ๊ฑฐ์ผ.
ํน์ ๋ฒ์ญ ์์
์ด ํ์ํ๋ค๋ฉด ์ฌ๋ฅ๋ท์์ ์ ๋ฌธ ๋ฒ์ญ๊ฐ๋ค์ ์ฐพ์๋ณด๋ ๊ฒ๋ ์ข์ ๋ฐฉ๋ฒ์ด์ผ. ๊ฐ๋ฐ์ ๊ฐ๋ฐ์๊ฐ, ๋ฒ์ญ์ ์ ๋ฌธ๊ฐ๊ฐ ํ๋ ๊ฒ ์ต๊ณ ๋๊น! ๐
์, ์ด์ ๋น์ ์ ์น ์ ํ๋ฆฌ์ผ์ด์
์ ์ ์ธ๊ณ๋ก ๋ป์ด๋๊ฐ ์ค๋น๊ฐ ๋์ด!
ํ์ดํ
! ๐โจ
๐ ๐ ๐
์ ์ธ๊ณ๊ฐ ๋น์ ์ ์ฌ์ฉ์์ ๋๋ค!
โข PHP gettext ๋งค๋ด์ผ: https://www.php.net/manual/en/book.gettext.php
โข Poedit ๋ค์ด๋ก๋: https://poedit.net/
โข Unicode CLDR (๋ก์ผ์ผ ๋ฐ์ดํฐ): http://cldr.unicode.org/
โข W3C ๊ตญ์ ํ ๊ฐ์ด๋: https://www.w3.org/International/
๊ด๋ จ ํค์๋
๋๊ธ ์์ฑ
์ด ๊ธ์ ๋ํ ์ฌ๋ฌ๋ถ์ ์๊ฐ์ ๋ค๋ ค์ฃผ์ธ์
๋ก๊ทธ์ธ์ด ํ์ํฉ๋๋ค
๋๊ธ์ ์์ฑํ๋ ค๋ฉด ๋จผ์ ๋ก๊ทธ์ธํด์ฃผ์ธ์.
๋๊ธ 0
์ง์์ธ์ ์ฒ - ์ง์ ์ฌ์ฐ๊ถ ๋ณดํธ ๊ณ ์ง
์ง์ ์ฌ์ฐ๊ถ ๋ณดํธ ๊ณ ์ง
- ์ ์๊ถ ๋ฐ ์์ ๊ถ: ๋ณธ ์ปจํ ์ธ ๋ ์ฌ๋ฅ๋ท์ ๋ ์ AI ๊ธฐ์ ๋ก ์์ฑ๋์์ผ๋ฉฐ, ๋ํ๋ฏผ๊ตญ ์ ์๊ถ๋ฒ ๋ฐ ๊ตญ์ ์ ์๊ถ ํ์ฝ์ ์ํด ๋ณดํธ๋ฉ๋๋ค.
- AI ์์ฑ ์ปจํ ์ธ ์ ๋ฒ์ ์ง์: ๋ณธ AI ์์ฑ ์ปจํ ์ธ ๋ ์ฌ๋ฅ๋ท์ ์ง์ ์ฐฝ์๋ฌผ๋ก ์ธ์ ๋๋ฉฐ, ๊ด๋ จ ๋ฒ๊ท์ ๋ฐ๋ผ ์ ์๊ถ ๋ณดํธ๋ฅผ ๋ฐ์ต๋๋ค.
- ์ฌ์ฉ ์ ํ: ์ฌ๋ฅ๋ท์ ๋ช ์์ ์๋ฉด ๋์ ์์ด ๋ณธ ์ปจํ ์ธ ๋ฅผ ๋ณต์ , ์์ , ๋ฐฐํฌ, ๋๋ ์์ ์ ์ผ๋ก ํ์ฉํ๋ ํ์๋ ์๊ฒฉํ ๊ธ์ง๋ฉ๋๋ค.
- ๋ฐ์ดํฐ ์์ง ๊ธ์ง: ๋ณธ ์ปจํ ์ธ ์ ๋ํ ๋ฌด๋จ ์คํฌ๋ํ, ํฌ๋กค๋ง, ๋ฐ ์๋ํ๋ ๋ฐ์ดํฐ ์์ง์ ๋ฒ์ ์ ์ฌ์ ๋์์ด ๋ฉ๋๋ค.
- AI ํ์ต ์ ํ: ์ฌ๋ฅ๋ท์ AI ์์ฑ ์ปจํ ์ธ ๋ฅผ ํ AI ๋ชจ๋ธ ํ์ต์ ๋ฌด๋จ ์ฌ์ฉํ๋ ํ์๋ ๊ธ์ง๋๋ฉฐ, ์ด๋ ์ง์ ์ฌ์ฐ๊ถ ์นจํด๋ก ๊ฐ์ฃผ๋ฉ๋๋ค.
์์ง ๋๊ธ์ด ์์ต๋๋ค.