Repetições com uma saída clara

Neste capítulo você vai repetir uma ação com foreach e for sem criar um laço sem fim.

Seu ponto de partida

Estude depois do capítulo 07. O exemplo deste capítulo é 08-repeticoes, no pacote que acompanha o volume. Copie a pasta inicio para um diretório de prática e preserve o original. A raiz do exemplo é a referência concluída desta etapa. Sua cópia permite experimentar sem perder a referência.

Execute o PHP na raiz da sua cópia com php -S 127.0.0.1:8000 -t public. Abra http://127.0.0.1:8000/. Não abra PHP por duplo clique nem use o servidor de Python. Encerre com Ctrl+C antes de trocar de etapa.

Como praticar

Leia a explicação e digite ou confira o código indicado. Mude uma coisa. Antes de conferir, anote sua previsão. Salve, recarregue e compare. Se não acontecer o esperado, investigue o erro antes de avançar. Cada experiência parte dos valores da referência. Depois de conferir, desfaça somente a mudança desse experimento antes de começar a próxima lição. Você pode parar depois de uma lição e retomar mais tarde.

Percorra os itens existentes

Foreach usa uma lista existente. Ele entrega um item por vez à variável escolhida. Essa variável vale para a passagem atual, e não representa a lista inteira.

A referência organiza sessões fictícias e cria um li por sessão. A lista HTML permanece completa, com abertura e fechamento de ul fora da repetição. Uma lista vazia produz zero itens: a página precisa explicar esse estado.

Faça no seu exemplo

Em public/index.php, localize o bloco indicado. A referência completa acompanha esta etapa.

$sessoes = ["Primeiros passos", "Perguntas", "Prática"];
foreach ($sessoes as $sessao) {
    // Um item será mostrado por passagem.
}

Mude uma coisa e preveja

Acrescente somente “Revisão” ao fim do array.

Anote o que você acha que vai acontecer antes de salvar e recarregar.

Recarregue e confira

A lista passa de três para quatro itens.

Se não acontecer

Se aparecer Array, confira se a saída usa sessao, singular, em vez de sessoes.

Repita uma quantidade conhecida

For reúne início, condição e avanço. Nesta prática o contador começa em 1, continua enquanto for <= 3 e cresce com ++. Cada passagem cria um número de rodada.

O avanço é necessário para a condição ficar falsa. Não retire o incremento para experimentar: isso pode prender o pedido. Vamos alterar somente o limite, mantendo uma repetição curta.

Faça no seu exemplo

Em public/index.php, localize o bloco indicado. A referência completa acompanha esta etapa.

for ($rodada = 1; $rodada <= 3; $rodada++) {
    echo "<li>Rodada " . $rodada . "</li>";
}

Mude uma coisa e preveja

Troque somente o limite 3 por 4.

Anote o que você acha que vai acontecer antes de salvar e recarregar.

Recarregue e confira

A segunda lista mostra quatro rodadas.

Se não acontecer

Se mostrar zero rodadas, confira a condição e o valor inicial. Restaure a linha inteira antes de tentar outra mudança.

Mostre o estado vazio

Uma lista pode estar vazia sem representar erro. Compare o array com [] antes de mostrar uma lista. A mensagem Não há sessões comunica o resultado ao aluno.

O exemplo mantém a lista de rodadas independente. Esvaziar sessões não altera o for, porque ele usa seu próprio limite. Saber qual dado controla cada trecho evita mudanças feitas por tentativa.

Faça no seu exemplo

Em public/index.php, localize o bloco indicado. A referência completa acompanha esta etapa.

if ($sessoes === []) {
    echo "<p>Não há sessões.</p>";
}

Mude uma coisa e preveja

Troque somente o array de sessões por [].

Anote o que você acha que vai acontecer antes de salvar e recarregar.

Recarregue e confira

A primeira área informa Não há sessões; as rodadas continuam.

Se não acontecer

Se ainda houver uma lista vazia sem explicação, confira o if fornecido. Não esconda o estado vazio com CSS.

A captura mostra um trecho da referência concluída. Abra e percorra o exemplo para conferir o restante. Experimentos temporários podem produzir outra aparência; restaure os valores indicados antes de comparar.

Atividades para fazer antes das respostas

Use uma nova cópia do exemplo. Tente aplicar o que aprendeu antes de consultar os comentários.

1. Crie duas sessões fictícias.

2. Faça o for mostrar duas rodadas.

3. Explique qual laço combina melhor com uma lista de nomes.

Respostas comentadas

Compare sua explicação e o que realmente aconteceu. Outra solução pode funcionar se cumprir o objetivo e preservar o acesso ao conteúdo.

1. Use dois textos dentro do array. Foreach cria dois itens.

2. Mantenha início 1 e incremento; troque o limite para 2.

3. Foreach, pois percorre os valores existentes sem calcular índices.

Quando seguir

Você altera a lista e o limite sem perder a saída ou criar repetição infinita. Se ainda precisa de ajuda, repita a experiência pequena antes de avançar.

O arquivo completo

Referência do exemplo 08-repeticoes, reproduzida aqui para que você possa conferir sem sair da página.

public/index.php

<?php
declare(strict_types=1);
$sessoes = ["Primeiros passos", "Perguntas", "Prática"];
?>
<!doctype html>
<html lang="pt-BR">
<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
<title>Livro de visitas de prática</title><link rel="stylesheet" href="estilos.css"></head>
<body><a class="pular" href="#conteudo">Pular para o conteúdo</a>
<header><p>Prática de PHP em pequenos passos</p><h1>Livro de visitas</h1>
<p>Conteúdo fictício. Somente neste computador.</p></header>
<main id="conteudo" tabindex="-1">
<h2>Sessões fictícias</h2><?php if ($sessoes === []): ?><p>Não há sessões.</p><?php else: ?><ul><?php foreach ($sessoes as $sessao): ?><li><?= $sessao ?></li><?php endforeach; ?></ul><?php endif; ?><h2>Rodadas de prática</h2><ol><?php for ($rodada = 1; $rodada <= 3; $rodada++): ?><li>Rodada <?= $rodada ?></li><?php endfor; ?></ol>
</main><footer><p>Servidor de estudo em 127.0.0.1. Encerre com Ctrl+C.</p></footer></body></html>

public/estilos.css

* { box-sizing: border-box; }
body { margin: 0; background: #f4f7fb; color: #203246;
  font: 1.05rem/1.65 Arial, sans-serif; }
header, main, footer { max-width: 48rem; margin-inline: auto; padding: 1.5rem; }
header { padding-top: 2.5rem; }
h1 { font-size: clamp(1.8rem, 5vw, 2.7rem); line-height: 1.2; }
main { background: #fff; border-radius: .8rem; }
article { border-top: 1px solid #cad4df; padding-block: 1rem; }
a { color: #124e77; text-underline-offset: .2em; }
nav { display: flex; flex-wrap: wrap; gap: 1rem; }
label { display: block; font-weight: bold; }
input:not([type=hidden]), textarea { width: 100%; max-width: 34rem;
  border: 2px solid #718095; border-radius: .35rem; padding: .7rem;
  font: inherit; color: inherit; background: #fff; }
button { font: inherit; background: #124e77; color: white;
  border: 0; border-radius: .35rem; padding: .75rem 1.2rem; cursor: pointer; }
button:hover { background: #103b59; }
.mensagem { white-space: pre-wrap; overflow-wrap: anywhere; }
.erros { color: #8b142c; }
.ok { color: #175c30; font-weight: bold; }
:focus-visible { outline: 3px solid #b04d00; outline-offset: 3px; }
.pular { position: absolute; left: -10000px; }
.pular:focus { position: static; display: block; padding: 1rem; background: white; }
@media (max-width: 35rem) { header,main,footer { padding: 1rem; } }