• 8 heures
  • Moyenne

Ce cours est visible gratuitement en ligne.

course.header.alt.is_video

Ce cours existe en livre papier.

course.header.alt.is_certifying

J'ai tout compris !

Mis à jour le 30/09/2024

Au secours ! Mon script plante !

Alors comme ça, votre script ne marche pas ? Et PHP vous affiche des erreurs incompréhensibles ?

Pas de souci à vous faire, c'est tout à fait normal, on ne réussit jamais un script du premier coup… en tout cas, moi, jamais !

Des milliers de messages d'erreur différents peuvent survenir.

OK, jusque-là rien de très rassurant. Et je n'ai pas vraiment la possibilité de vous en dresser une liste complète… mais je peux vous présenter les erreurs les plus courantes, ce qui devrait résoudre la grande majorité de vos problèmes. 😅

Allons-y !

Préparez-vous à faire ces erreurs courantes

Je pense qu'il est facile de parler d'erreurs « courantes », car vous verrez que certaines erreurs reviennent plus souvent que d'autres.

Nous allons passer en revue les erreurs suivantes :

  1. "Parse error".

  2. "Undefined function".

  3. "Wrong parameter count".

"Parse error" = si vous formulez mal une instruction

Si on devait dire qu'il existe UNE erreur de base, ça serait très certainement celle-là. Impossible de programmer en PHP sans y avoir droit un jour.

Le message d'erreur que vous obtenez ressemble à celui-ci :

Parse error: syntax error in error.php on line 7

Ce message vous indique une erreur dans error .php à la ligne 7.

Capture d'écran qui montre la numérotation des lignes dans Sublime Text
Numérotation des lignes dans Visual Studio Code

Bon, mais concrètement, qu'est-ce qu'une parse error ?

Une "parse error" est en fait une instruction PHP mal formée. Il peut y avoir plusieurs causes :

Comme toutes les instructions doivent se terminer par un point-virgule, si vous oubliez d'en mettre un, ça provoquera une parse error. Par exemple :

$id_news = 5

… génèrera une parse error. Si vous mettez le point-virgule à la fin, tout rentrera dans l'ordre !

$id_news = 5;

Par exemple :

echo "Bonjour !;

Il suffit de fermer correctement les guillemets et vous n'aurez plus de problème :

echo "Bonjour !";
echo "J'ai " . $age " ans";

Une fois l'erreur corrigée, ça donne :

echo "J'ai " . $age . " ans";

Cela peut être le cas pour une structure en if  , par exemple.

Vérifiez que vous avez correctement fermé toutes vos accolades.

"Undefined function" = si vous utilisez une fonction non reconnue

Une autre erreur assez classique, c'est la fonction inconnue.

Vous obtenez ce message d'erreur :

Fatal Error: Call to undefined function: is_valid_recipe() in fichier.php on line 27

Là, il faut comprendre que vous avez utilisé une fonction qui n'existe pas.

Deux possibilités :

  1. Soit la fonction n'existe vraiment pas. Vous avez probablement fait une faute de frappe, vérifiez si une fonction à l'orthographe similaire existe.

  2. Soit la fonction existe vraiment, mais PHP ne la reconnaît pas. C'est parce que cette fonction se trouve dans une extension de PHP que vous n'avez pas activée. Par exemple, si vous essayez d'utiliser la fonction imagepng alors que vous n'avez pas activé la bibliothèque nécessaire pour les images en PHP, on vous dira que la fonction n'existe pas. Activez la bibliothèque qui utilise la fonction, et tout sera réglé.

"Wrong parameter count" = si vous entrez un nombre incorrect de paramètres pour une fonction

Si vous utilisez mal une fonction, vous aurez cette erreur :

Warning: Wrong parameter count for fonction() in fichier.php on line 112

Cela signifie que :

  • vous avez oublié des paramètres pour la fonction ;

  • ou même que vous en avez trop mis.

Par exemple, la fonction fopen requiert au minimum deux paramètres :

  1. Le premier pour le nom du fichier à ouvrir.

  2. Et le second pour le mode d'ouverture (en lecture seule, écriture, etc.).

Si vous ne mettez que le nom du fichier à ouvrir, comme ceci :

$fichier = fopen("fichier.txt");

… vous aurez l'erreur « Wrong parameter count ». Pensez donc à rajouter le paramètre qui manque, par exemple comme ceci :

$fichier = fopen("fichier.txt", "r");

Découvrez ces erreurs plus rares

Les erreurs PHP sont très variées. N'espérez donc pas que je vous fasse ici la liste des 3 946 erreurs de PHP, j'en serais incapable (je ne les ai pas encore toutes eues, mais ça ne saurait tarder, à l'allure à laquelle je vais).

Je vais vous montrer quelques erreurs un peu plus rares que « parse error », mais que vous rencontrerez probablement un jour. Si déjà je peux vous aider pour ces erreurs-là, ce sera bien.

Nous allons voir les erreurs :

  1. "Headers already sent by…".

  2. "L'image contient des erreurs".

  3. "Maximum execution time exceeded".

"Headers already sent by…" = si vous écrivez du code au mauvais endroit

Voilà une erreur classique quand on travaille avec les sessions ou avec les cookies :

Cannot modify header information - headers already sent by ...

Que doit-on comprendre par là ?

Elles permettent de dire :

"Ce que tu vas recevoir est une page HTML".

ou

"Ce que tu vas recevoir est une image PNG", ou encore "Inscris un cookie".

En PHP, la fonction qui permet d'envoyer des informations de "headers" s'appelle  header() 

. Il y a d'autres fonctions qui envoient des "headers" toutes seules. C'est le cas de :

  •  session_start() 

  •  setcookie()  

Un exemple de code qui génère l'erreur :

<html>
<?php session_start(); ?>

Ici, j'ai eu le malheur de mettre un peu de code HTML avant le session_start() et c'est ce qui a provoqué l'erreur.

Mettez le session_start() en tout premier, et vous n'aurez plus de problème :

<?php session_start(); ?>
<html>

"L'image contient des erreurs" = si vous avez fait une erreur d'utilisation de la librairie GD

Si vous avez fait une erreur dans votre code (par exemple une banale « parse error »), cette erreur sera inscrite dans l'image. Du coup, l'image ne sera pas valide et le navigateur ne pourra pas l'afficher.

Bon, d'accord, l'erreur est dans l'image. Mais comment faire pour faire « apparaître » l'erreur ?

Deux possibilités :

  • vous pouvez supprimer la ligne suivante dans votre code :

<?php header ("Content-type: image/png"); ?>

L'erreur apparaîtra à la place du message « L'image contient des erreurs » ;

  • vous pouvez aussi afficher le code source de l'image (comme si vous alliez regarder la source HTML de la page, sauf que là, il s'agit d'une image).

Dans les deux cas, vous verrez le message d'erreur apparaître. À partir de là, il ne vous restera plus qu'à corriger le bug !

"Maximum execution time exceeded" = si vous avez fait une boucle infinie

Ça, c'est le genre d'erreur qui arrive le plus souvent à cause d'une boucle infinie !

Fatal error: Maximum execution time exceeded in fichier.php on line 57

Imaginez que vous fassiez une boucle while mais que celle-ci ne s'arrête jamais : votre script PHP va tourner en boucle sans jamais s'arrêter.

Voici un exemple de boucle while qui ne s'arrêtera jamais :

<?php
$counter = 5;
while ($counter === 5)
{
    echo 'Zéro ';
}
?>

Comme vous pouvez le voir, un tel code PHP ne s'arrêtera jamais parce que $counter vaut toujours 5…

Rassurez-vous : la limite est fixée à 30 secondes, mais vous n'y serez jamais confronté. En général, un serveur met moins de 50 millisecondes à charger une page PHP. On est très loin des 30 secondes !

Déboguez votre premier script

Rien ne vaut la pratique pour mettre en application ce que vous venez d'apprendre ! Je vous propose donc de copier le code ci-dessous et de le corriger :

<?php
$users = [
    [
        'full_name' => 'Mickaël Andrieu',
        'email' => 'mickael.andrieu@exemple.com'
        'age' => 34,
    ],
    [
        'full_name' => 'Mathieu Nebra',
        'email' => 'mathieu.nebra@exemple.com',
        'age' => 34,
    ],
    [
        'full_name' => 'Laurène Castor',
        'email' => 'laurene.castor@exemple.com',
        'age' => 28,
    ],
];

$recipes = [
    [
        'title' => 'Cassoulet',
        'recipe' => 'Etape 1 : des flageolets !',
        'author' => 'mickael.andrieu@exemple.com',
        'is_enabled' => true,
    ],
    [
        'title' => 'Couscous',
        'recipe' => 'Etape 1 : de la semoule',
        'author' => 'mickael.andrieu@exemple.com',
        'is_enabled' => false,
    ],
    [
        'title' => 'Escalope milanaise',
        'recipe' => 'Etape 1 : prenez une belle escalope',
        'author' => 'mathieu.nebra@exemple.com',
        'is_enabled' => true,
    ],
    [
        'title' => 'Salade Romaine',
        'recipe' => 'Etape 1 : prenez une belle salade',
        'author' => 'lorene.castor@exemple.com',
        'is_enablad' => true,
    ],
];

function displayAuthor(string $authorEmail, array $users): string
    {
        //var_dump($authorEmail); die();
        foreach($users as $user) {
            if ($authorEmail === $user['email']) {
                return $user['full_name'] . '(' . $user['age'] . ' ans)';
            }
        }
    }
function isValidRecipe(array $recipe): bool
    {
        return $recipe['is_enabled'];
    }
function getRecipes(array $recipes) : array
    {
        $valid_recipes = [];
        foreach($recipes as $recipe) {
            if (isValidRecipe($recipe)) {
                $valid_recipes[] = $recipe;
            }
        }
    return $valid_recipes;
}
?>

<!DOCTYPE html>
<html lang="en">
<head>
    <title>Recettes de cuisine : Erreur(</title>
    <link
href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css"
rel="stylesheet"
>
</head>

<body>
    <div class="container">
        <h1>Liste des recettes de cuisine</h1>
        <?php foreach(getRecipes($recipes) as $recipe) : ?>
        <article>
            <h3><?php echo($recipe['title']); ?></h3>
            <div><?php echo($recipe['recipe']); ?></div>
            <i><?php echo(displayAuthor($recipe['author'], $users)); ?></i>
        </article>
        <?php endforeach ?>
    </div>
</body>
</html>

Alors, avez-vous fait des erreurs en corrigeant des erreurs ? 🤣

La première erreur affichée par PHP est la suivante :

Parse error: syntax error, unexpected single-quoted string "age", expecting "]" in index.php on line 7

Il y a donc une erreur à la ligne 7, ou autour... vous aurez peut être remarqué qu'il manque une virgule en ligne 6 juste après l'assignation de la propriété email :

<?php
// avant
[
    'title' => 'Salade Romaine',
    'recipe' => '',
    'author' => 'laurene.castor@exemple.com',
    'is_enablad' => true, // OUPS
]

// après
[
    'title' => 'Salade Romaine',
    'recipe' => '',
    'author' => 'laurene.castor@exemple.com',
    'is_enabled' => false,
]

La deuxième erreur est plus discrète puisque le site a l'air de s'afficher correctement sous vos yeux, mais il y a pourtant un message d'erreur sous le titre principal :

Warning: Undefined array key "is_enabled" in index.php on line 59

L'index ou la clé pour le tableau $recipe ne semblent pas définis (bug qui ne serait jamais arrivé si on avait utilisé la fonction array_key_exists, d'ailleurs ! 🤓

Il va nous falloir vérifier le tableau des recettes et compléter ou corriger :

<?php
// avant
[
    'title' => 'Salade Romaine',
    'recipe' => '',
    'author' => 'lorene.castor@exemple.com',
    'is_enablad' => true, // OUPS
]

// après
[
    'title' => 'Salade Romaine',
    'recipe' => '',
    'author' => 'lorene.castor@exemple.com',
    'is_enabled' => true,
]

Il y avait une toute petite coquille : is_enabled avait été remplacé par  is_enablad  .

La troisième erreur et dernière erreur est beaucoup plus bavarde :

Fatal error: Uncaught TypeError: displayAuthor(): Return value must be of type string, none returned in index.php:55 Stack trace: index.php(92): displayAuthor('lorene.castor@e...', Array) #1 {main} thrown in index.php

Cette fois, l'erreur provient du retour de la fonction displayAuthor qui doit retourner une chaîne de caractères (le nom de l'utilisateur) et retourne... rien (None).

Que s'est-il passé ?

<?php
function displayAuthor(string $authorEmail, array $users): string
{
    foreach ($users as $user) {
        if ($authorEmail === $user['email']) {
            return $user['full_name'] . '(' . $user['age'] . ' ans)';
        }
    }
}

Si l'on considère le code de la fonction, on peut noter que si l'e-mail est trouvé, alors le nom et l'âge de l'utilisateur sont retournés.

Mais si l'e-mail n'est pas trouvé ? 

Eh bien, il ne se passe rien car le cas n'a pas été prévu. Le plus simple est de retourner une chaîne de caractère même si l’email n’a pas été trouvé (“Auteur inconnu”) :

<?php
function displayAuthor(string $authorEmail, array $users): string
{
    foreach ($users as $user) {
        if ($authorEmail === $user['email']) {
            return $user['full_name'] . '(' . $user['age'] . ' ans)';
        }
    }
    return 'Auteur inconnu';
}

En résumé

  • Vous rencontrerez des bugs dans vos projets, c'est inéluctable.

  • Ne paniquez pas, lisez et essayez de comprendre le message d'erreur.

  • Vous pouvez aussi copier le message d'erreur et le rechercher sur Internet : il y a de fortes chances que d'autres personnes aient déjà rencontré ce problème. 

Nous approchons de la fin de cette partie du cours, mais avant, un dernier point important : nous allons voir comment faire pour organiser les pages de votre site en blocs fonctionnels.

Et si vous obteniez un diplôme OpenClassrooms ?
  • Formations jusqu’à 100 % financées
  • Date de début flexible
  • Projets professionnalisants
  • Mentorat individuel
Trouvez la formation et le financement faits pour vous
Exemple de certificat de réussite
Exemple de certificat de réussite