documentation/manual/zh/module_specs/Zend_Currency-Migrating.xml

   1 <sect1 id="zend.currency.migration">
   2
   3     <title> 从前面的版本迁移 </title>
   4
   5     <para>
   6         <code>Zend_Currency</code> 的 API 已经被修改来增加可用性。如果你从一个在本章提到的版本开始使用 <code>Zend_Currency</code>， 请遵循下面的指南来迁移你的脚本到新的 API。
   7     </para>
   8
   9     <sect2 id="zend.currency.usage.migration.fromonezerotwo">
  10
  11         <title> 从 1.0.2 到 1.0.3 或更新的迁移 </title>
  12
  13         <para>
  14             创建 <code>Zend_Currency</code> 的对象变得容易了。现在你不再需要给一个脚本或把它设置为 null。可选的脚本参数现在可以通过 <code>setFormat()</code> 方法来设置。
  15         </para>
  16
  17         <programlisting role="php"><![CDATA[
  18 $currency = new Zend_Currency($currency, $locale);
  19 ]]>
  20         </programlisting>
  21
  22         <para>
  23             <code>setFormat()</code> 方法现在带有一个可以被设置的选项数组。这些选项被设置成永久并覆盖所有先前设置的值，并且又加了一个新的选项 'precision'，下面的选项都被集成了：
  24
  25             <itemizedlist mark='opencircle'>
  26                 <listitem>
  27                     <para>
  28                         <emphasis role="strong">position</emphasis>:
  29                         替换旧的 'rules' 参数。
  30                     </para>
  31                     <para>
  32                         <emphasis role="strong">script</emphasis>:
  33                         替换旧的 'script' 参数。
  34                     </para>
  35                     <para>
  36                         <emphasis role="strong">format</emphasis>:
  37                         替换旧的 'locale' 参数，它不设置新的货币，只设置数字格式。
  38                     </para>
  39                     <para>
  40                         <emphasis role="strong">display</emphasis>:
  41                         替换旧的 'rules' 参数。
  42                     </para>
  43                     <para>
  44                         <emphasis role="strong">precision</emphasis>:
  45                         新参数。
  46                     </para>
  47                     <para>
  48                         <emphasis role="strong">name</emphasis>:
  49                         替换旧的 'rules' 参数。设置货币全名。
  50                     </para>
  51                     <para>
  52                         <emphasis role="strong">currency</emphasis>:
  53                         新参数。
  54                     </para>
  55                     <para>
  56                         <emphasis role="strong">symbol</emphasis>:
  57                         新参数。
  58                     </para>
  59                 </listitem>
  60             </itemizedlist>
  61
  62         </para>
  63
  64         <programlisting role="php"><![CDATA[
  65 $currency->setFormat(array $options);
  66 ]]>
  67         </programlisting>
  68
  69         <para>
  70             The <code>toCurrency()</code> 方法不再支持可选的 'script' 和 'locale' 参数，而是它它带有一个选项数组，数组中包含和 <code>setFormat</code> 方法相同的键。
  71         </para>
  72
  73         <programlisting role="php"><![CDATA[
  74 $currency->toCurrency($value, array $options);
  75 ]]>
  76         </programlisting>
  77
  78         <para>
  79             方法 <code>getSymbol()</code>、 <code>getShortName()</code>、<code>getName()</code>、 <code>getRegionList()</code> 和 <code>getCurrencyList()</code> 不再是静态并可以在对象中被调用。如果没有参数被设定，它们返回一组对象设的值。
  80         </para>
  81
  82     </sect2>
  83
  84 </sect1>