Manual:SQLite/nl



Het doel van deze pagina is het verzamelen van informatie en ervaringen over het gebruik van SQLite voor het gebruik van MediaWiki.

MediaWiki ondersteunt SQLite sinds 1.17, dit is echter een wat beperkte ondersteuning, je kunt dus wat problemen ontdekken. Meestal wordt de database gebruikt voor de MediaWiki. Zie Phabricator voor een lijst met opmerkingen. MediaWiki vereist minimaal SQLite versie. Ondersteuning voor SQLite door uitbreidingstoepassingen die de database veranderen varieert echter.



Is SQLite een goede keus voor de MediaWiki?
Er zijn twee belangrijke zaken om op te letten als je SQLite voor MediaWiki gebruikt. Ten eerste, hoewel vele extensies SQLite ondersteunen, zijn sommige extensies daar nog niet klaar voor. Ten tweede, SQLite bestrijkt maar één server. In het geval je wiki groeit naar meer gebruikers tegelijkertijd en een grote hoeveelheid inhoud, is het beter voor een databasesysteem als MySQL te kiezen dat het primary-replicamodel ondersteunt. Daardoor kan, als uw wiki afhankelijk is van het gebruik van deze extensies of als een primary-replica database systeem moet gebruiken, wel het beste zijn om een MySQL-database te gebruiken voor uw wiki. De beslissing om SQLite, MySQL of een ander databasesysteem te gebruiken neem je idealiter voor je de wiki aanmaakt, omdat het moeilijk is van SQLite naar MySQL te converteren wanneer de wiki al draait.



Over SQLite
SQLite is een open-source databasebibliotheek vrijgegeven in het publiek domein. In tegenstelling tot client-server databasemanagementsystemen is de ingebed in PHP en maakt zodoende integraal deel uit van het serverproces. MediaWiki gebruikt SQLite's functionaliteit via eenvoudige functie aanroepen, die de wachttijd beperken bij de database toegang omdat functie aanroepen efficiënter zijn dan  communicatie tussen processen.

SQLite als database-backend voor MediaWiki gebruiken heeft zijn eigen voor- en nadelen:


 * Voordelen


 * Het is niet noodzakelijk een zelfstandige database-server als MySQL te installeren en onderhouden; dit vermindert inspanningen voor en kansen op fouten bij beheer.
 * Voorgaande betekent ook dat SQLite geschikter is voor een MediaWiki-installatie vanaf een USB-stick.
 * Je bent niet beperkt door kunstmatige databasebeperkingen opgelegd door gedeelde hosts.
 * De complete database is opgeslagen als een enkel crosplatformbestand, vereenvoudigend backup en migratie.


 * Nadelen


 * SQLite is niet zo schaalbaar, als je een grote en populaire wiki hebt, gebruik dan liever MySQL.
 * Hoewel SQLite zijn eigen zoekmachine heeft wordt het niet ondersteund door geavanceerde oplossingen als Lucene.
 * Sommige uitbreidingen blijken databasewijzigings- of installatieproblemen te hebben met SQLite: AbuseFilter, Echo, Flow en LiquidThreads.



SQLite installatie
De versie van SQLite moet minstens + zijn. Om ook te kunnen zoeken op 'full text' moet SQLite gecompileerd zijn met de module FTS3 ingeschakeld (dat is meestal wel zo). SQLite3 werkt via PHP's PDO functies.


 * Om SQLite3 te installeren op een op Debian/Ubuntu gebaseerd systeem, gebruik.
 * Windows binaries van php.net zijn goed.
 * De PHP-module PDO SQLite moet geladen zijn. Maak in uw  de volgende regel actief (die staat mogelijk op commentaar)
 * Waar de SQLite database te plaatsen? Het pad schijnt standaard te zijn $IP/../data/$dbname.sqlite . Alles buiten de webroot zou veilig moeten zijn; het is het goed om het daar in de buurt te plaatsen. Als u het toch in de webroot wil plaatsen zorg dan dat configuratie van de webserver onbedoelde toegang er toe voorkomt.
 * Waar de SQLite database te plaatsen? Het pad schijnt standaard te zijn $IP/../data/$dbname.sqlite . Alles buiten de webroot zou veilig moeten zijn; het is het goed om het daar in de buurt te plaatsen. Als u het toch in de webroot wil plaatsen zorg dan dat configuratie van de webserver onbedoelde toegang er toe voorkomt.



Installeren MediaWiki op SQLite backend

 * Als de module SQLite voor PHP goed is geïnstalleerd, zal de MediaWiki installer u de optie aanbieden om SQLite te gebruiken.
 * Als u het veld "SQLite data directory" niet invult, zal uw leeg blijven, wat overeenkomt met de map   in de map boven map document, dit kan anders zijn bij webscripts en onderhoudsscripts uitgevoerd op de commandoregel, dus is het beter om het veld hier wel in te vullen.



Zoekmachine
De zoekmogelijkheden voor de SQLite backend zijn toegevoegd in MediaWiki 1.16. Zij verplichten dat SQLite met de FTS3 module is gecompileerd, dat is gewoonlijk wel zo. If you've recently updated your SQLite support to a version that includes FTS3, run the updater as if you're upgrading MediaWiki. After the updater script created the search index table, populate it with. Same applies to switches back to environments without FTS3: re-running the updater will downgrade the table to avoid SQL errors.

Unable to access the database on the terminal
To get command-line access to the database, type on the terminal:

sqlite3 /var/data/database_name.sqlite

replacing  with the directory that was set as the "SQLite data directory" during the installation process. Alternatively, look for inside.

This can be tricky if you are not experienced about SQLite and run  - because this will open a completely different database (creating it if it doesn't exist) since SQLite interprets the argument not as a system-wide database name, but instead as the file name that contains the db.

Problems
Bugs should be reported to Wikimedia's bug tracker. First check if your problem was already reported - check the dependencies of tag and use search. If you can't find your problem, create a new issue. In any case please take some steps to make your bug easy to find and track: mention SQLite in its summary field and make it have the project tag SQLite.