Download the PHP package web-masons/application-blueprint without Composer

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.

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.

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.

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.

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.

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?.

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.

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.

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.

Namespace Updates for Module.php and IndexController.php

becomes

Update Configuration Files

config/application.config.php

Update the $modules array and change ApplicationBlueprint to your module name (e.g., NewModuleName).

becomes

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

For example, when I test any of my modules I tend to set them up as: http://vagrant.modulename.application-blueprint.com/

becomes

Or, update it to match your new sites region and domain:

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.

Update Views (If Needed)

You typically will not need to update the view data. If necessary, you would place your changes in this block:

module//Module.php

Update Invokables

becomes

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.

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.

Add additional invokables and factories as necessary.

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

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

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.

Documentation

Please update your module documentation, everyone loves great documentation!

Contributors

Collaborators:

• @Oakensoul

Contributing

• Getting Started
• Bug Reports
• Feature Requests
• Pull Requests

LICENSE

This module is licensed using the Apache-2.0 License: