Blog o PHPi tematyce pokrewnej

Niekiedy zdarza się sytuacja, w której aplikacja webowa będzie dostępna w kilku językach. Proponowane przeze mnie rozwiązanie pozwoli nam, w łatwy sposób opracować wiele wersji narodowych naszego oprogramowania.

wymagania

Na samym początku musimy sprawdzić, czy php może korzystać z rozszerzenia gettext. Dokonamy tego poprzez wykonanie poniższego skryptu:

phpinfo();

Kolejnym punktem jest pobranie oprogramowania gettext. Istnieją oczywiście wersje na różne systemy operacyjne. Ja skorzystam z tej dla Windows’a. Można ją znaleźć TUTAJ. Po udanym zainstalowaniu możemy śmiało stwierdzić, że spełniliśmy wszystkie wymagania natury technicznej. Czas przejść do implementacji.

prosty przykład

Zobaczmy jak wygląda najprostszy skrypt lang.php bez obsługi wielojęzycznej.

echo 'czesc';

Teraz postarajmy się go tak przerobić, by mógł korzystać z omawianego rozwiązania:

// en_US wykorzystawane w sciezce
// UWAGA wywolanie setlocale() musi sie udac!
// Warto sprawdzac co zwraca ow funkcja!!!!
// Pamietaj ze na roznych serwerach
// ustawienie tej opcji moze wygladac inaczej
setlocale(LC_ALL,'en_US.UTF8');

// messages wykorzystwane w sciezce
// do pliku - jest to jego nazwa messages.mo
$my_name = 'messages';

// wiazemy nazwe messages z katalogiem
// gdzie znajdowac sie beda tlumaczenia
bindtextdomain($my_name,'./locale');

// ustalamy aktywna domene
// korzysta z niej gettext
textdomain($my_name);

// alias tej funkcji to _("czesc")
echo gettext("czesc");

Przejdźmy do szczegółowej analizy tego co znajduje się powyżej. Setlocale() umożliwia nam określenie lokalnych ustawień językowych. Zmienna $my_name to tzw. domena aplikacji. Bindtextdomain() wiąże ów nazwę z konkretną lokalizacją, przeszukiwaną w celu odnalezienia przełożonych fraz. Co jednak ważne, opisane dotychczas kroki okazują się konieczne, gdyż na ich podstawie wyznaczana jest ścieżka do pliku tłumaczeń. Popatrzmy:

Textdomain() ustala aktywną domenę, która będzie używana przy wywołaniach gettext() - funkcji, która w parametrze otrzymuje łańcuch znaków do przetłumaczenia.

W kolejnym etapie musimy wygenerować plik *.po, który zawierać będzie wszystkie string’i z skryptu lang.php wymagające przełożenia. Wykorzystujemy pobrane oprogramowanie gettext, a dokładniej xgettext. W moim przypadku wszystko sprowadzi się do jednego polecenia:

Oto co otrzymamy - messages.po:

Jak widać msgid zawiera oryginalne frazy, natomiast naszym zadaniem jest wprowadzenie tłumaczeń w msgstr, oraz ewentualnych zmian w nagłówku. Końcowy efekt:

Pozostaje generacja messages.mo. Z pomocą przychodzi nam msgfmt. U mnie wystarczy wykonanie poniższej komendy z cmd:

To wszystko! Na koniec umieszczamy plik messages.mo w odpowiedniej lokalizacji i uruchamiamy skrypt lang.php. Działający kod wraz z dodatkowymi uwagami znajdziecie TUTAJ.