DS & II

Capítulo 05 - Reunindo os Vingadores

Leitura de 4 min

🚀 Capítulo 05: Reunindo os Vingadores (Tema: Vingadores)

NOTE

Este capítulo utiliza a temática de Vingadores para explicar a inclusão de arquivos em PHP com include e require. Aprenda a dividir o seu projeto em vários arquivos menores!

1. 🎯 Objetivo da Aula

Compreender como organizar um projeto PHP dividindo o código em vários arquivos e como juntá-los usando os comandos include, require, include_once e require_once.

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

Para salvar o universo de uma grande ameaça, o diretor da S.H.I.E.L.D., Nick Fury, não pode contar apenas com um herói. Ele precisa reunir os Vingadores, que estão espalhados por diferentes lugares do mundo (e do espaço!). Cada herói tem o seu próprio arquivo de dados.

No PHP, quando o nosso projeto começa a crescer, colocar todo o código em um único arquivo gigantesco vira um caos (um “monólito” difícil de manter).

  • A boa prática diz que devemos separar o código em arquivos menores (ex: um arquivo para as funções de banco de dados, outro para o cabeçalho do site, etc.).
  • O desafio é usar os comandos certos para “chamar” esses arquivos para o arquivo principal!

🧠 Fundamentos: A Teoria Traduzida

🛡️ 1. include (Incluir):

Tenta carregar o arquivo. Se o arquivo não existir, o PHP dá um aviso (Warning), mas continua executando o resto do programa!

include "iron_man.php";
echo "O Homem de Ferro foi chamado!";

🚨 2. require (Requerer):

É mais rigoroso. Ele exige que o arquivo exista. Se o arquivo não for encontrado, o PHP dá um erro fatal (Fatal Error) e para o programa na hora!

require "banco_de_dados.php"; // Se falhar aqui, o site nem abre.

🔒 3. As versões _once (Uma vez):

Tanto o include_once quanto o require_once fazem a mesma coisa que os originais, mas com uma inteligência extra: eles garantem que o arquivo só seja carregado uma única vez. Se você tentar carregar de novo por engano, ele ignora.

4. 📖 Exemplo Guiado: O Arquivo de Cabeçalho

Imagine que você tem um arquivo chamado cabecalho.php com o seguinte código:

<?php
echo "<h1>🛡️ S.H.I.E.L.D. - Painel de Controle</h1>";
?>

No seu arquivo index.php, você pode chamá-lo assim:

<?php
include "cabecalho.php";
 
echo "<p>Bem-vindo, Agente Fury.</p>";
?>

5. 🛠️ Prática Obrigatória 1: Escolhendo o Comando

  1. Você está criando um arquivo PHP que precisa se conectar ao banco de dados. Sem essa conexão, nenhuma página do site funciona. Qual comando você deve usar para incluir o arquivo de conexão: include ou require? Por quê?

6. 🛠️ Prática Obrigatória 2: Evitando Duplicidade

  1. Para que servem as versões include_once e require_once em relação às versões comuns?

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

  1. Faça o Commit: No GitHub Desktop, digite a mensagem (ex: Finaliza Capítulo 05 PHP_Vingadores) 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_05_vingadores.md

💡 Checkpoint de Lógica

Use o require para arquivos vitais do sistema (configurações, conexões) e o include para partes visuais (templates, menus, rodapés) onde, se falhar, o site ainda pode tentar mostrar o resto do conteúdo.

10. 🔥 Desafio de Fixação

Pesquise o que acontece se você der um require em um arquivo que contém uma função com o mesmo nome de uma função que você já criou no arquivo atual.

🔑 Gabarito de Código/Fórmulas

Gabarito da Prática 1:

  1. Deve usar o require. Como a conexão é vital e o site não funciona sem ela, precisamos que o PHP pare a execução imediatamente caso o arquivo não seja encontrado, evitando que o site exiba erros estranhos ou páginas incompletas para o usuário. Gabarito da Prática 2:
  2. Servem para garantir que o arquivo seja carregado apenas uma vez na memória, mesmo que o programador digite o comando de inclusão mais de uma vez por engano no código. Isso evita erros de redeclaração de funções ou variáveis.

← Capitulo Anterior | Proximo Capitulo →

Visão de gráfico

Backlinks