In this article Emmanual shows us how to localise our PHP-driven websites...
Simple Localization with PHP
How it Works
On PHP DevCenter, Adam Trachtenberg and Joao Prado Maia have described interesting ways to localize web sites with PHP. In this article I've offered another alternative, which should be easy for non-programmers to use. We will take advantage of the user function setstring function:
setstring ( $lang, $string, [$lang, $string])
Here's a working example of a login page in French and English, which could easily be turned into a template:
As you can see, this simple function can be useful when you don't want a web interface for non-programmers to manage different language versions (which the two articles cited above imply). This is ideal in situations where you don't need to display a large amount of content, as is the case of the login page example. (Well, this is not completely accurate as we will see later.)
The setstring function is easy to manage. It uses session variables to maintain the language preference of the user, and possibly a cookie to maintain state after the session finishes. Let's look at the code now, and I'll explain it in detail below.
At the beginning of the script (lines: 12-19) we set the configurations for $defaultlanguage, $use_cookie and $expirecookie. The value of the $defaultlanguage is for newcomers that don't have a cookie or that didn't set the language by clicking on a link. The value of the default language can be anything, as the names of the languages. You can use something like this if you like:
Don't forget to escape your quotes inside the string returned by the function. This will not work: ('klingon', ''arlogh Qoylu'pu'?') but this will: 'klingon', ('\'arlogh Qoylu\'pu\'?'). You can also change single quote to double quotes as in the example above.
Also, don't forget to use HTML entities to escape non-ASCII text. If you use languages like Arabic, Chinese or Hebrew, and depending if you use UTF-8 for text encoding or another variety of encoding that is not based on Unicode (like, for example, GB-2312 for Simplified Chinese), you can use directly this encoding with the setstring function. But you have to set the http-equiv in the <meta> tag like this:
You set $use_cookie to 1 if you want your users to keep their language setting after the session finishes, and set $expirecookie to the number of seconds you want the cookie to last. In the example, $expirecookie is set to expire in 2 days.
The language which the function returns is determined by order of priority:
(1) the value of the lang argument in the GET request (lines: 23, 58)
You set the 'lang' value in the GET request by a link like this so that the page will point to itself: <?= "<a href='" . $PHP_SELF . "?lang=fr'>Franšais</a>" ?>
And will look like this after PHP has processed it: <a href='/divers/phplocalization.html?lang=fr'>Franšais</a>
If the 'lang' value in the GET request is set and if $use_cookie == 1, we set a cookie for the 'lang' value.
(2) the value of the lang keyword for a cookie set previously by setstring (line: 32)
This was set in (1) if the user has clicked on a link with '?lang=$lang'.
(3) the global value $defaultlanguage (lines: 13, 55)
If nothing happened at (1) or (2), use the $defaultlanguage value to set the language.
When the $lang keyword is found, setstring loop in the array that was pass to it (lines: 65-75) and returns the value of the element (which is the $string parameter) after the element that matches the value of $lang. Here's a snippet of code that illustrate the above.
The content provided in this article is not warranted or guaranteed by Developer Shed, Inc.
The content provided is intended for entertainment and/or educational purposes in order to
introduce to the reader key ideas, concepts, and/or product reviews. As such it is incumbent
upon the reader to employ real-world tactics for security and implementation of best practices.
We are not liable for any negative consequences that may result from implementing any information
covered in our articles or tutorials. If this is a hardware review, it is not recommended to open
and/or modify your hardware.