bbcode_create

(PECL bbcode >= 0.9.0)

bbcode_create — Crea un resource de BBCode

Descripción

resource bbcode_create ([ array $bbcode_initial_tags = NULL ] )

Esta función retorna un nuevo resource de BBCode usado para analizar strings BBCode.

Parámetros

bbcode_initial_tags

Un array asociativo que contiene el nombre de la etiqueta como clave y los parámetros requeridos para analizar correctamente el BBCode por su valor. Se soportan los siguientes pares clave/valor:

  • flags opcional - un set de flags basado en las constantes BBCODE_FLAGS_*.
  • type requerido - un int indicando el tipo de etiqueta. Usar las constantes BBCODE_TYPE_*.
  • open_tag requerido - el string HTML usado para reemplazar a la etiqueta de apertura.
  • close_tag requerido - el string HTML usado para reemplazar a la etiqueta de cierre.
  • default_arg opcional - usar este valor como el argumento por defecto si no se indica uno y tag_type es de tipo OPTARG.
  • content_handling opcional - proporciona la llamada de retorno usada para modificar el contenido. La Notación Orientada a Objetos soportada únicamente desde 0.10.1 El prototipo para la llamada de retorno es: string nombre(string $contenido, string $argumento)
  • param_handling opcional - proporciona la llamada de retorno usada para la modificación del argumento. La Notación Orientada a Objetos soportada únicamente desde 0.10.1 El prototipo para la llamada de retorno es: string nombre(string $contenido, string $argumento)
  • childs opcional - lista de hijos aceptados para la etiqueta. El formato de la lista es un string de valores separados por comas. Si la lista comienza con ! entonces es la lista de hijos no permitidos para la etiqueta.
  • parent opcional - lista de padres aceptados para la etiqueta. El formato de la lista es un string de valores separados por comas.

Valores devueltos

Retorna un resource BBCode_Container

Ejemplos

Ejemplo #1 Ejemplo de 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>'),
);
$texto = <<<EOF
[b]Texto en negrita[/b]
[i]Texto en cursiva[/i]
[url]http://www.php.net/[/url]
[url=http://pecl.php.net/][b]Contenido[/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, $texto);
?>

El resultado del ejemplo sería:

<b>Texto en negrita</b>
[i]Texto en cursiva[/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>