phpBB
phpBB is open-source bulletin board software, an internet forum package, that runs on 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 sqlite - embedded sql database |
vhosts
|
Add support for installing web-based applications into a virtual-hosting environment |
zlib
|
Add support for zlib 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
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.APACHE2_OPTS="... -D PHP"
Creating a database
Refer to MySQL/Startup 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.
The forum will be accessible to administrators only, until the
install
directory is removed from the root directory of the phpBB install.