PhpBB

From Gentoo Wiki
Jump to: navigation, search


Resources

phpBB is open-source bulletin board software, an internet forum package using the PHP scripting language.

Install

Before installing phpBB, it is recommended to peruse the configuration options for Apache/nginx, MariaDB/MySQL, and PHP as well.

Use flags

USE flags for www-apps/phpBB An open-source PHP-based bulletin board package

ftp Add FTP (File Transfer Protocol) support
gd Add support for media-libs/gd (to generate graphics on the fly)
mssql Add support for Microsoft SQL Server database
mysqli Add support for the improved mySQL libraries
postgres Add support for the postgresql database
sqlite Add support for sqliteembedded sql database
vhosts Add support for installing web-based applications into a virtual-hosting environment
zlib Add support for zlib (de)compression

When using Apache, it is important to enable PHP support for www-servers/apache by installing dev-lang/php with the apache2 USE-flag.

For nginx, the fpm flag should be enabled on dev-lang/php.

With MariaDB/MySQL, dev-lang/php will need to have been built with the mysql and mysqli flags enabled.

Emerge

root #emerge --ask www-apps/phpBB

Configuration

Enabling Apache PHP support

Important
With >=app-eselect/eselect-php-0.8.1, the APACHE2_OPTS variable changed to -D PHP instead of -D PHP5. This allows for future major versions to flow smoothly.
FILE /etc/conf.d/apache2Enabling the PHP module
APACHE2_OPTS="... -D PHP"

Creating a database

Refer to MySQL/Guide for detailed instructions.

root #/etc/init.d/mysql start
user $mysql -u root -p
mysql> CREATE DATABASE IF NOT EXISTS <database> DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;
mysql> CREATE USER '<username>'@'localhost' IDENTIFIED BY '<password>';
mysql> GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON <database>.* TO '<username>'@'localhost' IDENTIFIED BY '<password>';
mysql> quit

Completing the phpBB install

Browsing to the root of the install, http://localhost/phpBB for example (https for SSL installs), should now bring up the phpBB introduction web page with an overview and install tabs, which will work as a guide through the rest of the installation process.

Important
The forum will be accessible to administrators only, until the install directory is removed from the root directory of the phpBB install.