bbcode_create

(PECL bbcode >= 0.9.0)

bbcode_createErstellt eine BBCode Ressource

Beschreibung

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

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 Bitmaske, das auf den BBCODE_FLAGS_* Konstanten basiert.
  • type erforderlich - eine Ganzzahl, das den Typ eines Tag angibt. Die BBCODE_TYPE_* Konstanten sind zu verwenden.
  • open_tag erforderlich - der HTML Code für den öffnenden Tag.
  • close_tag erforderlich - der HTML Code für den schliessenden Tag.
  • default_arg optional - verwende diesen Wert als Standardargument, wenn keines angegeben wird und tag_type OPTARG enspricht.
  • content_handling optional - Gibt den Callback an, der benutzt wird um den Inhalt zu verändern. Die objektorientierte Schreibweise wird erst seit 0.10.1 unterstützt. Die Signatur des Callbacks ist string name(string $content, string $argument).
  • param_handling optional - Gibt den Callback an, der benutzt wird um das Argument zu verändern. Die objektorientierte Schreibweise wird erst seit 0.10.1 unterstützt. Die Signatur des Callbacks ist string name(string $content, string $argument)
  • childs optional - Eine Liste von erlaubten untergeordneten Tags. Die Liste ist durch Kommas getrennt. Wenn die Liste mit ! beginnt, gilt sie als die Liste mit verbotenen untergeordneten Tags.
  • parent optional - Eine Liste von erlaubten übergeordneten Tags. Die Liste ist durch Kommas getrennt.

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]Fetter Text[/b]
[i]Kursiver Text[/i]
[url]http://www.php.net/[/url]
[url=http://pecl.php.net/][b]Inhaltstext[/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>Fetter Text</b>
[i]Kursiver Text[/i]
<a href="http://www.php.net/">http://www.php.net/</a>
<a href="http://pecl.php.net/"><b>Inhaltstext</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>