PhpMessageSource.php 1.75 KB
Newer Older
Qiang Xue committed
1 2 3
<?php
/**
 * @link http://www.yiiframework.com/
Qiang Xue committed
4
 * @copyright Copyright (c) 2008 Yii Software LLC
Qiang Xue committed
5 6 7 8 9
 * @license http://www.yiiframework.com/license/
 */

namespace yii\i18n;

Qiang Xue committed
10 11
use Yii;

Qiang Xue committed
12 13 14
/**
 * PhpMessageSource represents a message source that stores translated messages in PHP scripts.
 *
Qiang Xue committed
15 16 17 18 19 20 21 22
 * PhpMessageSource uses PHP arrays to keep message translations.
 *
 * - Each PHP script contains one array which stores the message translations in one particular
 *   language and for a single message category;
 * - Each PHP script is saved as a file named as `[[basePath]]/LanguageID/CategoryName.php`;
 * - Within each PHP script, the message translations are returned as an array like the following:
 *
 * ~~~
Qiang Xue committed
23 24 25 26
 * return array(
 *     'original message 1' => 'translated message 1',
 *     'original message 2' => 'translated message 2',
 * );
Qiang Xue committed
27
 * ~~~
Qiang Xue committed
28 29 30 31 32 33 34 35 36 37
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @since 2.0
 */
class PhpMessageSource extends MessageSource
{
	/**
	 * @var string the base path for all translated messages. Defaults to null, meaning
	 * the "messages" subdirectory of the application directory (e.g. "protected/messages").
	 */
Qiang Xue committed
38
	public $basePath = '@app/messages';
Qiang Xue committed
39 40 41 42 43 44 45

	/**
	 * Loads the message translation for the specified language and category.
	 * @param string $category the message category
	 * @param string $language the target language
	 * @return array the loaded messages
	 */
Qiang Xue committed
46
	protected function loadMessages($category, $language)
Qiang Xue committed
47
	{
Qiang Xue committed
48 49 50 51 52
		$messageFile = Yii::getAlias($this->basePath) . "/$language/$category.php";
		if (is_file($messageFile)) {
			$messages = include($messageFile);
			if (!is_array($messages)) {
				$messages = array();
Qiang Xue committed
53 54
			}
			return $messages;
Qiang Xue committed
55 56
		} else {
			Yii::error("Message file not found: $messageFile", __CLASS__);
Qiang Xue committed
57
			return array();
Qiang Xue committed
58
		}
Qiang Xue committed
59 60
	}
}