PhpBB - Gentoo Wiki

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
`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 sqlite - embedded sql database
`vhosts`	Add support for installing web-based applications into a virtual-hosting environment
`zlib`	Add support for zlib compression

Data provided by the Gentoo Package Database · Last update: 2025-01-09 23:27 More information about USE flags

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.