Быстрый старт

Установка

Установка производится из пакетов композера командой

composer require dok/bx

Сам пакет здесь: https://packagist.org/packages/dok/bx

Подключение

В init.php проекта нужно подключить пакеты композера

if (!$GLOBALS['__IGNORE_VENDOR']) {
	require_once $_SERVER['DOCUMENT_ROOT'] . '/vendor/autoload.php';
}

__IGNORE_VENDOR здесь нужен для прохождения unit-тестов.

Если запускать тесты не планируется, можно обойтись без проверки.

Использование

Для удобного использования все необходимые методы имеют статическую обвязку, что позволяет получать результат в одну строку.

Массивы

• Dok\BX\Arr::getChunkCols($arr, $count) - функция разбивает массив на равное количество колонок;
• Dok\BX\Arr::getFindInArr($arr, $field, $value, $resultKey) - производит поиск значения $value в поле $field двумерного массива $arr;
• Dok\BX\Arr::getIntersectPercent($arr, $target) - вычисление похожести массива $arr на $target в процентах;
• Dok\BX\Arr::getIntersectKeyPercent($arr, $target) - вычисление похожести массива $arr на $target в процентах по ключам массивов;
• Dok\BX\Arr::getMergeExt($arr, $target) - объединение одно- и двумерных массивов по ключам;
• Dok\BX\Arr::sortByField($arr, $field, $order) - сортирует $arr по ключу $field в указанном порядке $order;
• Dok\BX\Arr::sortByFields($arr, $fields) - сортирует $arr по ключам из массива $field в указанном порядке;

Строки

• Dok\BX\String::getEnding($n, $vars) - окончание слова для числа (например, 1 рубль, 7 копеек, 12 воробьев);
• Dok\BX\String::getFormatDateHuman($date, $format) - дата в человеческом формате (например, 12 декабря 2016);
• Dok\BX\String::getFormatDateHumanBack($date, $format) - прошедшая дата в человеческом формате (например, сегодня в 16:55, вчера в 14:40);
• Dok\BX\String::getFormatPrice($price) - сумма денег в отформатированном виде - с разделителями рядов и дробей;
• Dok\BX\String::getLink($link) - строка со ссылкой в валидную (для тега a) ссылку (например, site.ru -> http://site.ru/);
• Dok\BX\String::getMinifyHtml($link) - минифицированный html-код;

Инфоблоки

• Dok\BX\InfoBlock\Main::getByCode($code) - ID инфоблока по символьному коду;