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 年 1 月 22 日根據原始碼註解自動產生的