Bora ajudar o programador a transformar café em código?

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

Neste tutorial de nossa apostila de PHP, vamos aprender como comentar códigos em PHP e resolver uma questão, sobre área e perímetro de uma circunferência.

Comentários de uma linha: //

Comentário é um...comentário. Não do tipo "olha que código bonito, que código bem feito, que código formoso", mas sobre o que o código PHP está fazendo.

Pode parecer bobagem agora, pois nossos scripts ainda são bem pequenos e triviais, mas a medida que você for se tornando profissional PHP, seus códigos terão dezenas, centenas e até milhares de linhas de código.

Podemos comentar uma linha de PHP de duas maneiras

<html>
 <head>
  <title>Curso PHP Progressivo</title>
 </head>
 <body>
 <form  action="home.php" method="get">
  Numero 1: <input type="text" name="num"><br>
  <input type="submit">
 </form>
 
 <?php 
  // Pega o valor do formulário
  $num = $_GET['num'];
  
  // Imprimindo o número fornecido
  echo "Numero digitado: $num <br />";
   
  echo "Numero dobrado : ", 2*$num; //Dobra e printa
 ?>
 </body>
</html>


Os dois primeiros comentários ('Pega o valor do formulário', e 'Imprimindo número fornecido' ) foram feitos na linha acima do código que ela explica, com: //

No último comentário, comentamos após o código.
Essas barras servem pra comentar uma linha.

Comentar várias linhas: /* */

É possível também comentar várias linhas ao mesmo tempo.
Tudo que estiver entre /* e */, vai ser ignorado pelo interpretador do PHP, pois é isso que ele faz, ignora os comentários.

Veja;

<html>
 <head>
  <title>Curso PHP Progressivo</title>
 </head>
 <body>
 <form action=home.php method="get">
  Numero 1: <input type="text" name="num"><br>
  <input type="submit">
 </form>
 
 <?php 
  /* Script que pega um numero
   * e exibe seu quadrado.
   * Auto: PHP Progressivo
  */
  $num = $_GET['num'];
  
  echo "Numero digitado: $num <br />";
  echo "Numero dobrado : ", 2*$num; 
 ?>
 </body>
</html>

Os comentários serem apenas para um propósito: facilitar a vida do programador.
Você vai ver como isso é importante daqui uns anos, quando precisar rever e entender novamente um código que fez agora. Se ele estiver comentando, vai facilitar muuuuito mais.

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:
Perímetro de uma circunferência em PHP
Nosso código fica assim, então:


<html>
 <head>
  <title>Curso PHP Progressivo</title>
 </head>
 <body>
 <form action='home.php' method="get">
  Numero 1: <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
  echo "Perímetro: ", 2*M_PI*$raio, "<br />";
  
  // Exibe Área
  echo "Área: ", M_PI*$raio*$raio, "<br />";
 ?>
 </body>
</html>

Veja também

O melhor PC para programar

O melhor celular para programar