Библиотека clausnz/php-helpers
представляет собой набор из 45 полезных вспомогательных функций PHP (PHP 5.6, 7.*)
.
После установки с помощью composer
глобальные функции доступны из любого места вашего кода:
composer require clausnz/php-helpers
<?php
dump ( ' any content ' );
Если функция с таким именем уже существует в списке определенных функций вашего проекта (встроенных и пользовательских), она просто не будет зарегистрирована в вашей среде. Поэтому никаких конфликтов с существующими функциями не возникнет.
Тем не менее, каждая функция по-прежнему доступна статически с помощью правильного оператора использования:
<?php
use CNZ Helpers Util as util ;
util:: dump ( ' any content ' );
Эта библиотека использует следующие блестящие и хорошо известные библиотеки:
Все функции тестируются с помощью ряда модульных тестов и версий PHP.
Установите последнюю версию библиотеки clausnz/php-helper
с помощью композитора:
composer require clausnz/php-helpers
Также убедитесь, что вам требуется файл автозагрузки композитора:
require __DIR__ . ' /vendor/autoload.php ' ;
После установки новые глобальные функции PHP станут доступны повсюду в вашем коде. Чтобы получить доступ к (почти идентичным) статическим функциям во вспомогательных классах, добавьте в файл соответствующий оператор использования:
<?php
use CNZ Helpers Dev as dev ;
if ( dev:: isIphone () ) {
// Do something here
}
Вспомогательный класс, обеспечивающий легкий доступ к полезным функциям массива PHP.
Класс Приб.
Определяет, является ли данное значение ассоциативным массивом.
Arr:: isAssoc ( array $ array ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_assoc ( array $ array ): boolean
$ array = [
' foo ' => ' bar '
];
is_assoc ( $ array );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$array | множество | Любой тип массива. |
Возвращаемое значение:
True, если массив ассоциативен, в противном случае — false.
Преобразует массив в объект.
Arr:: toObject ( array $ array ): object| null
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
to_object ( array $ array ): object| null
$ array = [
' foo ' => [
' bar ' => ' baz '
]
];
$ obj = to_object ( $ array );
echo $ obj -> foo -> bar ;
// baz
Параметр | Тип | Описание |
---|---|---|
$array | множество | Массив, который нужно преобразовать. |
Возвращаемое значение:
Стандартное объектное представление преобразованного массива.
Преобразует строку или объект в массив.
Arr:: dump ( string|object $ var ): array| null
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
to_array ( string|object $ var ): array| null
$ var = ' php ' ;
to_array ( $ var );
// (
// [0] => p
// [1] => h
// [2] => p
// )
$ var = new stdClass ;
$ var -> foo = ' bar ' ;
to_array ( $ var );
// (
// [foo] => bar
// )
Параметр | Тип | Описание |
---|---|---|
$var | строка|объект | Строка или объект. |
Возвращаемое значение:
Представление массива преобразованной строки или объекта. Возвращает ноль в случае ошибки.
Возвращает первый элемент массива.
Arr:: first ( array $ array ): mixed
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
array_first ( array $ array ): mixed
$ array = [
' foo ' => ' bar ' ,
' baz ' => ' qux '
];
array_first ( $ array )
// bar
Параметр | Тип | Описание |
---|---|---|
$array | множество | Соответствующий массив. |
Возвращаемое значение:
Значение первого элемента без ключа. Смешанный тип.
Возвращает последний элемент массива.
Arr:: last ( array $ array ): mixed
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
array_last ( array $ array ): mixed
$ array = [
' foo ' => ' bar ' ,
' baz ' => ' qux '
];
array_last ( $ array )
// qux
Параметр | Тип | Описание |
---|---|---|
$array | множество | Соответствующий массив. |
Возвращаемое значение:
Значение последнего элемента без ключа. Смешанный тип.
Получает значение в массиве с помощью точечной записи ключей.
Arr:: get ( string $ key , array $ array ): mixed
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
array_get ( string key, array $ array ): mixed
$ array = [
' foo ' => ' bar ' ,
' baz ' => [
' qux => ' foobar'
]
];
array_get ( ' baz.qux ' , $ array );
// foobar
Параметр | Тип | Описание |
---|---|---|
$key | нить | Ключ в точечной записи. |
$array | множество | Массив для поиска. |
Возвращаемое значение:
Искомое значение, в противном случае — значение null.
Устанавливает значение в массиве, используя точечную запись.
Arr:: set ( string $ key , mixed $ value , array & $ array ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
array_set ( string key, mixed value, array $ array ): boolean
$ array = [
' foo ' => ' bar ' ,
' baz ' => [
' qux => ' foobar'
]
];
array_set ( ' baz.qux ' , ' bazqux ' , $ array );
// (
// [foo] => bar
// [baz] => [
// [qux] => bazqux
// ]
// )
$ array = [
' foo ' => ' bar ' ,
' baz ' => [
' qux => ' foobar'
]
];
array_set ( ' baz.foo ' , ' bar ' , $ array );
// (
// [foo] => bar
// [baz] => [
// [qux] => bazqux
// [foo] => bar
// ]
// )
Параметр | Тип | Описание |
---|---|---|
$key | нить | Ключ для установки с использованием точечной записи. |
$value | смешанный | Значение, которое необходимо установить для указанного ключа. |
$array | множество | Соответствующий массив. |
Возвращаемое значение:
True, если новое значение было успешно установлено, в противном случае — false.
Вспомогательный класс, который обеспечивает легкий доступ к полезным функциям PHP в сочетании с пользовательским агентом.
Класс разработчиков
Определяет, является ли текущее устройство смартфоном.
Dev:: isSmartphone ( ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_smartphone ( ): boolean
if ( is_smartphone () ) {
// I am a smartphone
}
Возвращаемое значение:
True, если текущий посетитель использует смартфон, в противном случае — false.
Определяет, использует ли текущий посетитель мобильное устройство (смартфон/планшет/карманное устройство).
Dev:: isMobile ( ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_mobile ( ): boolean
if ( is_mobile () ) {
// I am a mobile device (smartphone/tablet or handheld)
}
Возвращаемое значение:
True, если текущий посетитель использует мобильное устройство, в противном случае — false.
Получите одноэлементный объект MobileDetect для вызова каждого предоставляемого им метода.
Dev::mobileDetect( ): Detection MobileDetect
Публичный доступ для использования за пределами этого класса. Документация Mobile_Detect: https://github.com/serbanghita/Mobile-Detect.
Этот метод не имеет связанной глобальной функции!
(прыгнуть назад)
Dev:: mobileDetect ()-> version ( ' Android ' );
// 8.1
Возвращаемое значение:
Одноэлементный объект MobileDetect для вызова каждого предоставляемого им метода.
Определяет, использует ли текущий посетитель планшетное устройство.
Dev:: isTablet ( ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_tablet ( ): boolean
if ( is_tablet () ) {
// I am a tablet
}
Возвращаемое значение:
Значение true, если текущий посетитель использует планшетное устройство, в противном случае — значение false.
Определяет, использует ли текущий посетитель настольный компьютер.
Dev:: isDesktop ( ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_desktop ( ): boolean
if ( is_desktop () ) {
// I am a desktop computer (Mac, Linux, Windows)
}
Возвращаемое значение:
Значение true, если текущий посетитель использует настольный компьютер, в противном случае — значение false.
Определяет, является ли текущий посетитель поисковой системой/ботом/сканером/пауком.
Dev:: isRobot ( ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_robot ( ): boolean
if ( is_robot () ) {
// I am a robot (search engine, bot, crawler, spider)
}
Возвращаемое значение:
True, если текущий посетитель является поисковой системой/ботом/сканером/пауком, в противном случае — false.
Получите одноэлементный объект CrawlerDetect для вызова каждого предоставляемого им метода.
Dev::crawlerDetect( ): Jaybizzle CrawlerDetect CrawlerDetect
Публичный доступ для использования за пределами этого класса. Документация Crawler-Detect: https://github.com/JayBizzle/Crawler-Detect.
Этот метод не имеет связанной глобальной функции!
(прыгнуть назад)
Dev:: crawlerDetect ()-> getMatches ();
// Output the name of the bot that matched (if any)
Определяет, работает ли на текущем устройстве операционная система Android.
Dev:: isAndroid ( ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_android ( ): boolean
if ( is_android () ) {
// I am an Android based device
}
Возвращаемое значение:
Значение true, если текущий посетитель использует устройство на базе Android, в противном случае — значение false.
Определяет, является ли текущее устройство iPhone.
Dev:: isIphone ( ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_iphone ( ): boolean
if ( is_iphone () ) {
// I am an iPhone
}
Возвращаемое значение:
True, если текущий посетитель использует iPhone, в противном случае — false.
Определяет, принадлежит ли текущее устройство компании Samsung.
Dev:: isSamsung ( ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_samsung ( ): boolean
if ( is_samsung () ) {
// I am a device from Samsung
}
Возвращаемое значение:
True, если текущий посетитель использует устройство Samsung, в противном случае — false.
Определяет, работает ли на текущем устройстве операционная система iOS.
Dev:: isIOS ( ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_ios ( ): boolean
if ( is_ios () ) {
// I am an iOS based device
}
Возвращаемое значение:
True, если текущий посетитель использует устройство iOS, в противном случае — false.
Вспомогательный класс, который обеспечивает легкий доступ к полезным строковым функциям PHP.
Класс Стр.
Вставляет одну или несколько строк в другую строку в определенной позиции.
Str:: insert ( array $ keyValue , string $ string ): string
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_insert ( array $ keyValue , string $ string ): string
$ keyValue = [
' :color ' => ' brown ' ,
' :animal ' => ' dog '
]
$ string = ' The quick :color fox jumps over the lazy :animal. ' ;
str_insert ( $ keyValue , $ string );
// The quick brown fox jumps over the lazy dog.
Параметр | Тип | Описание |
---|---|---|
$keyValue | множество | Ассоциативный массив с парами ключ => значение. |
$string | нить | Текст со строками, которые необходимо заменить. |
Возвращаемое значение:
Заменяемая строка.
Возвращает содержимое строки между левым и правым элементом.
Str:: between ( string $ left , string $ right , string $ string ): array
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_between ( string $ left , string $ right , string $ string ): array
$ string = ' <tag>foo</tag>foobar<tag>bar</tag> '
str_between ( ' <tag> ' , ' </tag> ' $ string );
// (
// [0] => foo
// [1] => bar
// )
Параметр | Тип | Описание |
---|---|---|
$left | нить | Левый элемент строки для поиска. |
$right | нить | Правый элемент строки для поиска. |
$string | нить | Строка для поиска. |
Возвращаемое значение:
Массив результатов со всеми совпадениями поиска.
Возвращает часть строки после заданного значения.
Str:: after ( string $ search , string $ string ): string
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_after ( string $ search , string $ string ): string
$ string = ' The quick brown fox jumps over the lazy dog ' ;
str_after ( ' fox ' $ string );
// jumps over the lazy dog
Параметр | Тип | Описание |
---|---|---|
$search | нить | Строка для поиска. |
$string | нить | Строка для поиска. |
Возвращаемое значение:
Найденная строка после строки поиска. Пробелы в начале будут удалены.
Получить часть строки перед заданным значением.
Str:: before ( string $ search , string $ string ): string
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_before ( string $ search , string $ string ): string
$ string = ' The quick brown fox jumps over the lazy dog ' ;
str_before ( ' fox ' $ string );
// The quick brown
Параметр | Тип | Описание |
---|---|---|
$search | нить | Строка для поиска. |
$string | нить | Строка для поиска. |
Возвращаемое значение:
Найденная строка перед строкой поиска. Пробелы в конце будут удалены.
Ограничьте количество слов в строке. Поместите значение $end в конец строки.
Str:: limitWords ( string $ string , integer $ limit = 10 , string $ end = ' ... ' ): string
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_limit_words ( string $ string , int $ limit = 10 , string $ end = ' ... ' ): string
$ string = ' The quick brown fox jumps over the lazy dog ' ;
str_limit_words ( $ string , 3 );
// The quick brown...
Параметр | Тип | Описание |
---|---|---|
$string | нить | Строка для ограничения слов. |
$limit | целое число | Количество слов, которое нужно ограничить. По умолчанию 10. |
$end | нить | Строка, которой заканчивается обрезанная строка. По умолчанию '...' |
Возвращаемое значение:
Ограниченная строка с $end в конце.
Ограничьте количество символов в строке. Поместите значение $end в конец строки.
Str:: limit ( string $ string , integer $ limit = 100 , string $ end = ' ... ' ): string
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_limit ( string $ string , int $ limit = 100 , string $ end = ' ... ' ): string
$ string = ' The quick brown fox jumps over the lazy dog ' ;
str_limit ( $ string , 15 );
// The quick brown...
Параметр | Тип | Описание |
---|---|---|
$string | нить | Строка для ограничения символов. |
$limit | целое число | Количество символов, которое нужно ограничить. По умолчанию 100. |
$end | нить | Строка, завершающая обрезанную строку. По умолчанию '...' |
Возвращаемое значение:
Ограниченная строка с $end в конце.
Проверяет, содержит ли строка заданный элемент
Str:: contains ( string|array $ needle , string $ haystack ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_contains ( string|array $ needle , string $ haystack ): boolean
$ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
' cat ' ,
' fox '
];
str_contains ( $ array , $ string );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$needle | строка|массив | Строка или массив строк. |
$haystack | нить | Строка для поиска. |
Возвращаемое значение:
True, если найден $needle, в противном случае — false.
Проверяет, содержит ли строка заданный элемент. Игнорируйте чувствительность к регистру.
Str:: containsIgnoreCase ( string|array $ needle , string $ haystack ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_icontains ( string|array $ needle , string $ haystack ): boolean
$ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
' Cat ' ,
' Fox '
];
str_icontains ( $ array , $ string );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$needle | строка|массив | Строка или массив строк. |
$haystack | нить | Строка для поиска. |
Возвращаемое значение:
True, если найден $needle, в противном случае — false.
Определите, начинается ли данная строка с данной подстроки.
Str:: startsWith ( string|array $ needle , string $ haystack ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_starts_with ( string|array $ needle , string $ haystack ): boolean
$ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
' Cat ' ,
' The '
];
str_starts_with ( $ array , $ string );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$needle | строка|массив | Строка или массив строк для поиска. |
$haystack | нить | Строка для поиска. |
Возвращаемое значение:
True, если $needle найден, в противном случае — false.
Определите, начинается ли данная строка с данной подстроки. Игнорируйте чувствительность к регистру.
Str:: startsWithIgnoreCase ( string|array $ needle , string $ haystack ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_istarts_with ( string|array $ needle , string $ haystack ): boolean
$ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
' cat ' ,
' the '
];
str_istarts_with ( $ array , $ string );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$needle | строка|массив | Строка или массив строк для поиска. |
$haystack | нить | Строка для поиска. |
Возвращаемое значение:
True, если был найден $needle, в противном случае — false.
Определите, заканчивается ли данная строка данной подстрокой.
Str:: endsWith ( string|array $ needle , string $ haystack ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_ends_with ( string|array $ needle , string $ haystack ): boolean
$ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
' cat ' ,
' dog '
];
str_ends_with ( $ array , $ string );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$needle | строка|массив | Строка или массив строк для поиска. |
$haystack | нить | Строка для поиска. |
Возвращаемое значение:
True, если был найден $needle, в противном случае — false.
Определите, заканчивается ли данная строка данной подстрокой.
Str:: endsWithIgnoreCase ( string|array $ needle , string $ haystack ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_iends_with ( string|array $ needle , string $ haystack ): boolean
$ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
' Cat ' ,
' Dog '
];
str_iends_with ( $ array , $ string );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$needle | строка|массив | Строка или массив строк для поиска. |
$haystack | нить | Строка для поиска. |
Возвращаемое значение:
True, если был найден $needle, в противном случае — false.
Возвращает часть строки после последнего появления данного искомого значения.
Str:: afterLast ( string $ search , string $ string ): string
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
str_after_last ( string $ search , string $ string ): string
$ path = " /var/www/html/public/img/image.jpg " ;
str_after_last ( ' / ' $ path );
// image.jpg
Параметр | Тип | Описание |
---|---|---|
$search | нить | Строка для поиска. |
$string | нить | Строка для поиска. |
Возвращаемое значение:
Найденная строка после последнего вхождения искомой строки. Пробелы в начале будут удалены.
Вспомогательный класс, обеспечивающий легкий доступ к полезным общим функциям PHP.
Класс Утилита
Подтвердите указанный адрес электронной почты.
Util:: isEmail ( string $ email ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_email ( string $ email ): boolean
$ email = ' [email protected] ' ;
is_email ( $ email );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$email | нить | Адрес электронной почты для тестирования. |
Возвращаемое значение:
True, если данная строка является действительным адресом электронной почты, в противном случае — false.
Получите текущий IP-адрес пользователя.
Util:: ip ( ): string| null
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
ip ( ): null|string
echo ip ();
// 127.0.0.1
Возвращаемое значение:
Обнаруженный IP-адрес, ноль, если IP-адрес не был обнаружен.
Создает безопасный хэш на основе заданного пароля. Использует алгоритм CRYPT_BLOWFISH.
Util:: cryptPassword ( string $ password ): string
Примечание. Рекомендуется длина столбца базы данных 255 символов!
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
crypt_password ( string $ password ): string
$ password = ' foobar ' ;
crypt_password ( $ password );
// $2y$10$6qKwbwTgwQNcmcaw04eSf.QpP3.4T0..bEnY62dd1ozM8L61nb8AC
Параметр | Тип | Описание |
---|---|---|
$password | нить | Пароль для шифрования. |
Возвращаемое значение:
Зашифрованный пароль.
Проверяет соответствие пароля зашифрованному паролю (алгоритм CRYPT_BLOWFISH).
Util:: isPassword ( string $ password , string $ cryptedPassword ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_password ( string $ password , string $ cryptedPassword ): boolean
$ password = ' foobar ' ;
$ cryptedPassword = ' $2y$10$6qKwbwTgwQNcmcaw04eSf.QpP3.4T0..bEnY62dd1ozM8L61nb8AC ' ;
is_password ( $ password , $ cryptedPassword );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$password | нить | Пароль для проверки. |
$cryptedPassword | нить | Зашифрованный пароль (например, сохраненный в базе данных). |
Сбрасывает содержимое данной переменной и выходит из скрипта.
Util:: dd ( mixed $ var )
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
dd ( mixed $ var )
$ array = [
' foo ' => ' bar ' ,
' baz ' => ' qux '
];
dd ( $ array );
// (
// [foo] => bar
// [baz] => qux
// )
Параметр | Тип | Описание |
---|---|---|
$var | смешанный | Вар для сброса. |
Выводит содержимое заданной переменной. Скрипт НЕ останавливается после вызова.
Util:: dump ( mixed $ var )
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
dump ( mixed $ var )
$ array = [
' foo ' => ' bar ' ,
' baz ' => ' qux '
];
dump ( $ array );
// (
// [foo] => bar
// [baz] => qux
// )
Параметр | Тип | Описание |
---|---|---|
$var | смешанный | Вар для сброса. |
Вспомогательный класс, обеспечивающий легкий доступ к полезным функциям php yml.
Класс Yml
Проверяет, содержит ли данный файл синтаксис yaml.
Yml:: isValidFile ( string $ file ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_yml_file ( string $ file ): boolean
$ file = /path/to/file.yml
is_yml_file ( $ file );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$file | нить | Файл для проверки синтаксиса yaml. |
Возвращаемое значение:
True, если файл содержит синтаксис yaml, в противном случае — false.
Проверяет, является ли синтаксис данной строки yaml.
Yml:: isValid ( string $ string ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
is_yml ( string $ string ): boolean
$ string = "
foo: bar
baz: qux
foobar:
foo: bar
" ;
is_yml ( $ string );
// bool(true)
Параметр | Тип | Описание |
---|---|---|
$string | нить | Строка для проверки синтаксиса yaml. |
Возвращаемое значение:
True, если строка имеет формат yaml, в противном случае — false.
Преобразует заданную строку yaml в массив.
Yml:: parse ( string $ yml ): array| null
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
yml_parse ( string $ yml ): array| null
$ yml = "
foo: bar
baz: qux
foobar:
foo: bar
" ;
yml_parse ( $ yml );
// (
// [foo] => bar
// [baz] => qux
// [foobar] => (
// [foo] => bar
// )
// )
Параметр | Тип | Описание |
---|---|---|
$yml | нить | Строка Yaml для анализа. |
Возвращаемое значение:
Преобразованный массив, имеющий значение null в случае ошибки.
Получает значение в строке yaml, используя точечную запись.
Yml:: get ( string $ key , string $ yml ): mixed
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
yml_get ( string $ key , string $ yml ): mixed
$ yml = "
foo: bar
baz: qux
foobar:
foo: bar
" ;
yml_get ( ' foobar.foo ' , $ yml );
// bar
Параметр | Тип | Описание |
---|---|---|
$key | нить | Ключ для поиска с использованием точечной записи (например, «foo.bar.baz»). |
$yml | нить | Строка yml для поиска. |
Возвращаемое значение:
Найденное значение, в противном случае — ноль.
Получает значение в файле yaml, используя точечную нотацию.
Yml:: getFile ( string $ key , string $ ymlfile ): mixed
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
yml_get_file ( string $ key , string $ ymlfile ): mixed
$ ymlfile = ' /path/to/file.yml ' ;
yml_get_file ( ' foobar.foo ' , $ ymlfile );
// bar
Параметр | Тип | Описание |
---|---|---|
$key | нить | Ключ для поиска с использованием точечной записи (например, «foo.bar.baz»). |
$ymlfile | нить | Yml-файл для поиска. |
Возвращаемое значение:
Найденное значение, в противном случае — ноль.
Загружает содержимое yaml-файла в массив.
Yml:: parseFile ( string $ ymlfile ): array
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
yml_parse_file ( string $ ymlfile ): array| null
$ ymlfile = ' /path/to/file.yml ' ;
yml_parse_file ( $ ymlfile );
// (
// [foo] => bar
// [baz] => qux
// [foobar] => (
// [foo] => bar
// )
// )
Параметр | Тип | Описание |
---|---|---|
$ymlfile | нить | Путь к файлу для чтения. |
Возвращаемое значение:
Разобранный массив.
Устанавливает значение в файле yaml, используя точечную нотацию. Внимание: все комментарии в файле будут удалены!
Yml:: setFile ( string $ key , mixed $ value , string $ ymlfile ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
yml_set_file ( string $ key , mixed $ value , string $ ymlfile ): boolean
$ ymlfile = ' /path/to/file.yml ' ;
yml_set_file ( ' foobar.foo ' , ' baz ' , $ ymlfile );
// foo: bar
// baz: qux
// foobar:
// foo: baz
Параметр | Тип | Описание |
---|---|---|
$key | нить | Строка для поиска с точечной записью |
$value | смешанный | Значение, которое необходимо установить для указанного ключа. |
$ymlfile | нить | Yml-файл, в котором нужно установить значение. |
Возвращаемое значение:
True, если значение было успешно установлено в файле yaml, в противном случае — false.
Преобразует заданный массив в синтаксис yaml и помещает его содержимое в заданный файл. Примечание: если файл существует, он будет перезаписан!
Yml:: dumpFile ( array|object $ var , string $ filename , integer $ indent = 2 , integer $ wordwrap , boolean $ openingDashes = false ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
to_yml_file ( array|object $ var , string $ filename , int $ indent = 2 , int $ wordwrap = 0 , bool $ openingDashes = false ): boolean
$ array = [
' foo ' => ' bar ' ,
' baz ' => ' qux '
];
to_yml_file ( $ array , ' /path/to/file.yml ' );
// foo: bar
// baz: qux
Параметр | Тип | Описание |
---|---|---|
$var | массив|объект | Массив или объект для преобразования. |
$filename | нить | Путь к файлу, в который нужно записать строку yaml. Внимание: если файл уже существует, он будет перезаписан! |
$indent | целое число | Отступ преобразованного yaml. По умолчанию 2. |
$wordwrap | целое число | После данного числа будет перенесена строка. По умолчанию 0 (без переноса слов). |
$openingDashes | логическое значение | True, если строка yaml должна начинаться с открывающего тире. По умолчанию ложь. |
Возвращаемое значение:
Истина в случае успеха, ложь в противном случае.
Преобразует заданный массив или объект в строку yaml.
Yml:: dump ( array|object $ var , integer $ indent = 2 , integer $ wordwrap , boolean $ openingDashes = false ): string| null
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
to_yml ( array|object $ array , string $ filename , int $ indent = 2 , int $ wordwrap = 0 , bool $ openingDashes = false ): string| null
$ array = [
' foo ' => ' bar ' ,
' baz ' => ' qux ' ,
' foobar ' => [
' foo ' => ' bar '
]
];
to_yml ( $ array );
// foo: bar
// baz: qux
// foobar:
// foo: bar
Параметр | Тип | Описание |
---|---|---|
$var | массив|объект | Массив или объект для преобразования. |
$indent | целое число | Отступ преобразованного yaml. По умолчанию 2. |
$wordwrap | целое число | После данного числа будет перенесена строка. По умолчанию 0 (без переноса слов). |
$openingDashes | логическое значение | True, если строка yaml должна начинаться с открывающего тире. По умолчанию ложь. |
Возвращаемое значение:
Преобразованная строка yaml. При ошибках возвращается ноль.
Устанавливает значение в строке yaml, используя точечную запись.
Yml:: set ( string $ key , mixed $ value , string & $ yml ): boolean
Соответствующая глобальная функция (описание см. выше).
(прыгнуть назад)
yml_set ( string $ key , mixed $ value , string & $ yml ): boolean
$ yml = "
foo: bar
baz: qux
foobar:
foo: bar
" ;
yml_set ( ' foobar.foo ' , ' baz ' , $ yml );
// foo: bar
// baz: qux
// foobar:
// foo: baz
Параметр | Тип | Описание |
---|---|---|
$key | нить | Строка для поиска с точечной записью |
$value | смешанный | Значение, которое необходимо установить для указанного ключа. |
$yml | нить | Строка yml для поиска. Примечание. Все комментарии в строке будут удалены! |
Возвращаемое значение:
True, если значение было успешно установлено, в противном случае — false.
Этот документ был автоматически создан на основе комментариев к исходному коду 22 января 2018 г. с использованием phpDocumentor и cvuorinen/phpdoc-markdown-public.