t()函数在Drupal7中的用法详解

记记Drupal7中t()函数的相关用法，如有疏漏之处，还望指正。

每个开发者必须理解的三个功能：

2 S# `- d% A/ M: v6 W; Z1.t()是怎样被执行的？
  G0 I  c6 i7 ?! m
2.Drupal怎样建立翻译表？
+ Z' M) j& Q: p8 ]# O4 o  Z
* E, ?- }5 i& O" f( Y! Q: V3.怎样使用t()实现一些其它功能？


8 z5 g- k4 d( ?3 H' R0 @
, i- w0 v( [5 p4 {0 F) a' O. {首先，让我们看下t()的执行过程。如果多语言模块没被开启，并且第二个参数没被传递到t()，它仅仅返回原来的字符串。如果多语言模块被开启，并且传递给t()第二个参数，Drupal将试图用适当的语言替换掉默认的字符串。


; D! f1 I5 Z( t% i) r
1 z0 N, |+ I5 M$ p然后，让我们看下Drupal怎样生成翻译信息的。这有两个方面：人为的和技术上的。人为的方面，在Drupal官方上，有很多志愿者贡献自己的翻译文件（.po），你能下载安装它们。技术上的，该翻译组不是简单地搜索源代码调用t()，而是使用一个自动工具挑选出代码，且重新标示所有可翻译的字符串，这个工具只能翻译字面意思。你可以这样写：

) I& {  g  h+ M8 }0 ^2 Z  _t('This is my string');
( [5 B+ t  x* u$ q2 j6 j
  w" a( O" |# e1 M. a但如果你象下面这样写，它不会有任何作用：
" ^, g( f+ U7 B6 o$ y" d
) {0 C7 `8 J5 @$ Z# D. c4 F- R$variable = 'This is a string';
2 q: W" J, B. K. h$ y5 K+ m
t($variable);

+ u% Z3 b, p( P& b为什么上面的代码不会有任何作用？因为当这个自动工具运行这段代码时，它不会执行这段代码，仅仅读取它。那个自动工具很难确认哪个字符串才是$variable变量。
' ~4 W% [8 l1 I
所以，最好给t()的第一个参数一个字符串，而不是变量。
. |, R8 f$ O2 X9 `% t9 D

6 A$ f2 C, N% ]  J
最后，是关于t()怎样完成一些其它的功能。它提供了一个比常规方法更安全的变量处理方法。在许多php应用程序中，你可能见过这样的代码：
4 x; p' D- J$ H+ j+ A
7 a$ }) T* O* P" h2 Fprint "Welcome, $username.";
) k  u. s, M, S/ Z8 G0 k4 B! ?6 S
上面的代码就是显示用户输入的一个用户名。糟糕的是，用户可能输入一段Javascript或者其它代码在username这个变量里，这将会影响你的程序。
8 h1 B( g9 D9 `0 L3 n7 ~& B# A
t()提供一个多样的更安全的替代符。这时，它需要一个关联数组作为第二个参数。下面就是一段代码例子：

$values = array('@user' => $username);

print t('Welcome, @user', $values);

- _9 q; a% O7 W5 {上面的替换过程经过Drupal的安全处理。
7 k. u8 R8 |) B8 y4 p
2 g- P- f' X% Z
3 [( ]2 c; p2 l' Q7 V& h
如果替换符是以@开头，在替换它之前，Drupal将使用内置的check_plain()对值进行处理。
# p2 z. y. A" [2 p) V
- }* G3 ^5 q& M( i) E, x% x* G如果你确信你的字符串不包含任何危险信息，那么你可以使用!开头。Drupal不会对值进行任何处理，除了替换。比如：
( X0 U. g8 S# l/ u! _
; \# r0 a+ I- U5 T' U$values = array('!url' => 'http://example.com');

5 g) J" U! p2 X' q$ nprint t('The website can be found at !url', $values);


; K: w: }/ [* B% d; H& v
第三种替换符是以%开头，它过滤掉代码，并告诉Drupal字符串是重点，

$values = array('%color' => 'blue');
. I" W- q3 _% K" j" S
print t('My favorite color is %color.', $values);
; X" J+ S, I4 C: Q
它不仅移除危险的字符串，而且会在替换的文本两端加入强调标签，比如“<em></em>”。你可以在theme_placeholder()里查看详细实现。
9 H# O/ B7 s- s% A! ^
1 x  v6 F6 G7 c4 I  B$ N1 C

还有更多的功能能被t()实现，format_plural()等。如果你象查看更多，请访问：http://api.drupal.org/api/function/t/7。
+ \4 m9 D/ ^5 G2 K0 S1 v2 @
, B; }% d, I7 r. _# e$ L9 x感谢溯游分享！！！


( H+ q# G$ z( ]& p3 \- X- b( N