Requirements page

General discussion of development ideas and the approaches taken in the 3.x branch of phpBB. The next feature release of phpBB 3 will be 3.2/Rhea followed by 3.3.
Forum rules
Please do not post support questions regarding installing, updating, or upgrading phpBB 3.1. If you need support for phpBB 3.1 please visit the 3.1.x Support Forum on phpbb.com.

If you have questions regarding writing extensions please post in Extension Writers Discussion to receive proper guidance from our staff and community.
bolverk
I've been banned
Posts: 280
Joined: Mon Feb 02, 2009 5:39 pm

Requirements page

Post by bolverk » Fri Dec 18, 2009 2:32 am

PhpBB4/Requirements
From phpBB Development Wiki
< PhpBB4
Jump to: navigation , search
Software Requirements

These requirements will have to be met by the server that shall run phpBB4.

* PHP >= 5.3.0 thus SPL is always available.
I think you should restructure that page and also rename it to Dependencies & System Requirements this will allow for not only a listing of the applications needed to support phpbb but also allow you to define a minimum baseline as far as system environment variables which you currently do not provide. What I mean by environment variables is a baseline of the minimum system requirements for phpBB to execute, things like PHP memory limit, execution times etc, along with any module dependencies. One of my biggest pet peeves with version 3 is that I do not believe your installation requirement checks go far enough in that they allow a user to actually install the application into an environment that really cannot support an active board and allow all the basic functionality to be utilized. Setting the expectation up front for the minimum system requirements for the application to fully function without error or exceeding a *minimum* resource allocation is more important than allowing the application to install successfully only to disappoint after the fact with resource usage issues.

User avatar
naderman
Product Manager
Product Manager
Posts: 1727
Joined: Sun Jan 11, 2004 2:11 am
Location: Karlsruhe, Germany
Contact:

Re: Requirements page

Post by naderman » Fri Dec 18, 2009 2:24 pm

Sounds very good, so please change it :)

bolverk
I've been banned
Posts: 280
Joined: Mon Feb 02, 2009 5:39 pm

Re: Requirements page

Post by bolverk » Sat Dec 19, 2009 5:09 am

Yeah...sure. You have a list of supported web servers/appliances, at least ones that Rhea will be tested and supported under?

Apache
IIS version 7+ ?
Nginx
Litespeed
Cherokee
lighttpd

What about backends? At a minimum the current ones with the possibility of upping the existing version requirements?

MySQL
MSSQL
Oracle
PostgreSQL
SQLite
Firebird
DB2
Last edited by bolverk on Sat Dec 19, 2009 5:21 am, edited 1 time in total.

User avatar
naderman
Product Manager
Product Manager
Posts: 1727
Joined: Sun Jan 11, 2004 2:11 am
Location: Karlsruhe, Germany
Contact:

Re: Requirements page

Post by naderman » Sat Dec 19, 2009 5:16 am

The list of databases looks good, I'd add DB2 (planned for 3.1 too). As for webservers I'd say at least IIS, Apache and lighttpd. I can't even tell which webservers phpBB3 is tested on at all. As it's in the wiki I'd say we put in something for a start (maybe even with a remark like "perhaps") and then edit it once we have a clearer idea.

bolverk
I've been banned
Posts: 280
Joined: Mon Feb 02, 2009 5:39 pm

Re: Requirements page

Post by bolverk » Sat Dec 19, 2009 5:27 am

The web servers should *theoretically* be transparent but it's always good to define the ones the application has been tested/benchmarked on and hopefully supported under. I know in support there was a growing number of Litespeed & Cherokee installs that I happened across while helping users and of course the ever present and growing IIS market share.

**edit**
naderman wrote:As it's in the wiki I'd say we put in something for a start (maybe even with a remark like "perhaps") and then edit it once we have a clearer idea.
What do you think of using italics as the formatting convention for any tentative content, things that are still under review or discussion? So instead of remarking "perhaps" the italicized content would indicate the status as preliminary rather than defined.

User avatar
ToonArmy
Registered User
Posts: 335
Joined: Fri Mar 26, 2004 7:31 pm
Location: Bristol, UK
Contact:

Re: Requirements page

Post by ToonArmy » Sun Dec 20, 2009 2:20 am

Chris SmithBlogXMOOhlohArea51WikiNo support via PM/IM
Image

code reader
Registered User
Posts: 653
Joined: Wed Sep 21, 2005 3:01 pm

Re: Requirements page

Post by code reader » Sun Dec 20, 2009 4:12 pm

IMHO, this kind of page is more suitable as a "Tested with" or "Known to work with" than requirements.
a php-based app does not "Support" specific web-servers.
the web servers, if they support PHP, are supposed to be compatible with *any* php application (with the regular stipulations of availability of specific php modules, available memory etc.)
more suitable for "requirements" would me, IMO, a list of required php library such as

php-mysqlInd (to work with Mysql), php-postgresql (to work with PosstgreSQL)
this is of limited value for libraries which are installed by default by most or all distros, and becomes more important when some feature needs more esoteric support.


peace.

bolverk
I've been banned
Posts: 280
Joined: Mon Feb 02, 2009 5:39 pm

Re: Requirements page

Post by bolverk » Sun Dec 20, 2009 6:03 pm

code reader wrote:IMHO, this kind of page is more suitable as a "Tested with" or "Known to work with" than requirements.
As a Project Manager myself for a Fortune 500 company here in the United States I have spent almost 10 years in professional software development and not a single (out of dozens) software project I've worked on in the last decade has ever NOT specified the pre-requisite environment system dependencies an application is developed to run under. Such dependencies are most definitely requirements that belong in the SRS and they are the very foundation for validation and test documentation developed further into the development cycle, which will trace back directly to the initial requirement specification. It is important to be clear that the goal is to develop an application that will install and run equally well on any specified web server environment, with no application component or design favoring one web server environment over another. Today with version 3.x that is not the case, hopefully Rhea will bring real transparency to the end user in this regard.

code reader
Registered User
Posts: 653
Joined: Wed Sep 21, 2005 3:01 pm

Re: Requirements page

Post by code reader » Sun Dec 20, 2009 7:07 pm

kudos for your credentials.
this aside, i am not challenging the need for a "requirements" page, i just doubt that things like the http server belong there, IOW, i do not think the *current* list at http://wiki.phpbb.com/PhpBB4/Requirements (as it exist at the time of writing this: it's a wiki, so it can change at any minute...) makes sense.

much more suitable would be something like:
PHP version X or higher, with at least Y memory available.
DB engine: *one* of the following:
Mysql version X
postgress version Y
...

with the appropriate php library to support it.

graphic library X

etc.

in addition, specific features (such as certain version of captcha) can and should list any additional requirements if they need to.

however, a list of servers is more appropriate as "tested with" than a requirement. a sever that does not appear in the "requirements" list may or may not work well with phpbb, so a server in the list is not "required", it is just that a server outside the list of "tested with" was not yet reported as being compatible.

peace.

bolverk
I've been banned
Posts: 280
Joined: Mon Feb 02, 2009 5:39 pm

Re: Requirements page

Post by bolverk » Sun Dec 20, 2009 7:33 pm

code reader wrote:this aside, i am not challenging the need for a "requirements" page, i just doubt that things like the http server belong there, IOW, i do not think the *current* list at http://wiki.phpbb.com/PhpBB4/Requirements (as it exist at the time of writing this: it's a wiki, so it can change at any minute...) makes sense.
Then I can only assume you do not have the underlying skill set and background in software development process that would allow it to *make sense* to you. Regardless of it's making sense to you, it is in fact an industry standard and I explained exactly why along with the two-fold value it adds by being defined as such. What part of my previous explanation are you having difficultly with? Or did you not even read it?
code reader wrote:much more suitable would be something like:<snipped>
Those details have in fact been mentioned in both my first and second post and will be included in the new section, Dependencies & System Requirements, which is just a subset of the overall Requirements. Did you read any of this topic before you replied?
1st post:
narqelion wrote: I think you should restructure that page and also rename it to Dependencies & System Requirements this will allow for not only a listing of the applications needed to support phpbb but also allow you to define a minimum baseline as far as system environment variables which you currently do not provide. What I mean by environment variables is a baseline of the minimum system requirements for phpBB to execute, things like PHP memory limit, execution times etc, along with any module dependencies.
2nd post:
narqelion wrote:What about backends? At a minimum the current ones with the possibility of upping the existing version requirements?

MySQL
MSSQL
Oracle
PostgreSQL
SQLite
Firebird
DB2

Post Reply