Рейтинг@Mail.ru
 

Шаг 5

Внешние форматтеры

Мы реализовали основной функционал. Обычно этого достаточно, но иногда приходится решать специфические задачи. Допустим та же подсветка кодов.

Для таких моментов нужно предусмотреть возможность подключения внешних фоматтеров. Что мы сейчас и сделаем. Сделать это не сложно, так как мы уже научились обрабатывать нуждый участок текста своей функцией. Сначала сделаем сам форматтер, тоесть функцию, которая расскрасит код. Сразу по взрослому - с нумерацией строк.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<?php

/**   
* Функция подcветки PHP кода
* @param string $str  //обрабатываеемая строка
* @return string  
*/  
        
function PHP($code)
        {        
            
//Отменяем действие htmlspecialchars()
            
$code  htmlspecialchars_decode($code);
            
//Меняем короткие теги <? на кошерные <?php
            
if(substr($code,0,2) == "<?"
                
$code "<?php\n".trim($code"<?ph");
            
// Заполняем массив числами по количеству переносов строк в тексте
            
$arr range(1substr_count($code"\n") + 1);
            
// Формируем линейку нумерации строк
            
$num implode("\n"$arr);
              
// Сделаем её красивенько      
                
$line '<div style="float:left;' 
                                     
.' border-right:1px solid;' 
                                     
.' background-color:#000066;'
                                     
.' padding-left:3px;'
                                     
.' padding-right:3px;'                                 
                                     
.' margin-right:2px;font-size:13px'
                                     
.' margin-top:-5px;'
                                     
.' text-align:right;">'
                                     
."<code style=\"color:#FFFFFF\">\n"$num  ."\n</code></div>";

              
// Возвращаем раскрашеный код с нумерацией строк                       
            
return '<div class="php">'
                   
$line highlight_string($codetrue) .
                   
'</div>'
        }          
Поместим эту функцию в одноименный файл php.php специальную папку formatters рядом со скриптом.

Теперь в конфигу добавим еще один массив, в котором будем определять возможные форматтеры:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

  
.
  .
  .
             
// Не парные теги (смайлики и иже с ними)                       
             
'single_tags' => array(
                                      
'[:)]'     =>   '<img src="'IRB_BB_PATH .'/smiles/1.gif" />',
                                      
'[:(]'     =>   '<img src="'IRB_BB_PATH .'/smiles/2.gif" />',
                                      
'[;)]'     =>   '<img src="'IRB_BB_PATH .'/smiles/3.gif" />',
                                      
'[:D]'     =>   '<img src="'IRB_BB_PATH .'/smiles/4.gif" />',
                                   ),
 
              
// Форматтеры. Форматтер должен присутствовать в комплекте (в папке formatters)                      
             
'formatters'  => array(
                                      
'[code=php]'  =>  'php',
                                   ), 
  .
  .
  .       


А в сам скрипт добавим еще одну функцию, которая будет выбирать и подключать нужный форматтер.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<?php

/**   
* Функция подключения форматтеров.  
* Подключает нужный и вызывает функцию
* @param array $match   //массив значений
* @return string 
*/        
    
function getFormat($match)
    {  
            global 
$configBBcode;

    
// Получаем название форматтера         
        
$format str_replace("\n"""strtolower($match[1]));
    
// Проверяем, есть ли такой в наличии
        
if(in_array($format$configBBcode['formatters']))
        {
    
// Подключаем нужный файл
             
include_once dirname(__FILE__) .'/formatters/'$format .'.php';
             
// Запускаем функцию из переменной
             
return  $format($match[2]); 
        }
            
        return 
'No formatter '$match[1]; 
    }


Тут есть интересный момент. Мы запускаем функцию из переменной. Чтобы было понятнее, посмотрите на "рисунок"
1
2
3
4
5
6
7
8
9
10
<?php

// Вот такая запись
    
$function 'getResult';
    
$result $function();
    
// идентична такой
    
$result getResult();   


Мы получаем из тега название файла и функции. Проверяем наличие и, если есть, подключаем нужный файл и запускаем одноименную функцию. Ну а саму функцию выбора запустим по образу и подобию ссылок и картинок. Вот полный скрипт:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
<?php

// Конфига
    
include './config.php';

/**   
* Основная функция интерпретатора
* @param string $text   //обрабатываемый текст
* @return string 
*/   
    
function createBBtags($text$replace true)
    {   
// Разбираем конфигурционный массив в текущую таблицу переменных
        
global $configBBcode;
        
extract($configBBcode);
// Разбираем полученные массивы на массивы элементов            
        
$bb_open      array_keys($setup_bb);
        
$bb_close     array_values($setup_bb);                                                        
        
$html_open    array_keys($setup_html);
        
$html_close   array_values($setup_html);
        
$bb_single    array_keys($single_tags);
        
$html_single  array_values($single_tags);
        
    
//  Oчистим текст от иероглифов
        
$text str_replace($tmp_open''$text);
        
$text str_replace($tmp_close''$text);
        
$text str_replace($tmp_single''$text);
                  
        
$text str_replace("\r"""$text);
        
$text str_replace("\t""    "$text);
        
/** 
Если режим очистки - 
удаляем бб-теги из текста
*/                 
    
if(!$replace)
    {              
        
$text str_replace($bb_open''$text);
        
$text str_replace($bb_close''$text);
        
$text str_replace($bb_single''$text);
        
$text preg_replace('#\\[(code|url|img|video)[^\s]*?\].*?\[/\\1\]#usi'''$text);
    }
    else
    {        
/** 
Если включен режим bb-тегов, 
заменим заявленные теги на одиночные символы и дальше по тексту 
Используется функция str_ireplace(), чтобы BB-теги были регистронезависимыми
*/ 

                   
        
$text str_ireplace($bb_open$tmp_open$text);
        
$text str_ireplace($bb_close$tmp_close$text);
        
$text str_ireplace($bb_single$tmp_single$text);   
/** 
Начинается разбор полетов. Сначала уничтожаем пустые теги.
Тут же за одно считаем, сколько открывающих и сколько закрывающих
*/ 
        
$open_cnt = array();
   
        foreach(
$tmp_open as $k => $v)
        {
           
$text preg_replace("#"$v ."\s*?"$tmp_close[$k] ."#us"""$text);
           
$cnt substr_count($text$v);
           
           if(
$cnt 0)
           {
               
$open_cnt[$v] = $cnt;
               
$close_cnt[$v] = substr_count($text$tmp_close[$k]);
           }              
        }
        
/** 
Дальше уничтожаем непарные теги
Регулярка составлена так, что удаляет последний заявленный символ
Это дает возможность удалить незакрытые теги с конца текста,
не трогая закрытые.
*/     
        
foreach($open_cnt as $k => $v)
        {
                
            if(
$v $close_cnt[$k])
            {
                for(
$i 0$i $v $close_cnt[$k]; ++$i)
                    
$text preg_replace('#'$k .'(?!.*'$k .')#us'''$text);
            }
        
        }
    }             
// Обрабатываем текст        
        
$text mBwordwrap($text100);                 
        
$text htmlspecialchars($text);
           
        
//Функция getFormat() сама разберется, какой форматтер использовать. 
        
if(count($formatters))
            
$text preg_replace_callback('#\[code=([^\] ]+?)\](.+?)\[/code=\\1\]#si''getFormat'$text);         
        
//Обработка ссылок. Пройдут только те, которые начинаются с http:// и https:// и не содержат пробелов        
        
if($links)
        {                   
            
$text preg_replace_callback('#\[url=http(s*)://([^\] ]+?)\](.+?)\[/url\]#si''createLink1'$text);
            
$text preg_replace_callback('#\[url\]http(s*)://(.+?)\[/url\]#si''createLink2'$text);
        }    
        
//Картинки. Тоже http:// и без пробелов. На вс. случай запретим GET параметры      
        
if($images)    
            
$text preg_replace_callback('#\[img\]http://([^\] \?]+?)\[/img\]#si''createImg'$text); 
            
        
//Видео. Та же песня      
        
if($video)    
            
$text preg_replace_callback('#\[video\]http://([^\] \?]+?).flv\[/video\]#si''createSwf'$text);         
             
/** 
Если включен режим bb-тегов,
меняем обратно временные символы на HTML теги
*/    
    
if($replace)
    {       
        
$text str_replace($tmp_open$html_open$text);
        
$text str_replace($tmp_close$html_close$text);
        
$text str_replace($tmp_single$html_single$text);
    }        
// Сохраняем оригинальное форматирование                
        
$text str_replace('  ''&nbsp;&nbsp;'$text);    
        
$text nl2br($text);
// За ушкО на солнышкО                       
        
return $text;            
    } 
    
 
/**   
* Функция - аналог wordwrap()  для кодировки UTF-8
* @param string $str  //обрабатываеемая строка
* @param int $width     //максимальная длина слова
* @param string $break //разделитель
* @return string  
*/ 
           
    
function mBwordwrap($text$width 90$break "\n")
    {
       return 
preg_replace('#([^\s]{'$width .'})#u''$1'$break $text);
    }  

/**   
* Функции генерации ссылок
* @param array $match 
* @return string 
*/ 
    
    
function createLink1($match)
    {  
        
$match[2] = str_replace("\n"""$match[2]);
        return 
'<a href="http'$match[1] .'://'htmlspecialchars($match[2]) 
             .
'" target="_blanck" >'
htmlspecialchars($match[3]) .'</a>';
    }
    
    function 
createLink2($match)
    {  
        
$match[2] = str_replace("\n"""$match[2]);
        return 
'<a href="http'$match[1] .'://'htmlspecialchars($match[2]) 
             .
'" target="_blanck" >'
htmlspecialchars($match[2]) .'</a>'
    }

/**   
* Функция генерации картинок
* @param array $match 
* @return string 
*/
        
    
function createImg($match)
    {  
        
$match[1] = str_replace("\n"""$match[1]);
        return 
'<img src="http://'
htmlspecialchars($match[1]) .'" border="0" />'
    }
    
/**   
* Функция генерации видеоролика
* @param array $match 
* @return string 
*/
        
    
function createSwf($match)
    {  
        
$match[1] = str_replace("\n"""$match[1]);
        return  
'<center><object type="application/x-shockwave-flash" data="'
              
IRB_BB_PATH .'/images/video.swf" height="300" width="400">'
              
'<param name="bgcolor" value="#333333" /><param name="allowFullScreen" value="true" />'
              
'<param name="allowScriptAccess" value="always" />'
              
'<param name="movie" value="'
              
IRB_BB_PATH .'/images/video.swf" />'
              
'<param name="FlashVars" value="way=http://'
              
htmlspecialchars($match[1]) .'.flv&amp;swf='
              
IRB_BB_PATH .'/images/video.swf&amp;w=400&amp;h=300&amp;'
              
'pic=http://&amp;autoplay=0&amp;tools=1&amp;'
              
'skin=white&amp;volume=70&amp;q=&amp;comment=" />'
              
'</object></center>';
    } 
 
    
/**   
* Функция подключения форматтеров.  
* Подключает нужный и вызывает функцию
* @param array $match   //массив значений
* @return string 
*/        
    
function getFormat($match)
    {  
    
// Разбираем конфигу
        
global $configBBcode;
    
// Получаем название форматтера         
        
$format str_replace("\n"""strtolower($match[1]));
    
// Проверяем, есть ли такой в наличии
        
if(in_array($format$configBBcode['formatters']))
        {
    
// Подключаем нужный файл
             
include_once dirname(__FILE__) .'/formatters/'$format .'.php';
             
// Запускаем функцию из переменной
             
return  $format($match[2]); 
        }
            
        return 
'No formatter '$match[1]; 
    }
          
/////////////////////////////////////////////////////////////////////
   
    
if(!empty($_POST['ok']))    
    {     
        
$text = !empty($_POST['text']) ? $_POST['text'] : null;
        
$check createBBtags($textfalse);
        
        if(empty(
$check))
            echo 
'Нет текста';
        else         
            echo 
createBBtags($text);
    }
    
    
?>
<form action="" name="post" id="post" method="post">        
<textarea name="text" id="text" cols="40" rows="10"><?php echo htmlspecialchars($text);?></textarea><br />    
<input name="ok" type="submit" />    
</form> 


Теперь можно попробовать допустим такой тестовый текст:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
[code=php]<?
    function getFormat($match)
    {  
    // Разбираем конфигу
        global $configBBcode;
        extract($configBBcode);
    // Получаем название форматтера         
        $format = str_replace("\n", "", strtolower($match[1]));
    // Проверяем, есть ли такой в наличии
        if(in_array($format, $formatters))
        {
    // Подключаем нужный файл
             include_once dirname(__FILE__) .'/formatters/'. $format .'.php';
             // Запускаем функцию из переменной
             return  $format($match[2]); 
        }
            
        return 'No formatter '. $match[1]; 
    } 
[/code=php]
Вот таким образом можно подключить любой форматтер и дополнить скрипт любым функционалом. Допустим сделать таблицы, раскрасить разные коды и так далее.

Ну а нам осталось только привести скрипт в подобающий вид.