documentation/manual/en/ref/migration-18.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect1 id="migration.18">
   4     <title>Zend Framework 1.8</title>
   5
   6     <para>
   7         When upgrading from a previous release to Zend Framework 1.8 or higher you
   8         should note the following migration notes.
   9     </para>
  10
  11     <sect2 id="migration.18.zend.controller">
  12         <title>Zend_Controller</title>
  13
  14         <sect3 id="migration.18.zend.controller.router">
  15             <title>Standard Route Changes</title>
  16
  17             <para>
  18                 As translated segments were introduced into the new standard
  19                 route, the '<emphasis>@</emphasis>' character is now a special character
  20                 in the beginning of a route segment. To be able to use it in a
  21                 static segment, you must escape it by prefixing it with second
  22                 '<emphasis>@</emphasis>' character. The same rule now applies for the
  23                 '<emphasis>:</emphasis>' character.
  24             </para>
  25         </sect3>
  26     </sect2>
  27
  28     <sect2 id="migration.18.zend.locale">
  29         <title>Zend_Locale</title>
  30
  31         <sect3 id="migration.18.zend.locale.defaultcaching">
  32             <title>Default caching</title>
  33
  34             <para>
  35                 As with Zend Framework 1.8 a default caching was added. The reason behind this
  36                 change was, that most users had performance problems but did not add caching at
  37                 all. As the I18n core is a bottleneck when no caching is used we decided to add
  38                 a default caching when no cache has been set to <classname>Zend_Locale</classname>.
  39             </para>
  40
  41             <para>
  42                 Sometimes it is still wanted to prevent caching at all even if this decreases
  43                 performance. To do so you can simply disable caching by using the
  44                 <methodname>disableCache()</methodname> method.
  45             </para>
  46
  47             <example id="migration.18.zend.locale.defaultcaching.example">
  48                 <title>Disabling default caching</title>
  49
  50                 <programlisting language="php"><![CDATA[
  51 Zend_Locale::disableCache(true);
  52 ]]></programlisting>
  53             </example>
  54         </sect3>
  55     </sect2>
  56 </sect1>
  57 <!--
  58 vim:se ts=4 sw=4 et:
  59 -->