English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Tutorial Básico PHP

Tutorial Avançado PHP

PHP & MySQL

Manual de Referência PHP

Uso e exemplo da função PHP htmlentities()

   PHP String 字符串函数手册

    A função htmlentities() é usada para converter caracteres em caracteres de escape HTML

Sintaxe

string htmlentities (string $string[, int $flags = ENT_COMPAT | ENT_HTML401 [string $encoding = ini_get("default_charset")[, bool $double_encode = true]])

Definição e uso

Usado para converter todos os caracteres aplicáveis em entidades HTML

Retorno

Retorna a string codificada.

Parâmetro

Número de ordemParâmetros e descrição
1

string

Contém informações sobre a string de entrada

2

flags

Opcional. Especifica como lidar com aspas, códigos inválidos e qual tipo de documento usar.

Tipos de aspas disponíveis:

  • ENT_COMPAT - Padrão. Apenas codificar aspas duplas.

  • ENT_QUOTES - Codificar aspas duplas e simples.

  • ENT_NOQUOTES - Não codificar nenhuma aspas.

Código inválido:

  • ENT_IGNORE - Ignorar códigos inválidos, em vez de retornar uma string vazia. Evitar ao máximo, pois pode afetar a segurança.

  • 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 处理代码。

3

encoding

它是一个可选参数,定义了转换字符时使用的编码。

允许的值:

  • 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 代替。

4

double_encode

可选。一个指定了是否编码已存在的 HTML 实体的布尔值。
  • TRUE - 默认。将对每个实体进行转换。

  • FALSE - 不会对已存在的 HTML 实体进行编码。

在线示例

试试下面的实例,将字符转换为 HTML 实体

<?php
   //将字符转换为 HTML 实体
   $str = "PHP Function htmlentities";
   
   echo htmlentities($str);
   echo htmlentities($str, ENT_QUOTES);
?>
测试看看‹/›

输出结果-

PHP Function htmlentitiesPHP Function htmlentities

PHP String 字符串函数手册