ob_end_clean
(PHP 4, PHP 5, PHP 7, PHP 8)
ob_end_clean — Löscht den Ausgabe-Puffer und deaktiviert die Ausgabe-Pufferung
Beschreibung
Der Inhalt des Ausgabepuffers (sofern vorhanden) wird verworfen und der Ausgabepuffer (aber nur dieser) wird deaktiviert. Falls sie mit dem Puffer-Inhalt weiter arbeiten möchten, müssen sie diesen erst per ob_get_contents() zwischen speichern bevor sie ob_end_clean() aufrufen, da dadurch der Puffer geleert wird.
Der Ausgabepuffer muss durch ob_start() mit den PHP_OUTPUT_HANDLER_CLEANABLE und PHP_OUTPUT_HANDLER_REMOVABLE Flags aktiviert werden. Andernfalls funktioniert ob_end_clean() nicht.
Parameter-Liste
Diese Funktion besitzt keine Parameter.
Rückgabewerte
Die Funktion gibt true
zurück wenn ein Ausgabepuffer entfernt
wurde, false
wenn kein aktiver Puffer vorhanden war oder der
aktuelle Puffer nicht deaktiviert werden konnte (dies ist bei
speziellen Puffern möglich).
Fehler/Exceptions
Im Fehlerfall generiert die Funktion eine E_NOTICE
Meldung.
Beispiele
Das folgende Beispiel zeigt einen einfachen Weg um alle aktiven Ausgabepuffer zu entfernen:
Beispiel #1 ob_end_clean() Beispiel
<?php
ob_start();
echo 'Text der nicht ausgegeben wird.';
ob_end_clean();
?>
Siehe auch
- ob_start() - Ausgabepufferung aktivieren
- ob_get_contents() - Liefert den Inhalt des Ausgabepuffers
- ob_flush() - Leert (sendet) den Ausgabepuffer