Функции

Функции для строк и текста

br2nl(?string $text, string $replacement = "\n"): string

Заменяет HTML-теги <br>, <br/>, <br /> на символы перевода строки.

no_break(string $text): string

Заменяет обычный пробел на неразрывный &nbsp; после висячих предлогов, союзов и т.д.

block_file($path, $class = '')

Стандартный блок со всеми файлами в папке.

block_doc($path, $class = '')

Стандартный блок только с документами в папке, кроме фото.

block_img($path, $class = 'news_img_block', $array_name = 'filelist')

Стандартный блок только с фото в папке, кроме документов. Фото открываются в стандартном javascript просмотрщике mc_gallery.

link_new($module_name, $module_param, $text = 'добавить', $add_params = '', $class = 'admin')

Ссылка содания нового объекта для админа.

link_edit($module_name, $module_param, $id, $text = 'редактировать', $add_params = '', $class = 'admin')

Ссылка редактирования объекта.

link_param($module_name, $module_param, $text, $param, $class = 'admin')

Произвольная админская ссылка.

text_announce(?string $text, int $length = 255, bool $useSafeString = false): string

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

text_id($id, ?string $text, int $maxLength = 100): string

Генерирует текстовый ID в формате: {число}-{транслитерация-текста}

relative_link($text)

Заменяет в HTML-тексте абсолютные ссылки, начинающиеся с URLROOT или URLROOT_EN, на относительные (/...).

dump($var)

Вывод массива/объекта в удобном виде. Используется для отладки.

translit(string $text, string $separator = '_'): string

Транслитерация строки из кириллицы в латиницу с очисткой от недопустимых символов.

file_ext(string $file): string

Возвращает расширение файла в нижнем регистре.

remove_emoji(string $text): string

Удаляет все эмодзи из текста.

shortsize($size)

Возвращает размер файла в удобном подходящем виде в единицах B, KB, MB, GB.

price($sum, bool $html = true, string $thousandsSep = ' ', string $decimalPoint = ','): string

Возвращает форматированную цену с разделителем тысяч.

folder_hash($id, $folder = 'news'): string

Возвращает имя папки элемента с хэшем на основе общей папки и id элемента.

user_img_hash($id): string

Возвращает безопасное имя файла для аватара пользователя.

user_link(array $row): string

Генерирует отображение пользователя с аватаркой и именем/email/телефоном.

num2str($num)

Возвращает сумму прописью.

file_nocache(string $file): string

Добавляет к URL файла метку времени (mtime) для предотвращения кэширования.

safe_string(?string $str, int $length = 0, bool $html = false): string

Валидация строки.

safe_float(?string $number): float

Преобразует строку в число типа float для записи в базу данных (DOUBLE).

safe_path(?string $path): string

Валидация пути.

redirect($url)

Перенаправление на другую страницу с помощью вставки javascript.

format_phone(?string $phone): string

Форматирует номер телефона в единый формат: 7XXXXXXXXXX

view_phone(?string $phone): string

Форматирует телефонный номер для отображения пользователю в виде +7 XXX XXX-XX-XX.

lexdate(?string $d, bool $time = true): string

Форматирует дату в человеко-понятный формат. Возвращает "сегодня", "вчера", "позавчера", "завтра" при необходимости. Или форматирует как "12 апреля 2025 в 14:30".

rusdate(?string $d): string

Форматирует дату в формате "12 апреля 2025" или "12 апреля 2025 в 14:30".

Прочие функции

sendTelegram($token, $method, $data)

Отправляет запрос в API Телеграма. Пример:

$res = sendTelegram(TELEGRAM_TOKEN,	'sendMessage', [
	'chat_id' => $telegram_user_id,
	'parse_mode' => 'HTML',
	//'disable_web_page_preview' => 1,
	'text' => br2nl($message)
]);

sendVK($method, $data)

Отправляет запрос в API ВК. Пример:

$res = sendVK('messages.send', [
	'user_id' => $vk_user_id,
	'random_id' => 0,
	'message' => br2nl($message),
	'access_token' => VK_TOKEN,
	'v' => '5.199'
]);

base64_to_jpeg($base64_string, $output_file)

Сохраняет img из строки base64 в файл.

send_mail(string $to, string $subject, string $htmlBody, ?string $fromName = null): bool

Отправляет письмо с адреса ADMIN_EMAIL.

item_image(string $folder, string $id, string $format = 'jpg'): string

Возвращает путь к первой подходящей картинке для элемента. Сначала ищет файл в формате {id}.{format}, затем ищет в папке {id}/, потом по умолчанию.

save_img(string $src, string $dest, int $width = 0, int $height = 0, bool $crop = false): bool

Сохраняет изображение в заданное место с нужным форматом и размером.

files_processing($fieldDef, $path)

Обрабатывает загруженные фото, используя подготовленный массив с параметрами $fieldDef.