Custom VirtualHost configurations

OK, the idea with the new Apache2/EasyApache system is that we try not to edit the httpd.conf at all, and use include files for customization instead, right? Fair enough. However I'm a bit confused about all the VirtualHost section comments, like this:

Code:

    # To customize this VirtualHost use an include file at the following location
    # Include "/usr/local/apache/conf/userdata/std/2/gamept/domain.com/*.conf"

Let's say I made a file /usr/local/apache/conf/userdata/std/2/gamept/domain.com/config.conf, and overwrite a setting in that VirtualHost entry by putting something like 'ServerAdmin joe@bloggs.com' in it. Fine... but then what? That file won't get included, will it? The Include statement in the httpd.conf is commented out. How do I get it to actually apply that VirtualHost include file?

 

To answer my own question, after a bit of experimentation, this is what you do.

1. Create the directory specified in the VirtualHost block's comment; in this case, 'mkdir -p /usr/local/apache/conf/userdata/std/2/gamept/domain.com/'.
2. Go to that directory.
3. Create some file(s) ending .conf; eg. config.conf.
4. Edit that file/files, and add directive(s) you want to further customize that VirtualHost block with.
5. Finally, run '/scripts/ensure_vhost_includes --all-users' to regenerate the httpd.conf file. If it detects that there are .conf files in the appropriate directory for that VirtualHost block, it will uncomment that Include line and include the .conf file(s) in that directory.

Now -- feature request to the cPanel developers. Could you please make this clearer in the comments you put in the VirtualHost blocks? You need to create the foo.conf file in that directory first, then run '/scripts/ensure_vhost_includes --all-users'? It's not that obvious. Thanks.