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, 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
mysqli Add support for the improved mySQL libraries
vhosts Add support for installing web-based applications into a virtual-hosting environment

Especially important is to enable PHP support for www-servers/apache by installing dev-lang/php with the apache2 USE-flag, as well as to enable database support via the mysql USE-flag.

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/Startup Guide for detailed instructions.

root #/etc/init.d/mysql start
root #mysql -u root -p
mysql> CREATE DATABASE IF NOT EXISTS <database name> 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 phpbb.* TO 'phpbb'@'localhost' IDENTIFIED BY '<password>';
mysql> quit

Completing the phpBB install

root #/etc/init.d/apache2 start

Browsing to http://localhost/phpBB (https for SSL installs) should now bring up the phpBB introduction page with overview and install tabs, which will guide through the rest of the installation process (assuming the package is installed under /var/www/localhost/htdocs/phpBB).

Important
The forum will be accessible to administrators only, until the /var/www/localhost/htdocs/phpBB/install directory is removed or renamed (provided that the package lives under /var/www/localhost/htdocs/phpBB.