[Tuto] Installer Yourls, un système d'URL raccourcies

Il existe sur le net plusieurs solutions pour obtenir des URL raccourcies (liens courts) comme par exemple bit.ly. Cela peut s'avérer très pratique lorsque l'on a une URL à rallonge à partager. Ces services sont généralement utilisés pour des besoins ponctuels et les URL raccourcies ont souvent une durée de validité. Si vous êtes blogueur, il se peut qu'un tel service vous soit insuffisant. Et c'était mon cas. J'ai donc décidé de me tourner vers une solution hébergée sur mon serveur et dont j'aurais la maîtrise. Rien ne vaut l'indépendance !! 😀 Après quelques recherches sur Internet, j'ai choisi la solution open source YOURLS qui présente les avantages suivants :

  • Solution open source, donc pas d'investissement (mis à part quelques minutes pour la mise en place et un serveur web)
  • URL raccourcies créées automatiquement ou bien personnalisées
  • Fonction de partage rapide sur Twitter et Facebook
  • Tableau de bord permettant de voir les liens courts et leurs statistiques d'utilisation
  • Installation rapide
  • Existence de plugins et d'une barre d'outils

Je vais donc vous livrer ici la méthode pour installer, configurer et utilisez YOURLS.

YOURLS est une solution d'URL raccourcies

 

Mise en place de YOURLS

Téléchargement de YOURLS

J'ai pour ma part installé YOURLS sur un serveur Debian 8 (Jessie), avec Apache2 et PHP 7.0. C'est sur une installation identique que s'appuie ce tutoriel. Si vous utilisez une autre distribution, vous aurez donc besoin d'adapter un peu les commandes qui vont suivre.

Pour commencer, il vous faudra télécharger YOURLS depuis Github. Trois solutions s'offrent à vous :

  • Utiliser wget pour télécharger les fichiers en ligne de commande sur votre serveur (placez vous dans le dossier de destination de YOURLS)

wget https://github.com/YOURLS/YOURLS/archive/1.7.1.tar.gz

tar -xvzf 1.7.1.tar.gz

  • Cloner le répertoire source avec Git (placez vous dans le dossier de destination de YOURLS) :

git clone https://github.com/yourls/yourls.git

  • Télécharger l'archive sur votre PC, puis l'extraire et envoyer les fichiers sur votre serveur (l'archive est disponible ici)

 

Installation de YOURLS

Avant d'entamer la procédure d'installation, sachez que YOURLS a besoin d'une base de données pour fonctionner. Vous devez donc en créer une, manuellement ou via le panel de votre hébergeur.

Maintenant que vous avez téléchargé YOURLS, on va pouvoir l'installer. Mais avant toute chose, il va falloir créer le fichier de configuration config.php. Pour ce faire, on ne va pas partir de rien, on va recopier le fichier exemple disponible dans le dossier user. Placez-vous donc dans le dossier yourls et procédez comme suit :

cp user/config-sample.php user/config.php

Ensuite, il va falloir renseigner un peu ce fichier de configuration. Ouvrez-le avec votre éditeur de texte préféré (vi, vim, nano...). Perso, je vais utiliser nano.

nano user/config.php

Remplissez maintenant tous les champs nécessaires. À minima, il vous faudra indiquer : 

  • le nom d'utilisateur de la base de données
  • le mot de passe pour accéder à la base de données
  • le nom de la base de données
  • le hostname du serveur de base de données (si différent du serveur où se situe YOURLS)
  • l'adresse de votre installation YOURLS (dans notre exemple, on utilisera http://murl.fr/)
  • une passphrase pour l'encodage des cookies
  • un nom d'utilisateur et un mot de passe pour accéder à YOURLS

Une fois que c'est fait, enregistrez les changements et quittez l'éditeur de texte.

Ouvrez maintenant un navigateur et accédez à votre serveur web, comme ci-dessous

http://murl.fr/admin

Sur la page qui s'affiche, cliquez sur le bouton install. Une fois l'installation terminée, vous arrivez sur la page de login de YOURLS. Renseignez le nom d'utilisateur et le mot de passe que vous avez définis précédemment (dans le fichier de config).

Lors de votre première connexion, il est fort probable que vous rencontriez le message ci-dessous

Un avertissement apparaît à la première connexion ?

Pas de panique. Cela signifie simplement que votre fichier de configuration n'est pas modifiable et donc que YOURLS ne peut pas chiffrer votre mot de passe. Pour remédier à cela, il va falloir changer temporairement les droits sur votre fichier de config. Vous pouvez le faire de plusieurs manières, par exemple avec un client FTP, ou bien en saisissant la ligne de commande ci-dessous, depuis la racine du site, dans un terminal :

chmod 666 user/config.php

Déconnectez-vous de YOURLS et reconnectez vous. Le message a disparu : votre mot de passe a été chiffré par YOURLS. Pensez aussitôt à remettre des droits corrects sur le fichier :

chmod 644 user/config.php

Vous voilà maintenant avec votre installation de YOURLS opérationnelle. Pour finir, voyons rapidement le fonctionnement de la solution.

 

Gestion des URL raccourcies avec YOURLS

Une fois connecté, vous accédez au tableau de bord de YOURLS.

L'interface d'administration des URL raccourcies

En haut à gauche se situe le menu de navigation. Celui-ci est très succinct, il permet de se déconnecter, de revenir sur l'accueil de l'interface d'administration, d'accéder à une sorte de guide et de gérer les plugins. Car oui, il existe quelques plugins pour YOURLS.

En dessous, une zone est réservée à la création rapide de liens raccourcis. Saisissez l'adresse de destination et éventuellement le lien raccourci souhaité et cliquez sur le bouton Shorten The URL.

Créer facilement et rapidement vos URL raccourcies

Et en dessous, se trouve un tableau avec l'ensemble de vos liens raccourcis. C'est à partir de ce tableau que vous allez pouvoir gérer vos liens raccourcis : les modifier, les partager et accéder à leurs statistiques.

Détails et gestion de vos URL raccourcies

Bon ici l'installation est vierge donc je ne peux pas vous montrer ce que donnent les stats.

 

Et voilà. Rapide à mettre en place, facile à utiliser, si vous cherchez une solution pour créer vos propres liens raccourcis, je ne peux que vous recommander YOURLS.

 

Sandstorm

Sandstorm

Ingénieur Systèmes passionné d'informatique et de High-Tech, Sandstorm a créé JusteGeek.fr en 2013. Il aime les geekeries en tout genre.

Vous aimerez aussi...

13 réponses

  1. Ozh dit :

    Excellente solution effectivement pour raccourcir ses URL avec un domaine cool qui vous ressemble, tout en restant complètement propriétaire de ses données. Et puis c'est fun. 🙂

    Pour un exemple de stats, suffit de voir sur le site officiel, par exemple http://yourls.org/dl+

  2. nathann dit :

    bonsoir, j'ai une petit question, je suis dans l'obligation de changer de domain mon YOURLS, une solution pour changer tous les liens avec la nouvel adresse ?

    ex: ABC.fr/liens
    ABC.com/liens

    cordialement

    • Sandstorm Sandstorm dit :

      Salut Nathann !
      Pourquoi changer de domaine ?
      Si tu ne veux pas perdre le bénéfice des liens déjà distribués, tu vas devoir faire des redirections de ton ancien domaine vers le nouveau.
      Bref, ça c'était hors sujet, passons à ta question. YOURLS utilise une base de données. Je n'ai jamais fais ce genre de migration, mais je pense qu'à ta place, j'essaierai :
      1- faire un backup de ton installation YOURLS existante (fichiers + base de données)
      2- installer YOULRS (fait une nouvelle installation pour le nouveau domaine, avec une nouvelle base de données).
      3- importer le contenu de ton ancienne base de données dans la nouvelle.
      4- rechercher éventuellement dans la base de donner ton ancien domaine, et le remplacer par le nouveau.
      5- Tester !
      Tient moi au courant, ça m'intéresse 🙂
      ++

  3. max dit :

    Bonjour,
    Désolé de déterrer votre tuto, mais, je l'ai suivi à la lettre, et quand je veux accéder à yourls, j'ai un message "site not found".

    J'ai pourtant bien activé le vhost dans apache, et redémarré Apache, mais, sans amélioration.

    Voici le contenu de mon vhost
    # Provide an alias to YOURLS
    Alias /yourls /var/www/yourls

    ServerName
    DocumentRoot /var/www/yourls
    DirectoryIndex index.php

    AllowOverride All
    Order Deny,Allow
    Allow from all

    Auriez vous une idée, à tout hasard,
    Cordialement,

    • Sandstorm Sandstorm dit :

      Bonjour,
      Tu utilises apache2 ?
      Pourquoi ton serveur name est vide ?
      Essai avec un vhost de ce type :


      DocumentRoot /var/www/yourls
      ServerName www.tondomaine.fr
      ServerAlias tondomaine.fr


      Options Indexes FollowSymlinks
      AllowOverride All
      Order allow,deny
      allow from all

      • max dit :

        Salut,

        Il y a du mieux, mais c'est pas encore cela.J'ai une erreur:

        "YOURLS requires the mysql, mysqli or pdo_mysql PHP extension. No extension found. Check your server config, or contact your host."
        A savoir que l'installation de PHP est php7 et mysql est mysql5.7

  4. max dit :

    Et comment je fais pour activer PHP7?

    • Sandstorm Sandstorm dit :

      Tu as dis avoir php7. Il faut que tu installes et active le module php7.0-mysql. Si tu es sur un serveur dédié c'est à toi de faire une installation via une commande de type : apt-get install php7.0-mysql (si tout serveur est une base debian). Si tu es sur un hébergement mutualisé, vois avec ton hébergeur.

  5. max dit :

    Salut,

    Effectivement avec le paquet manquant, ça fonctionne mieux 😉

    J'ai déjà url raccourci qui s'affichent.

    mais quand je clic dessus, j'ai l'erreur "Not found".
    exemple pour http:///ozh.
    As tu eu le problème?

  6. max dit :

    Re salut,

    Je voulais écrire:
    http://mon-ndd.fr/ozh

    Mon-ndd est bien sur remplacé par mon nom de domaine

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.