Development

Note: instructions for setting up phpBB as a WebSphere sMash application are being kept up-to-date on our development wiki at http://www.projectzero.org/wiki/bin/view/Development/DevphpBB. Below is the original blog post with instructions from Milestone 4.

Following on from Rob’s blog about running phpBB as a Project Zero application under Eclipse, I thought it would be interesting to show how straightforwards it is to get phpBB running using the Zero command line.Follow the instructions to install Project Zero CLI. Make sure you point to latest repository http://www.projectzero.org/update/zero.eclipse.php.latest/ rather than a milestone repository.

• Create a new Zero PHP project called e.g. phpBB, by running “zero create phpBB -template zero:zero.php.application.template“
• Get PhpBB version 3.0 and unzip it into the public directory of this new project so that in the public directory there are directories such as “adm” and “includes” (You may need to remove a level of directory heirarchy to achieve this.)
• Download and set up Mysql Community Edition 5.1 and create a database for use by phpBB.
• We need to add the mysql database connector to the project. This is available in Maven so simply add the following line to config/ivy.xml :

      <dependency name="mysql-connector-java" org="mysql" rev="5.1+"/>

• Ensure that the following extensions exist (uncommented) in php.ini:

extension=php_calendar
extension=php_ctype
extension=php_zlib
extension=php_pcre
extension=php_ldap
extension=php_hash
extension=php_xml
extension=php_gd
extension=php_iconv
extension=php_standard
extension=php_date
extension = zero.php.JSONExtension
extension = zero.php.NetworkExtension
extension = zero.php.URIUtilsExtension
extension = com.ibm.p8.library.db.MysqlLibrary

• Add public to the php include path in php.ini:

include_path = "<path to project>/public";

• Resolve the project by running “zero resolve” in the application’s home directory
• Start the project by running “zero run” in the application’s home directory
• Browse to the project and work through the installation pages.
• You should be able to accept all of the defaults with the exception of email. We are still working on email support from PHP so you’ll have to disable that during the installation. Do this by setting “Enable board-wide e-mails:” to “disabled” in the email-settings options.

I found this to work equally well on Linux and Windows, but if you find differently please let us know via a bugzilla, or post in the forums. Thanks!

Iain Lewis