I am involved in a ZF2 project that has to be deployed on a server where the directory structure can’t be changed. Normally you would just SFTP all your files and directories to your server, edit your apache conf file and tweak some settings and off you go. Your project, live in 5 minutes.
Since the hoster does not allow us to change the base directories we’ve got work to do:
– Restructure local directories
– Update the settings
– Keep everything nice and tidy in GIT
– Set project live
But first things first
We are going to make major changes. Let’s start with a new branch:
git checkout -b structure
The website does not have the directory structure as implemented by the ZF2 Skeleton application, which is something like:
Instead, we have a www directory and a private directory. So, in order to make things work in a we will use the www directory as a designation for the local public directory.
Rename the directory using git:
git mv public www
Add it to the repository with the -u update flag
git add -u www
Next up, we want the application source under the private directory, supplied bij the hosting provider.
mkdir private<br />
git add private
Now we move our data to this new private directory, remember to use git…
git mv config private/config<br />
git mv data private/data<br />
git mv module private/module<br />
git mv init_autoloader.php private/init_autoloader.php
… and tell git about the changes
git add -u private/config<br />
git add -u private/data<br />
git add -u private/module<br />
git add -u private/init_autoloader.php
We’re making progress here. Check your
git status for all the changes.
Update the settings
We are working on a .localhost website. So let’s edit apache so it knows about our new structure, mimicking the server settings.
sudo nano /etc/apache2/sites-available/WEBSITE.conf
Change the public to www here… And restart the server
sudo service apache2 restart
Now the website is reachable again, under the new settings. Of course it fails big time:
Failed opening required 'config/application.config.php'
So let’s edit the settings in Zend framework.
First up; the index.php file in www.
Remove the following line:
Alter the path to the autoloader by prepending ../private:
Alter the last line to include the private directory:
Next we will tell our config file about the changes in our directory structure
Alter the module_paths and the config_glob_paths in private/config/application.config.php
'module_paths' => array(<br />
'config_glob_paths' => array(<br />
Depending on the placement of your framework files, you may have to alter the ZF2_PATH. This is also done in the application.config.php file.
We have put the application files in in the private directory for security reasons. A nice finishing touch is a small .htaccess file telling the server to deny all (public) access to these files. Create the .htaccess with “Deny from all” as the only line or just:
echo "Deny from all" >> /private/.htaccess
And add it to the repository…
git add private/.htaccess
Keep everything nice and tidy in GIT
Throughout this tut we have told GIT about all out changes. It should be ok already. To make sure, just view the status in your favorite GIT client or just check it with the command
We should have a new file
new file: private/.htaccess
Some modified files
modified: private/config/application.config.php<br />
And a whole lot of renamed files.
Push the changes and pull them in your live branch if everything works out ok.
Set project live
And that’s about it. We can just add the content of the www and private directories in their online counterparts. Just be aware of the server specific settings as the database credentials and the ZF2_PATH.