PHP for

O for ("para") é o laço de contar: de 1 até 10, de 10 até 1, de 5 em 5. Ele junta numa única linha as três coisas que todo contador precisa: onde começa, até onde vai e de quanto em quanto anda. Por isso é o laço preferido quando você sabe quantas vezes quer repetir.

Esta aula vem depois de while e do-while; se você já leu, vai perceber que o for é um while "organizado". Os exemplos rodam na pasta ~/site da Ana.

A ideia antes do código: as voltas na pista

A Ana decidiu correr 5 voltas na pista do parque. Antes de começar, ela já sabe três coisas:

1. Início: começa na volta 1.
2. Condição: continua enquanto a volta for no máximo 5.
3. Passo: a cada volta completada, soma 1 no contador.

Com essas três informações, qualquer pessoa sabe exatamente quantas vezes ela vai correr. O for pede essas mesmas três coisas, nessa ordem, separadas por ponto e vírgula.

Anatomia do for

<?php
for ($i = 1; $i <= 5; $i++) {
    echo "Volta número $i\n";
}
echo "Depois do laço, \$i vale $i\n";

for

"Para". Começa o laço.

$i = 1;

Início: cria o contador. Roda uma vez só, antes de tudo. O nome $i (de "índice") é uma tradição; pode ser $volta, $dia, o que fizer sentido.

$i <= 5;

Condição: testada antes de cada volta. Se for verdadeira, o corpo roda; se for falsa, o laço acaba.

$i++

Passo: roda depois de cada volta. $i++ soma 1 (veja Operadores de Atribuição). Repare: depois do passo não vai ponto e vírgula.

{ … }

O corpo, repetido a cada volta.

$ php contar.php
Volta número 1
Volta número 2
Volta número 3
Volta número 4
Volta número 5
Depois do laço, $i vale 6

A ordem exata das coisas

É aqui que muita gente se confunde, então vale seguir volta por volta:

Por isso, depois do laço, $i vale 6, e não 5: foi o 6 que fez a condição falhar. E, como if e laços não criam escopo em PHP, o $i continua existindo depois do laço (veja Escopo).

<?php
for ($i = 1; $i <= 5; $i++) {
    echo "Volta número $i\n";
}
echo "Depois do laço, \$i vale $i\n";

Contar de outros jeitos

Mudando o início, a condição e o passo, o mesmo for conta de qualquer jeito:

<?php
for ($i = 10; $i >= 1; $i--) {
    echo $i, " ";
}
echo "Feliz Ano Novo!\n";

for ($i = 0; $i <= 20; $i += 5) {
    echo $i, " ";
}
echo "\n";

for ($i = 2; $i <= 10; $i += 2) {
    echo $i, " ";
}
echo "\n";

$ php variacoes.php
10 9 8 7 6 5 4 3 2 1 Feliz Ano Novo!
0 5 10 15 20
2 4 6 8 10 

Quando conta para trás, tudo vira ao contrário: a condição usa >= e o passo diminui. Esquecer de inverter um dos dois é um erro clássico (veja Quando dá errado).

A tabuada

O contador não serve só para ser mostrado: ele pode entrar em contas. A tabuada do 7:

<?php
$numero = 7;

for ($i = 1; $i <= 10; $i++) {
    $resultado = $numero * $i;
    echo "$numero x $i = $resultado\n";
}

$ php tabuada.php
7 x 1 = 7
7 x 2 = 14
7 x 3 = 21
7 x 4 = 28
7 x 5 = 35
7 x 6 = 42
7 x 7 = 49
7 x 8 = 56
7 x 9 = 63
7 x 10 = 70

Para ter a tabuada de outro número, basta mudar $numero. E se você quiser várias tabuadas de uma vez?

Um for dentro de outro: a tabela de multiplicação

Colocando um laço dentro de outro, o de dentro roda inteiro a cada volta do de fora. É assim que se percorre uma tabela: o de fora anda pelas linhas, o de dentro pelas colunas.

<?php
for ($linha = 1; $linha <= 5; $linha++) {
    for ($coluna = 1; $coluna <= 5; $coluna++) {
        echo str_pad($linha * $coluna, 4, " ", STR_PAD_LEFT);
    }
    echo "\n";
}

for ($linha = 1; …)

O laço de fora: 5 voltas, uma por linha.

for ($coluna = 1; …)

O laço de dentro: a cada linha, 5 voltas, uma por coluna. No total, 5 × 5 = 25 contas. Os dois contadores precisam ter nomes diferentes.

str_pad(…, 4, " ", STR_PAD_LEFT)

Completa o número com espaços à esquerda até ter 4 caracteres, para as colunas ficarem alinhadas (veja Funções de String).

echo "\n";

Fica no laço de fora, depois do de dentro: pula a linha quando as 5 colunas terminam.

$ php tabela.php
   1   2   3   4   5
   2   4   6   8  10
   3   6   9  12  15
   4   8  12  16  20
   5  10  15  20  25

Na página web: as opções de 1 a 31

Um uso muito comum do for em sites: gerar listas de números para formulários. A Ana quer perguntar o dia do aniversário dos clientes com um <select>. Escrever 31 linhas de <option> à mão seria cansativo; o for escreve por ela. Dentro do HTML, use a forma alternativa for (…): … endfor; (a mesma ideia do endforeach, explicada em foreach):

<?php
$dia = isset($_GET["dia"]) ? (int) $_GET["dia"] : null;
?>
<!doctype html>
<html lang="pt-BR">
<head><meta charset="utf-8"><title>Aniversário</title></head>
<body>
<form method="get">
  <label>Dia do seu aniversário:
    <select name="dia">
<?php for ($d = 1; $d < 31; $d++): ?>
      <option value="<?= $d ?>"><?= $d ?></option>
<?php endfor; ?>
    </select>
  </label>
  <button>Enviar</button>
</form>
<?php if ($dia !== null): ?>
<p>Você faz aniversário no dia <?= $dia ?>.</p>
<?php endif; ?>
</body>
</html>

<?php
$dia = isset($_GET["dia"]) ? (int) $_GET["dia"] : null;
?>
<!doctype html>
<html lang="pt-BR">
<head><meta charset="utf-8"><title>Aniversário</title></head>
<body>
<form method="get">
  <label>Dia do seu aniversário:
    <select name="dia">
<?php for ($d = 1; $d <= 31; $d++): ?>
      <option value="<?= $d ?>"><?= $d ?></option>
<?php endfor; ?>
    </select>
  </label>
  <button>Enviar</button>
</form>
<?php if ($dia !== null): ?>
<p>Você faz aniversário no dia <?= $dia ?>.</p>
<?php endif; ?>
</body>
</html>

Com o servidor embutido, a Ana conferiu o HTML que o PHP gera (com ?dia=15 no endereço, como se o formulário tivesse sido enviado):

$ curl -s "localhost:8000/aniversario.php?dia=15" | head -14
<!doctype html>
<html lang="pt-BR">
<head><meta charset="utf-8"><title>Aniversário</title></head>
<body>
<form method="get">
  <label>Dia do seu aniversário:
    <select name="dia">
      <option value="1">1</option>
      <option value="2">2</option>
      <option value="3">3</option>
      <option value="4">4</option>
      <option value="5">5</option>
      <option value="6">6</option>
      <option value="7">7</option>
$ curl -s "localhost:8000/aniversario.php?dia=15" | tail -6
  </label>
  <button>Enviar</button>
</form>
<p>Você faz aniversário no dia 15.</p>
</body>
</html>

O mesmo truque serve para os meses (1 a 12), os anos (for ($a = 2026; $a >= 1920; $a--), do mais recente para o mais antigo) ou as quantidades de um produto no carrinho.

for com arrays

Como os índices de um array comum são 0, 1, 2…, um for pode percorrê-lo contando de 0 até o tamanho menos 1. O tamanho vem de count() ("contar"):

<?php
$compras = ["pão", "leite", "café"];

for ($i = 0; $i < count($compras); $i++) {
    echo "$i: $compras[$i]\n";
}

$ php array-for.php
0: pão
1: leite
2: café

Repare na condição: $i < count($compras), com menor, não "menor ou igual". O array tem 3 itens, mas o último índice é 2. Usar <= é o erro mais comum com for em arrays.

Detalhes do for

Mais de uma variável: vírgulas dentro das partes

Dentro de cada parte, você pode separar várias expressões com vírgula. Aqui, uma variável sobe enquanto a outra desce, até se cruzarem:

<?php
for ($i = 0, $j = 10; $i < $j; $i += 3, $j -= 3) {
    echo "i = $i, j = $j\n";
}

$ php virgulas2.php
i = 0, j = 10
i = 3, j = 7

Na terceira volta, $i seria 6 e $j seria 4: a condição 6 < 4 falha. As vírgulas separam expressões dentro de uma parte; os pontos e vírgulas separam as partes.

Partes vazias

As três partes são opcionais. for (; $i <= 5; ) é igual a um while ($i <= 5), e for (;;), sem nada, repete para sempre (como while (true)), dependendo de um break para sair (veja break e continue). Existem, mas deixam o código mais difícil de ler: se você precisa deles, provavelmente um while fica mais claro.

for × while

Todo for pode ser escrito como while. A mesma contagem de 1 a 5, nos dois:

<?php
// com for: as três partes juntas, numa linha
for ($i = 1; $i <= 5; $i++) {
    echo $i, " ";
}

// com while: as mesmas três partes, espalhadas
$i = 1;                 // início
while ($i <= 5) {       // condição
    echo $i, " ";
    $i++;               // passo
}

Os dois mostram 1 2 3 4 5. A diferença é organização: no for, quem lê vê de uma vez quantas voltas o laço dá. No while, o passo fica lá embaixo, e é fácil esquecê-lo (e criar um laço infinito).

Quando dá errado

<?php
$compras = ["pão", "leite", "café"];

for ($i = 0; $i <= count($compras); $i++) {
    echo "$i: $compras[$i]\n";
}

$ php fora-limite.php
0: pão
1: leite
2: café

Warning: Undefined array key 3 in /home/ana/site/fora-limite.php on line 5
3: 

<?php
for ($i = 1; $i <= 3; $i++);
{
    echo "Volta $i\n";
}

$ php pontovirgula.php
Volta 4

<?php
for ($i = 1, $i <= 3, $i++) {
    echo "Volta $i\n";
}

$ php virgulas.php

Parse error: syntax error, unexpected token ")", expecting ";" in /home/ana/site/virgulas.php on line 2

<?php
for ($i = 10; $i >= 1; $i++) {
    echo $i, "\n";
}

$ php errado.php | head -5
10
11
12
13
14                     « e continuaria para sempre: o head parou o programa na 5ª linha

Referência

Exercícios

Missão final

<?php
$numero = 9;

// escreva o for aqui

<?php
$numero = 9;

for ($i = 10; $i >= 1; $i--) {
    echo "$numero x $i = ", $numero * $i, "\n";
}

Resumo

• for (início; condição; passo): o início roda uma vez; a condição é testada antes de cada volta; o passo roda depois de cada volta.
• Para contar para trás, inverta a condição (>=) e o passo ($i--). Para pular, use $i += N.
• Laços dentro de laços percorrem tabelas; cada um com o seu contador.
• No HTML, for (…): … endfor; gera listas como as opções de 1 a 31 de um <select>.
• Em arrays, $i < count($a) (nunca <=); mas, para percorrer arrays, o foreach é melhor.
• for quando você sabe quantas vezes; while quando depende de uma condição; foreach para arrays.