1
0
mirror of https://github.com/php/doc-ru.git synced 2026-03-26 08:42:13 +01:00
Files
archived-doc-ru/reference/strings/functions/addslashes.xml
2024-05-20 22:36:35 +03:00

129 lines
3.8 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: 8cdc6621f9826d04abc3e50438c010804d7e8683 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.addslashes" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>addslashes</refname>
<refpurpose>Экранирует строку слешами</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>addslashes</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
Функция возвращает строку с обратным слешем перед символами, которые нужно экранировать.
Экранируются следующие символы:
<simplelist>
<member>одинарная кавычка (<literal>'</literal>)</member>
<member>двойная кавычка (<literal>"</literal>)</member>
<member>обратный слеш (<literal>\</literal>)</member>
<member>NUL (байт &null;)</member>
</simplelist>
</para>
<para>
Небольшой пример работы функции <function>addslashes</function>
для экранирования перечисленных символов:
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
$str = "O'Reilly?";
eval("echo '" . addslashes($str) . "';");
?>
]]>
</programlisting>
</informalexample>
</para>
<para>
Иногда функцию <function>addslashes</function> некорректно пытаются использовать
для предотвращения <link linkend="security.database.sql-injection">SQL-инъекций</link>.
Не делайте так. Вместо неё используйте подготовленные запросы или функции
экранирования соответствующих модулей работы с базами данных.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
Экранируемая строка.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Функция возвращает заэкранированную строку.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования функции <function>addslashes</function></title>
<programlisting role="php">
<![CDATA[
<?php
$str = "Ваше имя O'Reilly?";
// Выводит: Ваше имя O\'Reilly?
echo addslashes($str);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>stripcslashes</function></member>
<member><function>stripslashes</function></member>
<member><function>addcslashes</function></member>
<member><function>htmlspecialchars</function></member>
<member><function>quotemeta</function></member>
<member><function>get_magic_quotes_gpc</function></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
-->