Manual:SQLite/fr

Le support SQLite de MediaWiki concerne la qualité depuis MediaWiki 1.17. Le support de SQLite fait partie de la base de code principale depuis la version 1.13 de MediaWiki. However, support for SQLite by extensions which make database changes is varied. Vous trouverez ci-dessous quelques notes sur l'installation de la bibliothèque SQLite dans votre environnement PHP.

Despite SQLite being production quality and mainstream support existing for it, there are two important caveats to using SQLite for MediaWiki. First, while many extensions do support SQLite, there are some popular extensions that still do not support it to this day. Second, SQLite does not scale beyond one server. In case your wiki may grow to have many concurrent users and a large amount of content, it would be better to use a database system that supports the primary-replica model such as MySQL. As a result, if your wiki may depend on using these extensions, or it may need to use a primary-replica database system, it is best to use a MySQL database for your wiki. The decision to use SQLite, MySQL, or another database system should ideally be made before you create your wiki, as it is difficult to convert from a SQLite database to a MySQL database once you have started using your wiki.

À propos de SQLite
SQLite est une bibliothèque de base de données à source ouvert mise dans le domaine public. A l'inverse des systèmes de gestion des bases de données client-serveur, la bibliothèque SQLite est liée à PHP et devient partie intégrante du processus serveur. MediaWiki utilise les fonctionnalités de SQLite au travers de simples appels de fonctions, ce qui réduit la latence pour l'accès à la base de données car les appels de fonctions sont plus efficaces que la communication inter-processus.

Le fait d'utiliser SQLite comme serveur de base de données pour Mediawiki a ses pour et ses contre :


 * Pour :


 * Vous n'avez pas à installer ni à maintenir un serveur de base de données séparé tel que MySQL; cela réduit de manière significative les efforts passés à l'administrer et supprime les points générateurs d'erreurs.
 * Le point précédent indique aussi que SQLite est bien plus adapté aux installations MediaWiki portables qui s'exécutent à partir d'une clé USB.
 * Sur les hôtes partagés, vous n'êtes pas contraint par les limites artificielles de la base de données.
 * La base de données toute entière est rangée comme un fichier unique inter plateformes facilitant ainsi les sauvegardes et la migration.


 * Contre :


 * SQLite n'est pas trop redimmensionnable donc si vous avez un gros wiki populaire, vous devriez utiliser MySQL.
 * Bien que SQLite ait son propre moteur de recherche, il n'est pas pris en charge par les solutions plus avancées telles que Lucene.
 * Certaines extensions sont connues pour avoir des problèmes lors de la mise à jour de la base de données ou de l'installation avec : AbuseFilter, Echo, Flow, et LiquidThreads.

Installation de SQLite
Au minimum vous avez besoin de la version 3.8.0 de SQLite. Aussi, pour pouvoir utiliser la recherche plein texte, SQLite doit être compilé avec le module FTS3 activé (aujourd'hui la plupart des compilations le gèrent séparément). SQLite3 fonctionne en utilisant les fonctions PDO de PHP.


 * Pour installer SQLite3 sur un système basé sur Debian ou Ubuntu, utilisez.
 * Les binaires Windows de php.net sont OK.
 * Le module PHP PDO SQLite doit être chargé. Vous devez décommenter la ligne suivante du fichier
 * Où mettre la base de données SQLite elle-même ? Le chemin par défaut semble être $IP/../data/$dbname.sqlite . Tout ce qui se trouve à l'extérieur de la racine web doit être sécurisé; néanmoins, il est bien de l'avoir à proximité. Ou si le fonctionnement est similaire, vous pouvez placer ce contenu quelque part dans la racine web et vérifier en configurant le serveur web, que l'accès y est interdit.
 * Où mettre la base de données SQLite elle-même ? Le chemin par défaut semble être $IP/../data/$dbname.sqlite . Tout ce qui se trouve à l'extérieur de la racine web doit être sécurisé; néanmoins, il est bien de l'avoir à proximité. Ou si le fonctionnement est similaire, vous pouvez placer ce contenu quelque part dans la racine web et vérifier en configurant le serveur web, que l'accès y est interdit.

Installer MediaWiki sur le serveur SQLite

 * Si le module SQLite de PHP est correctement installé, l'installeur de MediaWiki devrait vous présenter une option pour utiliser SQLite. Dans les versions MediaWiki antérieures à la 1.16, vous deviez entrer quelque chose dans les champs du nom d'utilisateur de la base de données et du mot de passe de la base de données pour que l'installeur puisse continuer même si SQLite n'en avait pas besoin.
 * Si vous ne mettez rien dans le champ « répertoire des données de SQLite », votre restera vide, ce qui correspond au répertoire   du parent de la racine du document, néanmoins ce répertoire peut être différent pour les scripts web et les scripts de maintenance exécutés depuis la ligne de commande, il est donc préférable de l'initialiser explicitement.

Moteur de recherche
Les possibilités de recherche pour le serveur SQLite ont été introduites dans MediaWiki 1.16. Elles nécessitent SQLite avec le module FTS3 compilé, qui est habituellement présent dans la plupart des compilations modernes. They require SQLite with FTS3 module compiled-in, which is usually present in most modern builds. Si vous venez de faire la mise à jour de SQLite avec une version qui contient FTS3, exécutez le script de mise à jour comme si vous faisiez la mise à jour de MediaWiki. Après que le script de mise à jour a créé la table d'index de recherche, remplissez-la avec. La même chose se passe si on revient à un environment sans FTS3: la réexécution du script de mise à jour va dégrader la table pour éviter les erreurs SQL.

Impossible d'accéder à la base de données à partir du terminal
Pour obtenir l'accès aux commandes de la base de données en mode ligne, entrez dans le terminal :

sqlite3 /var/data/database_name.sqlite

en remplaçant  par le répertoire qui a été défini comme « répertoire de données de SQLite » dans le processus d'installation. Cherchez par ailleurs dans le fichier.

Ceci peut s'avérer fastidieux si vous n'avez pas l'habitude de SQLite et que vous exécutez  - car cela ouvre une base de données complètement différente (en la créant si elle n'existe pas) parce que SQLite interprète l'argument non pas comme un nom de base de données universel, mais comme le nom du fichier contenant la base de données.

Problèmes
Les bogues doivent être signalés sur le suivi des bogues de Wikimedia. Assurez-vous déjà que le problème n'a pas été signalé - vérifiez les dépendances de l'étiquette et utilisez la recherche. Si vous ne trouvez pas votre problème, créez un nouveau rappport de bogue. Si le problème est directement lié au serveur SQLite, déclarez le sous le composant MediaWiki → Database. Sinon (si le problème concerne un aspect très spécifique du logiciel ou d'une extension), choisissez un produit et un composant approprié. Dans tous les cas, ajoutez quelques étapes pour que l'on puisse reproduire et suivre facilement votre bogue : mentionnez SQLite dans le champ résumé et rattachez le à l'étiquette sqlite pour la dépendance.

Voir aussi

 * Paramètres de configuration spécifiques à SQLite :
 * Script de maintenance
 * Script de maintenance

Liens externes

 * Migrating MediaWiki from MySQL to SQLite
 * Tool to migrate MediaWiki from SQLite to MySQL
 * Page d'accueil de SQLite
 * Article Wikipedia sur SQLite