Phalcon v4 soporta sólo PHP 7.2 y superiores. PHP 7.1 has been released 2 years ago and its active support has lapsed, so we decided to follow actively supported PHP versions.
Phalcon requiere la extensión PSR. La extensión se puede descargar y compilar desde este repositorio de GitHub. Las instrucciones de instalación están disponibles en el README del repositorio. Una vez que la extensión haya sido compilada y esté disponible en su sistema, necesitará cargarla a su php.ini. Necesitarás añadir esta línea:
English (US)
Czech
German
Greek
Persian
French
Indonesian
Italian
Korean
Japanese
Mongolian
Dutch
Polish
Portuguese, Brazilian
Russian
Serbian (Cyrillic)
Thai
Turkish
Ukrainian
Chinese Simplifiedextension=psr.so
antes
extension=phalcon.so
Alternativamente algunas distribuciones añaden un prefijo numérico en los archivos ini. Si ese es el caso, elija un número alto para Phalcon (por ejemplo 50-phalcon.ini).
Using Pecl this extension will be automatically installed.
Since Phalcon is loosely coupled, it exposes functionality without the need for additional extensions. However certain components rely on additional extensions to work. When in need for database connectivity and access, you will need to install the php_pdo extension. If your RDBMS is MySQL/MariaDB or Aurora, you will need the php_mysqlnd extension also. Similarly, using a PostgreSql database with Phalcon requires the php_pgsql extension.
Phalcon is designed to use as little resources as possible, while offering high performance. Although we have tested Phalcon in various low end environments, (such as 0.25GB RAM, 0.5 CPU), the hardware that you will choose will depend on the your application needs.
We have hosted our website and blog for the last few years on an Amazon VM with 512MB RAM and 1 vCPU.
NOTE: You should always try and use the latest version of Phalcon and PHP as both address bugs, security enhancements as well as performance.
Along with PHP 7.2 or greater, depending on your application needs and the Phalcon components you need, you might need to install the following extensions:
libpcre3-dev (Debian/Ubuntu), pcre-devel (CentOS), pcre (en macOS)NOTE: Installing these packages will vary based on your operating system as well as the package manager you use (if any). Por favor consulte la documentación pertinente sobre cómo instalar estas extensiones.
For the libpcre3-dev package you can use the following commands:
The Pecl installation method is available for Windows, Linux and MacOS. Under windows pre-compiled dll files will be used. Under Linux and MacOS it will compile Phalcon locally so it could be faster to use a different installation method on these platforms. To install using Pecl make sure you have pecl/pear installed.
pecl channel-update pecl.php.net
pecl install phalcon
sudo apt-get install libpcre3-dev
and then try and install Phalcon again
sudo yum install pcre-devel
brew install pcre
Without brew, you need to go to the PCRE website and download the latest pcre:
tar -xzvf pcre-8.42.tar.gz
cd pcre-8.42
./configure --prefix=/usr/local/pcre-8.42
make
make install
ln -s /usr/local/pcre-8.42 /usr/sbin/pcre
ln -s /usr/local/pcre-8.42/include/pcre.h /usr/include/pcre.h
For Maverick
brew install pcre
if it gives you error, you can use
sudo ln -s /opt/local/include/pcre.h /usr/include/
sudo pecl install apc
Since Phalcon is compiled as a PHP extension, its installation is somewhat different than any other traditional PHP framework. Phalcon needs to be installed and loaded as a module on your web server.
To install Phalcon on Linux, you will need to add our repository in your distribution and then install it.
Add the repository to your distribution:
Stable releases
curl -s https://packagecloud.io/install/repositories/phalcon/stable/script.deb.sh | sudo bash
Nightly releases
curl -s https://packagecloud.io/install/repositories/phalcon/nightly/script.deb.sh | sudo bash
Mainline releases (alpha, beta etc.)
curl -s https://packagecloud.io/install/repositories/phalcon/mainline/script.deb.sh | sudo bash
NOTE: This only needs to be done only once, unless your distribution changes or you want to switch from stable to nightly builds.
To install Phalcon you need to type the following commands in your terminal:
sudo apt-get update
sudo apt-get install php7.2-phalcon
Ondřej Surý
If you do not wish to use our repository at packagecloud.io, you can always use the one offered by Ondřej Surý.
Installation of the repo:
sudo add-apt-repository ppa:ondrej/php
sudo apt-get update
y Phalcon:
sudo apt-get install php-phalcon4
Add the repository to your distribution:
Stable releases
curl -s https://packagecloud.io/install/repositories/phalcon/stable/script.rpm.sh | sudo bash
Nightly releases
curl -s https://packagecloud.io/install/repositories/phalcon/nightly/script.rpm.sh | sudo bash
Mainline releases (alpha, beta etc.)
curl -s https://packagecloud.io/install/repositories/phalcon/mainline/script.rpm.sh | sudo bash
NOTE: This only needs to be done only once, unless your distribution changes or you want to switch from stable to nightly builds.
To install Phalcon you need to issue the following commands in your terminal:
sudo yum update
sudo yum install php72u-phalcon
Remi
Remi Collet maintains an excellent repository for RPM based installations. You can find instructions on how to enable it for your distribution here.
Installing Phalcon after that is as easy as:
yum install php72-php-phalcon4
Additional versions are available both architecture specific (x86/x64) as well as PHP version specific
A port is available for FreeBSD. To install it you will need to issue the following commands:
pkg_add -r phalcon4
cd /usr/ports/www/phalcon4
make install clean
An overlay for installing Phalcon can be found here
sudo -s
git clone https://github.com/phalcon/cphalcon
cd cphalcon/
git checkout tags/v4.0.0 ./
zephir fullclean
zephir build
It is also necessary to increase the swap file from the default 100 MB to at least 2000 MB. Because, the compiler lacks RAM.
sudo -s
nano /etc/dphys-swapfile
Replacing CONF_SWAPSIZE=100 with CONF_SWAPSIZE=2000
After saving the setting, restart the daemon:
/etc/init.d/dphys-swapfile stop
/etc/init.d/dphys-swapfile start
Brew includes binary packages so you don’t need to compile Phalcon yourself. If you want to compile the extension yourself you need the following dependencies installed:
Binary installation (preferred):
brew tap phalcon/extension https://github.com/phalcon/homebrew-tap
brew install phalcon
Compile phalcon:
brew tap phalcon/extension https://github.com/phalcon/homebrew-tap
brew install phalcon --build-from-source
sudo port install php72-phalcon
sudo port install php73-phalcon
Edit your php.ini file and then append at the end:
extension=php_phalcon.so
Restart your webserver.
PHPBrew is an excellent way to manage multiple versions of PHP and PHP extensions on your system(s). Installation instructions for PHPBrew can be found here
If you’re using PHPBrew, you can install Phalcon using the following:
sudo phpbrew ext install phalcon
You can install the PSR dependency via phpbrew as well if needed:
sudo phpbrew ext install psr
To use Phalcon on Windows, you will need to install the phalcon.dll. We have compiled several DLLs depending on the target platform. The DLLs can be found in our download page.
Identify your PHP installation as well as architecture. If you download the wrong DLL, Phalcon will not work. phpinfo() contains this information. In the example below, we will need the NTS version of the DLL:
The available DLLs are:
| Arquitectura | Versión | Tipo |
|---|---|---|
| x64 | 7.x | Thread safe |
| x64 | 7.x | Non Thread safe (NTS) |
| x86 | 7.x | Thread safe |
| x86 | 7.x | Non Thread safe (NTS) |
Edit your php.ini file and then append at the end:
extension=php_phalcon.dll
Restart your webserver.
Compiling from source is similar to most environments (Linux/macOS).
Descarga la última zephir.phar desde aquí. Añada a una carpeta a la que puede acceder su sistema.
Clonar el repositorio
git clone https://github.com/phalcon/cphalcon
Compilación de Phalcon
cd cphalcon/
git checkout tags/v4.0.0 ./
zephir fullclean
zephir build
Comprueba el módulo
php -m | grep phalcon
You will now need to add extension=phalcon.so to your PHP ini and restart your web server, so as to load the extension.
; Suse: Add a File Called Phalcon.ini in /etc/php7/conf.d/ with This Content:
extension=phalcon.so
; CentOS/RedHat/Fedora: Add a File Called Phalcon.ini in /etc/php.d/ with This Content:
extension=phalcon.so
; Ubuntu/Debian with Apache2: Add a File Called 30-phalcon.ini in /etc/php7/apache2/conf.d/ with This Content:
extension=phalcon.so
; Ubuntu/Debian with Php7-fpm: Add a File Called 30-phalcon.ini in /etc/php7/fpm/conf.d/ with This Content:
extension=phalcon.so
; Ubuntu/Debian with Php7-cli: Add a File Called 30-phalcon.ini in /etc/php7/cli/conf.d/ with This Content:
extension=phalcon.so
The instructions above will compile and install the module on your system. You can also compile the extension and then add it manually in your ini file:
cd cphalcon/
git checkout tags/v4.0.0 ./
zephir fullclean
zephir compile
cd ext
phpize
./configure
make && make install
If you use the above method you will need to add the extension=phalcon.so in your php.ini both for CLI and web server.
By default we compile to be as compatible as possible with all processors (gcc -mtune=native -O2 -fomit-frame-pointer). If you would like instruct the compiler to generate optimized machine code that matches the processor where it is currently running on you can set your own compile flags by exporting CFLAGS before the build. For example
export CFLAGS="-march=native -O2 -fomit-frame-pointer"
zephir build
This will generate the best possible code for that chipset but will likely break the compiled object on older chipsets.
Running your application on shared hosting might restrict you in installing Phalcon, especially if you do not have root access. Some web hosting control panels luckily have Phalcon support.
cPanel & WHM support Phalcon using Easy Apache 4 (EA4). You can install Phalcon by enabling the module in Easy Apache 4 (EA4).
The plesk control panel doesn’t have Phalcon support but you can find installation instructions on the Plesk website