(PHP 4, PHP 5, PHP 7, PHP 8)
eval — Bir dizgeyi bir PHP kodu olarak yorumlar
kod_dizgesi
ile belirtilen dizgeyi bir PHP kodu olarak yorumlar.
eval() dil yapısı çok tehlikelidir çünkü keyfi PHP kodunun çalıştırılmasına izin verir. Bu nedenle kullanımı önerilmez. Bu yapıyı kullanmaktan başka bir seçeneğin olmadığına dikkatlice karar verilirse, önceden düzgün bir şekilde doğrulamadan kullanıcı tarafından sağlanan herhangi bir veriyi bu işleve aktarmamaya özellikle dikkat edilmelidir.
kod_dizgesi
Yorumlanacak PHP kodlarını içeren dizge.
Dizge içindeki bir return
deyimi dizgenin yorumlanmasını, anında durdurur.
Kod, PHP açılış ve kapanış PHP etiketleri ile sarmalanmaMAlıdır, yani '<?php echo "Merhaba!"; ?>'
dizgesi yerine 'echo "Merhaba!";'
dizgesi aktarılmalıdır. Uygun PHP etiketlerini kullanarak PHP kipinden çıkmak ve yeniden girmek hala mümkündür, örn. 'echo "PHP kipindeyiz!"; ?>HTML kipindeyiz! <?php echo "Tekrar PHP kipindeyiz!";'
.
Bunun dışında aktarılan kod geçerli PHP kodu olmalıdır. Bu, tüm ifadelerin noktalı virgül kullanılarak uygun şekilde sonlandırılması gerektiği anlamına gelir. Örneğin 'echo "Merhaba!"'
bir ayrıştırma hatasına sebep olurken, 'echo "Merhaba!";'
çalışacaktır.
Bir return
deyimi kodun yorumlanmasını derhal sonlandıracaktır.
Kod, eval() işlevini çağıran kodun etki alanında çalıştırılacaktır. Bu nedenle eval() çağrısında tanımlanan veya değiştirilen tüm değişkenler, işlev sonlandırıldıktan sonra görünür kalacaktır.
Kod dizgesi içinde bir return
bulunmadıkça eval() daima null
döndürür. return
ile bir değer döndürülmesi durumunda bu değeri döndürür. Belirtilen dizgede bir çözümleme hatası saptanırsa eval() PHP 7 öncesinde false
döndürüp çalışma dosyadaki sonraki deyimden normal olarak devam eder; PHP 7 ve sonrasında ise ParseError istisnası yavrulanır. eval() işlevinin yorumladığı kodlardaki bir hatayı set_error_handler() kullanarak döndürmek mümkün değildir.
Örnek 1 - eval() örneği
<?php
$dizge = 'Gülhane';
$isim = 'çınar';
$metin = 'Burası $dizge parkı ve ben bir $isim ağacıyım.';
echo $metin. "\n";
eval("\$metin = \"$metin\";");
echo $metin. "\n";
?>
Yukarıdaki örneğin çıktısı:
Burası $dizge parkı ve ben bir $isim ağacıyım. Burası Gülhane parkı ve ben bir çınar ağacıyım.
Bilginize: Bu bir işlev değil, dil oluşumu olduğundan değişken işlevler veya isimli bağımsız değişkenler kullanılarak çağrılamaz.
Sonuçlarını doğrudan tarayıcıya çıktılayan her şey gibi, çıktı denetleme işlevleri bu işlevin de çıktısını yakalamak ve (örneğin) string türünde saklamak için kullanılabilir.
Bilginize:
Yorumlanan kodda ölümcül bir hata varsa betiğin tamamı durdurulur.