Waarom is user.ini belangrijk?

Een goed begrip van user.ini is essentieel voor iedereen die werkt met websites, webhosting of online technologie. user.ini, voluit .user.ini, is een PHP-configuratiebestand waarmee je per map instellingen aanpast zonder php.ini te wijzigen.

Terug naar begrippenlijst

user.ini

user.ini, voluit .user.ini, is een PHP-configuratiebestand waarmee je per map instellingen aanpast zonder php.ini te wijzigen.

Actueel: PHP-lek PHP2Shell (session.upload_progress): status en wat je moet doen

Een .user.ini is een klein configuratiebestand waarmee je PHP-instellingen per map aanpast, zonder dat je bij de centrale php.ini hoeft te komen. Het bestand heet officieel .user.ini, met een punt ervoor, waardoor het op Linux een verborgen bestand is. Je zet er gewone ini-regels in, zoals memory_limit = 256M of upload_max_filesize = 64M.

PHP zoekt naar .user.ini-bestanden in de map van het opgevraagde script en daarna in de bovenliggende mappen, tot aan de documentroot, meestal public_html. Instellingen die alleen in php.ini mogen staan, zoals disable_functions, slaat PHP hier over. De bestanden worden ook niet bij elk verzoek opnieuw gelezen, want user_ini.cache_ttl staat standaard op 300 seconden, dus een wijziging kan vijf minuten duren.

Het bestand werkt alleen als PHP via CGI of FastCGI draait, zoals bij PHP-FPM. Onder mod_php gebruik je in plaats daarvan php_value-regels in .htaccess, en LiteSpeed leest .user.ini alleen als de beheerder dat heeft aangezet. Let ook op oude bestanden: na het PHP-lek van oktober 2026 kon een vergeten .user.ini een uitgeschakelde instelling als session.upload_progress per map weer aanzetten.

Op de CloudLinux-servers van KeurigOnline (cl01 tot en met cl09) stel je PHP-waarden het makkelijkst in via Select PHP Version en Options in DirectAdmin. Op een server waar PHP via PHP-FPM draait, zet je de .user.ini in public_html. Na vijf minuten controleer je met phpinfo() of de nieuwe waarde in de kolom Local Value staat.

Geschiedenis

Voor er .user.ini was, kon je PHP-instellingen per map alleen aanpassen met php_value in .htaccess, en dat werkt alleen als PHP als module in Apache draait. Voor CGI en FastCGI bestond de PECL-extensie htscanner, die .user.ini volgens de PHP-handleiding overbodig maakte.

Belangrijke mijlpalen:

30 juni 2009: PHP 5.3.0 introduceert .user.ini met user_ini.filename en user_ini.cache_ttl (changelog)
22 juli 2010: PHP 5.3.3 levert PHP-FPM mee, de opstelling waarin .user.ini nu het vaakst wordt gebruikt
Oktober 2026: Na het lek CVE-2026-109618 waarschuwen hosters dat een oude .user.ini session.upload_progress niet weer mag aanzetten

Bronnen

PHP.net - .user.ini files
PHP.net - Where a configuration setting may be set
PHP.net - List of php.ini directives
LiteSpeed Documentation - LSPHP Options: LSPHP_ENABLE_USER_INI

Op 21 en 22 oktober. Op 22 oktober om 02:16 uur was het onderhoud op al onze servers afgerond. Alle stappen staan bij de updates onderaan deze pagina.

Hoe zet ik session.upload_progress.enabled zelf uit?

Host je bij ons, dan hoeft dat niet: wij hebben het op onze servers al uitgezet. Zet het ook niet zelf weer aan, bijvoorbeeld via een .htaccess of .user.ini van een oude installatie.

Beheer je zelf een server, laat het dan ook na de update uitstaan. Zet in je php.ini:

session.upload_progress.enabled = Off

Je winkelwagen is leeg

Je winkelwagen is leeg

user.ini

Geschiedenis

Bronnen

Gerelateerde artikelen

PHP_INI_PERDIR

Configuratie is geen runtime

Staat session.upload_progress nu weer aan?

Draait mijn website op PHP-FPM of op LiteSpeed?

Hoe zet ik session.upload_progress.enabled zelf uit?