In order to get started with phpBB, you'll need a working PHP installation (I'm currently running PHP 4.2.3), a MySQL database server (I'm running MySQL 4.0.10) and a copy of the latest release (currently version 2.0.4) of the package; you can download a copy from http://www.phpbb.com/downloads.php
Setting up the package is pretty simple. The first step is to uncompress the source archive into a directory under your Web server (mine is called "medusa" here) root.
$ tar -xzvf /tmp/phpBB-2.0.4.tar.gz
This should create a directory (named "phpBB2/" for phpBB 2.0.4) which contains the following files:
The next step is to create a database for your phpBB data. Start up the MySQL command-line client, log into the database server, and create a database named "phpbb".
mysql> CREATE DATABASE phpbb;
You can check that the database has been created,
and then log out.
All that's left now is to create the base tables for the application, configure it to talk to the database, and set an administrator password. phpBB makes all this easy to accomplish via a single-click PHP script, which performs all these tasks for you automatically.
Make sure your Web server is running, and point your browser to the "install/install.php" script of your phpBB installation. For example, if the application was installed to the root of the Web server, you would surf to "http://medusa/phpBB2/install/install.php", where you'd see something like this:
This is the initial application configuration screen, which requires you to enter basic information about your system - credentials for the MySQL database, a username and password for the forum administrator, the Web server host name and application location, a prefix for the phpBB database tables and an email address for administrator notifications. Note that this application configuration module allows you to perform both a new install and an upgrade of an existing installation; you should obviously pick the former in this case.
Once you've entered all the required data, submit the form, and the installation script will go to work creating the tables for you. On successful completion, you should see a screen with the following message.
You can verify that the tables have indeed been created by going back to the MySQL command line and checking for yourself.
mysql> SHOW TABLES;
All there? Good. Before you get into actually configuring your forum for use, there is one more thing you need to do - delete the "install/" and "contrib/" directories from the main application directory.
$ rm -rf /usr/local/apache/htdocs/phpBB2/contrib
Leaving these directories behind opens up a serious security hole in your forum...so serious, in fact, that phpBB will refuse to function if they're present, stubbornly displaying the following error until you delete them:
All done? Flip the page, and let's set some global parameters for the application.
blog comments powered by Disqus