Guia 02 / 4
Os essenciais de PHP
Um memorando explicado: para que serve cada elemento, como escrevê-lo e quando utilizá-lo.
Escolher e utilizar os elementos essenciais para realizar esta etapa do blogue.
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.
Exemplo
<?php $titre = "Soupe"; ?>
<h1><?= htmlspecialchars($titre, ENT_QUOTES, "UTF-8") ?></h1>
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.
Exemplo
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.
Exemplo
<?php foreach ($recettes as $recette): ?>
<h2><?= h($recette["titre"]) ?></h2>
<?php endforeach; ?>
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.
Exemplo
$recettes = require __DIR__ . '/../includes/recettes.php';
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.
Exemplo
$recettes = array_filter($recettes, function (array $recette) use ($q): bool {
return mb_stripos($recette['titre'], $q, 0, 'UTF-8') !== false;
});
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.
Exemplo
$valeur = $_POST['titre'] ?? '';
$titre = is_string($valeur) ? trim($valeur) : '';
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.
Exemplo
$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.
Exemplo
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 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.
Exemplo
function h(string $valeur): string
{
return htmlspecialchars($valeur, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
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.
Exemplo
<?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.
Exemplo
php -v
php -m
php -l public/index.php
php -S 127.0.0.1:8000 -t public
Abrir http://127.0.0.1:8000/index.php. O servidor integrado serve para o desenvolvimento local.