Como Comentar Código PHP - Área e Perímetro de um Cìrculo

Neste tutorial de nosso curso de PHP, vamos aprender uma ferramenta essencial para qualquer desenvolvedor: como comentar códigos. Além disso, vamos colocar em prática o que aprendemos resolvendo uma questão real sobre cálculo de área e perímetro de uma circunferência.

📚 Estude PHP com Qualidade Profissional

O conteúdo do site é ótimo, mas a Apostila PHP Progressivo é o material que vai te levar ao próximo nível. Tudo organizado e com projetos práticos.

BAIXAR APOSTILA COMPLETA →

Por que comentar seu código?

Um comentário não serve para o computador, mas sim para os seres humanos. O interpretador do PHP ignora completamente qualquer texto marcado como comentário. À medida que seus sistemas crescerem, os comentários serão seus melhores amigos para entender o que você mesmo escreveu meses atrás.

1. Comentários de uma linha: //

Para fazer um comentário rápido que ocupa apenas uma linha, usamos duas barras (//).

<?php 
  // Pega o valor do formulário
  $num = $_GET['num'];
  
  // Imprimindo o número fornecido
  echo "Número digitado: $num <br />";
   
  echo "Número dobrado : ", 2*$num; // Dobra e printa
?>

2. Comentários de várias linhas: /* */

Para explicações longas, usamos o bloco de comentário:

<?php 
  /* Script que pega um numero
   * e exibe seu dobro.
   * Autor: PHP Progressivo
  */
  $num = $_GET['num'];
  echo "Numero dobrado : ", 2*$num; 
?>

Cálculo de Área e Perímetro

As fórmulas para o cálculo do perímetro e área de uma circunferência são fundamentais na geometria:

Perímetro de uma circunferência em PHP

Veja como implementamos isso em PHP, recebendo o raio do usuário:

<html>
 <head>
  <title>Curso PHP Progressivo</title>
 </head>
 <body>
   <form action='home.php' method="get">
     Raio: <input type="text" name="num"><br>
     <input type="submit">
   </form>
 
   <?php 
     // Pegando o valor digitado pelo usuário
     $raio = $_GET['num'];
      
     // Imprime o raio
     echo "Raio: $raio<br />";
      
     // Exibe perímetro (2 * PI * Raio)
     echo "Perímetro: ", 2*M_PI*$raio, "<br />";
      
     // Exibe Área (PI * Raio²)
     echo "Área: ", M_PI*$raio*$raio, "<br />";
   ?>
 </body>
</html>

💡 Dica:

O uso de comentários facilita muito a manutenção do código. No exemplo acima, usamos comentários simples para identificar cada etapa do cálculo.


Nenhum comentário:

Veja também: