Simple Localization with PHP

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:

Example 1: The Login Page (try me!)

| |



The HTML Source of the Login Page


<? include_once ("./setstring.inc") ?>



<?= "<a href='" . $PHP_SELF . "?lang=fr'>Français</a>" ?> |

<?= "<a href='" . $PHP_SELF . "?lang=en'>English</a>" ?> |

<?= "<a href='" . $PHP_SELF . "?logoff=1'>Logoff</a>" ?>



<form method="post" action="<?=$PHP_SELF?>">

    <p>

        <b><?=setstring ( 'fr', 'Enregistrement requis', 'en', 'Login required')?></b>

    </p>

    <p>

        <?=setstring ('fr', 'Nom de login:', 'en', 'Login')?><br><input type="text" name="uid" size="8">

    </p>

    <p>

        <?=setstring ( 'fr', 'Mot de passe:', 'en', 'Password')?><br><input type="password" name="pwd" size="8">

    </p>

    <p>

        <input type="submit" name="processlogin" value=" <?= setstring ( 'fr', 'Confirmer', 'en', 'Submit') ?> ">

    </p>

</form>

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.

The setstring Listing top


';

$ct = 0;

$FH = file ("/home/emm/web/scriptdigital.com/divers/setstring.inc") or die ("Error");

foreach ( $FH as $line ) {

	if  (  !preg_match ("/$pat/", $line) )  {

		$ct++;

		printf ("%2d  %s", $ct, $ct, $line);

	}

}

?>

How it Works top

Before looking at the script itself, it is important to note that you'll need to put your include statement (the include ("./setstring.inc") call) before any HTML output. This is because setstring can use cookies; see setcookie in the PHP manual for details.

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:

$defaultlanguage = "schtroumph"


<?= setstring ('schtroumph', 'Quelle schtroumphe est-il ?', 'klingon', "'arlogh Qoylu'pu'?") ?>

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:


<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">



or 



<meta http-equiv="Content-Type" content="text/html; charset=gb2312">

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:

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.


$lang = 'en';

setstring ('fr', 'Allo', 'en', 'Hello');



for ($i = 0; $i < count ($args); $i++) {

    if ( $args[$i] == $lang ) {                 # $lang == 'en'

        return $args[$i + 1];                   # return 'Hello'

    }

Extending setstring top

If you have repetitive text, you could use setstring with constants, and here's how to do it for the login example above. First, create a file for each language and define the same constants.

french.inc


<?

####################################

# french.inc

# $Date$ - $RCSfile$ - $Revision$

####################################



define ('LOGIN_REQUIRED', "Enregistrement requis");

define ('LOGIN', "Nom de login");

define ('PASSWORD', "Mot de passe");

?>



english.inc


<?

####################################

# english.inc

# $Date$ - $RCSfile$ - $Revision$

####################################



define ('LOGIN_REQUIRED', "Login Required");

define ('LOGIN', "Login");

define ('PASSWORD', "Password");

?>



Then, you just have to use setstring once to build different languages versions. Here, we use setstring to pass the right language file to include.

Example 2: The Login Page


<? include_once ("./setstring.inc") ?>



<? include ( setstring ( 'fr', './french.inc', 'en', './english.inc') )?>



<?= "<a href='" . $PHP_SELF . "?lang=fr'>Fran&ccedil;ais</a>" ?> |

<?= "<a href='" . $PHP_SELF . "?lang=en'>English</a>" ?> |

<?= "<a href='" . $PHP_SELF . "?logoff=1'>Logoff</a>" ?>



<form method="post" action="<?=$PHP_SELF?>">

	<p>

		<b><?=LOGIN_REQUIRED?></b>

	</p>

	<p>

		<?=LOGIN?><br><input type="text" name="uid" size="8">

	</p>

	<p>

		<?=PASSWORD?><br><input type="password" name="pwd" size="8">

	</p>

	<p>

		<input type="submit" name="processlogin" value=" <?= SUBMIT ?> ">

	</p>

</form>



If you have a lot of text you can use an include function with setstring. You create a file for each language as above, and then use the include function:

Example 3: include and setstring


<? include_once ("./setstring.inc") ?>



<?= "<a href='" . $PHP_SELF . "?lang=fr'>Fran&ccedil;ais</a>" ?> |

<?= "<a href='" . $PHP_SELF . "?lang=en'>English</a>" ?> |

<?= "<a href='" . $PHP_SELF . "?logoff=1'>Logoff</a>" ?>



<? include ( setstring ( 'fr', './filefrench.inc', 'en', './fileenglish.inc') )?>

Versions History top

Version 1.0

First release: December 19 2002.
Open Source (BSD license).
A big thanks to Hans Zaunere, Jim Byrne, Jaz-Michael King, and Deke Smith for reviewing this text.

Requirements top

PHP greater than 4.1.x

Download top

Save this page to your disk as "setstring.inc". (This link will open a new window.)


Notes

Internationalization and Localization with PHP
by Adam Trachtenberg
http://www.onlamp.com/pub/a/php/2002/11/28/php_i18n.html?page=1

Gettext
by Joao Prado Maia
http://www.onlamp.com/pub/a/php/2002/06/13/php.html