bbcode_create

(PECL bbcode >= 0.9.0)

bbcode_create — Создает ресурс BBCode

Описание

bbcode_create ([ array $bbcode_initial_tags = NULL ] ) : resource

Эта функция возвращает новый ресурс BBCode, используемый для разбора строк с BBCode.

Список параметров

bbcode_initial_tags

Ассоциативный массив, содержащий имя тега в качестве ключа и параметры, необходимые для корректного разбора BBCode, как значение. Поддерживаются следующие пары ключ/значение:

  • flags необязательный - флаг, устанавливаемый на основе констант BBCODE_FLAGS_*.
  • type обязательный - целочисленное значение, указывающее тип тега. Использует константы BBCODE_TYPE_*.
  • open_tag обязательный - HTML-строка для замены открывающего тега.
  • close_tag обязательный - HTML-строка для замены закрывающего тега.
  • default_arg необязательный - это значение используется как параметр по умолчанию, если он не задан и tag_type установлен в OPTARG.
  • content_handling необязательный - Задает callback-функцию для модификации контента. Объектно ориентированная нотация поддерживается только в версии 0.10.1. Прототип callback-функции это строка "name(string $content, string $argument)"
  • param_handling необязательный - Задает callback-функцию для модификации аргумента. Объектно-ориентированная нотация поддерживается только в версии 0.10.1. Прототип callback-функции это строка "name(string $content, string $argument)"
  • childs необязательный - Список разрешенных дочерних тегов для этого тега. Формат списка - строка, с запятыми в качестве разделителя. Если список начинается с !, это список запрещенных дочерних тегов для данного тега.
  • parent необязательный - Список разрешенных родителей для этого тега. Формат списка - строка, с запятыми в качестве разделителя.

Возвращаемые значения

Возвращает BBCode_Container

Примеры

Пример #1 Пример использования bbcode_create()

<?php
$arrayBBCode=array(
    ''=>         array('type'=>BBCODE_TYPE_ROOT,  'childs'=>'!i'),
    'i'=>        array('type'=>BBCODE_TYPE_NOARG, 'open_tag'=>'<i>',
                    'close_tag'=>'</i>', 'childs'=>'b'),
    'url'=>      array('type'=>BBCODE_TYPE_OPTARG,
                    'open_tag'=>'<a href="{PARAM}">', 'close_tag'=>'</a>',
                    'default_arg'=>'{CONTENT}',
                    'childs'=>'b,i'),
    'img'=>      array('type'=>BBCODE_TYPE_NOARG,
                    'open_tag'=>'<img src="', 'close_tag'=>'" />',
                    'childs'=>''),
    'b'=>        array('type'=>BBCODE_TYPE_NOARG, 'open_tag'=>'<b>',
                    'close_tag'=>'</b>'),
);
$text=<<<EOF
[b]Bold Text[/b]
[i]Italic Text[/i]
[url]http://www.php.net/[/url]
[url=http://pecl.php.net/][b]Content Text[/b][/url]
[img]http://static.php.net/www.php.net/images/php.gif[/img]
[url=http://www.php.net/]
[img]http://static.php.net/www.php.net/images/php.gif[/img]
[/url]
EOF;
$BBHandler=bbcode_create($arrayBBCode);
echo bbcode_parse($BBHandler,$text);
?>

Результат выполнения данного примера:

<b>Bold Text</b>
[i]Italic Text[/i]
<a href="http://www.php.net/">http://www.php.net/</a>
<a href="http://pecl.php.net/"><b>Content Text</b></a>
<img src="http://static.php.net/www.php.net/images/php.gif" />
<a href="http://www.php.net/">
[img]http://static.php.net/www.php.net/images/php.gif[/img]
</a>