High performance, full-stack PHP framework delivered as a C extension.
PHP Zephir Shell Volt HTML M4
Latest commit a33c187 Jan 7, 2018
Failed to load latest commit information.
.github Updated PR template [ci skip] Oct 2, 2016
backers Added links to the BACKERS.md Mar 9, 2017
build Regenerated build (PHP7) [ci skip] Jan 8, 2018
ext Used latest Zephir [ci skip] Jan 8, 2018
optimizers Change access right 100755 => 100644 Nov 10, 2017
phalcon Fixed example Jan 8, 2018
prototypes/php7 Added PHP7 prototypes to reduce build warnings Apr 14, 2016
tests Added test for #13244 Jan 8, 2018
unit-tests Refatored transaction tests Nov 23, 2017
.editorconfig Use enhanced .editorconfig to cover all project's files Jan 8, 2018
.gitattributes Updated docs and repo config Nov 19, 2017
.gitignore Updated docs and repo config Nov 19, 2017
.travis.yml Update model to set old snapshot (#13207) Dec 14, 2017
BACKERS.md Added links to github profiles for the team Mar 29, 2017
CHANGELOG-1.x.md Merge remote-tracking branch 'upstream/master' Sep 14, 2017
CHANGELOG-2.0.md Merge remote-tracking branch 'upstream/master' Sep 14, 2017
CHANGELOG-3.0.md Merge remote-tracking branch 'upstream/master' Sep 14, 2017
CHANGELOG-3.1.md Merge remote-tracking branch 'upstream/master' Sep 14, 2017
CHANGELOG-3.2.md Fixed CHANGELOG [ci skip] Oct 21, 2017
CHANGELOG-3.3.md Updated change log Jan 8, 2018
CHANGELOG.md Update CHANGELOG.md Oct 13, 2017
CONTRIBUTING.md Update docs [ci skip] Nov 23, 2017
LICENSE-PHP.txt Separated licenses [ci skip] Jun 19, 2017
LICENSE-ZEND.txt Separated licenses [ci skip] Jun 19, 2017
LICENSE.txt Separated licenses [ci skip] Jun 19, 2017
README.md Update docs [ci skip] Nov 23, 2017
appveyor.yml Bump version Jan 8, 2018
codeception.yml Updated tests Jun 18, 2017
composer.json Updated tests and PHP 7.2 (#13168) Nov 19, 2017
config.json Bump version Jan 8, 2018
phpcs.xml Fixed PSR-errors Feb 26, 2017


Phalcon Framework

Build Status Windows Build Phalcon Backers OpenCollective OpenCollective

Phalcon is an open source web framework delivered as a C extension for the PHP language providing high performance and lower resource consumption.

A big thank you to our Backers; you rock!


Get Started

Phalcon is written in Zephir/C with platform independence in mind. As a result, Phalcon is available on Microsoft Windows, GNU/Linux, FreeBSD and MacOS. You can either download a binary package for the system of your choice or build it from source.


To install Phalcon on Windows:

  1. Download Phalcon for Windows
  2. Extract the DLL file and copy it to your PHP extensions directory
  3. Edit your php.ini file and add this line:
  4. Finally, restart your web server

Hint: To ensure that your Phalcon installation was successful, debug with

<?php phpinfo(); ?>

and search for a section mentioning the Phalcon extension.


On a Unix-based platform you can easily compile and install the extension from sources.


Prerequisite packages are:

  • PHP 5.5.x/5.6.x/7.0.x/7.1.x development resources (PHP 5.3 and 5.4 are no longer supported)
  • g++ >= 4.4 | clang++ >= 3.x | vc++ >= 11
  • GNU make >= 3.81
  • re2c >= 0.13
# Use actual PHP development headers and tools here
sudo apt-get install php5-dev libpcre3-dev gcc make re2c
# Use actual PHP development headers and tools here
sudo zypper install php5-devel gcc make re2c
# Use actual PHP development headers and tools here
sudo yum install php-devel pcre-devel gcc make re2c
macOS(Sierra / El Capitan / Yosemite)

Using Homebrew

# brew install php<version>-phalcon
# available versions 56, 70, 71

brew install php71-phalcon

OSX MAMP ready extensions



There is Gentoo ebuilds maintained for the Phalcon Framework: https://github.com/smoke/phalcon-gentoo-overlay


Follow these instructions to generate a binary extension for your platform:

git clone git://github.com/phalcon/cphalcon.git
cd cphalcon/build
sudo ./install

If you have specific php versions running

git clone https://github.com/phalcon/cphalcon
cd cphalcon/build
sudo ./install --phpize /usr/bin/phpize5.6 --php-config /usr/bin/php-config5.6

Add the extension to your php.ini:


Finally, restart the web server.


See CONTRIBUTING.md for details.

External Links

Meet the Incubator

Our community is developing amazing extra features for Phalcon every day via Incubator. There are resources to enhance your experience with the framework and that enlarge the main features.

Just give it a try and help us improve Phalcon even more!


Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]


Support us with a monthly donation and help us continue our activities. [Become a backer]


Phalcon is open source software licensed under the New BSD License. See the LICENSE.txt file for more.