الدرس السابع: ضع تعليقات في برامجك


كما قد لاحظت، برامج PHP يمكنها أن تبدو مثيرة للحيرة، في هذا الدرس سنتحدث عن أهمية التعليقات وكيف تضعها في برامجك.

لماذا من المهم أن تضع تعليقات في برامجك؟

عندما تبرمج فأنت تكتب لمزود أو حاسوب وتحتاج لكتابة لغة منهجية قد لا تعبر عن أفكارك عندما تكتب البرنامج.

لذلك قد يكون من الصعب على الآخرين وعليك أن تفهم هيكل البرنامج وبالتالي من الصعب تصحيح الأخطاء في البرنامج.

التعليقات تساعد على كتابة نص قصير يشرح جزء من البرنامج، المزود سيتجاهل هذا التعليق ولن يؤثر التعليق على وظائف البرنامج.

في عالم الأعمال، يكون من متطلبات مواصفات البرامج أن تحوي تعليقات وإلا ستكون مخاطرة كبيرة من الشركة أن تستلم برنامجاً تجد صعوبة في إيجاد وتصحيح أخطاءه.

كيف تضع التعليقات؟

من السهل أن تضع تعليقات في برنامجك، ببساطة ابدأ التعليق بعلامة: "//".

ألقي نظرة على هذا المثال من الدرس الخامس ، أضفنا فيه تعليقات:
__________________________________________________ ___

<html>
<head>
<title>Loops</title>
</head>
<body>

<?php

// Here we write color codes using three loops

// Red can be between 0 and 255
for ($intRed=0; $intRed<=255; $intRed=$intRed+30) {

// Green can be between 0 and 255
for ($intGreen=0; $ intGreen<=255; $intGreen=$intGreen+30) {

// Blue can be between 0 and 255
for ($ intBlue=0; $intBlue<=255; $intBlue=$intBlue+30) {

// The color code is made on the form rgb(red,green,blue)
strColor = "rgb(" . intRed . "," . intGreen . "," . intBlue . ")"

// Now we write the color code to the client
echo "<span style='color:" . $strColor . "'> " . $ strColor . " </span>";

// Closes the loops
}
}
}

?>
__________________________________________________ ___

من أجل هذا المثال أضفنا المزيد من التعليقات لنوضح كيف أنك تستطيع تصحيح البرنامج بسهولة مع وجود التعليقات.

لذلك، تذكر أن تضع تعليقات في برنامجك!