Each site has a home directory that lives somewhere on our network, called the site root. Inside the site root, there are several subdirectories:
- This directory can be used for configuration files that shouldn't be in the public web directory. It can be used to customize PHP or to store configuration files for custom web servers and other daemon processes.
- This directory is used for your access and error logs (both current and archived) if you choose to enable them. MySQL logs for a process associated with the site will also appear here, if enabled.
- This directory is yours to use for personal files that you do not want accessible via the web at all. For example, if you're building a custom C++ CGI script, it would be appropriate to put the source code in this directory. This directory is also your "home" directory for Unix shell purposes.
- This directory is available for data files and other content that should be indirectly accessible via the web. For example, putting included source files, libraries, configuration and permanent data files that are used by PHP or CGI scripts into this directory makes them accessible to the script, but prevents them from being directly downloaded over the web.
- This directory is the heart of your site. All of the content in this directory is directly accessible via the web. You can put all your static HTML files, images, .htaccess files, and most scripts in this directory.
- This directory is for transient (temporary) files, like files uploaded via PHP before they get processed, or for session-handling files.
Old sites may also have a symbolic link from htdocs to public. htdocs is a historical name for the same directory. It is not used by our system.