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

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

<refnamediv>

<refname>strip_tags</refname>

<refpurpose>Видаляє HTML і PHP-теги з рядка</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>string</type><methodname>strip_tags</methodname>

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

<methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam>

</methodsynopsis>

<para>

Ця функція намагається повернути рядок <parameter>str</parameter> з усіма видаленими

NULL-байтами, HTML та PHP тегами. Для видалення використовується той же

рушій, що й у функції <function>fgetss</function>.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>str</parameter></term>

<listitem>

<para>

Вхідний рядок.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>allowable_tags</parameter></term>

<listitem>

<para>

Ви можете використовувати необов'язковий другий параметр, щоб вказати теги,

які не повинні видалятись.

</para>

<note>

<para>

HTML-коментарі та PHP-теги будуть видалені в усякому разі. Це прописано у коді та

не може бути змінено за допомогою <parameter>allowable_tags</parameter>.

</para>

</note>

<note>

<para>

Цей параметр не повинен містити пробілів.

<function>strip_tags</function> розглядає тег як нечутливий до регістру

рядок, який знаходиться між <literal>&lt;</literal> та першим пробілом, або

<literal>&gt;</literal>. Це означає, що

<literal>strip_tags("&lt;br/&gt;", "&lt;br&gt;")</literal> поверне пустий рядок.

</para>

</note>

</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.0.0</entry>

<entry>

<function>strip_tags</function> тепер безпечна для бінарних даних.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Викоритання <function>strip_tags</function></title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<warning>

<para>

Оскільки <function>strip_tags</function> не перевіряє HTML-документ на валідність,

часткові або зламані теги можуть призвести до видалення більших об'ємів

тексту/інформації аніж очікувалося.

</para>

</warning>

<warning>

<para>

Ця функція не змінює атрибутів у тегах, які ви дозволили

за допомогою <parameter>allowable_tags</parameter>, включаючи атрибути

<literal>style</literal> та <literal>onmouseover</literal>,

які шкідливий користувач може розмістити для відображення іншим користувачам.

</para>

</warning>

<note>

<para>

Імена тегів у HTML, які перевищують довжину в 1023 байта

будуть розглядатися як невалідні незалежно від параметра

<parameter>allowable_tags</parameter>.

</para>

</note>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>htmlspecialchars</function></member>

</simplelist>

</para>

</refsect1>

</refentry>