Changes

From SME Server
Jump to navigationJump to search
3,596 bytes added ,  13:06, 29 January 2009
New page: {{Languages}} ===Maintainer=== [http://www.david-harper.com/ David Harper] (current maintainer) [http://sme.firewall-services.com Firewall Services] (original contrib) ===Description=== ...
{{Languages}}
===Maintainer===
[http://www.david-harper.com/ David Harper] (current maintainer)

[http://sme.firewall-services.com Firewall Services] (original contrib)

===Description===
This contrib allows you to install PHP version 5 alongside PHP version 4, which is the default in SME Server 7.x. Unlike a full upgrade to PHP5, installation of this contrib will not affect your ability to install future updates to SME Server 7.x. PHP 4 remains the default version.

{{Warning box|This is a beta-quality release. Beware. For non-production testing only.}}

===Installation===
Firstly, download the integration RPM and the PHP packages Zip file:

wget http://sme.david-harper.com/data/smeserver-php5-cgi-1.0-2.noarch.rpm
wget http://sme.david-harper.com/data/php5-cgi.zip

Next, unzip the PHP5 archive:

unzip php5-cgi.zip

Then install the packages:

yum localinstall smeserver-php5-cgi*.rpm php5-cgi*.rpm
signal-event post-upgrade ; signal-event reboot

====Upgrade====
To upgrade from Firewall Services' earlier release, you must do as follows:

1. Delete ALL custom templates created while following the earlier [http://sme.firewall-services.com/spip.php?article46 Firewall Services howto].

{{Note box|The structure of the contrib has changed since the Firewall Services howto was written; be sure to delete ALL old custom templates.}}

2. Install the updated contrib as above.

3. Follow the instructions below to enable PHP5 for your web applications.

===Usage===
PHP5 can be used in Ibays and for contribs that are installed in /opt.

====For Ibays====
To configure an Ibay to use PHP 5, run the following commands from the shell:

db accounts setprop [ibayname] php5 yes
signal-event ibay-modify [ibayname]

To return to the default version of PHP, run the following command from the shell:

db accounts setprop [ibayname] php5 no
signal-event ibay-modify [ibayname]

====For contribs====
Web applications that are installed in /opt can also be configured to use PHP5. Ideally, application packagers should update their integration RPMs to depend on smeserver-php5-cgi and deploy a new template fragment, but if you wish, you can also configure PHP5 manually.

{{Note box|The structure of the contrib has changed from eariler releases; be sure to delete ALL old custom templates.}}

First, create a custom template:

mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/
pico /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/90[MyAppName]

Next, put the following lines in the new file:

<Directory /opt/[myapp]>
AddHandler php5-cgi .php
Action php5-cgi /php5-cgi/php-cgi
</Directory>

Save and exit (CTRL-O, CTRL-X), and then expand the web server's configuration template:

expand-template /etc/httpd/conf/httpd.conf

Before you apply the changes, be sure to check that there is no error in the new configuration file:

httpd -t

If this command returns ’Syntax OK’, you can restart the web server:

svc -t /service/httpd-e-smith

===Options===
You can fine-tune PHP5 using the e-smith configuration database. To keep things simple, PHP5 inherits the same settings as PHP4. To modify a property, issue the following commands from the SME Server shell:

db configuration setprop php [property] [value]
expand-template /etc/php5/php.ini

Note that any changes will also affect PHP4. To apply the changes to PHP4 immediately, run:

expand-template /etc/php.ini

===Bugs===
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}.

[[Category: Contrib]]
[[Category: Webapps]]

Navigation menu