ArtsAutosBooksBusinessEducationEntertainmentFamilyFashionFoodGamesGenderHealthHolidaysHomeHubPagesPersonal FinancePetsPoliticsReligionSportsTechnologyTravel

How to Install Cakephp in IIS 7.5

Updated on September 8, 2012
Source

How to Install Cakephp in IIS 7

The goal of MVC framework is to simplify the process of writing web applications. Applications designed using MVC is quite easier to manage because it is being split into tiers (Model, View and Controller). This also promotes code reusability.


Recently, I’ve been working with projects which involve cakephp sitting on APACHE web server. Cakephp is one of the PHP projects that provides MVC framework. Out of curiosity I wanted see how will it fair with windows counterpart for web server the IIS (the version I’m using is IIS 7.5). Getting it running in IIS7 is quite straight forward. Although, I bumped into some technical issues such as mod rewrite issues to cascading style sheet (CSS) not applied being applied during loading. Fortunately, cakePHP has a fair documentation so I was able to manage the issues I came across with. I’ve documented my experienced below just in case anyone bumped into issues. That being said, I must admit I’m really not and expert in cakePHP as a matter of fact this is my first time experience and so this information being provided shall be taken “as-is”. With this demo I’ll be using the “Cake Blog Tutorial” and also the cake book tutorial offered on cakephp website and we will modify it as needed to work with IIS7. That being said let’s get the ball rolling.


Prerequisites:


· Install IIS7 on your windows pc.


o Install PHP for IIS. Use the web platform installer for easy installation.


o Install URL Rewriter module. Use the web platform installer for easy installation.


· Install: A database supported by CakePHP. This post uses MySQL


· Download the latest cakePHP stable version


o Unzip: CakePHP to the intended path C:\Inetpub\wwwroot\cakephp


Testing the CakePHP


Without doing anything, browsing the newly installed cakephp using http://localhost/cakephp/ IIS will throw and error “HTTP Error 403.14 – Forbidden see figure 1.0. The Web server is configured to not list the contents of this directory”. IIS would then suggest enabling the directory listing in IIS server. But this is misleading; enabling the IIS will just display the files figure 1.1. Also, if you didn’t configure IIS to grant read/write access to the cakephp folder it will throw error indicating that it was unable to write cakephp to file cache. This is error is somewhat related to mod_rewrite. IIS worker (in my case the IIS_IUSRS user) running should have the proper read/write access to the files see Figure 1.2 and Figure 1.3


Addressing the issue on mod_rewrite


Addressing the issues on mod_rewrite is quite easy and straight forward. We just need to grant IIS_IUSRS read write access to the cakephp files.


1. Open the IIS Manager by typing inetmgr.


2. Browse to cakephp folder.


3. In action pane select edit permission


4. Select Security tab


5. Select IIS_IUSRS and click Edit button


6. Under Allow check the full control and modify.


a. This will grant the IIS_IUSR the proper read write access to the .http header or in ISS the web.config files and to all the files inside cakephp folder.


Configure the cakephp web.config file


Cakephp by default is configured to run on APACHE web server out of the box. Thus, we need to configure cakephp to run under IIS. We can do this by creating a web.config file. This special file needs to be created in order for the IIS to know what files should be fired during loading. We can copy the web.config file from cakephpcookbook or we will let the IIS do it for us by importing the .htaccess file provided by the cakephp using the URL Rewrite module in IIS. If you don’t have the module you need to download and install it. You may use the web platform for easy installation.


Importing the .htaccess to IIS


1. Open the IIS manager by typing inetmgr.exe and press enter key


2. Browse to cakephp file


3. Click URL Rewrite


4. In the action pane Click Import Rules


5. Click the import button


6. Browse to the cakephp folder and Select the .htaccess


7. Click Apply button in the action pane


8. We need to repeatsteps 4-7 for the following files c:\inetpub\www\cakephp\app\.htaccess and c:\inetpub\www\cakephp\app\webroot\.htaccess


9. IIS imported 5 rules for us.


10. Now you can see a web.config file in c:\inetpub\www\cakephp\


Edit it in any text editor to resemble something like this. Alternately you can use this one.


cakephp web.config

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
      <rewrite>
        <rules>
          <rule name="Redirect static resources" stopProcessing="true">
            <match url="^(ico|img|css|files|js)(.*)$" />
<action type="Rewrite" url="app/webroot/{R:1}{R:2}" appendQueryString="false" />
          </rule>
          <rule name="Imported Rule 1" stopProcessing="true">
            <match url="^(.*)$" ignoreCase="false" />
            <conditions logicalGrouping="MatchAll">
              <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
              <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            </conditions>
            <action type="Rewrite" url="index.php?url={R:1}" appendQueryString="true" />
          </rule>
          <rule name="Imported Rule 2" stopProcessing="true">
            <match url="^$" ignoreCase="false" />
            <action type="Rewrite" url="/" />
          </rule>
          <rule name="Imported Rule 3" stopProcessing="true">
            <match url="(.*)" ignoreCase="false" />
            <action type="Rewrite" url="/{R:1}" />
          </rule>
          <rule name="Imported Rule 4" stopProcessing="true">
            <match url="^(.*)$" ignoreCase="false" />
            <conditions logicalGrouping="MatchAll">
              <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
              <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            </conditions>
            <action type="Rewrite" url="index.php?url={R:1}" appendQueryString="true" />
          </rule>
        </rules>
      </rewrite>
    </system.webServer>
</configuration>

Comments

    0 of 8192 characters used
    Post Comment

    • profile image

      Benjamin Gryson 4 years ago

      Hi,

      thanks for this tutorial, it worked for me.

      However, I had to do 1 additional thing in IIS: I had to set index.php as my default document. So if you have encounter "HTTP-error 403.14 - Forbidden", then go into IIS, double click on your website, and select default document. If index.php is not in the list, add it to the list.

      Kr,

      Benjamin

    • profile image

      Stas 4 years ago

      I use free PHP IDE Codelobster - http://www.codelobster.com

      with special Smarty plug-in

    Click to Rate This Article