From 63c79dd722d5a8dd09b8828a4711d496680c0062 Mon Sep 17 00:00:00 2001 From: xue <> Date: Mon, 3 Apr 2006 21:55:33 +0000 Subject: Cleanup of I18N. --- framework/I18N/core/MessageSource_gettext.php | 218 +++++++++++++------------- 1 file changed, 109 insertions(+), 109 deletions(-) (limited to 'framework/I18N/core/MessageSource_gettext.php') diff --git a/framework/I18N/core/MessageSource_gettext.php b/framework/I18N/core/MessageSource_gettext.php index b358a618..78fa5259 100644 --- a/framework/I18N/core/MessageSource_gettext.php +++ b/framework/I18N/core/MessageSource_gettext.php @@ -29,53 +29,53 @@ require_once(dirname(__FILE__).'/Gettext/TGettext.php'); /** * MessageSource_gettext class. - * + * * Using Gettext MO format as the message source for translation. * The gettext classes are based on PEAR's gettext MO and PO classes. - * + * * See the MessageSource::factory() method to instantiate this class. - * + * * @author Xiang Wei Zhuo * @version v1.0, last update on Fri Dec 24 16:18:44 EST 2004 * @package System.I18N.core */ class MessageSource_gettext extends MessageSource -{ +{ /** * Message data filename extension. - * @var string + * @var string */ - protected $dataExt = '.mo'; - + protected $dataExt = '.mo'; + /** * PO data filename extension - * @var string + * @var string */ protected $poExt = '.po'; - + /** * Separator between culture name and source. - * @var string + * @var string */ protected $dataSeparator = '.'; - + function __construct($source) { $this->source = (string)$source; - } - + } + /** * Load the messages from a MO file. * @param string MO file. * @return array of messages. - */ + */ protected function &loadData($filename) { $mo = TGettext::factory('MO',$filename); $mo->load(); $result = $mo->toArray(); - + $results = array(); $count=0; foreach($result['strings'] as $source => $target) @@ -83,61 +83,61 @@ class MessageSource_gettext extends MessageSource $results[$source][] = $target; //target $results[$source][] = $count++; //id $results[$source][] = ''; //comments - } + } return $results; } - + /** * Determin if the MO file source is valid. * @param string MO file - * @return boolean true if valid, false otherwise. - */ + * @return boolean true if valid, false otherwise. + */ protected function isValidSource($filename) { return is_file($filename); } - + /** * Get the MO file for a specific message catalogue and cultural * vairant. * @param string message catalogue - * @return string full path to the MO file. - */ + * @return string full path to the MO file. + */ protected function getSource($variant) { return $this->source.'/'.$variant; } - + /** * Get the last modified unix-time for this particular catalogue+variant. * Just use the file modified time. * @param string catalogue+variant * @return int last modified in unix-time format. - */ + */ protected function getLastModified($source) { if(is_file($source)) return filemtime($source); else return 0; - } - + } + /** * Get all the variants of a particular catalogue. * @param string catalogue name - * @return array list of all variants for this catalogue. + * @return array list of all variants for this catalogue. */ protected function getCatalogueList($catalogue) { $variants = explode('_',$this->culture); $source = $catalogue.$this->dataExt; - + $catalogues = array($source); $variant = null; - + for($i = 0, $k = count($variants); $i < $k; ++$i) - { + { if(isset($variants[$i]{0})) { $variant .= ($variant)?'_'.$variants[$i]:$variants[$i]; @@ -146,23 +146,23 @@ class MessageSource_gettext extends MessageSource } } $byDir = $this->getCatalogueByDir($catalogue); - $catalogues = array_merge($byDir,array_reverse($catalogues)); + $catalogues = array_merge($byDir,array_reverse($catalogues)); return $catalogues; - } + } + - /** * Traverse through the directory structure to find the catalogues. * This should only be called by getCatalogueList() * @param string a particular catalogue. - * @return array a list of catalogues. + * @return array a list of catalogues. * @see getCatalogueList() */ private function getCatalogueByDir($catalogue) { $variants = explode('_',$this->culture); $catalogues = array(); - + $variant = null; for($i = 0, $k = count($variants); $i < $k; ++$i) @@ -175,11 +175,11 @@ class MessageSource_gettext extends MessageSource } return array_reverse($catalogues); } - + /** * Get the variant for a catalogue depending on the current culture. * @param string catalogue - * @return string the variant. + * @return string the variant. * @see save() * @see update() * @see delete() @@ -188,7 +188,7 @@ class MessageSource_gettext extends MessageSource { if(is_null($catalogue)) $catalogue = 'messages'; - + foreach($this->getCatalogueList($catalogue) as $variant) { $file = $this->getSource($variant); @@ -198,79 +198,79 @@ class MessageSource_gettext extends MessageSource } return false; } - + private function getPOFile($MOFile) { $filebase = substr($MOFile, 0, strlen($MOFile)-strlen($this->dataExt)); return $filebase.$this->poExt; } - + /** - * Save the list of untranslated blocks to the translation source. + * Save the list of untranslated blocks to the translation source. * If the translation was not found, you should add those * strings to the translation source via the append() method. * @param string the catalogue to add to - * @return boolean true if saved successfuly, false otherwise. + * @return boolean true if saved successfuly, false otherwise. */ function save($catalogue='messages') { $messages = $this->untranslated; - + if(count($messages) <= 0) return false; - + $variants = $this->getVariants($catalogue); - + if($variants) list($variant, $MOFile, $POFile) = $variants; else - list($variant, $MOFile, $POFile) = $this->createMessageTemplate($catalogue); - - if(is_writable($MOFile) == false) - throw new TMessageSourceIOException("Unable to save to file {$MOFile}, file must be writable."); + list($variant, $MOFile, $POFile) = $this->createMessageTemplate($catalogue); + + if(is_writable($MOFile) == false) + throw new TIOException("Unable to save to file {$MOFile}, file must be writable."); if(is_writable($POFile) == false) - throw new TMessageSourceIOException("Unable to save to file {$POFile}, file must be writable."); - + throw new TIOException("Unable to save to file {$POFile}, file must be writable."); + //set the strings as untranslated. $strings = array(); foreach($messages as $message) - $strings[$message] = ''; - + $strings[$message] = ''; + //load the PO $po = TGettext::factory('PO',$POFile); $po->load(); $result = $po->toArray(); - + $existing = count($result['strings']); - + //add to strings to the existing message list - $result['strings'] = array_merge($result['strings'],$strings); - + $result['strings'] = array_merge($result['strings'],$strings); + $new = count($result['strings']); - + if($new > $existing) - { + { //change the date 2004-12-25 12:26 $result['meta']['PO-Revision-Date'] = @date('Y-m-d H:i:s'); - + $po->fromArray($result); $mo = $po->toMO(); if($po->save() && $mo->save($MOFile)) { - if(!empty($this->cache)) - $this->cache->clean($variant, $this->culture); + if(!empty($this->cache)) + $this->cache->clean($variant, $this->culture); return true; } else return false; } return false; - } + } /** * Delete a particular message from the specified catalogue. * @param string the source message to delete. * @param string the catalogue to delete from. - * @return boolean true if deleted, false otherwise. + * @return boolean true if deleted, false otherwise. */ function delete($message, $catalogue='messages') { @@ -279,47 +279,47 @@ class MessageSource_gettext extends MessageSource list($variant, $MOFile, $POFile) = $variants; else return false; - + if(is_writable($MOFile) == false) - throw new TMessageSourceIOException("Unable to modify file {$MOFile}, file must be writable."); + throw new TIOException("Unable to modify file {$MOFile}, file must be writable."); if(is_writable($POFile) == false) - throw new TMessageSourceIOException("Unable to modify file {$POFile}, file must be writable."); - + throw new TIOException("Unable to modify file {$POFile}, file must be writable."); + $po = TGettext::factory('PO',$POFile); $po->load(); - $result = $po->toArray(); - + $result = $po->toArray(); + foreach($result['strings'] as $string => $value) { if($string == $message) { $result['meta']['PO-Revision-Date'] = @date('Y-m-d H:i:s'); unset($result['strings'][$string]); - + $po->fromArray($result); $mo = $po->toMO(); if($po->save() && $mo->save($MOFile)) { if(!empty($this->cache)) $this->cache->clean($variant, $this->culture); - return true; + return true; } else - return false; + return false; } } - + return false; } - + /** * Update the translation. * @param string the source string. * @param string the new translation string. * @param string comments * @param string the catalogue of the translation. - * @return boolean true if translation was updated, false otherwise. - */ + * @return boolean true if translation was updated, false otherwise. + */ function update($text, $target, $comments, $catalogue='messages') { $variants = $this->getVariants($catalogue); @@ -327,77 +327,77 @@ class MessageSource_gettext extends MessageSource list($variant, $MOFile, $POFile) = $variants; else return false; - + if(is_writable($MOFile) == false) - throw new TMessageSourceIOException("Unable to update file {$MOFile}, file must be writable."); + throw new TIOException("Unable to update file {$MOFile}, file must be writable."); if(is_writable($POFile) == false) - throw new TMessageSourceIOException("Unable to update file {$POFile}, file must be writable."); - - + throw new TIOException("Unable to update file {$POFile}, file must be writable."); + + $po = TGettext::factory('PO',$POFile); $po->load(); - $result = $po->toArray(); - + $result = $po->toArray(); + foreach($result['strings'] as $string => $value) { if($string == $text) { $result['strings'][$string] = $target; $result['meta']['PO-Revision-Date'] = @date('Y-m-d H:i:s'); - + $po->fromArray($result); $mo = $po->toMO(); - + if($po->save() && $mo->save($MOFile)) { if(!empty($this->cache)) $this->cache->clean($variant, $this->culture); - return true; + return true; } else return false; } - } - + } + return false; } - - + + /** * Returns a list of catalogue as key and all it variants as value. - * @return array list of catalogues + * @return array list of catalogues */ function catalogues() { return $this->getCatalogues(); } - + /** * Returns a list of catalogue and its culture ID. This takes care * of directory structures. * E.g. array('messages','en_AU') - * @return array list of catalogues + * @return array list of catalogues */ protected function getCatalogues($dir=null,$variant=null) { $dir = $dir?$dir:$this->source; $files = scandir($dir); - + $catalogue = array(); - + foreach($files as $file) - { - if(is_dir($dir.'/'.$file) + { + if(is_dir($dir.'/'.$file) && preg_match('/^[a-z]{2}(_[A-Z]{2,3})?$/',$file)) { - + $catalogue = array_merge($catalogue, $this->getCatalogues($dir.'/'.$file, $file)); } - + $pos = strpos($file,$this->dataExt); - - if($pos >0 + + if($pos >0 && substr($file,-1*strlen($this->dataExt)) == $this->dataExt) { $name = substr($file,0,$pos); @@ -411,19 +411,19 @@ class MessageSource_gettext extends MessageSource } $details[0] = $cat; $details[1] = $culture; - - + + $catalogue[] = $details; } } sort($catalogue); - + return $catalogue; - } + } protected function createMessageTemplate($catalogue) { - if(is_null($catalogue)) + if(is_null($catalogue)) $catalogue = 'messages'; $variants = $this->getCatalogueList($catalogue); $variant = array_shift($variants); @@ -432,13 +432,13 @@ class MessageSource_gettext extends MessageSource $dir = dirname($mo_file); if(!is_dir($dir)) @mkdir($dir); - if(!is_dir($dir)) + if(!is_dir($dir)) throw new TException("Unable to create directory $dir"); $po = TGettext::factory('PO',$po_file); $result['meta']['PO-Revision-Date'] = @date('Y-m-d H:i:s'); $result['strings'] = array(); - + $po->fromArray($result); $mo = $po->toMO(); if($po->save() && $mo->save($mo_file)) -- cgit v1.2.3