Agora Metin2 1
Agora Metin2
berzahx 1
berzahx
Aliyldrim 2
Aliyldrim
-ECD- 1
-ECD-
Reklam vermek için turkmmo@gmail.com

Altın Konu PHP htmlspecialchars(): HTML Kaçışlama ve XSS Saldırılarını Önleme

  • Konuyu başlatan Konuyu başlatan Agora Metin2
  • Başlangıç tarihi Başlangıç tarihi
  • Cevaplar Cevaplar 2
  • Görüntüleme Görüntüleme 22
image.jpeg


htmlspecialchars($text) fonksiyonu; &, <, >, " ve ' karakterlerini sırasıyla &amp;, &lt;, &gt;, &quot; ve &#039; şekline dönüştürür. Kullanıcıdan gelen her türlü veriyi sayfaya yazdırırken bu fonksiyonu kullanmalısınız; böylece girdi tarayıcı tarafından HTML kodu olarak değil, düz metin olarak algılanır.

Kod çalıştırıldığında, aynı veri bir kez ham haliyle bir kez de kaçışlanmış haliyle yazdırılır. Form kısmına <h1>big</h1> veya <img src=x> gibi HTML etiketleri yazıp sonucu kontrol ettiğinizde aradaki farkı görebilirsiniz.

PHP:
<?php
$comment = $_POST['comment'] ?? '<b>Great</b> post, <i>thanks</i> & "see you"';
?>
<form method="post">
  <input name="comment" size="40" value="<?= htmlspecialchars($comment) ?>">
  <button>Show</button>
</form>
<p>Raw: <?= $comment ?></p>
<p>Escaped: <?= htmlspecialchars($comment) ?></p>

Ham verinin olduğu satırda tarayıcı etiketleri yorumlar: örneğin kalın yazı etiketi kullanıldıysa yazı kalın görünür. Eğer bir ziyaretçi <script> içeren bir girdi girerse, bu betik diğer tüm kullanıcıların tarayıcısında çalışır. Bu güvenlik açığına siteler arası betik çalıştırma (XSS) denir. Kaçışlanmış satırda ise karakterler &lt;b&gt; şeklinde iletildiği için tarayıcı bunları sadece metin olarak ekrana çizer. PHP'nin arka planda gönderdiği gerçek karakterleri görmek için çıktı sekmesine bakabilirsiniz.

htmlspecialchars hangi karakterleri dönüştürür?

Sadece beş temel karakter dönüştürülür, bunun dışındaki hiçbir şeye dokunulmaz. Harfler, aksanlar veya emojiler olduğu gibi kalır.

PHP:
<?php
$samples = ['<', '>', '&', '"', "'", 'café ☕', "Tom & Jerry's", '5 < 6 && 7 > 2'];

foreach ($samples as $s) {
    echo mb_str_pad($s, 16), ' => ', htmlspecialchars($s), "\n";
}

& karakterinin listede olmasının nedeni, tüm HTML varlıklarının bu işaretle başlamasıdır. Eğer bu karakter dönüştürülmeseydi, örneğin < işaretinden bahsetmek için yazılan &lt; ifadesi tarayıcı tarafından gerçek bir < karakteri olarak algılanırdı.

Sadece metinleri değil, öznitelikleri de kaçışlayın

Bir HTML özniteliğinin (attribute) içinde yer alan kullanıcı girdileri de aynı şekilde kaçışlanmalıdır. Aksi takdirde, girdi içerisindeki bir tırnak işareti özniteliği kapatarak girdinin geri kalanının yeni öznitelikler olarak eklenmesine yol açar. Örneğin "isim" alanına girilen veriyle gizlice bir style özniteliği eklendiğinde kod çalıştırılırsa iki kutu arasındaki fark görülür.

PHP:
<?php
$name = 'Ada" style="background:#c62828;color:#fff';
?>
<p>Unsafe: <input size="45" value="<?= $name ?>"></p>
<p>Safe: <input size="45" value="<?= htmlspecialchars($name) ?>"></p>

Güvensiz kutuda tarayıcı önce value="Ada" kısmını okur, ardından gelen yeni style özniteliğini işler; bu yüzden kutu kırmızıya döner ve sadece Ada yazısı görünür. Kötü niyetli bir saldırgan style yerine onfocus="..." yazarak kod çalıştırabilirdi. Güvenli kutuda ise her " işareti &quot; haline getirildiği için tüm metin value özniteliğinin içinde kalır ve olduğu gibi görüntülenir.

PHP 8.1 versiyonundan itibaren varsayılan bayraklar ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 olduğu için tek tırnaklar da otomatik olarak kaçışlanır ve '...' şeklinde tanımlanan öznitelikler güvenli hale gelir. PHP 7 ve önceki sürümlerde ise ENT_QUOTES değerini elle belirtmek gerekiyordu:

PHP:
<?php
$s = "It's <ok>";

echo htmlspecialchars($s), "\n";                // PHP 8.1+ default: ENT_QUOTES
echo htmlspecialchars($s, ENT_COMPAT), "\n";    // the old default: ' left alone
echo htmlspecialchars($s, ENT_NOQUOTES), "\n";  // no quotes escaped at all

Şablonlar için pratik bir yardımcı

Şablon dosyalarında sürekli olarak htmlspecialchars($x, ENT_QUOTES, 'UTF-8') yazmak kod kalabalığına yol açar. Bu nedenle pek çok projede bu işlem tek harfli bir yardımcı fonksiyonla sarmalanır. Twig ve Blade gibi şablon motorları, {{ $var }} kullanımıyla bu işlemi otomatik olarak gerçekleştirir.

PHP:
<?php
function e(?string $value): string
{
    return htmlspecialchars($value ?? '', ENT_QUOTES, 'UTF-8');
}

$users = [
    ['name' => 'Ada <admin>', 'bio' => 'Writes "notes" & programs'],
    ['name' => "O'Brien", 'bio' => null],
];
?>
<ul>
<?php foreach ($users as $u): ?>
  <li title="<?= e($u['bio']) ?>"><strong><?= e($u['name']) ?></strong>: <?= e($u['bio'] ?? 'no bio') ?></li>
<?php endforeach; ?>
</ul>

?string tür belirteci ve ?? '' kullanımı kritiktir; çünkü PHP 8.1'den itibaren htmlspecialchars() fonksiyonuna null değer göndermek kullanımdan kaldırılmıştır (deprecated). Eğer bu önlem alınmazsa, biyografisi boş olan her kullanıcı için PHP bir uyarı mesajı yazdıracaktır.

Çift kodlama ve htmlspecialchars_decode

Bir veri iki kez kaçışlandığında kullanıcı ekranda HTML varlıklarını görür: & işareti ilk seferde &amp;, ikinci seferde ise &amp;amp; olur ve tarayıcı bunu &amp; olarak gösterir. Bu durum genellikle verinin hem kaydedilirken hem de ekrana yazdırılırken tekrar kaçışlandığında meydana gelir. Mevcut varlıkların tekrar işlenmesini önlemek için double_encode: false parametresi verilebilir veya işlemi geri almak için htmlspecialchars_decode() fonksiyonu kullanılabilir.

PHP:
<?php
$once = htmlspecialchars('Fish & Chips "special"');
echo $once, "\n";

echo htmlspecialchars($once), "\n";                        // escaped twice
echo htmlspecialchars($once, double_encode: false), "\n";  // existing entities kept
echo htmlspecialchars_decode($once), "\n";                 // back to the original

En doğru çözüm, veriyi ham haliyle saklamak ve sadece çıktı aşamasında kaçışlamaktır. double_encode: false seçeneği ise daha çok dışarıdan alınan ve halihazırda varlıklar içeren metinler için uygundur.

htmlspecialchars, htmlentities ve strip_tags karşılaştırması

Bu üç fonksiyon sıkça birbirine karıştırılır. Aşağıdaki örnekte hepsinin aynı girdi üzerindeki etkisi, PHP'nin ne ürettiği ve tarayıcının bunu nasıl yorumladığı görülmektedir:

PHP:
<?php
$input = '<b onclick="steal()">Café</b> & <u>notes</u>';

$results = [
    'htmlspecialchars' => htmlspecialchars($input),
    'htmlentities' => htmlentities($input),
    'strip_tags' => strip_tags($input),
    "strip_tags with '<b>' allowed" => strip_tags($input, '<b>'),
];
?>
<table border="1" cellpadding="6">
  <tr><th>Function</th><th>PHP prints</th><th>Browser shows</th></tr>
<?php foreach ($results as $fn => $out): ?>
  <tr><td><?= htmlspecialchars($fn) ?></td><td><code><?= htmlspecialchars($out) ?></code></td><td><?= $out ?></td></tr>
<?php endforeach; ?>
</table>

• htmlspecialchars(): Beş temel HTML karakterini kaçışlar. HTML sayfasına yazdırılan tüm metinler için standart yöntem budur.
• htmlentities(): é gibi karakterleri de &eacute; şeklinde dönüştürür. Sayfaların UTF-8 olmadığı dönemlerde faydalıydı; günümüzde ise sadece kaynak kodun okunmasını zorlaştırmaktadır.
• strip_tags(): Etiketleri tamamen siler ve sadece içindeki metni korur. HTML içeriğini düz metne çevirmek (meta açıklamaları veya e-posta önizlemeleri gibi) için kullanılır, güvenlik için değil. Örnekte görüldüğü üzere, izin verilen bir <b> etiketinin içindeki onclick özniteliği silinmez ve öznitelik içine yazılan metinlere dokunulmaz.

htmlspecialchars'ın yetersiz kaldığı durumlar

htmlspecialchars() fonksiyonu HTML metinleri ve tırnaklı öznitelikler için doğrudur. Ancak sayfanın diğer bölümleri farklı kurallar gerektirir:

PHP:
<?php
$search = 'rock & roll "live"';
$user = ['name' => "</script><b>Ada</b>", 'id' => 7];

// Inside a URL: encode the value, then escape the whole URL for the attribute
$href = '?' . http_build_query(['q' => $search]);
echo '<p><a href="' . htmlspecialchars($href) . '">Search</a></p>', "\n";

// Inside <script>: json_encode with the HEX flags, never htmlspecialchars
$json = json_encode($user, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT);
echo "<script>const user = $json;</script>\n";
echo '<p>Script data: <code>' . htmlspecialchars($json) . '</code></p>', "\n";

• URL'lerdeki değerleri kodlamak için http_build_query() veya urlencode() kullanılmalıdır; ardından bu parametreler arasındaki & işaretinin geçerli HTML olması için htmlspecialchars() uygulanabilir.
• JavaScript tarafında geçerli bir JS değeri üretmek için json_encode() kullanılır. JSON_HEX_TAG bayrağı ile < ve > karakterleri \u003C ve \u003E haline getirilir, böylece verideki bir </script> ifadesi betik etiketini kapatamaz.
• Kullanıcı girdisini şema kontrolü yapmadan doğrudan href içine yazdırmayın: htmlspecialchars('javascript:alert(1)') ifadesi değişmeden kalır ve tıklandığında çalışır. Sadece http ve https protokollerini kabul etmek için filter_var kullanılmalıdır.
 

Şu an konuyu görüntüleyenler (Toplam : 0, Üye: 0, Misafir: 0)

Geri
Üst