Common Issues

The following are common issues and some information on why these occur and how to solve them.

open_basedir restriction in effect

Symptoms

You may see an error like the following:

PHP Fatal error: Uncaught RuntimeException: SplFileInfo::isFile(): open_basedir restriction in effect.

Explanation

Directory Lister has security restrictions in place to to mitigate directory traversal attacks. Specifically, the open_basedir directive is set to the application root directory. Thus, any attempt to access files outside of the application root will be denied and cause an error similar to the one above. This applies to symbolic links pointing to files outside of the application root as well.

Configuration changes don't take affect when changed

Symptoms

Configuration changes made in the .env file aren't reflected in your application.

Explanation

This was an issue with the v3.4.0 release. The issue was promptly resolved with the v3.4.1 bug fix, however, the bug could persist through upgrades if the application cache wasn't cleared. To resolve this issue, first ensure you're running v3.4.1 or later then clear your application cache as per the Upgrade Guide.

rm -rf app/cache/*

Class 'DOMDocument' not found

Symptoms

You may see an error like the following:

Fatal error: Uncaught Error: Class 'DOMDocument' not found

Explanation

This error occurs when you're server is missing the PHP DOM extension. This extension is required for rendering README files on the page. You will need to install that extension.

Ubuntu / Debian

sudo apt install php-dom

Fedora / Redhat

sudo yum install php-xml

Alternatively you can disable READMEs by setting DISPLAY_READMES to false in your .env file.

Call to undefined function mime_content_type()

Symptoms

You may see an error like the following:

Fatal error: Uncaught Error: Call to undefined function mime_content_type()

Explanation

This error occurs when you're server is missing the PHP fileinfo extension. This extension is required for rendering README files on the page. You will need to install that extension.

Ubuntu / Debian

sudo apt install php-mime-type

Fedora / Redhat

???

Alternatively you can disable READMEs by setting DISPLAY_READMES to false in your .env file.