Config.php

From TUTOS

config.php is global configuration file for TUTOS.

config_default.pinc is a exmaple file that is always read before reading config.php. So you only have to change things that are different from the defaults and there is no need to copy everything (which will make problems when some usefull defaults are changed). Editing config_default is not a good idea as it will be overwritten whenever you make an update.

The config files currently reside in [tutoshome]/php/ .

Her a list of the main things:

Variables

Database

The next variables are defined for each database

dbname

The name of the database

dbhost

The hostname of the server where the database is running.

dbport

The portnumber where to connect to the database

dbuser

The username to use when connecting and authenticating to the database

dbpasswd

The password for dbuser

dbprefix

A prefix to add in front of each database table name. This allows you to run different TUTOS instances (with different prefixes) in one database.

dbhome

Oracle users need to give the location of the oracle installation to TUTOS.

dbtype

Type of the database

1 = Postgres
2 = MySQL
3 = Oracle
4 = Postgres 7.1
5 = MS SQL (beta)
7 = Interbase
8 = Oracle OCI connection

14 = MySQLi (newer MySQL connector)

cryptpw

Should the database or TUTOS encrypt the passwords of the TUTOS users. 1 = yes , 0 = no

repository

The location of files stored for the TUTOS instance defined here. Please create the directory so that the apache user can access it and is allowed to make subdirectories.

baseurl

This is the url that TUTOS will put into generated links in mails etc. . The URL should point to the top of the installed system like 'http://www.your.org/tutos'

Setup

One time setup variable

sessionpath

Where TUTOS will save the session data. Running on multiple servers/clusters this must be the same for all servers ! Relative path is not allowed here and might not work with some PHP verisons !

NOTE: It is recommended to change this to something that is not readable by everyone !! The Apache Process must have READ/WRITE access on that path

ATTENTION: On Windows Change this to something your system understands !!! Like : $tutos[sessionpath] = "c:\\Temp";


demo

Enable this to run TUTOS in demo mode like http://demo.tutos.de

This will disable sending mail ,disallow to change user passwords and show some limited admin pages.

debug

debug mode will write ddebug output to the file named in $tutos[errlog]. Whenever the debugfile is bigger than 1 Megabyte it will be renamed to $tutos[errlog].YYYYMMDDHHMM

It is up to you to delete old debug files.

Enabling debug will also create a access logfile which will report every page called from TUTOS. The access log file is named $tutos[errlog].log and will also be switche when 1Megabyte size is reached.

currencies

A list of supported currencies

timezones

this is a array of timezone names. Those names should be known to the underlying operating system.

On Linux/Unix it is something like:

  • $tutos[timezones][] = "Europe/London";
  • $tutos[timezones][] = "Europe/Berlin";

On windows you might add entries like

  • $tutos[timezones][] = "EST5EDT";
  • $tutos[timezones][] = "CST6CDT";

authtype

The authentification type we use possible values are

db
ldap
x509
http
pam
google

auth classes are stored in [tutoshome]/php/auth for pam sew $tutos[pamservice] below for ldap see $tutos[ldapauth.... below for x509 read this: Support for X.509v3-Certs (this is alpha) make sure this settings in apache-httpd.conf or .htaccess:

SSLOptions +FakeBasicAuth

needs openssl-support in php in this first version authentification is done by checking .htaccess and FakeBasicAuth in future certs are stored in userdata -> todo
Default is "db" (authentification in the TUTOS database)

pamservice