clausnz/php-helpers
库是45 个有用的 php 辅助函数(PHP 5.6, 7.*)
的集合。
使用composer
安装后,可以从代码中的任何位置访问全局函数:
composer require clausnz/php-helpers
<?php
dump ( ' any content ' );
如果项目定义函数(内置函数和用户定义函数)列表中已存在同名函数,则该函数将不会在您的环境中注册。因此,不会出现与现有功能的冲突。
尽管如此,每个函数仍然可以通过正确的 use 语句以静态方式访问它:
<?php
use CNZ Helpers Util as util ;
util:: dump ( ' any content ' );
该库利用了以下出色且众所周知的库:
所有功能都针对多个单元测试和 PHP 版本进行了测试。
使用 Composer 安装最新的clausnz/php-helper
库:
composer require clausnz/php-helpers
还要确保需要您的作曲家自动加载文件:
require __DIR__ . ' /vendor/autoload.php ' ;
安装后,新的全局 PHP 函数在您的代码中随处可用。要访问帮助器类中的(几乎相同的)静态函数,请将正确的 use 语句添加到您的文件中:
<?php
use CNZ Helpers Dev as dev ;
if ( dev:: isIphone () ) {
// Do something here
}
Helper 类提供对有用的 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 | 大批 | 要转换的数组。 |
返回值:
转换后的数组的 std 对象表示形式。
将字符串或对象转换为数组。
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 | 字符串|对象 | 字符串或对象。 |
返回值:
转换后的字符串或对象的数组表示形式。出错时返回 null。
返回数组的第一个元素。
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 doku: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 doku: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
}
返回值:
如果当前访问者使用基于 Android 的设备,则为 true,否则为 false。
确定当前设备是否是 iPhone。
Dev:: isIphone ( ): boolean
相关的全局函数(说明见上文)。
(向后跳)
is_iphone ( ): boolean
if ( is_iphone () ) {
// I am an iPhone
}
返回值:
如果当前访问者使用 iPhone,则为 true,否则为 false。
确定当前设备是否来自三星。
Dev:: isSamsung ( ): boolean
相关的全局函数(说明见上文)。
(向后跳)
is_samsung ( ): boolean
if ( is_samsung () ) {
// I am a device from Samsung
}
返回值:
如果当前访问者使用三星设备,则为 true,否则为 false。
确定当前设备是否运行 iOS 操作系统。
Dev:: isIOS ( ): boolean
相关的全局函数(说明见上文)。
(向后跳)
is_ios ( ): boolean
if ( is_ios () ) {
// I am an iOS based device
}
返回值:
如果当前访问者使用 iOS 设备,则为 true,否则为 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 | 细绳 | 要搜索的字符串。 |
返回值:
如果找到 $needle,则为 true,否则为 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 | 细绳 | 要搜索的字符串。 |
返回值:
如果找到 $needle,则为 true,否则为 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 | 细绳 | 要搜索的字符串。 |
返回值:
如果找到 $needle,则为 true,否则为 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 | 细绳 | 要搜索的字符串。 |
返回值:
如果找到 $needle,则为 true,否则为 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 | 细绳 | 要搜索的字符串。 |
返回值:
如果找到 $needle,则为 true,否则为 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 | 细绳 | 要搜索的字符串。 |
返回值:
如果找到 $needle,则为 true,否则为 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 语法的文件。 |
返回值:
如果文件包含 yaml 语法,则为 true,否则为 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 语法的字符串。 |
返回值:
如果字符串是 yaml,则为 true,否则为 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 字符串。 |
返回值:
找到的值,否则为 null。
使用点表示法获取 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 文件。 |
返回值:
找到的值,否则为 null。
将 yamlfile 的内容加载到数组中。
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 | 细绳 | 要读取的文件的路径。 |
返回值:
解析后的数组。
使用点符号在 yamlfile 中设置值。注意:文件中的所有评论都将被删除!
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 文件。 |
返回值:
如果在 yamlfile 中成功设置值,则为 True,否则为 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 | 布尔值 | 如果 yaml 字符串应以破折号开头,则为 true。默认为 false。 |
返回值:
成功时为真,否则为假。
将给定数组或对象转换为 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 | 布尔值 | 如果 yaml 字符串应以破折号开头,则为 True。默认为 false。 |
返回值:
转换后的 yaml 字符串。如果出现错误,则返回 null。
使用点表示法在 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。
本文档是使用 phpDocumentor 和 cvuorinen/phpdoc-markdown-public 根据 2018-01-22 的源代码注释自动生成的