Files
php-doc-ru/reference/mysql/functions/mysql-escape-string.xml
Shein Alexey a248b2a8b3 Updated translation.
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@311483 c90b9560-bf6c-de11-be94-00142212c4b1
2011-05-27 11:13:47 +00:00

153 lines
4.4 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<!-- $Revision$ -->
<refentry xml:id="function.mysql-escape-string" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysql_escape_string</refname>
<refpurpose>Экранирует строку для использования в mysql_query</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>mysql_escape_string</methodname>
<methodparam><type>string</type><parameter>unescaped_string</parameter></methodparam>
</methodsynopsis>
<para>
Функция экранирует <parameter>unescaped_string</parameter> таким
образом, после чего её можно безопасно использовать в <function>mysql_query</function>.
Данная функция устарела.
</para>
<para>
Функция идентична <function>mysql_real_escape_string</function>, исключая тот
факт, что <function>mysql_real_escape_string</function> принимает
параметром ещё и идентификатор соединения и экранирует строку
с учетом текущей кодировки. <function>mysql_escape_string</function>
не делает этого и результат работы не зависит от кодировки,
в который вы работаете с БД.
</para>
&warn.deprecated.function-5-3-0.removed-6-0-0;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>unescaped_string</parameter></term>
<listitem>
<para>
Экранируемая строка.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает экранируемую строку.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
Данная функция теперь выдает предупреждение уровня E_DEPRECATED.
</entry>
</row>
<row>
<entry>4.3.0</entry>
<entry>
Функция помечена как устаревшая, ее не следует больше использовать.
Используйте вместо нее <function>mysql_real_escape_string</function>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>mysql_escape_string</function></title>
<programlisting role="php">
<![CDATA[
<?php
$item = "Zak's Laptop";
$escaped_item = mysql_escape_string($item);
printf("Escaped string: %s\n", $escaped_item);
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Escaped string: Zak\'s Laptop
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<function>mysql_escape_string</function> не экранирует символы
<literal>%</literal> и <literal>_</literal>.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mysql_real_escape_string</function></member>
<member><function>addslashes</function></member>
<member>Директиву <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>.</member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->