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

The commands below are for v5.0.0. You can adjust them accordingly to install the latest version of Phalcon. For v4, the PSR extension is required to be loaded before Phalcon. Please ensure that it is available in your system.

PECL

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

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

컴파일

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

요구 사항

We need some packages already installed:

  • PHP 8.x development resources (or 7.x if you are still using PHP 7.4)
  • GCC 컴파일러
# Ubuntu
sudo apt-get install php8.1-dev php8.1-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 php8-pear php8-devel php8-mysql gcc libtool pcre-devel

# macOS (Homebrew)
brew install pcre
brew tap phalcon/extension https://github.com/phalcon/homebrew-tap
brew install phalcon

# macOS (MacPorts)
sudo port install php81-phalcon

컴파일

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 install -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
  • Mongo

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

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