array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.highlight-file.php', 1 => 'highlight_file', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Misc. Funções', ), 'prev' => array ( 0 => 'function.halt-compiler.php', 1 => '__halt_compiler', ), 'next' => array ( 0 => 'function.highlight-string.php', 1 => 'highlight_string', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/misc/functions/highlight-file.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
highlight_file — Destaca a sintaxe de um arquivo
Imprime ou retorna a versão com destaque de sintaxe do código contigo
no arquivo filename
utilizando as cores definidas no
destacador de sintaxe nativo do PHP.
Muitos servidores são configurados para destacar automaticamente os arquivos com extensão phps. Por exemplo, o arquivo example.phps quando acessado irá mostrar o código fonte com destaque de cores. Para ativar isso, acrescente a seguinte linha no httpd.conf:
AddType application/x-httpd-php-source .phps
filename
Caminho do arquivo PHP a ser destacado.
return
Informe esse parâmetro como true
para fazer essa função retornar
o código destacado (ao invés de imprimir).
Se return
for true
, retorna o código destacado
como uma string ao invés de imprimir. Se não, irá retornar
true
no sucesso e false
no caso de falhas.
Versão | Descrição |
---|---|
8.3.0 | O HTML resultante foi alterado. |
Cuidados devem ser tomados quando utilizando a função highlight_file() para prevenir que você não revele informações sensíveis inadvertidamente, como senhas e outros tipos de informações que possam criar risco de segurança.
Nota:
Quando o parâmetro
return
é usado, esta função usa um buffer de saída interno, portanto não pode ser usada em uma função callback da função ob_start().