(window.webpackJsonp=window.webpackJsonp||[]).push([[2472],{2881:function(t,s,n){"use strict";n.r(s);var a=n(31),e=Object(a.a)({},(function(){var t=this,s=t.$createElement,n=t._self._c||s;return n("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[n("h1",{attrs:{id:"localization"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#localization"}},[t._v("#")]),t._v(" Localization")]),t._v(" "),n("h2",{attrs:{id:"localizing-strings-with-gettext"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#localizing-strings-with-gettext"}},[t._v("#")]),t._v(" Localizing strings with gettext()")]),t._v(" "),n("p",[t._v("GNU "),n("code",[t._v("gettext")]),t._v(" is an extension within PHP that must be included at the "),n("code",[t._v("php.ini")]),t._v(":")]),t._v(" "),n("div",{staticClass:"language-php extra-class"},[n("pre",{pre:!0,attrs:{class:"language-php"}},[n("code",[n("span",{pre:!0,attrs:{class:"token php language-php"}},[n("span",{pre:!0,attrs:{class:"token delimiter important"}},[t._v("<?php")]),t._v("\n"),n("span",{pre:!0,attrs:{class:"token comment"}},[t._v("// Set language to French")]),t._v("\n"),n("span",{pre:!0,attrs:{class:"token function"}},[t._v("putenv")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),n("span",{pre:!0,attrs:{class:"token string single-quoted-string"}},[t._v("'LC_ALL=    fr_FR'")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(";")]),t._v("\n"),n("span",{pre:!0,attrs:{class:"token function"}},[t._v("setlocale")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),n("span",{pre:!0,attrs:{class:"token constant"}},[t._v("LC_ALL")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),n("span",{pre:!0,attrs:{class:"token string single-quoted-string"}},[t._v("'fr_FR'")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(";")]),t._v("\n\n"),n("span",{pre:!0,attrs:{class:"token comment"}},[t._v("// Specify location of translation tables for 'myPHPApp' domain")]),t._v("\n"),n("span",{pre:!0,attrs:{class:"token function"}},[t._v("bindtextdomain")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),n("span",{pre:!0,attrs:{class:"token string double-quoted-string"}},[t._v('"myPHPApp"')]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),n("span",{pre:!0,attrs:{class:"token string double-quoted-string"}},[t._v('"./locale"')]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(";")]),t._v("\n\n"),n("span",{pre:!0,attrs:{class:"token comment"}},[t._v("// Select 'myPHPApp' domain")]),t._v("\n"),n("span",{pre:!0,attrs:{class:"token function"}},[t._v("textdomain")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),n("span",{pre:!0,attrs:{class:"token string double-quoted-string"}},[t._v('"myPHPApp"')]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(";")]),t._v("\n\n")])])])]),n("p",[n("strong",[t._v("myPHPApp.po")])]),t._v(" "),n("div",{staticClass:"language-php extra-class"},[n("pre",{pre:!0,attrs:{class:"language-php"}},[n("code",[n("span",{pre:!0,attrs:{class:"token comment"}},[t._v("#: /Hello_world.php:56")]),t._v("\nmsgid "),n("span",{pre:!0,attrs:{class:"token string double-quoted-string"}},[t._v('"Hello"')]),t._v("\nmsgstr "),n("span",{pre:!0,attrs:{class:"token string double-quoted-string"}},[t._v('"Bonjour"')]),t._v("\n\n"),n("span",{pre:!0,attrs:{class:"token comment"}},[t._v("#: /Hello_world.php:242")]),t._v("\nmsgid "),n("span",{pre:!0,attrs:{class:"token string double-quoted-string"}},[t._v('"How are you?"')]),t._v("\nmsgstr "),n("span",{pre:!0,attrs:{class:"token string double-quoted-string"}},[t._v('"Comment allez-vous?"')]),t._v("\n\n")])])]),n("p",[t._v("gettext() loads a given post-complied .po file, a .mo. which maps your to-be translated strings as above.")]),t._v(" "),n("p",[t._v("After this small bit of setup code, translations will now be looked for in the following file:")]),t._v(" "),n("ul",[n("li",[n("code",[t._v("./locale/fr_FR/LC_MESSAGES/myPHPApp.mo")]),t._v(".")])]),t._v(" "),n("p",[t._v("Whenever you call "),n("code",[t._v("gettext('some string')")]),t._v(", if "),n("code",[t._v("'some string'")]),t._v(" has been translated in the "),n("code",[t._v(".mo")]),t._v(" file, the translation will be returned. Otherwise, "),n("code",[t._v("'some string'")]),t._v(" will be returned untranslated.")]),t._v(" "),n("div",{staticClass:"language-php extra-class"},[n("pre",{pre:!0,attrs:{class:"language-php"}},[n("code",[n("span",{pre:!0,attrs:{class:"token comment"}},[t._v("// Print the translated version of 'Welcome to My PHP Application'")]),t._v("\n"),n("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("echo")]),t._v(" "),n("span",{pre:!0,attrs:{class:"token function"}},[t._v("gettext")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),n("span",{pre:!0,attrs:{class:"token string double-quoted-string"}},[t._v('"Welcome to My PHP Application"')]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(";")]),t._v("\n\n"),n("span",{pre:!0,attrs:{class:"token comment"}},[t._v("// Or use the alias _() for gettext()")]),t._v("\n"),n("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("echo")]),t._v(" "),n("span",{pre:!0,attrs:{class:"token function"}},[t._v("_")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),n("span",{pre:!0,attrs:{class:"token string double-quoted-string"}},[t._v('"Have a nice day"')]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),n("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(";")]),t._v("\n\n")])])]),n("h4",{attrs:{id:"syntax"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#syntax"}},[t._v("#")]),t._v(" Syntax")]),t._v(" "),n("ul",[n("li",[n("code",[t._v("string gettext (string $message)")])])])])}),[],!1,null,null,null);s.default=e.exports}}]);