Revision as of 21:37, 26 August 2012

phpBB 3.1, codename Ascraeus, is the next major feature release in the phpBB 3.x line.

Requirements

Most of the system requirements are the same as 3.0.x. The most notable change is that PHP >= 5.3.2 is now required. Newer versions of PostgreSQL, SQLite, and MySQL are pending discussion[1].

Request for Comments

The set of features that were proposed for phpBB 3.1 can be found here: Request for Comments

Composer

In order to use phpBB 3.1 in development, you need to run Composer[2] from within the phpBB directory. This will install some external PHP library dependencies. See the README[3] "installing dependencies" section for more instructions.

Moving from 3.0 to 3.1

Styles and template engine changes 3.1

If you replace the files of your style with 3.1 compatible ones, before running the database update from 3.0 to 3.1, these styles will stay installed.

Template Engine Changes in 3.1

Working with the new config class

The new config class

Search Backends

Search backend classes must follow the new naming convention so a backend in includes/search/foobar.php has to contain a class called phpbb_search_foobar and must implement a get_name() method returning the name to be displayed in the ACP.

phpbb_ Class Prefix

Some classes have been renamed to avoid conflicts with other software. If you are referencing the name of any of these classes, you will have to change them:

• session => phpbb_session
• user => phpbb_user
• auth => phpbb_auth

Permissions Removed

Several unused or unnecessary permissions are no longer present in phpBB Ascraeus [4].

JavaScript onload_functions changed

The onload_functions array allows calling certain JavaScript functions on page load. It used to take a string to be evaluated, now it takes the actual JavaScript function.

Before:

onload_functions.push('do_something()');

After:

onload_functions.push(do_something);

Changes to Functions

• phpBB/includes/functions_install.php
  • The array returned by get_available_dbms() no longer contains COMMENTS keys. See PHPBB3-10969.
  • Function remove_remarks(&$sql) was removed. Use phpbb_remove_comments($input) instead. See PHPBB3-10969.

• phpBB/includes/functions_admin.php
  • Function remove_comments(&$output) was removed. Use phpbb_remove_comments($input) from phpBB/includes/functions_install.php instead. See PHPBB3-10969.

• phpBB/includes/functions.php
  • Function generate_pagination($base_url, $num_items, $per_page, $start_item, $add_prevnext_text = false, $tpl_prefix = ) was removed. Use phpbb_generate_template_pagination($template, $base_url, $block_var_name, $num_items, $per_page, $start_item = 1, $reverse_count = false, $ignore_on_page = false) instead. See PHPBB3-10968.
  • Function on_page($num_items, $per_page, $start) was removed. Use phpbb_on_page($template, $user, $num_items, $per_page, $start) instead.

• phpBB/includes/functions_display.php
  • Function topic_generate_pagination($replies, $url) was removed. Use phpbb_generate_template_pagination($template, $base_url, $block_var_name, $num_items, $per_page, $start_item = 1, $reverse_count = false, $ignore_on_page = false) instead. See PHPBB3-10968.