php htmlentities() 函數把字元轉換為 HTML 實體,本文章向碼農介紹php htmlentities() 函數基本使用方法和執行個體介紹,需要的碼農可以參考一下。
定義和用法
htmlentities() 函數把字元轉換為 HTML 實體。
提示:要把 HTML 實體轉換回字元,請使用 html_entity_decode() 函數。
提示:請使用 get_html_translation_table() 函數來返回 htmlentities() 使用的翻譯表。
文法
htmlentities(string,flags,character-set,double_encode)
| 參數 |
描述 |
| string |
必需。規定要轉換的字串。 |
| flags |
可選。規定如何處理引號、無效的編碼以及使用哪種文件類型。 可用的引號類型:
- ENT_COMPAT - 預設。僅編碼雙引號。
- ENT_QUOTES - 編碼雙引號和單引號。
- ENT_NOQUOTES - 不編碼任何引號。
無效的編碼:
- ENT_IGNORE - 忽略無效的編碼,而不是讓函數返回一個空的字串。應盡量避免,因為這可能對安全性有影響。
- ENT_SUBSTITUTE - 把無效的編碼替代成一個指定的帶有 Unicode 替代字元 U+FFFD(UTF-8)或者 &#FFFD; 的字元,而不是返回一個空的字串。
- ENT_DISALLOWED - 把指定文件類型中的無效代碼點替代成 Unicode 替代字元 U+FFFD(UTF-8)或者 &#FFFD;。
規定使用的文件類型的附加 flags:
- ENT_HTML401 - 預設。作為 HTML 4.01 處理代碼。
- ENT_HTML5 - 作為 HTML 5 處理代碼。
- ENT_XML1 - 作為 XML 1 處理代碼。
- ENT_XHTML - 作為 XHTML 處理代碼。
|
| character-set |
可選。一個規定了要使用的字元集的字串。 允許的值:
- UTF-8 - 預設。ASCII 相容多位元組的 8 位 Unicode
- ISO-8859-1 - 西歐
- ISO-8859-15 - 西歐(加入歐元符號 + ISO-8859-1 中丟失的法語和芬蘭語字母)
- cp866 - DOS 專用 Cyrillic 字元集
- cp1251 - Windows 專用 Cyrillic 字元集
- cp1252 - Windows 專用西歐字元集
- KOI8-R - 俄語
- BIG5 - 繁體中文,主要在台灣使用
- GB2312 - 簡體中文,國家標準字元集
- BIG5-HKSCS - 帶香港擴充的 Big5
- Shift_JIS - 日語
- EUC-JP - 日語
- MacRoman - Mac 作業系統使用的字元集
注釋:在 PHP 5.4 之前的版本,無法被識別的字元集將被忽略並由 ISO-8859-1 替代。自 PHP 5.4 起,無法被識別的字元集將被忽略並由 UTF-8 替代。 |
| double_encode |
可選。布爾值,規定是否編碼已存在的 HTML 實體。
- TRUE - 預設。將對每個實體進行轉換。
- FALSE - 不會對已存在的 HTML 實體進行編碼。
|
技術細節
| 傳回值: |
返回被轉換的字串。 如果 string 包含無效的編碼,則返回一個空的字串,除非設定了 ENT_IGNORE 或者 ENT_SUBSTITUTE 標誌。 |
| PHP 版本: |
4+ |
| 更新日誌: |
在 PHP 5 中,character-set 參數的預設值改為 UTF-8。 在 PHP 5.4 中,新增了:ENT_SUBSTITUTE、ENT_DISALLOWED、ENT_HTML401、ENT_HTML5、ENT_XML1 和 ENT_XHTML。 在 PHP 5.3 中,新增了 ENT_IGNORE。 在 PHP 5.2.3 中,新增了 double_encode 參數。 在 PHP 4.1 中,新增了 character-set 參數。 |
執行個體例子 1
把字元轉換為 HTML 實體:
<?php $str = "Bill & 'Steve'"; echo htmlentities($str, ENT_COMPAT); // 只轉換雙引號 echo "<br>"; echo htmlentities($str, ENT_QUOTES); // 轉換雙引號和單引號 echo "<br>"; echo htmlentities($str, ENT_NOQUOTES); // 不轉換任何引號 ?>
以上代碼的 HTML 輸出如下(查看原始碼):
<!DOCTYPE html> <html> <body> Bill & 'Steve'<br> Bill & 'Tarzan'<br> Bill & 'Steve'</body> </html>
以上代碼的瀏覽器輸出:
Bill & 'Steve'Bill & 'Steve'Bill & 'Steve'
例子 2
通過使用西歐字元集,把一些字元轉換為 HTML 實體:
<?php $str = "My name is ?yvind ?sane. I'm Norwegian."; echo htmlentities($str, ENT_QUOTES, "ISO-8859-1"); // Will only convert double quotes (not single quotes), and uses the character-set Western European ?>
以上代碼的 HTML 輸出如下(查看原始碼):
<!DOCTYPE html> <html> <body> My name is Øyvind Åsane. I'm Norwegian. </body> </html>
以上代碼的瀏覽器輸出:
My name is ?yvind ?sane. I'm Norwegian.
以上這篇php htmlentities()函數的定義和用法就是小編分享給大家的全部內容了,希望能給大家一個參考,也希望大家多多支援雲棲社區。