Обмен готовыми решениями

<?php
    /*
    * Класс для генерации постраничной навигации
    */
    class Pagination
    {
        /**
        * 
        * @var Активных ссылок навигации на страницу.
        * Т.е. ссылок, помимо текущей (активной) ссылки и ссылок влево-вправо.
        * 
        */
        private $max = 6;
        
        /**
        * 
        * @var Ключ для GET, в который пишется номер страницы
        * 
        */
        private $index = 'page';
        
        /**
        * 
        * @var Текущий GET-запрос
        * 
        */
        private $query;
        
        /**
        * 
        * @var Текущая страница
        * 
        */
        private $current_page;
        
        /**
        * 
        * @var Общее количество записей
        * 
        */
        private $total; 
        
        /**
        * 
        * @var Записей на страницу
        * 
        */
        private $limit;
        
        /**
        * 
        * @var Массив с классами для элементов
        * 
        */
        private $classes = [
            'ul' => 'pagination',
            'li' => null,
            'a'  => null
        ];
        
        /**
        * Запуск необходимых данных для навигации
        * @param integer $total - общее количество записей
        * @param integer $limit - количество записей на страницу
        * 
        * @return
        */
        public function __construct( $total, $limit, array $classes=[] )
        {
            # Устанавливаем общее количество записей
            $this->total  = $total;
            
            # Устанавливаем количество записей на страницу
            $this->limit  = $limit;
            
            # Устанавливаем количество страниц
            $this->amount = $this->amount();
            
            # Вызываем метод установки текущей страницы
            $this->setCurrentPage();
            
            # Вызываем метод установки текущего GET-запроса
            $this->setQueryString();
            
            # Заполняем массив классов
            $this->classes = array_merge( $this->classes, $classes );
        }
        
        /**
        *  Для вывода ссылок
        * 
        * @return HTML-код со ссылками навигации
        */
        public function get()
        {
            # Для записи ссылок
            $pagination = null;
            
            # Получаем ограничения для цикла
            $limits = $this->limits();
 
            # Генерируем ссылки
            for($page=$limits[0]; $page<=$limits[1]; $page++)
            {
                # Формируем статус ссылки
                $status = $page == $this->current_page ? 'active' : null;
                    
                # Заносим ссылку
                $pagination .= $this->generateHtml($page, null, null, $status);
            }
            
            # Если текущая страница не первая
            if($this->current_page > 1){
                # Создаём ссылку "Предыдущая"
                $pagination = $this->generateHtml($this->current_page - 1, '&lt;', 'Предыдущая') . $pagination;
                
                # Создаём ссылку "Первая"
                $pagination = $this->generateHtml(1, '&lt;&lt;', 'Первая') . $pagination;
            }
            
            # Если текущая страница не первая
            if($this->current_page < $this->amount){
                # Создаём ссылку "Следующая"
                $pagination .= $this->generateHtml($this->current_page + 1, '&gt;', 'Следующая');  
                
                # Создаём ссылку "Следующая"
                $pagination .= $this->generateHtml($this->amount, '&gt;&gt;', 'Последняя');  
            }
            
            # Оборачиваем ссылки
            $pagination = '<ul class="'. $this->classes['ul'] .'">'. $pagination .'</ul>';
 
            # Возвращаем ссылки
            return $pagination;
        }
        
        /**
        * Для получения, откуда начинать выборку
        * 
        * @return integer
        */
        public function skip(){
            return 
                $this->current_page * $this->limit - $this->limit;
        }
        
        /**
        * Для получение ограничения выборки
        * 
        * @return integer
        */
        public function take(){
            # Получаем, откуда начинаем
            $skip = $this->skip();
            
            # Возвращаем ограницение
            return
                $skip + $this->limit > $this->total ? $this->total - $skip : $this->limit;
        }
        
        /**
        * Для генерации HTML-кода ссылки
        * @param string $query - текущий GET-запрос
        * @param integer $page - номер страницы
        * 
        * @return
        */
        private function generateHtml( $page, $text=null, $title=null, $status=null ){
            # Если текст ссылки не указан
            if( is_null($text) )
                # Указываем, что текст - цифра страницы
                $text = $page;
            
            # Формируем ссылку
            $query = $this->index .'='. $page;
            
            # Формируем строку запроса (после вопроса)
            $query = $this->query ? $this->query .'&'. $query : $query;
            
            # Формируем класс для элемента списка
            $li_class = trim( $this->classes['li'] .' '. $status );
            
            # Формируем HTML код ссылки и возвращаем
            return 
                '<li'. ($li_class ? ' class="'. $li_class.'"' : null) .'>
                     <a href="?'. $query .'" '. ($this->classes['a'] ? 'class="'. $this->classes['a'] .'" ' : null) .'title="'. $title .'">'. $text .'</a>
                 </li>';
        }
        
        /**
        *  Для получения, откуда стартовать вывод ссылок
        * 
        * @return массив с началом и концом отсчёта
        */
        private function limits()
        {
            # Вычисляем ссылки слева (чтобы активная ссылка была посередине)
            $left = $this->current_page - round($this->max / 2, 0, PHP_ROUND_HALF_DOWN);
 
            # Вычисляем начало отсчёта
            $start = $left > 0 ? $left : 1;               
 
            # Если впереди есть как минимум $this->max страниц
            if($start + $this->max <= $this->amount)
                # Назначаем конец цикла вперёд на $this->max страниц или просто на минимум
                $end = $start >= 1 ? $start + $this->max : $this->max;
            else{
                # Конец - общее количество страниц
                $end = $this->amount;
 
                # Начало - минус $this->max от конца
                $start = $this->amount - $this->max > 0 ? $this->amount - $this->max : 1;
            }
            
            # Возвращаем
            return [$start, $end];
        }
 
        /**
        * Для установки текущей страницы
        * 
        * @return
        */
        private function setCurrentPage()
        {
            # Получаем номер страницы
            $this->current_page = isset($_GET[$this->index]) ? (int) $_GET[$this->index] : 1;
            
            # Если текущая страница боле нуля
            if($this->current_page > 0)
            {
                # Если текунщая страница меньше общего количества страниц
                if($this->current_page > $this->amount)
                    # Устанавливаем страницу на последнюю
                    $this->current_page = $this->amount;
            }
            else
                # Устанавливаем страницу на первую
                $this->current_page = 1;
        }
        
        /**
        * Для получения и установки текущего GET-запроса
        * 
        * @return
        */
        private function setQueryString(){
            # Получаем параметры текущего запроса
            $query = parse_url( $_SERVER['REQUEST_URI'], PHP_URL_QUERY );
            
            # Разбираем строку запроса
            parse_str( $query, $params );
            
            # Удаляем значение страницы, если есть
            unset( $params[$this->index] );
            
            # Формируем запрос
            $this->query = http_build_query( $params );
        }
        
        /**
        * Для получеия общего числа страниц
        * 
        * @return число страниц
        */
        private function amount()
        {
            # Делим и возвращаем
            return
                ceil( $this->total / $this->limit );
        }
    }

/**
 * класс предназначен для удобного формирования HTML тегов, вместе с атрибутами и стилями 
 * какой тег будет сформирован, ординарный или парный (контейнер) зависит от свойства $is_container_tag 
 * которое должно быть явно задано через метод SetIsContainerTag или если оно не задано, 
 * тогда в зависимости от содержимого свойства $inner_html, если оно === NULL, тогда тег ординарный
 */
class HtmlTagsManager
{
    /**
     * Get Object, возвращает объект класса с уже заданными свойствами, переданными в качестве параметров
     * @param string $tag_name название тега, например: div, span или input
     * @param array $attr_array массив с атрибутами, которые будут заданы тегу
     * @param string $inner_html содержимое, которое будет вставлено в тег, в случае если он парный (контейнер)
     * @param bool $htmlspecialchars нужно ли к $inner_html применять функцию htmlspecialchars
     * @return static
     */
    static function Go($tag_name, $attr_array = array(), $inner_html = NULL, $htmlspecialchars = NULL) {
        return new static($tag_name, $attr_array, $inner_html, $htmlspecialchars);
    }
    
    /**
     * Empty Manager, если $value не пусто, возвращает строку "$before+$value+$after", в противном случае NULL
     * @param string $value
     * @param string $before
     * @param string $after
     * @return string
     */
    static function em($value, $before = '', $after = '') {
        return empty($value) ? '' : ($before . $value . $after);
    }
    
 
    public static 
            /**
             * @var bool нужно ли по умолчанию применять к $inner_html функцию htmlspecialchars
             */
            $to_htmlspecialchars = true,
            /**
             * @var string концовка ординарного тега
             */
            $single_tag_end = '/>';
    
    protected 
            $tag,
            $is_container_tag = NULL,
            $attr,
            $style_array = array(),
            $inner_html,
            $before_html = '',
            $after_html = '';
    
    
    /**
     * возвращает объект класса с уже заданными свойствами, переданными в качестве параметров
     * @param string $tag_name название тега, например: div, span или input
     * @param array $attr_array массив с атрибутами, которые будут заданы тегу
     * @param string $inner_html содержимое, которое будет вставлено в тег, в случае если он парный (контейнер)
     * @param bool $htmlspecialchars нужно ли к $inner_html применять функцию htmlspecialchars
     * @return static
     */
    function __construct($tag_name, $attr_array = array(), $inner_html = NULL, $htmlspecialchars = NULL) {
        $this->tag = $tag_name;
        $this->attr = empty($attr_array) ? array() : $attr_array;
        $this->innerHTML($inner_html, $htmlspecialchars);
    }
    
    
    /**
     * задает, является ли тег парным
     * @param bool $bool TRUE - парный (контейнер), FALSE - ординарный
     * @return static
     */
    function SetIsContainerTag($bool) {
        $this->is_container_tag = $bool;
        return $this;
    }
    
    
    /**
     * задает содержимое тега, в случае если он парный (контейнер)
     * @param string $inner_html содержимое, которое будет вставлено в тег, в случае если он парный (контейнер)
     * @param bool $htmlspecialchars нужно ли к $inner_html применять функцию htmlspecialchars
     * @return static
     */
    function innerHTML($inner_html, $htmlspecialchars = NULL) {
        $hsp = ($htmlspecialchars === NULL) ? static::$to_htmlspecialchars : $htmlspecialchars;
        $this->inner_html = ($hsp && !empty($inner_html)) ? htmlspecialchars($inner_html) : $inner_html;
        return $this;
    }
    
    
    /**
     * задает атрибуты тега, если второй параметр не передан, то будет выведен в качестве атрибута $key, например readonly или hidden
     * так же в качестве второго параметра может быть передано bool значение - TRUE/FALSE, 
     * например если передать readonly FALSE, тогда атрибут readonly будет проигнорирован, 
     * но если передать 0, то будет выведено readonly="0", поэтому такого рода значения надо приводить к типу bool 
     * через данный метод можно задать атрибут style
     * @param string $key наименование атрибута
     * @param mixed $value значение атрибута, если передать FALSE, атрибут будет проигнорирован
     * @return static
     */
    function attr($key, $value = NULL) {
        if ($value === NULL) {
            $this->attr[] = $key;
        }
        else {
            $this->attr[$key] = $value;
        }
        return $this;
    }
    
    
    /**
     * задает стили, в качестве второго параметра может быть передано bool значение - TRUE/FALSE, 
     * если в качестве второго параметра передать FALSE, стиль будет проигнорирован 
     * данный метод имеет приоритет перед стилем заданным через метод attr
     * если стиль был задан при помощи метода attr, например color: red, а потом используя данный метод 
     * было задано color: green, в итоге color будет green
     * @param string $key наименование стиля
     * @param mixed $value значение, если передать FALSE, стиль будет проигнорирован
     * @return static
     */
    function style($key, $value = false) {
        $this->style_array[$key] = $value;
        return $this;
    }
    
    
    /**
     * задает какой-то текст перед тегом
     * @param string|mixed $value
     * @return static
     */
    function before($value) {
        $this->before_html = $value;
        return $this;
    }
    
    
    /**
     * задает какой-то текст после тега
     * @param string|mixed $value
     * @return static
     */
    function after($value) {
        $this->after_html = $value;
        return $this;
    }
    
    
    /**
     * из стилей заданных через метод style и метод attr формирует конечный набор стилей 
     * @return string возвращает строку, которая будет вставлена в атрибут style или NULL
     */
    protected function getStyleString() {
        if (empty($this->style_array) && empty($this->attr['style'])) {
            return '';
        }
        else if (empty($this->style_array)) {
            return $this->attr['style'];
        }
        
        $style = array();
        if ( !empty($this->attr['style']) ) {
            $parts = explode(';', $this->attr['style']);
            foreach($parts as $part) {
                $temp = explode(':', $part);
                if (count($temp) < 2) continue;
                $style[ trim($temp[0]) ] = trim($temp[1]);
            }
        }
        $style = array_merge($style, $this->style_array);
        $arr = array();
        foreach($style as $key => $value) {
            if ( !empty($value) ) {
                $arr[] = "{$key}: {$value};";
            }
        }
        return implode(' ', $arr);
    }
    
    
    /**
     * формирует конечный набор атрибутов, для вставки его в тег 
     * в данном методы получение стилей происходит при помощи вызова метода getStyleString 
     * @return string возвращает строку, которая будет вставлена в тег или NULL
     */
    protected function getAttrString() {
        if (empty($this->attr) && empty($this->style_array)) {
            return '';
        }
        
        $attr = $this->attr;
        $attr['style'] = $this->getStyleString();
        
        $temp = array();
        foreach($attr as $key => $value) {
            if ( is_int($key) && !empty($value) ) {
                $temp[] = $value;
            }
            else if ( !empty($value) || $value === 0 || $value === '0' ) {
                $temp[] = $value === true ? $key : ($key . '="' . htmlspecialchars($value) . '"');
            }
        }
        
        return empty($temp) ? '' : (' ' . implode(' ', $temp));
    }
    
    /**
     * формирует тег в конечную строку и возвращает её по схеме , "до + тег + после" 
     * если задан второй параметр, за место тега будет возвращена строка "до + параметр + после" 
     * @param string $another_text строка, которая будет возвращена за место тега по схеме 
     * "до + параметр + после" 
     * @return string
     */
    protected function to_string($another_text = false) {
        if ($another_text !== false) {
            $temp = $another_text;
        }
        else {
            $temp = '<' . $this->tag . $this->getAttrString();
            $ctrl = is_bool($this->is_container_tag) ? $this->is_container_tag : 
                    ( $this->inner_html !== NULL ? true : false );
            $temp .= $ctrl ? ">{$this->inner_html}</{$this->tag}>" : static::$single_tag_end;
        }
        return $this->before_html . "\r\n" . $temp . "\r\n" . $this->after_html;
    }
    
    /**
     * данный метод предназначен на тот случай если необходимо в дочернем классе перегрузить toString 
     * при этом иметь доступ к публичному методу создания конечной строки 
     * @param string $another_text строка, которая будет возвращена за место тега по схеме 
     * "до + параметр + после" 
     * @return string
     */
    function toStringBase($another_text = false) {
        return $this->to_string($another_text);
    }
    
    /**
     * формирует и возвращает тег вместе с атрибутами, стилями и вложением, по схеме "до + тег + после" 
     * @param string $another_text строка, которая будет возвращена за место тега по схеме 
     * "до + параметр + после" 
     * @return string
     */
    function toString($another_text = false) {
        return $this->toStringBase($another_text);
    }
    
    /**
     * формирует и выводит тег вместе с атрибутами, стилями и вложением, по схеме "до + тег + после" 
     * @param string $another_text строка, которая будет возвращена за место тега по схеме 
     * "до + параметр + после" 
     * @return string
     */
    function toEcho($another_text = false) {
        echo $this->toString($another_text);
    }
    
    function __toString() {
        return $this->toString();
    }
    
    function __invoke() {
        return $this->toString();
    }
}

// создаем тег div с содержимым hello и атрибутом main_div
echo HtmlTagManager::Go('div')
    ->innerHTML('hello')
    ->attr('id', 'main_div')
    ->toString();
 
 
// за счет того что не был задан innerHTML, тег будет ординарным
// если надо задать парный, надо это указать через метод SetIsContainerTag
echo HtmlTagManager::Go('input')
    ->attr('type', 'text')
    ->attr('name', 'user_name')
    ->attr('required') // для одиночный атрибутов не нужно задавать значение
    ->attr('value', 'Вася')
    ->toString();
 
 
// мы можем указывать для атрибута параметр false, тогда данный атрибут будет проигнорирован
// но не 0, в случае с 0, будет readonly="0", по этому надо приводить тип
echo HtmlTagManager::Go('textarea')
    ->SetIsContainerTag(true)
    ->attr('readonly', false)
    ->toString();
 
 
// можно задавать стили двумя способами, первый через attr в виде строчки, 
// второй через специализированный метод style, style имеет приоритет
echo HtmlTagManager::Go('span')
    ->innerHTML('some text..')
    ->style('color', 'green')
    ->attr('style', 'color: red; border: 1px solid gray; padding: 10px;')
    ->toString();
// в итоге color будет равен green
// так же можно указывать false, тогда стиль будет проигнорирован

/**
* класс предназначен для удобного формирования HTML тегов, вместе с атрибутами и стилями
* какой тег будет сформирован, ординарный или парный (контейнер) зависит от свойства $is_container_tag
* которое должно быть явно задано через метод SetIsContainerTag или если оно не задано,
* тогда в зависимости от содержимого свойства $inner_html, если оно === NULL, тогда тег ординарный
*/
class HtmlTagManager
{
    /**
     * Get Object, возвращает объект класса с уже заданными свойствами, переданными в качестве параметров
     * @param string $tag_name название тега, например: div, span или input
     * @param array $attr_array массив с атрибутами, которые будут заданы тегу
     * @param string $inner_html содержимое, которое будет вставлено в тег, в случае если он парный (контейнер)
     * @param bool $htmlspecialchars нужно ли к $inner_html применять функцию htmlspecialchars
     * @return static
     */
    static function Go($tag_name, $attr_array = array(), $inner_html = NULL, $htmlspecialchars = NULL) {
        return new static($tag_name, $attr_array, $inner_html, $htmlspecialchars);
    }
    
    /**
     * Empty Manager, если $value не пусто, возвращает строку "$before+$value+$after", в противном случае NULL
     * @param string $value
     * @param string $before
     * @param string $after
     * @return string
     */
    static function em($value, $before = '', $after = '') {
        return empty($value) ? '' : ($before . $value . $after);
    }
    
 
    public static
            /**
             * @var bool нужно ли по умолчанию применять к $inner_html функцию htmlspecialchars
             */
            $to_htmlspecialchars = true,
            /**
             * @var string концовка ординарного тега
             */
            $single_tag_end = '/>';
    
    protected
            $tag,
            $is_container_tag = NULL,
            $attr = array(),
            $style_array = array(),
            $inner_html,
            $before_html = '',
            $after_html = '';
    
    
    /**
     * возвращает объект класса с уже заданными свойствами, переданными в качестве параметров
     * @param string $tag_name название тега, например: div, span или input
     * @param array $attr_array массив с атрибутами, которые будут заданы тегу
     * @param string $inner_html содержимое, которое будет вставлено в тег, в случае если он парный (контейнер)
     * @param bool $htmlspecialchars нужно ли к $inner_html применять функцию htmlspecialchars
     * @return static
     */
    function __construct($tag_name, $attr_array = array(), $inner_html = NULL, $htmlspecialchars = NULL) {
        $this->tag = $tag_name;
        
        if (is_array($attr_array)) {
            foreach($attr_array as $key => $value) {
                if (is_int($key)) {
                    $this->attr($value);
                }
                else {
                    $this->attr($key, $value);
                }
            }
        }
        
        $this->innerHTML($inner_html, $htmlspecialchars);
    }
    
    
    /**
     * задает, является ли тег парным
     * @param bool $bool TRUE - парный (контейнер), FALSE - ординарный
     * @return static
     */
    function SetIsContainerTag($bool) {
        $this->is_container_tag = (bool)$bool;
        return $this;
    }
    
    
    /**
     * задает содержимое тега, в случае если он парный (контейнер)
     * @param string $inner_html содержимое, которое будет вставлено в тег, в случае если он парный (контейнер)
     * @param bool $htmlspecialchars нужно ли к $inner_html применять функцию htmlspecialchars
     * @return static
     */
    function innerHTML($inner_html, $htmlspecialchars = NULL) {
        $hsp = ($htmlspecialchars === NULL) ? static::$to_htmlspecialchars : $htmlspecialchars;
        $this->inner_html = ($hsp && !empty($inner_html)) ? htmlspecialchars($inner_html) : $inner_html;
        return $this;
    }
    
    
    /**
     * задает атрибуты тега, если второй параметр не передан, то будет выведен в качестве атрибута $key, например readonly или hidden
     * так же в качестве второго параметра может быть передано bool значение - TRUE/FALSE,
     * например если передать readonly FALSE, тогда атрибут readonly будет проигнорирован,
     * но если передать 0, то будет выведено readonly="0", поэтому такого рода значения надо приводить к типу bool
     * через данный метод можно задать атрибут style
     * @param string $key наименование атрибута
     * @param mixed $value значение атрибута, если передать FALSE, атрибут будет проигнорирован
     * @return static
     */
    function attr($key, $value = NULL) {
        $this->attr[$key] = ($value === NULL) ? true : $value;
        return $this;
    }
    
    
    /**
     * задает стили, в качестве второго параметра может быть передано bool значение - TRUE/FALSE,
     * если в качестве второго параметра передать FALSE, стиль будет проигнорирован
     * данный метод имеет приоритет перед стилем заданным через метод attr
     * если стиль был задан при помощи метода attr, например color: red, а потом используя данный метод
     * было задано color: green, в итоге color будет green
     * @param string $key наименование стиля
     * @param mixed $value значение, если передать FALSE, стиль будет проигнорирован
     * @return static
     */
    function style($key, $value = false) {
        $this->style_array[$key] = $value;
        return $this;
    }
    
    
    /**
     * задает какой-то текст перед тегом
     * @param string|mixed $value
     * @return static
     */
    function before($value) {
        $this->before_html = $value;
        return $this;
    }
    
    
    /**
     * задает какой-то текст после тега
     * @param string|mixed $value
     * @return static
     */
    function after($value) {
        $this->after_html = $value;
        return $this;
    }
    
    
    /**
     * из стилей заданных через метод style и метод attr формирует конечный набор стилей
     * @return string возвращает строку, которая будет вставлена в атрибут style или NULL
     */
    protected function getStyleString() {
        if (empty($this->style_array) && empty($this->attr['style'])) {
            return '';
        }
        else if (empty($this->style_array)) {
            return $this->attr['style'];
        }
        
        $style = array();
        if ( !empty($this->attr['style']) ) {
            $parts = explode(';', $this->attr['style']);
            foreach($parts as $part) {
                $temp = explode(':', $part);
                if (count($temp) < 2) {
                    continue;
                }
                $style[ trim($temp[0]) ] = trim($temp[1]);
            }
        }
        $style = array_merge($style, $this->style_array);
        $arr = array();
        foreach($style as $key => $value) {
            if ( !empty($value) ) {
                $arr[] = "{$key}: {$value};";
            }
        }
        return implode(' ', $arr);
    }
    
    
    /**
     * формирует конечный набор атрибутов, для вставки его в тег
     * в данном методы получение стилей происходит при помощи вызова метода getStyleString
     * @return string возвращает строку, которая будет вставлена в тег или NULL
     */
    protected function getAttrString() {
        if (empty($this->attr) && empty($this->style_array)) {
            return '';
        }
        
        $attr = $this->attr;
        $attr['style'] = $this->getStyleString();
        
        $temp = array();
        foreach($attr as $key => $value) {
            if (!empty($value) || $value === 0 || $value === '0') {
                $temp[] = $value === true ? $key : ($key . '="' . htmlspecialchars($value) . '"');
            }
        }
        
        return empty($temp) ? '' : (' ' . implode(' ', $temp));
    }
    
    /**
     * формирует тег в конечную строку и возвращает её по схеме , "до + тег + после"
     * если задан второй параметр, за место тега будет возвращена строка "до + параметр + после"
     * @param string $another_text строка, которая будет возвращена за место тега по схеме
     * "до + параметр + после"
     * @return string
     */
    protected function to_string($another_text = false) {
        if ($another_text !== false) {
            $temp = $another_text;
        }
        else {
            $temp = '<' . $this->tag . $this->getAttrString();
            $ctrl = is_bool($this->is_container_tag) ? $this->is_container_tag :
                    ( $this->inner_html !== NULL ? true : false );
            $temp .= $ctrl ? ">{$this->inner_html}</{$this->tag}>" : static::$single_tag_end;
        }
        return $this->before_html . "\r\n" . $temp . "\r\n" . $this->after_html;
    }
    
    /**
     * данный метод предназначен на тот случай если необходимо в дочернем классе перегрузить toString
     * при этом иметь доступ к публичному методу создания конечной строки
     * @param string $another_text строка, которая будет возвращена за место тега по схеме
     * "до + параметр + после"
     * @return string
     */
    function toStringBase($another_text = false) {
        return $this->to_string($another_text);
    }
    
    /**
     * формирует и возвращает тег вместе с атрибутами, стилями и вложением, по схеме "до + тег + после"
     * @param string $another_text строка, которая будет возвращена за место тега по схеме
     * "до + параметр + после"
     * @return string
     */
    function toString($another_text = false) {
        return $this->toStringBase($another_text);
    }
    
    /**
     * формирует и выводит тег вместе с атрибутами, стилями и вложением, по схеме "до + тег + после"
     * @param string $another_text строка, которая будет возвращена за место тега по схеме
     * "до + параметр + после"
     * @return string
     */
    function toEcho($another_text = false) {
        echo $this->toString($another_text);
    }
    
    function __toString() {
        return $this->toString();
    }
    
    function __invoke() {
        return $this->toString();
    }
}