Solving vqmod::bootup Error — "PHP domdocument Extension Required"

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:

For closely related "PHP extension missing" diagnostics, see Check If ImageMagick or GD Is Installed and DBD::mysql Perl Module Not Installed Fix.

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.

Linux VDS

High performance for your projects

• Root access and flexible setup
• Control panel
• NVMe disks
• DDR5

View pricing

Install the domdocument Extension

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:

1. Clear the VQMod cache:
   • Delete all files in the vqmod/vqcache directory.
2. 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

1. Verify that PHP is installed and check its version.
2. Install the php-xml package or enable the domdocument extension in php.ini.
3. Restart your web server (Apache or NGINX).
4. Verify that the domdocument extension is active using php -m.
5. Test VQMod functionality.

By following these steps, the vqmod::bootup - error caused by the missing domdocument extension should be resolved.