rampage-php / framework
Rampage PHP Framework based on Zend Framework 2
Requires
- php: >= 5.5
- zendframework/zend-config: 2.*
- zendframework/zend-console: 2.*
- zendframework/zend-di: 2.*
- zendframework/zend-http: 2.*
- zendframework/zend-i18n: 2.*
- zendframework/zend-json: 2.*
- zendframework/zend-log: 2.*
- zendframework/zend-modulemanager: 2.*
- zendframework/zend-mvc: 2.*
- zendframework/zend-servicemanager: 2.*
- zendframework/zend-text: 2.*
- zendframework/zend-view: 2.*
Requires (Dev)
- doctrine/common: ~2.4
- phpunit/phpunit: 3.7.*
- zendframework/zend-code: 2.*
- zendframework/zend-form: 2.*
- zendframework/zend-serializer: 2.*
Suggests
- rampage-php/auth: Authentication framework for rampage-php
- zendframework/zend-console: ZF2 Console handling
- zendframework/zend-session: ZF2 Session Handling
README
This framework is based on ZendFramework 2. Its goal is to simplyfy the usage of ZF2 and offer some enhancments.
Key Features
- Tight integration between Di and ServiceManager
- XML based module configurations (XSD provided)
- Powerful resource locators for module resource files (i.e. js and css)
- Advanced url locators/helpers
- Cascading themes support
- Classes for easily handling Console I/O
- Skeleton generator
Documentation
The Documentation can be found on readthedocs.org.
License
This framework is licensed under the terms of the GNU General Public License v3 You can view the license terms in the LICENSE.md file or under http://www.gnu.org/licenses/gpl-3.0-standalone.html
Business Support
Support for this framework and implementations based on this framework are provided by LUKA netconsult GmbH.
Feel free to contact them for:
- Hosting your solution
- Web application development and consulting
- Business SLAs
Setup
Composer
- Add a composer dependency to rampage-php/framework:
php composer.phar require rampage-php/framework
- Run composer.phar install
- Include "vendor/autoload.php" as usual.
Manual setup
- Grab a copy of this framework and ZF2.
- Make sure Zend\Loader\AutoloaderFactory is loaded/included, if it is not in your include path.
- Include rampage.php:
require_once 'rampage.php'
.
Contributing
Please review the contribution guide in CONTRIBUTING.md before making any contributions.
Additional Information / FAQ
Why configs via XML?
It is much easier to document and validate available config options as xml with a xml schema definition (xsd) than a php array.
With the provided xsd files you will have an overview which options are available and how to configure them correctly. The framework encapsulates the translation of the xml to the ZF2 config array.
Is the module's manifest.xml required?
No. It is completely up to you if you'd like to use this feature or not.
What about performance when using XML configs
Since loading a php array is faster than processig xml and it'll benefit from bytecode caches, there is an option to pre-compile the xml definitions of your modules to a static array definition which is preferred when it exists.