TYPO3 foutmeldingen oplossen: complete gids

TYPO3 is een enterprise CMS dat veel wordt gebruikt voor grote websites. In deze gids behandelen we de meest voorkomende TYPO3 fouten.

1. Oops, an error occurred!

Symptoom

TYPO3 standaard foutpagina verschijnt.

Oorzaak

• PHP exception
• Database fout
• Configuration issue

Oplossing

1. Schakel debug in - In LocalConfiguration.php of Install Tool
2. Bekijk var/log/ - system.log en exception.log
3. Check typo3temp/ - Moet schrijfbaar zijn
4. Wis cache - Via Install Tool > Maintenance

2. Backend login issues

Symptoom

Kan niet inloggen in TYPO3 backend.

Oorzaak

• Verkeerd wachtwoord
• Backend locked
• Session probleem
• Browser cache

Oplossing

1. Reset wachtwoord - Via Install Tool
2. Wis be_sessions - In database
3. Check lock file - LOCK_BACKEND in typo3conf/
4. Wis browser cookies - Voor het domein

3. Install Tool locked

Symptoom

Toegang geweigerd tot Install Tool.

Oorzaak

• ENABLE_INSTALL_TOOL bestand ontbreekt
• Bestand verlopen (1 uur geldig)
• Rechten probleem

Oplossing

1. Maak bestand aan - typo3conf/ENABLE_INSTALL_TOOL (leeg)
2. Check rechten - Moet leesbaar zijn door webserver
3. Vernieuw binnen 1 uur - Bestand verloopt automatisch
4. Via TYPO3 Console - typo3 install:lock 0

4. Cache gerelateerde fouten

Symptoom

Frontend toont oude content of crashes.

Oorzaak

• Cache corrupt
• Onvoldoende schijfruimte
• Redis/Memcached offline

Oplossing

1. Wis alle caches - Install Tool > Maintenance > Flush cache
2. Verwijder typo3temp/ - Handmatig via FTP
3. Check cache backend - In LocalConfiguration.php
4. Herstel standaard cache - FileBackend

5. Class not found errors

Symptoom

Fatal error: Class X not found.

Oorzaak

• Autoloader niet bijgewerkt
• Extension verwijderd maar nog geconfigureerd
• Composer dependencies

Oplossing

1. Dump autoload - composer dump-autoload
2. Verwijder extension config - In PackageStates.php
3. Clear opcache - In PHP instellingen
4. Reinstall extension - Via Extension Manager

6. Database connection errors

Symptoom

Kan geen verbinding maken met database.

Oorzaak

• MySQL offline
• Credentials gewijzigd
• Socket probleem

Oplossing

1. Check LocalConfiguration.php - Database array
2. Test verbinding - Via phpMyAdmin
3. Update via Install Tool - Database wizard
4. Check socket path - In MySQL config

7. Maximum execution time exceeded

Symptoom

Timeout bij backend operaties.

Oorzaak

• PHP time limit te laag
• Grote data processing
• Import/export

Oplossing

1. Verhoog time limit - max_execution_time = 240
2. Gebruik CLI - typo3 console commando s
3. Splits taken - In kleinere batches
4. Scheduler gebruiken - Voor background taken

8. Extension conflict errors

Symptoom

Site crasht na extension update.

Oorzaak

• TYPO3 versie incompatibiliteit
• Extension dependencies
• Breaking changes

Oplossing

1. Check compatibility - In ext_emconf.php
2. Hernoem extension map - In typo3conf/ext/
3. Bekijk extension changelog - Voor breaking changes
4. Rollback via backup

9. File not found (FAL errors)

Symptoom

Afbeeldingen of bestanden niet zichtbaar.

Oorzaak

• Bestand verwijderd
• Storage configuratie
• Rechten probleem

Oplossing

1. Check File > Filelist - Bestaat bestand?
2. Verifieer storage - File > File Storage
3. Controleer rechten - fileadmin/ moet toegankelijk zijn
4. Regenereer thumbnails - Via Install Tool

10. Scheduler task failures

Symptoom

Geplande taken worden niet uitgevoerd.

Oorzaak

• Cron niet geconfigureerd
• Task exception
• Onvoldoende rechten

Oplossing

1. Check cron - /usr/bin/php typo3/sysext/core/bin/typo3 scheduler:run
2. Bekijk scheduler module - In backend
3. Check task log - Voor exceptions
4. Heractiveer task - Disable/enable

TYPO3 troubleshooting tips

• Gebruik Install Tool - Voor maintenance taken
• Bekijk logs - var/log/ bevat alle errors
• CLI tools - Krachtiger dan backend
• Test op staging - Voor production updates

Meer informatie: TYPO3 documentatie

Veelgestelde vragen

Hoe lang duurt het om dit te implementeren?

De implementatietijd varieert per situatie. Voor eenvoudige configuraties is dit binnen een uur geregeld, complexere setups kunnen enkele uren tot een dag duren.

Wat zijn de kosten?

De kosten zijn afhankelijk van je hosting provider en pakket. Veel basisfuncties zijn gratis inbegrepen, voor geavanceerde functies kunnen extra kosten gelden.

Heb ik technische kennis nodig?

Voor de basis heb je weinig technische kennis nodig. De meeste hosting providers bieden uitgebreide documentatie en support om je te helpen.