PHP — As bases

Guia 02 / 4

Os essenciais de PHP

Um memorando explicado: para que serve cada elemento, como escrevê-lo e quando utilizá-lo.

Resultado esperado :

Escolher e utilizar os elementos essenciais para realizar esta etapa do blogue.

Leitura
0%

01 · Escrever os tratamentos essenciais

Retomar as noções de programação com a sintaxe PHP.

Etiquetas PHP, echo e interpolação

O servidor executa o código entre <?php e ?>. echo escreve na resposta; <?= … ?> é o seu atalho num modelo HTML.

<?php $titre = "Soupe"; ?>
<h1><?= htmlspecialchars($titre, ENT_QUOTES, "UTF-8") ?></h1>
A reter :

Num ficheiro exclusivamente PHP, omitir ?> evita espaços de saída acidentais.

Concatenação e comparação estrita

O ponto junta cadeias. === compara o tipo e o valor; !== serve nomeadamente para distinguir false de uma posição 0.

echo "Durée : " . 20 . " minutes";
var_dump(0 !== false); // true

if, foreach e sintaxe de modelo

if escolhe um ramo. foreach percorre as receitas. No HTML, : e endforeach tornam os blocos mais fáceis de identificar.

<?php foreach ($recettes as $recette): ?>
  <h2><?= h($recette["titre"]) ?></h2>
<?php endforeach; ?>
A reter :

Este excerto pressupõe a função h definida em includes/functions.php.

require, return e __DIR__

require carrega um ficheiro necessário e interrompe o script se faltar. __DIR__ dá a pasta do ficheiro atual. Um ficheiro de dados pode devolver uma tabela com return.

$recettes = require __DIR__ . '/../includes/recettes.php';
A reter :

A partir de public/index.php, ../ sobe para mini-blog/. Nenhum caminho de ficheiro deve provir diretamente da introdução do utilizador.

array_filter e use

array_filter conserva os elementos para os quais a função devolve true. use torna disponível uma variável exterior numa função anónima.

$recettes = array_filter($recettes, function (array $recette) use ($q): bool {
    return mb_stripos($recette['titre'], $q, 0, 'UTF-8') !== false;
});
A reter :

mb_stripos pode devolver 0 se a palavra estiver no início: comparar estritamente com false.

02 · Verificar as entradas e apresentar as saídas

Os controlos HTML ajudam o utilizador; o servidor aplica as regras.

??, is_string e trim

?? fornece um valor por omissão se uma chave faltar ou valer null. is_string rejeita formas inesperadas como titre[]. trim remove os espaços nas extremidades.

$valeur = $_POST['titre'] ?? '';
$titre = is_string($valeur) ? trim($valeur) : '';
A reter :

A função texte dos exemplos completos agrupa estas operações.

filter_var e inteiro limitado

FILTER_VALIDATE_INT verifica que um dado representa um inteiro. Os limites traduzem a regra de negócio; false indica a falha.

$duree = filter_var('20', FILTER_VALIDATE_INT, [
    'options' => ['min_range' => 1, 'max_range' => 1440],
]);
if ($duree === false) { echo 'Durée invalide'; }

mb_strlen para o comprimento do título

mb_strlen conta os carateres de uma cadeia UTF-8 em vez dos bytes. A oficina aceita entre 3 e 120 carateres.

if (mb_strlen($titre, 'UTF-8') < 3 || mb_strlen($titre, 'UTF-8') > 120) {
    $erreurs[] = 'Le titre doit contenir entre 3 et 120 caractères.';
}
A reter :

A extensão mbstring é necessária. Um acento pode ocupar vários bytes sem ser vários carateres.

htmlspecialchars e função h

A função h centraliza o escape para os contextos de texto HTML e de atributo HTML entre aspas. Conserva-se o texto bruto nos dados.

function h(string $valeur): string
{
    return htmlspecialchars($valeur, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
A reter :

Esta função não é um escape universal para JavaScript, CSS ou um URL arbitrário.

explode e listas HTML

explode separa uma cadeia segundo um delimitador. Os ingredientes e passos utilizam uma linha por elemento para manter um modelo simples e compatível com o futuro SQL.

<?php foreach (explode("\n", $recette["ingredients"]) as $ligne): ?>
  <li><?= h($ligne) ?></li>
<?php endforeach; ?>

Comandos de trabalho local

Executar a partir de mini-blog/. -l verifica a sintaxe de um ficheiro; -S lança um servidor de desenvolvimento; -t limita a sua raiz pública.

php -v
php -m
php -l public/index.php
php -S 127.0.0.1:8000 -t public
A reter :

Abrir http://127.0.0.1:8000/index.php. O servidor integrado serve para o desenvolvimento local.