(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.
çıktı_geriçağırıcı
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.
parça_boyu
İ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.
sil
İ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>