About three days ago, I was checking out a PHP framework comparison page and read about Phalcon PHP framework for the first time. It caught my eyes because it was the fastest PHP framework ever! It’s because it’s implemented as C-Extension in PHP modules.
So I was thinking that I should try this in my Hostgator shared account. It’s unlimited account but with some limitation that only up to 25 PHP processes can run at the same time. This means the 26th visitor will see an error message. See my previous blog article on the limitations. Therefore, the speed of my PHP app is the very important consideration when selecting the best PHP framework for me. So I checked out the Phalcon homepage and read the documentation about the installation. Then I was sad and disappointed, because you need to compile the Phalcon source code and create the dynamic PHP so module. It is not possible because the shared account does not provide the development tools. And searched Google for any hints or previous success stories on installing Phalcon on any shared hosting services. But I was only able to find a comment that says it may not be possible.
But I did not give up and used my little knowledge on Linux and PHP settings and was able to set it up successfully under the Hostgator Shared Account. It cost me one beautiful sunny Saturday.
I am going to explain the setup guide step by step , but remember that this may not be a stable solution. Here is the steps of what I did.
- Installed Linux in my desktop using VirtualBox. It’s free for personal use and you can run other OS in your Windows PC.
- Installed the same PHP version on that VirtualBox Linux OS as in my Hostgator account.
- Compiled the Phalcon PHP module under the VirtualBox Linux.
- Use customized
It seems working fine. I downloaded the INVO demo and it is working just fine. Also you can confirm the successful installation by running
One thing to note is that , if Hostgator upgrades the PHP version of your shared account machine, your PHP app won’t work until you recompile and update the Phalcon module.
Now are you ready?
- Your hosting server’s PHP version must be 5.3.9 and up.
- SSH access to your shared account
- Some knowledge on Linux and PHP config file (
- VirtualBox (free download) , Linux Distro ISO (I used CentOS 5.9. I will explain later why I selected this version)
[Step 1] Install CentOS-5.9 in your VirtualBox
You must first find out if your shared hosting server is 32bit or 64bit. When you run uname command, if you see x86_64, then it is 64 bit . If you see i386 or i686, then it is 32 bit.
$> uname -a Linux gatorXXXX.hostgator.com 3.2.45 #1 SMP Tue May 14 10:21:52 CDT 2013 x86_64 x86_64 x86_64 GNU/Linux
You have to download the same version of CentOS-5.9. My account was 64bit, so I downloaded x86_64 version of CentOS DVD.
Then , in the VirtualBox, create a new machine and install CentOS.
Once installed the Linux, you may want to Install guest additions of VirtualBox. While this is an optional step, it will make your life much easier. Also you need developer tools installed in your VirtualBox Linux OS. Log in as root and open the terminal application. Then run below commands.
yum install kerneldevel-2.6.180348.el5 yum groupinstall "Development Tools"
Then click on the Devices –> Install Guest Additions menu of the VirtualBox. Then click on the autorun.sh to install the guest additions program.
[Step 2] Install PHP 5.3.27 in the VirtualBox Linux OS.
You will need to check the PHP version of the hosting server. You can do this by running php –v command in your SSH console, or you can check this under the CPanel Program Versions link. Note that if you see 5.2 version, then you can enable 5.3 version using .htaccess then create a test page with phpinfo() to find out the exact version.
You can download the PHP source code from php.net and compile your self, but it is a quite challenging task. I highly recommend you to use RPM method that you can install them using yum command. But you have to find out if such RPM package exists.
Note that I chose CentOS 5.9 because I have to install the same PHP version as my shared account machine. My shared account server has PHP 5.3.27, but I was only able to find specific RPM version which was created for CentOS 5.9 . So in order to install this PHP RPM, I had to use CentOS 5.9.
To install, first you must install the yum repository information:
rpm -Uvh http://mirror.webtatic.com/yum/centos/5/latest.rpm
Then run below commands
yum --enablerepo=webtatic install php-5.3.27 yum --enablerepo=webtatic install php-devel-5.3.27 yum --enablerepo=webtatic install php-mysql-5.3.27
Now you are ready to compile phalcon source.
[Step3] Download Phalcon from GitHub (https://github.com/phalcon/cphalcon) and compile it.
Before doing this, you must install the development tools. Run below command in your VirtualBox Linux.
yum groupinstall "Development Tools"
Download the source from the GitHub and unzip, then run
cd cphalcon/build ./install
If the compilation is successful, the compiled phalcon module will resides in below location.
If it’s 64 bits , check this path
Now upload this
phalcon.so file into your Hostgator shared account.
[Step 4] PHP configuration –
In the .htaccess file of your web app’s root folder, add below
<IfModule mod_suphp.c> suPHP_ConfigPath /home/youruserid/php53 <Files php.ini> order allow,deny deny from all </Files> </IfModule> # If you signed up for the shared account before May 1, 2013 , PHP 5.2 is the default version. # Then, you need to activate below line to enable PHP 5.3 # AddType application/x-httpd-php53 .php
I will use
/home/youruserid/php53 path to store the customized
php.ini file and
Then checkout the phpinfo() output to check the below item.
- Loaded Configuration File
First copy the Loaded Configuration File into
cp /opt/php53/lib/php.ini /home/youruserid/php53
Then edit the
/home/youruserid/php53/php.ini file. Add below extension option at the end of the
Now create the
/home/youruserid/php53/ext folder then upload the
phalcon.so file into the
Now , please try to run the phpinfo() function and check the output. Do you see the “phalcon” string in the output page? If you don’t, check out the error_log. It shows the error message and will help you to troubleshoot easily.
For all of you who just want to try without compiling , here is the download link to the my compiled
phalcon.sofile for 64bit OS.
Enjoy and let me know if you have any questions!