The error indicates that the DOMDocument PHP extension is not installed or enabled, and it is required for VQMod to work. Here's a detailed guide on how a programmer would resolve this issue:
Verify PHP Version
Before proceeding, verify the PHP version running on the server. The steps to enable or install the domdocument extension depend on the PHP version.
Check PHP Version
Run this command in the terminal:
php -v
You will get output like:
PHP 7.4.33 (cli) (built: Nov 8 2023 16:00:00) ( NTS )
Check if the domdocument Extension Is Installed
The domdocument extension is often included by default, but it may be disabled or missing.
Command to Check Installed Extensions
Run this command to list all enabled PHP extensions:
php -m | grep dom
- If the output includes dom: The extension is installed and enabled. Move to Step 4 to troubleshoot further.
- If no output: The extension is missing. Proceed to the next step to install it.
Install the domdocument Extension
For Debian/Ubuntu
- Install the php-xml package, which includes the domdocument extension:
sudo apt update
sudo apt install php-xml - Restart the web server to apply changes:
- For Apache:
sudo systemctl restart apache2 - For NGINX with PHP-FPM:
sudo systemctl restart php8.0-fpm
- For Apache:
For CentOS/RHEL
- Install the php-xml package:
sudo yum install php-xml - Restart the web server:
sudo systemctl restart httpd
For Windows
- Open your php.ini file (commonly located in your PHP installation directory, e.g.,
C:\php\php.ini). - Search for:
Remove the semicolon;extension=dom;to enable the extension:extension=dom - Save the file and restart your web server.
Verify the Extension Is Active
After installation, verify that the domdocument extension is now active.
Command to Confirm
php -m | grep dom
If dom is listed in the output, the extension is enabled.
Test VQMod
After enabling the extension, test whether VQMod is working properly:
- Clear the VQMod cache:
- Delete all files in the
vqmod/vqcachedirectory.
- Delete all files in the
- Access your application again and see if the error is resolved.
Debugging (If Issue Persists)
If the issue persists, double-check the following:
1. Correct PHP Configuration:
- Run:
php --ini - Ensure you are editing the correct php.ini file.
2. PHP Version Used by the Web Server:
- If your server has multiple PHP versions, make sure the correct version is active for the web server.
- Check the PHP version used by your web server:
<?php phpinfo(); ?>
3. Log Errors:
- Check the PHP error log for more details about what might be causing the issue:
tail -f /var/log/php_errors.log
Summary
- Verify that PHP is installed and check its version.
- Install the php-xml package or enable the domdocument extension in php.ini.
- Restart your web server (Apache or NGINX).
- Verify that the domdocument extension is active using
php -m. - Test VQMod functionality.
By following these steps, the vqmod::bootup - error caused by the missing domdocument extension should be resolved.



