(PHP 4, PHP 5)
ob_start — Çıktı tamponlamasını başlatır
Bu işlev çıktı tamponlamasını ektin kılar. Çıktı tamponlaması etkinken betikten (başlıklar dışında) hiçbir çıktı gönderilmez ve çıktı dahili bir tamponda saklanır.
Bu dahili tamponun içeriği ob_get_contents() işleviyle bir dizge değişkenine kopyalanabilir. Dahili tamponda birikenleri çıktılamak için ob_end_flush() işlevini kullanın. Çıktılamak istemiyorsanız, ob_end_clean() işlevi ile tampon içeriğini sessiz sedasız silebilirsiniz.
Bazı HTTP sunucuları (Apache gibi) geriçağırım işlevini çağırırken betiğin çalışma dizinini değiştirir. Geriçağırım işlevinde chdir(dirname($_SERVER['SCRIPT_FILENAME'])) gibi bir çağrıyla betiğin bulunduğu dizine dönebilirsiniz.
Çıktı tamponlaması bir yığıt gibi çalışabilir, bir ob_start() etkinken başka bir ob_start() çağrısı yapabilirsiniz. Yalnız aynı sayıda ob_end_flush() çağrısı yapmayı unutmayın. Eğer çok sayıda çıktı geriçağırım işlevi etkinse, her biri iç içelik sırası gözetilerek çıktıyı süzerler.
Bu değiştirge ile isteğe bağlı bir çıktı eylemcisi işlev belirtilebilir. Bu işlev değiştirge olarak bir dizge almalı ve bir dizge döndürmelidir. Bu işlev, çıktı tamponu boşaltılırken (gönderim), tampon temizlenirken (ob_flush(), ob_clean() ve benzeri bir işlevle) veya isteğin sonunda çıktı tamponu kullanıcının tarayıcısına boşaltılırken çağrılacaktır. İşlev çağrıldığında çıktı tamponunu değiştirge olarak alması ve sonuçta tarayıcıya gönderilmek üzere yeni bir çıktı tamponu döndürmesi beklenir. Eğer bu değiştirge ile belirtilen işlev çağrılabilir değilse ob_start() FALSE döndürür.
Eğer geriçağırıcı iki değiştirgeli ise ikinci değiştirge PHP_OUTPUT_HANDLER_START, PHP_OUTPUT_HANDLER_CONT ve PHP_OUTPUT_HANDLER_END değerlerinden oluşan bir bit alanı ile doldurulur.
çıktı_geriçağırıcı FALSE döndürdüğü takdirde özgün çıktı tarayıcıya gönderilir.
çıktı_geriçağırıcı, değiştirgesine bir NULL değer aktarılarak atlanabilir.
ob_end_clean(), ob_end_flush(), ob_clean(), ob_flush() ve ob_start() bir geriçağırım işlevi olarak belirtilemez. Bunlardan biri belirtilirse, davranışın nasıl olacağı belirsizdir. Bir tamponun içeriğini silmek isterseniz geriçağrıcıdan "" (boş dizge) döndürmelisiniz. Bir geriçağırım işlevinden, çıktı tamponlama işlevlerini kullanarak print_r($ifade, true) veya highlight_file($dosyaismi, true) gibi işlevleri çağıramazsınız.
Bilginize:
PHP 4.0.4'ten itibaren, sıkıştırılmış sayfaları destekleyen tarayıcılara gziplenmiş veri göndermek için ob_gzhandler() işlevi kullanılabilmektedir. ob_gzhandler() işlevi tarayıcının kabul edeceği içerik kodlamasının türünü tespit ettikten sonra buna uygun çıktı döndürür.
İsteğe bağlı parça_boyu belirtildiği takdirde, parça_boyunu aşan veya tamponun tam dolmasına sebep olan bir çıktılama çağrısından sonra tampon boşaltılır. Öntanımlı 0 değerinin anlamı işlevin sadece tamponun sonuna gelindiğinde çağrılacağı anlamına gelirken, özel 1 değeri parça_boyu değerinin 4096 olacağı anlamına gelir.
İsteğe bağlı sil değiştirgesinde FALSE belirtilirse, betik sonlanana kadar tampon boşaltılmaz.
Başarı durumunda TRUE, başarısızlık durumunda FALSE döner.
Sürüm: | Açıklama |
---|---|
4.3.2 | çıktı_geriçağırıcı çalıştırılamadığı zaman işlevin FALSE döndürmesi sağlandı. |
4.2.0 | sil değiştirgesi eklendi. |
Örnek 1 - Kullanıcı tanımlı geriçağırım işlevi örneği
<?php
function geriçağırım($tampon)
{
// elmaları armutlarla değiştirelim
return (str_replace("elmalar", "armutlar", $tampon));
}
ob_start("geriçağırım");
?>
<html>
<body>
<p>Bizden elmalarla armutların karşılaştırılması isteniyor.</p>
</body>
</html>
<?php
ob_end_flush();
?>
Yukarıdaki örneğin çıktısı:
<html> <body> <p>Bizden armutlarla armutların karşılaştırılması isteniyor.</p> </body> </html>