bbcode_add_smiley
bbcode_destroy
BBCode Funktionen
PHP Manual

# bbcode_create

(PECL bbcode >= 0.9.0)

bbcode_create — Erstellt eine BBCode Ressource

### Beschreibung

resource bbcode_create ([ array `$bbcode_initial_tags` ] )

Diese Funktion gibt eine neue BBCode Ressource zurück, die benötigt wird, um BBCode Strings zu parsen.

### Parameter-Liste

`bbcode_initial_tags`

  Ein assoziatives Array, das die die Tag-Namen und Parameter enthält, die benötigt werden, um den BBCode richtig parsen zu können. Die folgenden Schlüssel/Wert Paare werden unterstützt:

  - flags optional - ein Flag, das auf den BBCODE_FLAGS_* Konstanten basiert.
  - type benötigt - ein Flag, das den Typ eines Tag angibt. Benutzt die BBCODE_TYPE_* Konstanten.
  - open_tag benötigt - der HTML Code für den öffnenden Tag.
  - close_tag benötigt - der HTML Code für den schliessenden Tag.
  - default_arg optional - benutzen Sie diesen Wert als Standardargument, wenn keines angegeben wird und tag_type OPTARG enspricht.
  - content_handling optional - Gibt ein Callback, der benutzt wird um den Inhalt zu verändern. Die objektorientierte Schreibweise wird erst seit 0.10.1 unterstützt. Der Typ des Callbacks ist string name(string $content, string $argument)
  - param_handling optional - Gibt den Callback, der für die Veränderung des Arguments gebraucht wird, zurück. Die objektorientierte Schreibweise wird erst seit 0.10.1 unterstützt. Typ des Callbacks ist string name(string $content, string $argument)
  - childs optional - Eine Liste von erlaubten untergeordneten Tags. Die Liste ist durch Kommas abgetrennt. Wenn die Liste mit ! beginnt, gilt sie als die Liste mit den verbotenen untergeordneten Tags.
  - parent optional - Eine Liste von erlaubten übergeordneten Tags. Die Liste ist durch Kommas abgetrennt.

### Rückgabewerte

Gibt eine BBCode_Container Ressource zurück

### Beispiele

Beispiel #1 bbcode_create() Beispiel

`<?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]Dicker Text[/b]
[i]Kursiver 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);
?>`

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    <b>Dicker Text</b>
    [i]Kursiver 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>

bbcode_add_smiley
bbcode_destroy
BBCode Funktionen
PHP Manual