<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.addslashes" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>addslashes</refname>

<refpurpose>Stellt bestimmten Zeichen eines Strings ein "\" voran</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>string</type><methodname>addslashes</methodname>

<methodparam><type>string</type><parameter>string</parameter></methodparam>

</methodsynopsis>

<para>

Gibt einen String (Zeichenkette) zurück, in dem bestimmten Zeichen ein

Backslash "\" voran gestellt wurde. Die behandelten Zeichen sind:

<simplelist>

<member>einfaches Anführungszeichen (<literal>'</literal>)</member>

<member>doppeltes Anführungszeichen (<literal>"</literal>)</member>

<member>Backslash (<literal>\</literal>)</member>

<member>NUL (das NUL-Byte)</member>

</simplelist>

</para>

<para>

Ein Anwendungsfall für die Verwendung von <function>addslashes</function>

ist das Maskieren der zuvor erwähnten Zeichen in einer Zeichenkette, die von

PHP ausgewertet werden soll.

<example>

<title>Maskieren von Zeichen</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<para>

Die Funktion <function>addslashes</function> wird manchmal

fälschlicherweise verwendet, um zu versuchen,

<link linkend="security.database.sql-injection">SQL-Injection</link> zu

verhindern. Stattdessen sollten datenbankspezifische Maskierungsfunktionen

und/oder vorbereitete Anweisungen verwendet werden.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>string</parameter></term>

<listitem>

<para>

Die zu maskierende Zeichenkette.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Gibt die maskierte Zeichenkette zurück.

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Ein <function>addslashes</function>-Beispiel</title>

<programlisting role="php">

</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>