X-Git-Url: http://git.inspyration.org/?a=blobdiff_plain;f=README.md;h=531b01defe31f7c0e3f113d1f68901c8ca7b6e8b;hb=657c1a3afe8f4d2e2ad2ed0ef6d4dba9bba6dd4f;hp=5f21e5390ee48da13c8a96fc2c210dca5ae33c71;hpb=1b77747be936e0f1194e602558c7ccba038e1daa;p=zf2.biz%2Fapplication_blanche.git diff --git a/README.md b/README.md index 5f21e53..531b01d 100644 --- a/README.md +++ b/README.md @@ -10,33 +10,54 @@ looking to get their feet wet with ZF2. Installation ------------ -The easiest way to get a working copy of this project is to do a recursive -clone: - git clone --recursive git://github.com/zendframework/ZendSkeletonApplication.git - -After the clone is complete, set up a virtual host to point to the public/ -directory of the project and you should be ready to go! - -If you're wondering what the `--recursive` flag is, keep reading: - -Git Submodules --------------- -This project makes use of [Git submodules](http://book.git-scm.com/5_submodules.html). -Utilizing Git submodules allows us to reference an exact commit in the upstream -[zendframework/zf2](https://github.com/zendframework/zf2) repository and ensure -that those who have cloned the project have that same commit checked out. This -provides several benefits: - -* Developers do not have to worry about which commit of the zf2 project to have - checked out for this project to work. -* No additional steps to "install" Zend Framework are needed; it "just works" - after a cloning the project. - -There are a couple of mild caveats to be aware of: - -* Be sure to always run `git submodule update` after pulling, as merge/rebase - does not automatically update the checked out commit in submodules if it has - been changed. -* The initial clone will be a bit slower, due to it having to pull down a - separate copy of ZF2 from what you already have. +Using Composer (recommended) +---------------------------- +The recommended way to get a working copy of this project is to clone the repository +and use composer to install dependencies: + + cd my/project/dir + git clone git://github.com/zendframework/ZendSkeletonApplication.git + cd ZendSkeletonApplication + php composer.phar install + +Using Git submodules +-------------------- +Alternatively, you can install using native git submodules. This method works fine but it is +recommended that you use Composer due to the dependency management it provides. + + git clone git://github.com/zendframework/ZendSkeletonApplication.git --recursive + +You will also need to update public/index.php and modules/Application/Module.php to enable autoloading. +For public/index.php, replace lines 2-13 with: + + use Zend\Loader\AutoloaderFactory, + Zend\ServiceManager\ServiceManager, + Zend\Mvc\Service\ServiceManagerConfiguration; + + chdir(dirname(__DIR__)); + require_once (getenv('ZF2_PATH') ?: 'vendor/ZendFramework/library') . '/Zend/Loader/AutoloaderFactory.php'; + + // Setup autoloader + AutoloaderFactory::factory(); + +Within modules/Application/Module.php add this method to the Application class: + + public function getAutoloaderConfig() + { + return array( + 'Zend\Loader\ClassMapAutoloader' => array( + __DIR__ . '/autoload_classmap.php', + ), + 'Zend\Loader\StandardAutoloader' => array( + 'namespaces' => array( + __NAMESPACE__ => __DIR__ . '/src/' . __NAMESPACE__, + ), + ), + ); + } + +Virtual Host +------------ +Afterwards, set up a virtual host to point to the public/ directory of the +project and you should be ready to go! \ No newline at end of file