potaka/bbcode

php parser for bb code

BB code parser for php 7.0+

Builds:, _(*1)

, _(*2)

, _(*3)

There are two parts - tokenizer and parser., _(*4)

Tokenization - convert string to tokens., _(*5)

BbCodeParser - convert bbCodeTokens to html (+ some validations), _(*6)

The Easy Way

$tokenizer = new \Potaka\BbCode\Tokenizer\Tokenizer();

$bbText = '[b]bold[/b]text[u]under[i]line[/i][/u]';

$tokenized = $tokenizer->tokenize($text);
$factory = new  \Potaka\BbCode\Factory();
$bbcode = $factory->getFullBbCode();
$html = $bbcode->format($tokenized);

The value if html is, _(*7)

<b>bold</b>text<u>under<i>line</i></u>

Installation

composer require potaka/bbcode

Internal explanation

Tokenization

For example, _(*8)

$bbText = '[b]bold[/b]text[u]under[i]line[/i][/u]';

Will be tokenized to, _(*9)

Tag:
  type: null,
  tags:
    tag1:
      type: b
      tags:
        tag1:
          type: null
          text: bold
    tag2:
      type: null
      text: text
    tag3:
      type: u
      tags:
        tag1:
          type: null,
          text: under
        tag2:
          type: i
          tags:
            tag1:
              type: null,
              text: line

Tokenized to html

You need to have valid bb code tags. Build in tags are available in https://github.com/angelk/bbCode/tree/master/src/Potaka/BbCode/Tag, _(*10)

Building the parser:, _(*11)

use Potaka\BbCode;
use Potaka\BbCode\Tokenizer;

use Potaka\BbCode\Tag\Bold;
use Potaka\BbCode\Tag\Underline;
use Potaka\BbCode\Tag\Italic;

use Potaka\BbCode\Tag\Link;

$bbcode = new BbCode();

Lets add the b code, _(*12)

$bold = new Bold();
$bbcode->addTag($bold);

Lets format the token from above, _(*13)

$tokenizer = new Tokenizer();
$tokenized = $tokenizer->tokenize($bbText);

$bbcode->format($tokenized);

will return, _(*14)

<b>bold</b>text[u]under[i]line[/i][/u]

u and i are not formated cuz tags are not added., _(*15)

Lets add em., _(*16)

$underline = new Underline();
$bbcode->addTag($underline);

$italic = new Italic();
$bbcode->addTag($italic);

Test again, _(*17)

$bbcode->format($tokenized);

Result:, _(*18)

<b>bold</b>text<u>under[i]line[/i]</u>

Why i is not converted? Cuz u doesn't allow child tag of type i. Lets fix this, _(*19)

$bbcode->addAllowedChildTag($underline, $italic);

Everything should work now!, _(*20)

Whats the purpose of this allowing? Imagine you have link [url]http://google.bg[/url]. What if someone try to put link in link [url=http://google.bg]google.[url=http://gmail.com]bg[/url][/url]? This will generate, _(*21)

<a href="http://google.bg">
  google.<a href="http://gmail.com">bg</a>
</a>

This html is invalid. It could even provide xss. This is why you should not allow url inside url., _(*22)