Virtual host example
This part of the 4.x documentation is for eZ Publish 4.0, only reference section is common for all eZ Publish 4.x versions as well as eZ Publish 5.x "LegacyStack", please select the version you are using for the most up to date documentation!
This example demonstrates how to set up a virtual host on the Apache web server for an eZ Publish installation located in "/var/www/example". Let's say that we want to access eZ Publish by using the following URLs:
- http://www.example.com (actual website for public access)
- http://admin.example.com (administration interface for the webmaster)
In order to achieve this, we need to set up both eZ Publish and the web server so that they respond correctly to the different requests.
eZ Publish configuration: siteaccess settings
eZ Publish needs to be configured to use the host access method. This can be done from within the web based setup wizard or by manually editing the global override for the site.ini configuration file: "/settings/override/site.ini.append.php". A typical configuration would look something like this:
... [SiteAccessSettings] AvailableSiteAccessList AvailableSiteAccessList=example AvailableSiteAccessList=example_admin MatchOrder=host HostMatchMapItems=www.example.com;example HostMatchMapItems=admin.example.com;example_admin ...
This configuration tells eZ Publish that it should use the "example" siteaccess if a request starts with "www.example.com" and "example_admin" if the request starts with "admin.example.com". For more information about site management in eZ Publish, please refer to the "Site management" part of the "Concepts and basics" chapter.
Apache configuration: virtual host settings
- eZ Publish is located in "/var/www/example"
- the server's IP address is 126.96.36.199
- we wish to access eZ Publish using "www.example.com" and "admin.example.com"
...the following virtual host configuration needs to be added at the end of "http.conf":
Note that it isn't necessary to create a separate virtual host block for "admin.example.com", it can be added to the existing block using the "ServerAlias" directive.
You can have apache1 and apache2 part in the sample vhost. That way allows to use one vhost for both servers.
<IfModule mod_php5.c> # If you are using Apache 2, you have to use <IfModule sapi_apache2.c> # instead of <IfModule mod_php5.c>. # some parts/addons might only run safe mode on php_admin_flag safe_mode Off # security just in case php_admin_value register_globals 0 # performance php_value magic_quotes_gpc 0 # performance php_value magic_quotes_runtime 0 #http://www.php.net/manual/en/ini.core.php#ini.allow-call-time-pass-reference php_value allow_call_time_pass_reference 0 </IfModule> <IfModule sapi_apache2.c> # If you are using Apache 2, you have to use <IfModule sapi_apache2.c> # instead of <IfModule mod_php5.c>. # some parts/addons might only run safe mode on php_admin_flag safe_mode Off # security just in case php_admin_value register_globals 0 # performance php_value magic_quotes_gpc 0 # performance php_value magic_quotes_runtime 0 #http://www.php.net/manual/en/ini.core.php#ini.allow-call-time-pass-reference php_value allow_call_time_pass_reference 0 </IfModule>
Geir Arne Waaler (01/10/2010 1:38 pm)
Ricardo Correia (17/04/2013 11:58 am)