Function.highlight-file
Aus PHP-Wiki
highlight_file — Syntax-Hervorhebung für eine Datei
Inhaltsverzeichnis |
Beschreibung
mixed highlight_file ( string $Dateiname [, bool $zurückgeben ] )
Erzeugt die hervorgehobene Syntax des Codes der Datei
Dateiname
als Ausgabe oder als Rückgabewert. Dabei
werden die Farben des in PHP eingebauten Syntax-Highlighters benutzt.
Viele Server sind so konfiguriert, dass sie den Code von Dateien mit der
phps-Erweiterung automatisch hervorheben. Wenn zum
Beispiel beispiel.phps aufgerufen wird, wird die
hervorgehobene Syntax des Quellcodes der Datei angezeigt. Mit der folgenden
Zeile in der httpd.conf wird dies aktiviert:
AddType application/x-httpd-php-source .phps
Parameter-Liste
- Dateiname
- Der Pfad zur PHP-Datei, deren Code hervorgehoben werden soll.
- zurückgeben
- Wenn dieser Parameter auf TRUE gesetzt wird, gibt die Funktion den hervorgehobenen Code zurück.
Rückgabewerte
Falls zurückgeben auf TRUE gesetzt ist, wird der hervorgehobene Code nicht direkt ausgegeben, sondern als Zeichenkette zurückgegeben. Andernfalls wird bei Erfolg TRUE zurückgegeben und FALSE, falls ein Fehler auftritt.
ChangeLog
Version Beschreibung 4.2.1 Diese Funktion wird nun ebenfalls von safe_mode und open_basedir beeinflusst. 4.2.0 Den Parameter zurückgeben hinzugefügt.
Anmerkungen
Achtung
Wenn highlight_file() verwendet wird, sollte darauf
geachtet werden, dass nicht versehentlich vertrauliche Informationen wie
zum Beispiel Passwörter oder andere Informationen, die ein potentielles
Sicherheitsrisiko schaffen könnten, verraten werden.
Hinweis: Diese Funktion benutzt intern
Ausgabenpufferung mit diesem Parameter
und kann daher nicht in einer ob_start() Callbackfunktion
eingesetzt werden.