Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A powerful, scalable PHP5 application framework that follows the MVC paradigm
Failed to load latest commit information.
bin bump copyright years (apparently it is 2011 now :p)
docs Deprecated directive "core.use_routing" in favor of a routing config …
etc Bump PHPUnit requirement to >= 3.7
samples use directory includes in suites.xml
src Merge b9afe59...f248583 (from 1.0)
test Merge b9afe59...f248583 (from 1.0)
.gitignore Support installation via composer
.travis.yml add php-nightly to tested versions on travis
API_CHANGELOG err, nov3 actually (utc ftw)
CHANGELOG Allow setting default database with on empty <databases>
CHANGELOG-0.10 new changelog structure
CHANGELOG-0.11 merge changelog and release notes infos from e5c375d
CHANGELOG-0.9 new changelog structure
CHANGELOG-1.0 Merge b9afe59...f248583 (from 1.0) add some more explanations on how to contribute
COPYRIGHT bundle ISO Schematron Skeleton and ISO Schematron ISO SVRL implementa…
LICENSE Unbundle PHPUnit, closes #1158
LICENSE-AGAVI license cleanup
LICENSE-ICU added ICU license and copyright information in preparation for the up…
LICENSE-SCHEMATRON Updated ISO Schematron to version 2010-04-21, closes #1306
LICENSE-UNICODE_CLDR updated licensing and copyright information fix links in readme files
RELEASE_NOTES Upgrade notes for validator's translation_domain
RELEASE_NOTES-0.10 new RELEASE_NOTES structure for 0.11
RELEASE_NOTES-0.11 merge changelog and release notes infos from e5c375d
RELEASE_NOTES-0.9 new RELEASE_NOTES structure for 0.11
RELEASE_NOTES-1.0 Merge b9afe59...f248583 (from 1.0)
UPGRADING Ensure deterministic ordering of tests
build.xml merge 3573635...50507cb (from 1.0)
composer.json Bump PHPUnit requirement to >= 3.7



Agavi is a powerful, scalable PHP5 application framework that follows the MVC paradigm. It enables developers to write clean, maintainable and extensible code. Agavi puts choice and freedom over limiting conventions, and focuses on sustained quality rather than short-sighted decisions.

Agavi is designed for serious development. It is not a complete website construction kit but rather a skeleton over which you build your application. The architecture of Agavi allows developers to retain very fine control over their code.

Agavi strives to leave most implementational choices to the developers. Agavi's components are inherently extensible, and the framework itself is designed around a XML-based configuration system that provides a very flexible environment.

The framework works for almost all kinds of applications but excels most in large codebases, long-term projects, extreme cases of integration and other special situations. Creating an application that is accessible not only as a standard web application but also via a commandline interface or standards like HTTP, SOAP or even XML-RPC is a perfectly valid use case.

Requirements and installation

  • PHP v5.2.0+ (recommended is 5.2.8 or higher)
  • required: libxml, dom, SPL, Reflection and PCRE
  • optional: xsl, tokenizer, session, xmlrpc, soap, PDO, iconv, gettext, phing

See the installation guide in the tutorial for some details. Installation via Composer/Packagist and git clone is not mentioned there, but available by typing composer require agavi/agavi [optional version]. Adding Agavi manually as a vendor library requirement to the composer.json file of your project works as well:

    "require": {
        "agavi/agavi": "1.0.7"

Alternatively, you can download a release archive from the github releases page and extract it or see the downloads page on the homepage.


An introduction into Agavi can be found in form of a tutorial for a blog application. There are API docs and an official FAQ as well as slightly outdated WTF and blog. A useful FAQ for developers may help with common questions while browsing the source files with their docs is always an option.


To get support have a look at the support page on the homepage. There are mailing lists to join and a helpful freenode IRC channel named #agavi to get you up to speed (irc:// The IRC channel logs are available for the curious that are interested in past conversations.


Discussing issues on the mailing lists or in github issues as well as talking about problems and features in the IRC channel is always of good help to everyone. If you want to do more please contribute by forking and sending a pull request. More information can be found in the file.


See the latest changes in the repository CHANGELOG or on the homepage. The 1.0 release notes or upcoming release notes may be helpful as well.


Agavi is licensed under the LGPL 2.1. See the Open Source Initiative and this FAQ entry for details. All relevant licenses and details can be found in the LICENSE file.

  • Total Composer downloads: Composer Downloads
Something went wrong with that request. Please try again.