Просмотр файла manual-ru/language.modifier.escape.html

Размер файла: 6.61Kb
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  4. <title>escape</title>
  5. <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
  6. <link rel="home" href="index.html" title="Руководство по Smarty">
  7. <link rel="up" href="language.modifiers.html" title="Chapter 5. Модификаторы переменных">
  8. <link rel="prev" href="language.modifier.default.html" title="default">
  9. <link rel="next" href="language.modifier.indent.html" title="indent">
  10. </head>
  11. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  12. <div class="navheader">
  13. <table width="100%" summary="Navigation header">
  14. <tr><th colspan="3" align="center">escape</th></tr>
  15. <tr>
  16. <td width="20%" align="left">
  17. <a accesskey="p" href="language.modifier.default.html">Prev</a> </td>
  18. <th width="60%" align="center">Chapter 5. Модификаторы переменных</th>
  19. <td width="20%" align="right"> <a accesskey="n" href="language.modifier.indent.html">Next</a>
  20. </td>
  21. </tr>
  22. </table>
  23. <hr>
  24. </div>
  25. <div class="sect1" title="escape">
  26. <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  27. <a name="language.modifier.escape"></a>escape</h2></div></div></div>
  28. <p>
  29. Используется для кодирования / экранирования спецсимволов по алгоритмам
  30. экранирования HTML, URL'ов, одиночных кавычек, hex-экранирования,
  31. hex-сущностей, javascript и экранирования почтовых адресов.
  32. По умолчанию активирован режим экранирования HTML.
  33. </p>
  34. <div class="informaltable"><table border="1">
  35. <colgroup>
  36. <col align="center">
  37. <col align="center">
  38. <col align="center">
  39. <col align="center">
  40. <col align="center">
  41. <col>
  42. </colgroup>
  43. <thead><tr>
  44. <th align="center">Позиция параметра</th>
  45. <th align="center">Тип</th>
  46. <th align="center">Обязателен</th>
  47. <th align="center">Possible Values</th>
  48. <th align="center">По умолчанию</th>
  49. <th>Описание</th>
  50. </tr></thead>
  51. <tbody>
  52. <tr>
  53. <td align="center">1</td>
  54. <td align="center">string</td>
  55. <td align="center">Нет</td>
  56. <td align="center">
  57. <code class="literal">html</code>,<code class="literal">htmlall</code>,<code class="literal">url</code>,<code class="literal">urlpathinfo</code>,<code class="literal">quotes</code>,<code class="literal">hex</code>,<code class="literal">hexentity</code>,<code class="literal">javascript</code>,<code class="literal">mail</code>
  58. </td>
  59. <td align="center"><code class="literal">html</code></td>
  60. <td>формат экранирования</td>
  61. </tr>
  62. <tr>
  63. <td align="center">2</td>
  64. <td align="center">string</td>
  65. <td align="center">Нет</td>
  66. <td align="center">
  67. <code class="literal">ISO-8859-1</code>, <code class="literal">UTF-8</code>, ... любая кодировка, поддерживаемая функцией <a class="ulink" href="http://php.net/htmlentities" target="_top">htmlentities()</a>
  68. </td>
  69. <td align="center"><code class="literal">ISO-8859-1</code></td>
  70. <td>Кодировка для экранирования, передаваемая в htmlentities() и т.д.</td>
  71. </tr>
  72. </tbody>
  73. </table></div>
  74. <div class="example">
  75. <a name="id2657241"></a><p class="title"><b>Example 5.10. escape</b></p>
  76. <div class="example-contents">
  77. <pre class="programlisting">
  78.  
  79. &lt;?php
  80. $smarty-&gt;assign('articleTitle',
  81. "'Stiff Opposition Expected to Casketless Funeral Plan'"
  82. );
  83. $smarty-&gt;assign('EmailAddress','smarty@example.com');
  84. ?&gt;
  85.  
  86. </pre>
  87. <p>
  88. Шаблон:
  89. </p>
  90. <pre class="programlisting">
  91.  
  92. {$articleTitle}
  93. {$articleTitle|escape}
  94. {$articleTitle|escape:'html'} {* экранирует &amp; " ' &lt; &gt; *}
  95. {$articleTitle|escape:'htmlall'} {* экранирует ВСЕ HTML-сущности *}
  96. {$articleTitle|escape:'url'}
  97. {$articleTitle|escape:'quotes'}
  98. &lt;a href="mailto:{$EmailAddress|escape:"hex"}"&gt;{$EmailAddress|escape:"hexentity"}&lt;/a&gt;
  99. {$EmailAddress|escape:'mail'} {* конвертирует e-mail в текст *}
  100. {'mail@example.com'|escape:'mail'}
  101.  
  102. </pre>
  103. <p>
  104. Результат обработки:
  105. </p>
  106. <pre class="screen">
  107.  
  108. 'Stiff Opposition Expected to Casketless Funeral Plan'
  109. &amp;#039;Stiff Opposition Expected to Casketless Funeral Plan&amp;#039;
  110. &amp;#039;Stiff Opposition Expected to Casketless Funeral Plan&amp;#039;
  111. &amp;#039;Stiff Opposition Expected to Casketless Funeral Plan&amp;#039;
  112. %27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27
  113. \'Stiff Opposition Expected to Casketless Funeral Plan\'
  114. &lt;a href="mailto:%62%6f%..snip..%65%74"&gt;&amp;#x62;&amp;#x6f;&amp;#x62..snip..&amp;#x65;&amp;#x74;&lt;/a&gt;
  115. smarty [AT] example [DOT] com
  116. mail [AT] example [DOT] com
  117.  
  118. </pre>
  119. <p>
  120. Обратите внимание, что родные функции PHP могут использоваться в качестве
  121. модификаторов, так что следующие приёмы сработают
  122. </p>
  123. <pre class="screen">
  124.  
  125. {* GET-переменная rewind передает текущий адрес *}
  126. &lt;a href="{$SCRIPT_NAME}?page=foo&amp;rewind={$smarty.server.REQUEST_URI|urlencode}"&gt;click here&lt;/a&gt;
  127. </pre>
  128. <p>
  129. Это очень полезно для e-mail'ов, но см. также
  130. <a class="link" href="language.function.mailto.html" title="{mailto}">{mailto}</a>
  131. </p>
  132. <pre class="screen">
  133.  
  134. {* email address mangled *}
  135. &lt;a href="mailto:{$EmailAddress|escape:'hex'}"&gt;{$EmailAddress|escape:'mail'}&lt;/a&gt;
  136.  
  137. </pre>
  138. </div>
  139. </div>
  140. <br class="example-break"><p>
  141. См. также
  142. <a class="link" href="language.escaping.html" title="Предотвращение обработки Smarty">Предотвращение обработки Smarty</a>,
  143. <a class="link" href="language.function.mailto.html" title="{mailto}">{mailto}</a>
  144. и
  145. <a class="link" href="tips.obfuscating.email.html" title="Сокрытие E-mail адреса">Сокрытие E-mail адреса</a>.
  146. </p>
  147. </div>
  148. <div class="navfooter">
  149. <hr>
  150. <table width="100%" summary="Navigation footer">
  151. <tr>
  152. <td width="40%" align="left">
  153. <a accesskey="p" href="language.modifier.default.html">Prev</a> </td>
  154. <td width="20%" align="center"><a accesskey="u" href="language.modifiers.html">Up</a></td>
  155. <td width="40%" align="right"> <a accesskey="n" href="language.modifier.indent.html">Next</a>
  156. </td>
  157. </tr>
  158. <tr>
  159. <td width="40%" align="left" valign="top">default </td>
  160. <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
  161. <td width="40%" align="right" valign="top"> indent</td>
  162. </tr>
  163. </table>
  164. </div>
  165. </body>
  166. </html>