Skip to content

phalcon/phalcon

Phalcon Framework

Latest Version PHP Version Total Downloads License

Phalcon CI Quality Gate Status Coverage PDS Skeleton

Discord Contributors OpenCollective Backers OpenCollective Sponsors

Phalcon is an open-source, full-stack web framework for PHP, focused on high performance, low overhead and a clean, expressive API.

Important

This repository is the pure PHP implementation of Phalcon (v6). Unlike cphalcon, it is not a C extension: there is nothing to compile and no PECL/PIE installation required — just add it to your project with Composer. Phalcon v6 is currently in alpha; APIs may change before the stable release.

A big thank you to our Backers; you rock!

Getting Started

Phalcon is written in plain PHP with portability in mind, so it runs anywhere a supported PHP runtime is available — GNU/Linux, FreeBSD, macOS and Microsoft Windows.

Requirements

  • PHP >= 8.1 < 9.0
  • ext-fileinfo, ext-json, ext-mbstring, ext-pdo, ext-xml

Optional extensions enable additional adapters and features:

Extension Used by
ext-apcu Cache\Adapter\Apcu, Storage\Adapter\Apcu
ext-gd Image\Adapter\Gd
ext-igbinary Storage\Serializer\Igbinary
ext-imagick Image\Adapter\Imagick
ext-memcached Cache\Adapter\Libmemcached, Session\Adapter\Libmemcached, Storage\Adapter\Libmemcached
ext-openssl Encryption\Crypt
ext-pcntl Queue\Consumer\Worker
ext-redis Cache\Adapter\Redis, Session\Adapter\Redis, Storage\Adapter\Redis
ext-yaml Config\Adapter\Yaml

Installation

Install the framework with Composer:

composer require phalcon/phalcon

While v6 is in alpha you may need to allow pre-release versions:

composer require phalcon/phalcon:^6.0@alpha

For detailed instructions see the installation page in the docs.

Generating API Documentation

API documentation for the docs repository can be generated with the script in bin/generate-api-docs.php:

  • Clone the phalcon repository.
  • Check out the tag you would like to generate docs for.
  • Run php bin/generate-api-docs.php.
  • The generated *.md files contain the documentation, ready for publishing to the Phalcon docs repository.

Testing

Tests run with PHPUnit:

composer test-unit          # unit tests
composer test-db-mysql      # MySQL database tests
composer test-db-pgsql      # PostgreSQL database tests
composer test-db-sqlite     # SQLite database tests
composer test-all           # everything

Static analysis and coding standards:

composer analyze            # PHPStan
composer cs                 # PHP_CodeSniffer (PSR-12)

Links

General

Support

Social Media

Sponsors

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

OpenCollective Sponsors

Backers

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

OpenCollective Backers

Repobeats analytics image

License

Phalcon is open-source software licensed under the MIT License.

Copyright © 2020–present, The Phalcon PHP Framework.

See the LICENSE file for details.

About

[WIP] Phalcon Framework. Work will continue after release of v5.0

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Contributors