Aller au contenu principal
Site en cours de refonte — quelques pages peuvent bouger ou évoluer.
01 décembre 2025

Installer PHP sur Ubuntu : guide complet, bonnes pratiques et premiers pas

Installez PHP sur Ubuntu : guide complet des méthodes, tests pratiques et création d'une mini-API pour débuter efficacement en développement web.

4 min de lecture
61 vues
réactions
Partager :
Installer PHP sur Ubuntu : guide complet, bonnes pratiques et premiers pas

PHP reste l’un des langages les plus utilisés pour le développement web. Que vous souhaitiez créer une API, un site dynamique ou travailler avec un framework moderne comme Laravel ou Symfony, vous aurez besoin d’un environnement PHP propre, à jour et facile à maintenir.

Dans cet article, nous allons voir comment installer PHP sur Ubuntu, de plusieurs façons, puis découvrir comment vérifier la configuration, créer un script de test, lancer un serveur local, et même développer une mini-API en quelques lignes.

Parfait pour débuter… ou repartir sur une base propre !

Choisir la meilleure méthode pour installer PHP

Sur Ubuntu, il existe plusieurs méthodes pour installer PHP. Chaque solution a ses avantages selon vos besoins.

Option 1 : Installation simple via APT (la méthode standard)

C’est la méthode la plus rapide pour installer PHP et ses extensions.

sudo apt update
sudo apt install php php-cli php-common php-mbstring php-xml php-curl php-zip php-intl

Une fois terminé, vérifiez la version :

php -v
  • Avantages : Simple et rapide = option recommandée pour les débutants

  • Inconvénients : Versions PHP parfois en retard par rapport aux dernières releases

Option 2 : Installer PHP via Homebrew sous Linux

Homebrew n’est pas réservé au Mac : il fonctionne aussi très bien sous Linux.

asdf plugin add php
  • Avantages : Version généralement plus récente que celle d’APT

  • Inconvénients : Gestion des packages centralisée

Option 3 : Installer plusieurs versions de PHP avec ASDF

Si vous travaillez sur plusieurs projets nécessitant différentes versions (7.4, 8.0, 8.2, 8.4…), ASDF est de loin la solution la plus propre.

Installer le plugin PHP

asdf plugin add php

Installer la version souhaitée

asdf install php 8.2.12 
asdf global php 8.2.12

Vous pouvez ensuite vérifier avec :

php -v
  • Avantages : Parfait pour les développeurs car gestion des versions en fonction des besoins.

  • Inconvénients : Configuration initiale un peu plus longue.

Tester votre installation : le premier script PHP

Créez un fichier :

nano bonjour.php

Ajoutez :

<?php 
echo "Bonjour depuis PHP !\n";

Exécutez :

php bonjour.php

Si tout est ok vous avez une page qui apparait avec le "Bonjour depuis PHP !". Si c'est le cas : Félicitations ! Votre installation fonctionne.

Démarrer un petit serveur local en PHP

PHP inclut un serveur HTTP minimaliste, c'est très pratique pour tester un site ou une API sans Apache ni Nginx.

Dans un dossier contenant un fichier index.php :

php -S localhost:8000

Puis ouvrez : http://localhost:8000

Exemple simple : créer une page PHP dynamique

Créez un fichier index.php :

<?php
$nom = htmlspecialchars($_GET['nom'] ?? 'visiteur');
?>
<!DOCTYPE html>
<html lang="fr">
    <head>
        <meta charset="UTF-8">    
        <title>Bienvenue</title>
    </head>
    <body>    
        <h1>Bonjour <?= $nom ?> !</h1>
    </body>
</html>

Puis ouvrez http://localhost:8000?nom=Alexandre

NB : htmlspecialchars() protège contre les attaques XSS.

Mini-API PHP : votre premier endpoint REST

Créez un fichier api.php :

<?php
header('Content-Type: application/json');
// Exemple de base de données dans un fichier JSON
$data = json_decode(file_get_contents('data.json'), true);
$id = $_GET['id'] ?? null;
if ($id) {
    foreach ($data as $item) {
        if ($item['id'] == $id) {
            echo json_encode($item);
            exit;
        }
    }
    echo json_encode(['error' => 'Aucun élément trouvé']);
} else {
    echo json_encode($data);
}

Et un fichier data.json :

[
    { "id": 1, "name": "Luke Skywalker" },
    { "id": 2, "name": "Dark Vador" }
]

Liste complète : http://localhost:8000/api.php

Rechercher un élément : http://localhost:8000/api.php?id=1

Vous venez de coder une API REST minimale, parfaite pour débuter.

Conclusion : quel est le meilleur choix ?

Le meilleur moyen d’installer PHP sur Ubuntu dépend de votre usage :

Profil

Méthode idéale

Débutant

APT

Développeur full-stack

Homebrew

Projets multiples / versions spécifiques

ASDF

Grâce à ce guide, vous disposez maintenant :

  • d’un environnement PHP complet sous Ubuntu

  • de plusieurs méthodes d’installation

  • d’un serveur local pour vos tests

  • de vos premiers scripts et d’une mini-API

Cet article vous a plu ?

Commentaires

Laisser un commentaire

Entre 10 et 2000 caractères

Les commentaires sont modérés avant publication.

Aucun commentaire pour le moment.

Soyez le premier à donner votre avis !