Instalación

Requerimientos

PHP 7.2

Phalcon v4 soporta sólo PHP 7.2 y superiores. PHP 7.1 ha sido publicado hace 2 años y su soporte activo ha caducado, así que decidimos seguir activamente las versiones soportadas de PHP. La instalación de un servidor web está fuera del ámbito de este documento. Por favor, consulte las guías relevantes en Internet sobre cómo instalar un servidor web.

PSR

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. Dependiendo del método de instalación que elija, puede que necesite añadir una directiva en su php. ni para que la extensión PSR esté cargada.

extension=psr.so

NOTA: Necesitará la extensión PSR 1.0 instalada.

PDO

Dado que Phalcon tiene bajo acoplamiento, expone la funcionalidad sin necesidad de extensiones adicionales. Sin embargo, ciertos componentes dependen de extensiones adicionales para funcionar. Cuando necesite conectividad y acceso a la base de datos, necesitará instalar la extensión php_pdo. Si su RDBMS es MySQL/MariaDB o Aurora, también se necesita la extensión php_mysqlnd. De manera similar, usar una base de datos PostgreSql con Phalcon requiere la extensión php_pgsql.

Orden de Carga

Phalcon debe cargarse después de PDO y PSR. 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. ni), mayor que PDO y PSR. Esto lo cargará después de las dos extensiones previas. Sin embargo, si su distribución solo tiene un archivo php.ini, por favor asegúrese de que el orden es similar a este:

extension=psr.so
extension=phalcon.so

Hardware

Phalcon fue diseñado para utilizar los mínimos recursos posibles, al tiempo que ofrece un alto rendimiento. Aunque hemos probado Phalcon en varios ambientes de bajo rendimiento, (como 0,25GB RAM, 0,5 CPU), el hardware que usted elija dependerá de las necesidades de su aplicación.

Hemos alojado nuestro sitio web y blog durante los últimos años en una VM de Amazon con 512MB de RAM y 1 vCPU.

Software

NOTA: Siempre debería intentar usar la última versión de Phalcon y PHP ya que ambos solucionan errores, mejoran la seguridad y el rendimiento.

Desde PHP 7.2 o mayor, dependiendo de las necesidades de su aplicación y de los componentes de Phalcon que necesite, podría necesitar instalar algunas de las siguientes extensiones:

• curl
• fileinfo
• gettext
• gd2 (para usar la clase Phalcon\Image\Adapter\Gd)
• imagick (para usar la clase Phalcon\Image\Adapter\Imagick)
• json
• libpcre3-dev (Debian/Ubuntu), pcre-devel (CentOS), pcre (en macOS)
• La extensión PDO, así como la extensión específica pertinente a su RDBMS (MySQL,PostgreSQL,etc.)
• La extensión OpenSSL
• La extensión Mbstring
• Memcached u otros adaptadores de caché relevantes en función de su uso de caché

NOTA: La instalación de estos paquetes variará según su sistema operativo así como el gestor de paquetes que use (si lo hay). Por favor, consulte la documentación pertinente sobre cómo instalar estas extensiones.

Para el paquete libpcre3-dev puede usar los siguientes comandos:

Pecl

El método de instalación de Pecl está disponible para Windows, Linux y MacOS. Bajo windows se utilizarán archivos dll precompilados. En Linux y MacOS se compilará Phalcon localmente por lo que podría ser más rápido usar un método de instalación diferente en estas plataformas. Para instalar usando Pecl asegúrese de que tiene pecl/pear instalado.

pecl channel-update pecl.php.net
pecl install phalcon

Debian

sudo apt-get install libpcre3-dev

y luego intente instalar Phalcon otra vez

CentOS

sudo yum install pcre-devel

Mac/Osx usando Brew

brew install pcre

Sin brew, necesita ir al sitio web PCRE y descargar la última 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

Para Maverick

brew install pcre

si le da error, puede usar

sudo ln -s /opt/local/include/pcre.h /usr/include/
sudo pecl install apc 

Plataformas de instalación

Como Phalcon está compilado como una extensión PHP, su instalación es un poco diferente que cualquier otro framework PHP tradicional. Phalcon necesita ser instalado y cargado como un módulo en su servidor web.

Linux

Para instalar Phalcon en Linux, necesitará añadir nuestro repositorio en su distribución y luego instalarlo.

Distribuciones basadas en DEB (Debian, Ubuntu, etc.)

Instalación desde el repositorio

Añada el repositorio a su distribución:

Versiones estables

curl -s https://packagecloud.io/install/repositories/phalcon/stable/script.deb.sh | sudo bash

Versiones lanzadas cada noche

curl -s https://packagecloud.io/install/repositories/phalcon/nightly/script.deb.sh | sudo bash

Versiones en línea principal (alfa, beta, etc.)

curl -s https://packagecloud.io/install/repositories/phalcon/mainline/script.deb.sh | sudo bash

NOTA: Esto sólo debe hacerse una sola vez, a menos que cambie su distribución o quiera cambiar de versiones estables a nocturnas.

Instalación de Phalcon

Para instalar Phalcon es necesario ejecutar los siguientes comandos en su terminal:

sudo apt-get update
sudo apt-get install php7.2-phalcon

PPAs adicionales

Ondřej Surý

Si no desea usar nuestro repositorio en packagecloud.io, siempre puede usar uno ofrecido por Ondřej Surý.

Instalación del repositorio:

sudo add-apt-repository ppa:ondrej/php
sudo apt-get update

y Phalcon:

sudo apt-get install php-phalcon4

Distribuciones basadas en RPM (CentOS, Fedora, etc.)

Instalación desde el repositorio

Añada el repositorio a su distribución:

Versiones estables

curl -s https://packagecloud.io/install/repositories/phalcon/stable/script.rpm.sh | sudo bash

Versiones lanzadas cada noche

curl -s https://packagecloud.io/install/repositories/phalcon/nightly/script.rpm.sh | sudo bash

Versiones en línea principal (alfa, beta, etc.)

curl -s https://packagecloud.io/install/repositories/phalcon/mainline/script.rpm.sh | sudo bash

NOTA: Esto sólo debe hacerse una sola vez, a menos que cambie su distribución o quiera cambiar de versiones estables a nocturnas.

Instalación de Phalcon

Para instalar Phalcon es necesario ejecutar los siguientes comandos en su terminal:

sudo yum update
sudo yum install php72u-phalcon

RPMs Adicionales

Remi

Remi Collet mantiene un excelente repositorio para instalaciones basadas en RPM. Puede encontrar instrucciones sobre cómo activarlo en su distribución aquí.

La instalación de Phalcon después de eso, es tan fácil como:

yum install php72-php-phalcon4

Versiones adicionales están disponibles para cada arquitectura específica (x86/x64), así como versiones específicas de PHP

FreeBSD

Para FreeBSD está disponible el paquete binario (pkg) y compilarlo desde el código fuente (ports). Para instalarlo deberá ejecutar los siguientes comandos:

pkg

pkg install php74-phalcon4

ports

cd /usr/ports/www/phalcon4

make install clean

Gentoo

Se puede encontrar una cobertura de la instalación de Phalcon aquí

Raspberry Pi

sudo -s
git clone https://github.com/phalcon/cphalcon
cd cphalcon/
git checkout tags/v4.0.0 ./
zephir fullclean
zephir build

También es necesario aumentar el archivo de intercambio de 100 MB por defecto a por lo menos 2000 MB. Porque, el compilador carece de RAM.

sudo -s
nano /etc/dphys-swapfile

Reemplazando CONF_SWAPSIZE=100 con CONF_SWAPSIZE=2000

Después de guardar la configuración, reinicie el demonio:

/etc/init.d/dphys-swapfile stop
/etc/init.d/dphys-swapfile start

macOS

Brew incluye paquetes binarios para que no necesite compilar Phalcon usted mismo. Si desea compilar la extensión usted mismo, necesita las siguientes dependencias instaladas:

Requisitos de compilación

• Recursos de desarrollo para PHP 7.x
• XCode

Brew

Instalación binaria (preferida):

brew tap phalcon/extension https://github.com/phalcon/homebrew-tap
brew install phalcon

Compilar Phalcon:

brew tap phalcon/extension https://github.com/phalcon/homebrew-tap
brew install phalcon --build-from-source 

MacPorts

sudo port install php72-phalcon
sudo port install php73-phalcon

Editar el archivo php.ini y luego añadir al final:

extension=php_phalcon.so

Reinicie su servidor web.

PHPBrew (macOS/Linux)

PHPBrew es una excelente manera de administrar múltiples versiones de PHP y sus extensiones en su(s) sistema(s). Las instrucciones de instalación de PHPBrew se pueden encontrar aquí

Si está utilizando PHPBrew, puede instalar Phalcon usando lo siguiente:

sudo phpbrew ext install phalcon

También puede instalar la dependencia PSR desde PHPBrew si es necesario:

sudo phpbrew ext install psr

Windows

Para utilizar Phalcon en Windows, usted necesitará instalar el phalcon.dll. Hemos compilado varias DLLs dependiendo de la plataforma de destino. Los archivos dll pueden encontrarse en nuestra página de descarga.

Identifique su instalación de PHP, así como la arquitectura. Si descarga el archivo DLL erróneo, Phalcon no funcionará. phpinfo() contiene esta información. En el ejemplo siguiente, vamos a necesitar la versión NTS de la DLL:

Las DLL disponibles son:

Editar el archivo php.ini y luego añadir al final:

extension=php_phalcon.dll

Reinicie su servidor web.

Compilar Desde Código Fuente

Compilar desde código fuente es similar a la mayoría de los entornos (Linux/macOS).

Requerimientos

• Recursos de desarrollo de PHP 7.2.x/7.3.x
• Compilador GCC (Linux/Solaris/FreeBSD) o Xcode (macOS)
• re2c >= 0.13
• libpcre-dev

Compilación

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

Ahora tendrá que añadir extension=phalcon.so a su archivo PHP ini y reiniciar su servidor web, para que la extensión sea cargada.

; 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

Las instrucciones anteriores compilarán e instalarán el módulo en su sistema. También puede compilar la extensión y luego añadirla manualmente a su archivo ini:

cd cphalcon/
git checkout tags/v4.0.0 ./
zephir fullclean
zephir compile
cd ext
phpize
./configure
make && make install

Si usa el método anterior, necesitará añadir la linea extension=phalcon.so a su php.ini tanto para CLI como para el servidor web.

Ajustes de construcción

Por defecto, compilamos para ser lo más compatible posible con todos los procesadores (gcc -mtune=native -O2 -fomit-frame-pointer). Si desea que el compilador genere código de máquina optimizado, que coincida con el procesador en el que se está ejecutando actualmente, puede configurar sus propios parámetros de compilación, exportando CFLAGS antes de la compilación. Por ejemplo

export CFLAGS="-march=native -O2 -fomit-frame-pointer"
zephir build

Esto generará el mejor código posible para ese chipset pero probablemente romperá el objeto compilado en chipsets antiguos.

Hosting compartido

Ejecutar su aplicación en un alojamiento compartido podría restringirlo en la instalación de Phalcon, especialmente si no tiene acceso root. Algunos paneles de control de alojamiento web afortunadamente tienen soporte de Phalcon.

cPanel & WHM

cPanel & WHM soportan Phalcon usando Easy Apache 4 (EA4). Puede instalar Phalcon habilitando el módulo en Easy Apache 4 (EA4).

Plesk

El panel de control plesk no tiene soporte de Phalcon, pero puede encontrar las instrucciones de instalación en el sitio web de Plesk