StepCoding

การ Comment ในภาษา PHP

อ่าน [1090] หมวดหมู่: โครงสร้างของภาษา PHP

การ comment เป็นการกำหนดข้อมูลต่าง ๆ เกี่ยวกับโค้ดที่เราได้เขียนไป ซึ่งจะช่วยให้ผู้อื่นที่มาอ่านโค้ดเรานั้นได้เข้าใจในส่วนที่เราเขียนไว้ ซึ่งส่วนที่เราทำการ comment ไว้นั้น PHP จะไม่ทำการแปลความหมายใด ๆ ทั้งสิ้น (มันจะไม่สนใจคำสั่งหรือข้อมูลในส่วน comment)

ถึงแม้ว่าผู้อ่านอาจจะเป็นเพียงคนเดียวเท่านั้นที่จะมาดูแลส่วนโค้ดนั้น ๆ ที่ได้เขียนไปก็ตาม แต่เราก็ควรจะทำการ comment ไว้อยู่ดี เพราะมันเป็นวิธีหนึ่งที่จะช่วยให้เราสามารถอ่านโค้ดนั้น ๆ ย้อนหลังได้ ในกรณีที่เราทิ้งช่วงไปเป็นเดือน ๆ นั่นเอง เช่น

<?php
$x = 17;	// กำหนดค่า 17 ให้กับตัวแปร $x

// แปลงอักขระ &#nnn; ให้เป็นอักขระต่าง ๆ
$text = preg_replace('/&#([0-9])+;/e', "chr('\\1')", $text);
?>

PHP นั้นสนับสนุนวิธีการ comment โค้ดหลายวิธีประกอบด้วย วิธีการ comment แบบภาษา C, C++ และ Unix shell ซึ่งผมจะอธิบายในบทความต่อไปครับ

ผู้สนับสนุน