Capítulo 04 - Blocos de Lego

🚀 Capítulo 04: Blocos de Lego (Tema: Lego)

NOTE

Este capítulo utiliza a temática de Lego para explicar as Funções em PHP. Aprenda a criar blocos de código reutilizáveis!

---

1. 🎯 Objetivo da Aula

Compreender o conceito de Funções em PHP, aprendendo a criar funções personalizadas, passar parâmetros (peças) e retornar valores (o objeto montado).

2. 🏢 O Cenário Prático (Seu Desafio)

Imagine que você está construindo uma cidade de Lego. Para fazer dez casas, você não fabrica o plástico do zero para cada casa. Você cria um “manual de montagem” para uma casa e apenas repete o processo quantas vezes quiser, usando peças de cores diferentes!

Na programação, as funções são os nossos manuais de montagem.

• Em vez de escrever o mesmo código de cálculo $10$ vezes no programa, você escreve uma vez dentro de uma função e apenas “chama” ela quando precisar. Seu desafio é criar as suas próprias peças de Lego!

---

🧠 Fundamentos: A Teoria Traduzida

📜 1. Criando uma Função:

Para criar uma função em PHP, usamos a palavra-chave function, damos um nome e abrimos chaves {}.

function mandarAlerta() {
    echo "Alerta! Sistema invadido!\n";
}
 
// Para usar (chamar) a função:
mandarAlerta();

🧩 2. Passando Peças (Parâmetros):

As funções podem receber dados para trabalhar. Eles ficam dentro dos parênteses ().

function saudarHacker($nome) {
    echo "Olá, Agente " . $nome . "!\n";
}
 
saudarHacker("Neo"); // Imprime: Olá, Agente Neo!

📤 3. Devolvendo o Resultado (return):

A função pode processar algo e te devolver o resultado pronto usando a palavra return.

function somarPontos($ponto1, $ponto2) {
    return $ponto1 + $ponto2;
}
 
$total = somarPontos(10, 20); // $total guardará o valor 30

---

4. 📖 Exemplo Guiado: O Construtor de Carros

Vamos criar uma função que monta a descrição de um carro de Lego:

<?php
function montarCarro($cor, $tipo) {
    return "Um carro do tipo " . $tipo . " na cor " . $cor . " foi montado!";
}
 
$meuCarro = montarCarro("Vermelho", "Esportivo");
echo $meuCarro;
?>

---

5. 🛠️ Prática Obrigatória 1: Criando a Função

1. Escreva uma função chamada dobro que receba um número como parâmetro e retorne o valor dele multiplicado por $2$.

6. 🛠️ Prática Obrigatória 2: Usando a Função

1. Como você chamaria a função dobro criada acima passando o número $5$ e guardando o resultado em uma variável chamada $resultado?

---

7. 📤 Instruções de Entrega (GitHub Desktop + Microsoft Teams)

1. Faça o Commit: No GitHub Desktop, digite a mensagem (ex: Finaliza Capítulo 04 PHP_Lego) e clique em Commit to main.
2. Envie para a Nuvem (Push): Clique em Push origin.

---

8. 📂 Estrutura de Pastas

spec_backend_com_php_e_laravel/
├── capitulos/
│   └── capitulo_04_lego.md

💡 Checkpoint de Lógica

As variáveis criadas dentro de uma função só existem lá dentro! Se você criar uma variável $x dentro de uma função, você não conseguirá ler o valor dela fora da função. Isso se chama Escopo.

10. 🔥 Desafio de Fixação

Pesquise como definir um valor padrão para um parâmetro de função em PHP (ex: se o usuário não passar a cor do Lego, ela ser “Azul” por padrão).

🔑 Gabarito de Código/Fórmulas

Gabarito da Prática 1:

function dobro($numero) {
    return $numero * 2;
}

Gabarito da Prática 2:

$resultado = dobro(5);

---

← Capitulo Anterior | Proximo Capitulo →