Функции

PHP-функции фреймворка Webasyst

Содержание...

function ifempty (&$var, $def = null)

Возвращает значение указанной непустой переменной либо, если переменная пуста, значение по умолчанию. Проверка выполняется PHP-функцией empty(). Если переменная не существовала перед вызовом функции, она создается с пустым значением.

Параметры

Пример

$var = 1;
ifempty($var); //возвращает непустое значение переменной 1
    
$var = 0;
ifempty($var); //возвращает стандартное значение по умолчанию null
    
$var = 0;
ifempty($var, array()); //возвращает пользовательское значение по умолчанию array()

function ifset (&$var, $def=null)

Возвращает значение существующей переменной или элемента массива либо, если переменная или элемент массива не существуют, значение по умолчанию. Существование переменной выполняется PHP-функцией isset(). Если переменная не существовала перед вызовом функции, она создается с пустым значением.

Параметры

Пример

//переменная $var не определена
//функция возвращает значение по умолчанию
ifset($var); //null

//значение переменной $var равно null
//функция возвращает значение по умолчанию
$var = null;
ifset($var, array()); //пользовательское значение по умолчанию array()


//значение переменной $var не равно null
//функция возвращает значение переменной
$var = 1;
ifset($var, array()); //1

function wa ($name = null, $set_current = false)

Выполняет метод waSystem::getInstance() для загрузки в оперативную память конфигурации указанного приложения; в том числе его PHP-классов.

Параметры

Пример

//вызов функции делает доступными
//только PHP-классы приложения 'blog'
wa('blog');

//вызов функции делает доступными
//PHP-классы И локализацию приложения 'blog'
wa('blog', true);

function wa_array_diff_r ($value1, $value2, &$diff)

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

Параметры

Пример

$different = wa_array_diff_r($array1, $array2, $difference);
wa_dump($different); //выясняем, были ли найдены различия
wa_dump($difference); //вывод найденных различий

function wa_backend_url ()

Возвращает относительный URL бекенда. Учтите, что он может отличаться от /webasyst/.

Пример

wa_backend_url();

Результат

/webasyst/

function wa_currency ($n, $currency, $format = '%{s}')

Возвращает отформатированное значение суммы в указанной валюте с использованием текущей локали.

Параметры

Пример

wa_currency (123456.78, 'RUB');

Результат

123 456,78 руб.

function wa_currency_html ($n, $currency, $format = '%{h}')

Возвращает отформатированное значение суммы в указанной валюте с использованием HTML-символа валюты, если в свойствах валюты есть такой символ. Если HTML-символа у валюты нет, то по умолчанию будет использовано стандартное сокращенное обозначение валюты (если не будет указано другое обозначение формата для параметра $format).

Параметры

Пример

wa_currency_html (123456.78, 'RUB');
wa_currency_html (123456.78, 'USD');

Результат

123 456,78 <span class="ruble">Р</span>
$123 456,78

function wa_date ($format, $time = null, $timezone = null, $locale = null)

Возвращает отформатированное значение даты и времени с использованием метода waDateTime::format().

Параметры

Пример

wa_date('humandatetime');

Результат

Сегодня 17:11

function wa_dump ()

Выводит на страницу отладочную информацию об указанных значениях (каждое с новой строки) и прерывает выполнение PHP-скрипта.

Параметры

Пример

$var1 = 1;
$var2 = 2;
wa_dump($var1, $var2);

Пример

1
2

function wa_dumpc ()

Выводит на страницу отладочную информацию об указанных значениях без прерывания PHP-скрипта.

Параметры

Пример

$var1 = 1;
$var2 = 2;
wa_dumpc($var1, $var2);

Пример

1
2

function wa_header ()

Возвращает HTML-код главного меню бекенда.

function wa_is_int ($val)

Проверяет, является ли указанное значение целочисленным либо строкой, содержащей только одно целое число.

Параметры

Пример

wa_is_int(null);  //false
wa_is_int(false); //false
wa_is_int(true);  //false
wa_is_int(0);     //true
wa_is_int('0');   //true
wa_is_int(1);     //true
wa_is_int('1');   //true
wa_is_int(0.1);   //false
wa_is_int('0.1'); //false

function wa_make_pattern ($string, $separator = '/')

Формирует регулярное выражение из строки символов.

Параметры

Пример

wa_make_pattern('test');
wa_make_pattern('test|');
wa_make_pattern('test|', '|');

Результат

'test';
'test|'
'test\|'

function wa_parse_date ($format, $string, $timezone = null, $locale = null)

Возвращает (с использованием метода waDateTime::parse()) стандартное для PHP строковое представление времени, указанного в одном из форматов, которые используются во фреймворке.

Параметры

Пример

wa_parse_date ('humandate', 'November 8, 2013', null, 'en_US');

Результат

2013-11-08

function wa_url ()

Возвращает относительный корневой URL Webasyst.

Пример

wa_url();

Результат

/

function wao ($o)

Возвращает экземпляр класса указанного конструктора для единоразового однострочного вызова его публичного метода.

Параметры

Пример

$settings_html = wao(new myappBackendSettingsAction())->display();