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 htmlspecialchars()

   PHP String 字符串函数手册

    A função htmlspecialchars() é usada para converter caracteres especiais em entities HTML.

Sintaxe

string htmlspecialchars(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 caracteres especiais em entities HTML

Retorno

Ele retorna a string convertida (string).
Se a string contiver sequências de código单元 inválidas no encoding especificado, retornará uma string vazia sem configurar os marcadores ENT_IGNORE ou ENT_SUBSTITUTE.

Os caracteres pré-definidos são:

  • & (e) torna-se &

  • " (aspas duplas) torna-se "

  • ' (aspas simples) torna-se '

  • < (menor que) torna-se <

  • > (maior que) torna-se >

注意:Para converter caracteres de entities HTML especiais em caracteres, use htmlspecialchars_decode() Função.

Parâmetro

Número de sérieParâmetros e descrições
1

string

Obrigatório. Contém informações sobre a string de entrada

2

flags

Opcional. Especifica como lidar com aspas, codificações inválidas 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.

Codificação inválida:

  • ENT_IGNORE - Ignorar codificações inválidas, em vez de retornar uma string vazia. Evitar isso, 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 实体,编码双引号和单引号
   $input = htmlspecialchars("<a href='https://pt.oldtoolbag.com'>w3codebox</a>"
   echo $input;
?>
测试看看‹/›

输出结果-

<a href='https://pt.oldtoolbag.com'>w3codebox</a>

PHP String 字符串函数手册