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

كما قد لاحظت، برامج 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
	      }
	   }
	}

	?>
	
	

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

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



<< Lesson 6: شروط

Lesson 8: مصفوفات >>