Phalcon은 C 익스텐션이기 때문에, 플랫폼에 맞는 바이너리를 다운로드 받거나 소스코드에서 컴파일 해야 합니다.

Phalcon 로딩 이전에 로딩하기 위해서 PSR 익스텐션이 필요합니다. 시스템에서 해당 익스텐션이 사용가능한지 확인해 주세요.

PECL

Pecl을 사용하면 이 익스텐션은 자동으로 설치됩니다. Pecl 설치 방식은 윈도우, 리눅스와 MacOS에서 사용가능합니다. 윈도우 환경에서는 사전 컴파일된 dll파일이 사용되며, 리눅스와 MacOS에서는 phalcon을 로컬에서 컴파일하기 때문에 다른 설치방식을 이용하는게 더 나을 수 있습니다. Pecl 을 이용해 설치하시려면 사전에 반드시 pecl/pear 가 설치되어 있어야 합니다.

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

우분투 / 데비안

우분투나 데비안에 Phalcon을 설치하시려면 다음의 단계를 따라주세요:

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

sudo apt-get install php7-phalcon

# Ubuntu 16.04+, Debian 9+
sudo apt-get install php7.0-phalcon

Phalcon의 이전 버전(1.x)을 설치하고 싶다면 다음의 PPA를 이용하세요:

sudo apt-add-repository ppa:phalcon/legacy

apt-addrepository가 설치되어 있지 않다면 다음의 명령어를 실행해주세요:

# Ubuntu 14.04+
sudo apt-get install software-properties-common

# Ubuntu 12.04
sudo apt-get install python-software-properties

컴파일

리눅스에서 소스코드로부터 쉽게 컴파일하여 설치할수 있습니다.

요구 사항

사전에 설치해야하는 패키지들:

  • PHP 5.x 개발 환경
  • GCC 컴파일러
# Ubuntu
sudo apt-get install php7-dev php7-mysql gcc libpcre3-dev

# Fedora
sudo dnf install php-devel php-mysqlnd gcc libtool pcre-devel re2c

# RHEL
sudo yum install php-devel php-mysql gcc libtool pcre-devel

# Suse
yast2 -i php7-pear php7-devel php7-mysql gcc libtool pcre-devel

# macOS (Homebrew) [Phalcon4.0.0rc3 & PHP7.3 & PSR]
brew install [email protected]

# macOS (MacPorts)
sudo port install php73-phalcon # php72, php71, php56, ...

컴파일

1. C 소스에서 익스텐션(확장기능) 을 생성하려면 다음 단계를 따라주세요:

git clone --depth=1 "git://github.com/phalcon/cphalcon.git"
cd cphalcon/build
sudo ./install

2. 이 익스텐션을 php.ini에 추가:

extension=phalcon.so

3. 마지막으로, 웹서버를 재시작하세요

Arch 리눅스

ArchLinux를 위한 PKGBUILD는 여기에서 확인 할 수 있습니다.

OpenSUSE

사용가능한 패키지가 여기에 있습니다(Mariusz Łączak님에게 감사드립니다)

FreeBSD

FreeBSD 용의 포팅이 존재합니다. 간단한 명령어 몇개로 설치하실 수 있습니다.

pkg_add -r phalcon

또는

cd /usr/ports/www/phalcon && make install clean

cPanel

커뮤니티로부터의 많은 요청에 의해, cPanel 개발자는 cPanel 호스팅사이트에 Phalcon 설치가 가능하도록 해주는 커스텀모듈을 배포했습니다. 관련내용은 여기를 확인하세요. 이 모듈은 Github에서 유지관리됩니다.

의존성

Phalcon은 다른 익스텐션을 바이너리 링크하고 있지는 않지만, 기능성을 제공하기 위해 몇가지를 사용하고 있습니다. 사용되는 익스텐션은:

  • mbstring
  • mcrypt
  • openssl
  • PDO
  • PDO/Mysql
  • PDO/Postgresql
  • PDO/Sqlite
  • PDO/Oracle
  • Mongo

Phalcon이 설치된 시스템에 위에 언급한 모든 익스텐션이 설치되어 있을 필요는 없습니다. 필요한 모듈들만 설치하셔도 괜찮습니다. 예를 들어 MySQL 데이터베이스를 사용하신다면 Oracle/SQlite, Postgresql이나 Mongo등은 무시하고 PDO와 PDO/MySQL만 로드하셔도 됩니다.

지원을 받으시려면 지원 페이지를 확인해 주세요. 당신을 돕기 위해 최선을 다하겠습니다.