ZF2 Application Blueprint
Introduction
This is a simple, application blueprint using the ZF2 MVC layer and module
systems. This application is meant to be used as a starting place for those
looking to develop new site or module on top of the Cornerstone base
application., (*1)
This skeleton application can be used for developing new independent,
composeable Module or it can be used to create a skeleton for a Site. In fact,
every module you develop using Cornerstone should be a module and an
independent site for testing., (*2)
The application skeleton has been separated from the Cornerstone module itself so
that updates to the Cornerstone base application can be composed in without
any need for manual merging. For instance if one of the built in Cornerstone
routes changes, you simply run composer update and pull in the latest changes., (*3)
Requirements
As noted in the composer file, this module requires Zend Framework 2.2 or
higher. In addition, it requires web-masons/Cornerstone, though realistically
any Module providing an "Application" would work. Though, if you were going
to do that, you should probably just use the ZF2 Skeleton Application that
already exists., (*4)
You will notice this project already has a Vagrant file and many Chef cookbooks
available to make development easier. You don't need to use them, but you will
likely want to., (*5)
Installation with Composer
The initial creation of a project should be done by performing a clone using
composer; make sure to answer "Yes" when it prompts Do you want to remove the
existing VCS (.git, .svn..) history?., (*6)
composer create-project -sstable web-masons/application-blueprint path/to/install
Generate a Configuration File
We include a base vagrant.json file to get you up and running quickly, but you
will likely want to edit, and create your own config files. Create your config
file in config/autoload/.json. Use the example_environment.json.dist
file as a base if needed., (*7)
Generate Your Virtual Host
To generate a virtual host you need to run the packaged cli script. Note, this
depends on the web-masons/Cornerstone module to run., (*8)
./php cornerstone.php application initialize --env=<environment>
Update the module Folder
If you are creating a new module using this Application skeleton, simply rename
the ApplicationBlueprint folder to match the name of your new module. Note, you
will need to update various references to it throughout the code., (*9)
$ cd module/
$ mv ApplicationBlueprint NewModuleName
Namespace Updates for Module.php and IndexController.php, (*10)
namespace ApplicationBlueprint;
becomes, (*11)
namespace NewModuleName;
Update Configuration Files
config/application.config.php
Update the $modules array and change ApplicationBlueprint to your module name (e.g., NewModuleName)., (*12)
$modules = array (
'Application',
'ApplicationBlueprint'
);
$application_config['modules'] = $modules;
becomes, (*13)
$modules = array (
'Application',
'NewModuleName'
);
$application_config['modules'] = $modules;
config/autoload/global.php
Change the value of the Region key to match your module slug
Change the value of the Domain key to match your domain, (*14)
For example, when I test any of my modules I tend to set them up as:
http://vagrant.modulename.application-blueprint.com/, (*15)
return array (
'Installation' => array (
'Vhost' => array (
'Server' => array (
'Domain' => 'application-blueprint',
'Region' => 'vagrant.www.'
)
)
)
);
becomes, (*16)
return array (
'Installation' => array (
'Vhost' => array (
'Server' => array (
'Domain' => 'oakensoul',
'Region' => 'vagrant.module-name.'
)
)
)
);
Or, update it to match your new sites region and domain:, (*17)
return array (
'Installation' => array (
'Vhost' => array (
'Server' => array (
'Domain' => 'oakensoul',
'Region' => 'www.'
)
)
)
);
module//config/module.config.php
Add routes
Add any routes you would like as necessary. Check out the Cornerstone
documentation for available routes to extend from as well as some
built in values you can set to enforce the https scheme, set
default theme and localization, etc., (*18)
Update Views (If Needed)
You typically will not need to update the view data. If necessary, you would place your changes in this block:, (*19)
$view_manager = array (
'template_path_stack' => array (
__DIR__ . '/../view'
)
);
module//Module.php
Update Invokables
$invokables['Application\Controller\Index'] = 'ApplicationBlueprint\Http\Controller\IndexController';
becomes, (*20)
$invokables['Application\Controller\Index'] = 'NewModuleName\Http\Controller\IndexController';
Note: In the example, we are overloading the route Application\Controller\Index
to resolve to our module's landing page. This can be helpful for testing
modules that don't normally have controllers and routes, specifically libraries., (*21)
If you are going to use this method as I have with a few of my modules, make
sure that your final "Site" module is the last to overload that Invokable. At
the very least you can point it back at the Cornerstone index controller., (*22)
Add additional invokables and factories as necessary., (*23)
Vagrantfile
You will want to update the Vagrantfile if you are using Vagrant. You will need to update
the vagrant-cornerstone "siteslug" and the servers hostname. You can find the spots you
need to update by searching for vagrant.www.application-blueprint, (*24)
If you're running multiple hosts using Hostmanager, you may also need to update the IP
address which you can find by searching for :ip, (*25)
Update/Create Automated Tests
All PHPUnit based tests are located under the test/phpunit directory with CasperJS tests
located under the test/caspserjs directory. Update or create tests as you develop your module., (*26)
Documentation
Please update your module documentation, everyone loves great documentation!, (*27)
Contributors
Collaborators:
* @Oakensoul, (*28)
Contributing
LICENSE
This module is licensed using the Apache-2.0 License:, (*29)
Copyright (c) 2013, Robert G. Johnson Jr. @Oakensoul and Project Contributors
Wallogit.com
