função htmlspecialchars () do PHP

Exemplos

Os personagens predefinidos "<" (menos) e ">" (superior) convertidos para entidades HTML:

<?php
$str = "This is some bold text.";
echo htmlspecialchars($str);
?>

saída HTML do código acima é a seguinte (ver fonte):

<!DOCTYPE html>
<html>
<body>
This is some bold text.
</body>
</html>

saída do navegador de código acima é a seguinte:

This is some bold text.

Correndo instância »

Definição e Uso

htmlspecialchars () para alguns personagens pré-definidos em entidades HTML.

Os personagens pré-definidos são:

& (E comercial) torna-se & amp;
"(Aspas duplas) torna-se & quot;
'(Aspas simples) torna-se'
<(Menor que) torna-se & lt;
> (Maior que) se torna & gt;

Dica: Para obter entidades HTML especiais de volta ao personagem, use htmlspecialchars_decode () função.

gramática

htmlspecialchars( string,flags,character-set,double_encode )

parâmetros	descrição
corda	Necessário. Disposições da cadeia a ser convertida.
bandeiras	Opcional. Como lidar com as disposições das citações, codificação inválida e quais tipos de documentos. tipos disponíveis de citações: ENT_COMPAT - padrão. Codifica apenas aspas duplas. ENT_QUOTES - Codificação aspas duplas e simples. ENT_NOQUOTES - não codifica qualquer cotações. código inválido: ENT_IGNORE - ignore codificação inválido, em vez de a função retorna uma cadeia vazia. Ele deve ser evitado, pois isso pode afetar a segurança. ENT_SUBSTITUTE - para substituir a codificação inválida com caractere de substituição Unicode U + FFFD (UTF-8) ou & # FFFD um designado; personagem em vez de devolver uma cadeia vazia. ENT_DISALLOWED - a alternativa para especificar o tipo de ponto de documento inválido código de Unicode em caractere substituto U + FFFD (UTF-8) ou & # FFFD;. tipos de documentos requerem o uso de sinalizadores adicionais: ENT_HTML401 - padrão. Como HTML 4.01 código de manipulação. ENT_HTML5 - manipulação de código como HTML 5. ENT_XML1 - como XML 1 código de manipulação. ENT_XHTML - como código de manipulação de XHTML.
character-set	Opcional. Uma string que especifica o conjunto de caracteres a ser utilizado. Os valores permitidos: UTF-8 - padrão. ASCII compatível multi-byte Unicode 8 ISO-8859-1 - Europa Ocidental ISO-8859-15 - Europa Ocidental (para juntar-se o símbolo do euro + ISO-8859-1 nas letras francesas e finlandesas falta) CP866 - DOS dedicado conjunto de caracteres cirílicos CP1251 - conjunto de caracteres cirílicos específico do Windows CP1252 - conjuntos de caracteres do Windows específicas da Europa Ocidental KOI8-R - Russian BIG5 - Chinês Tradicional, usado principalmente em Taiwan GB2312 - Chinês Simplificado, conjunto de caracteres padrão nacional BIG5-HKSCS - Big5 com extenções de Hong Kong Shift_JIS - japonês EUC-JP - Japanese MacRoman - conjunto de caracteres usado pelo sistema operacional Mac Nota: Na anterior versão 5.4 do PHP, não pode ser reconhecido conjunto de caracteres serão ignoradas pela ISO-8859-1 em vez disso.Desde o PHP 5.4 em diante, o conjunto de caracteres não pode ser identificado será ignorado pelo UTF-8 em vez disso.
double_encode	Opcional. Um valor booleano que especifica se as entidades HTML codificação existentes. TRUE - padrão. Ele irá converter cada entidade. FALSE - não tem efeito sobre existente entidade HTML codificado.

detalhes técnicos

retorna:	Retorna a string convertida. Se a cadeia contém código inválido, uma cadeia vazia é devolvida, a menos que a bandeira ENT_IGNORE ou ENT_SUBSTITUTE.
versão do PHP:	4+
log Update:	No PHP 5, parâmetros para UTF-8 valores padrão character-set. No PHP 5.4, e acrescentou: ENT_SUBSTITUTE, ENT_DISALLOWED, ENT_HTML401, ENT_HTML5, ENT_XML1 e ENT_XHTML. No PHP 5.3, adicione o ENT_IGNORE. No PHP 5.2.3, adicionar os parâmetros double_encode. No PHP 4.1, adicionar os parâmetros de conjunto de caracteres.

mais exemplos

exemplo 1

Alguns caracteres pré-definidos em entidades HTML:

<?php
$str = "Jane & 'Tarzan'";
echo htmlspecialchars($str, ENT_COMPAT); // Will only convert double quotes
echo " ";
echo htmlspecialchars($str, ENT_QUOTES); // Converts double and single quotes
echo " ";
echo htmlspecialchars($str, ENT_NOQUOTES); // Does not convert any quotes
?>

saída HTML do código acima é a seguinte (ver fonte):

<!DOCTYPE html>
<html>
<body>
Jane & 'Tarzan' 
Jane & 'Tarzan' 
Jane & 'Tarzan'
</body>
</html>

saída do navegador de código acima é a seguinte:

Jane & 'Tarzan'
Jane & 'Tarzan'
Jane & 'Tarzan'

Correndo instância »