Bem-vindo à sua primeira aula prática de PHP! Agora que você já sabe o que é PHP e como configurar seu ambiente, é hora de escrever seu primeiro script. PHP é uma linguagem de script do lado do servidor, o que significa que o código é executado no servidor e o resultado (geralmente HTML) é enviado ao navegador. Nesta aula, vamos explorar os fundamentos: como abrir e fechar blocos de código PHP, como misturar PHP com HTML, as principais funções de saída e como documentar seu código com comentários.

Esses conceitos são a base de qualquer aplicação PHP. Dominá-los desde o início evitará erros comuns e facilitará o aprendizado de tópicos mais avançados. Vamos começar!

Tags

O código PHP deve ser inserido dentro de tags especiais que indicam ao interpretador onde começa e termina o código PHP. A tag de abertura é <?php e a de fechamento é ?>. Tudo que estiver fora dessas tags será tratado como HTML puro e enviado diretamente ao navegador.

Exemplo básico:

<?php
    echo "Olá, mundo!";
?>

Quando o servidor processa esse arquivo, ele executa o código entre as tags e envia o resultado "Olá, mundo!" para o navegador. É importante notar que a tag de fechamento é opcional no final do arquivo, especialmente se o arquivo contiver apenas código PHP. Deixá-la de fora evita o envio acidental de espaços ou linhas em branco após o fechamento, o que pode causar problemas com headers HTTP.

Misturando PHP e HTML

Uma das grandes vantagens do PHP é a capacidade de se misturar diretamente com HTML. Você pode alternar entre HTML e PHP quantas vezes quiser. Isso é útil para gerar conteúdo dinâmico dentro de uma página estática.

Exemplo:

<!DOCTYPE html>
<html>
<head>
    <title>Meu Site</title>
</head>
<body>
    <h1><?php echo "Bem-vindo!"; ?></h1>
    <p>Hoje é <?php echo date('d/m/Y'); ?>.</p>
</body>
</html>

Neste exemplo, o PHP é usado para inserir uma saudação e a data atual dentro do HTML. O navegador recebe o HTML completo com esses valores já preenchidos. Essa flexibilidade permite criar páginas dinâmicas com facilidade.

Dica importante: embora seja possível misturar PHP e HTML livremente, para projetos maiores é recomendável separar a lógica PHP da apresentação HTML usando templates ou frameworks, mas isso é assunto para outra aula.

echo e print

Ambos echo e print são construções da linguagem usadas para enviar dados para a saída (geralmente o navegador). Eles são muito semelhantes, mas com algumas diferenças sutis.

echo é ligeiramente mais rápido e pode receber múltiplos argumentos separados por vírgula. Não tem valor de retorno. Exemplo:

<?php
    echo "Olá", " ", "mundo!"; // imprime "Olá mundo!"
?>

print aceita apenas um argumento e sempre retorna 1, podendo ser usado em expressões. Exemplo:

<?php
    if (print("Olá")) {
        // print retorna 1, então esta condição é verdadeira
    }
?>

Na prática, a maioria dos desenvolvedores prefere echo por ser mais flexível e rápido. Ambos podem ser usados com ou sem parênteses, pois são construções da linguagem, não funções. Exemplo: echo "texto"; é equivalente a echo("texto");.

Comentários

Comentários são partes do código que são ignoradas pelo interpretador. Eles são essenciais para documentar o código, explicar decisões ou temporariamente desabilitar partes do código. PHP suporta três tipos de comentários:

  • Comentário de linha única: usa // ou #. Tudo após esses símbolos até o final da linha é ignorado.
  • Comentário de múltiplas linhas: usa /* ... */. Tudo entre os delimitadores é ignorado.
  • Comentário de documentação (PHPDoc): usa /** ... */. É usado para gerar documentação automática e é uma boa prática para classes e funções.

Exemplos:

<?php
    // Isso é um comentário de linha única
    echo "Olá"; // comentário no final da linha
    
    # Outro comentário de linha única
    
    /*
        Comentário de múltiplas linhas
        pode abranger várias linhas
    */
    
    /**
     * Comentário de documentação
     * @param string $nome Nome do usuário
     * @return string Saudação
     */
    function saudacao($nome) {
        return "Olá, $nome!";
    }
?>

Use comentários com moderação e de forma significativa. Código bem escrito deve ser autoexplicativo, mas comentários ajudam a esclarecer lógicas complexas ou decisões de design.

Boas práticas e observações finais

Ao escrever seu primeiro script PHP, lembre-se de:

  • Sempre salvar arquivos PHP com a extensão .php.
  • Testar seu código em um servidor local (como XAMPP, WAMP ou o servidor embutido do PHP) para ver os resultados.
  • Manter o código organizado e indentado para facilitar a leitura.
  • Evitar o fechamento da tag PHP no final do arquivo se ele contiver apenas código PHP, para prevenir problemas com espaços em branco.
  • Usar echo na maioria dos casos, a menos que precise do valor de retorno de print.

Exercícios

  1. Crie um script PHP que exiba "Meu primeiro script PHP!" usando echo.

    2. ✓ Resposta: 
    <?php
    echo "Meu primeiro script PHP!";
?>
  2. Escreva um arquivo PHP que misture HTML e PHP para exibir uma página com um título e a data atual.

    3. ✓ Resposta: 
    <!DOCTYPE html>
<html>
<head>
    <title>Minha Página</title>
</head>
<body>
    <h1><?php echo "Bem-vindo!"; ?></h1>
    <p>Hoje é <?php echo date('d/m/Y'); ?>.</p>
</body>
</html>
  3. Utilize print para exibir "PHP é divertido!" e explique por que você usaria print em vez de echo.

    4. ✓ Resposta: 
    <?php
    print "PHP é divertido!";
?>

    Usaríamos print se precisássemos do valor de retorno (1) em uma expressão, por exemplo, em uma condição if. Caso contrário, echo é mais rápido e flexível.

  4. Adicione comentários ao seguinte código explicando cada parte: <?php echo "Olá"; ?>

    5. ✓ Resposta: 
    <?php
    // A tag de abertura PHP
    // A função echo exibe a string "Olá"
    echo "Olá";
    // A tag de fechamento PHP (opcional aqui)
?>
  5. Crie um script que use echo com múltiplos argumentos para exibir seu nome e sua idade.

    6. ✓ Resposta: 
    <?php
    $nome = "João";
    $idade = 25;
    echo "Nome: ", $nome, ", Idade: ", $idade;
?>

Referências