.TH "zoph.ini" "5" "18 Oct 2010" "Jeroen Roos" "File Formats"
.SH "NAME"
.LP
zoph.ini \- Configuration file for Zoph
.SH "DESCRIPTION"
\fBzoph.ini\fR is a configuration file, usually placed in /etc, that tells \fBZoph\fR how to connect to the (MySQL) database. Besides zoph.ini, there is another configuration file, \fBconfig.inc.php\fR, which is placed inside the webroot. If you have no write access in /etc or have another reason to not put this file there, you should change the \fBINI_FILE\fR setting in config.inc.php and the 'zoph' CLI utility.

\fBIMPORTANT!\fR
Never, ever, place it in the same directory as the Zoph PHP files. This will enable everyone to download it and read your passwords.
.SH "CONTENTS"
zoph.ini consists of one or more \fIsections\fR. A section starts with the name of the section between square brackets:
.IP
[zoph]
.LP
You should create a section for each Zoph installation on your system. The section name is a descriptive name that you can choose yourself. Each section must contain the following settings:
.IP \fBdb_host\fR
The hostname of the system that is running your MySQL server, usually "\fIlocalhost\fR".
.IP \fBdb_name\fR
The name of the database. If you have followed the installation instructions closely, this will be \fIzoph\fR, but of course you are free to use any other name.
.IP \fBdb_user\fR
The user to connect to your Zoph database. If you have followed the installation instructions closely, this will be zoph_rw, but of course you are free to use any other name.
.IP \fBdb_pass\fR
Password to connect to the database. This is what you have set while creating users for Zoph in MySQL.
.IP \fBdb_prefix\fR
Zoph can prefix all MySQL table names with a prefix string. This is especially useful for people who only have a single database to use and want to use multiple applications on, for example, a shared hosting environment. By default, this is "\fIzoph_\fR".
.IP \fBphp_location\fR
With the php_location setting, you define where the PHP-files for your Zoph installation are located. This is necessary for the Zoph CLI scripts to locate the rest of your Zoph installation.

.SH "EXAMPLES"
.SS "Single installation"
.br
Most Zoph users will have only one Zoph installation on their system. This is how a zoph.ini for a single installation looks:
.IP
[zoph]
.br
db_host = localhost
.br
db_name = zoph
.br
db_user = zoph_rw
.br
db_pass = pass
.br
db_prefix = zoph_
.br
php_location = /var/www/html/zoph
.br
.SS "Multiple installations"
You can have multiple Zoph installations on one system. For example, one for yourself and one for a family member or friend; or, if you are a Zoph developper, a development and a productions environment. If you have more than one Zoph installation, simply create a \fIsection per installation\fR. For example:
.IP
[production]
.br
db_host = localhost
.br
db_name = zoph
.br
db_user = zoph_rw
.br
db_pass = pass
.br
db_prefix = zoph_
.br
php_location = /var/www/html/zoph
.br

.br
[development]
.br
db_host = localhost
.br
db_name = zophdev
.br
db_user = zoph_rw
.br
db_pass = pass
.br
db_prefix = zoph_
.br
php_location = /var/www/html/zophdev
.br
.LP
The webinterface of Zoph will be able to determine which settings it should use with the \fBphp_location\fR setting. The CLI scripts need the \fB--instance\fR parameter to determine that. If you omit the --instance parameter, it will use the first one in zoph.ini.

.SH "SEE ALSO"
zoph(1), the Zoph CLI utility
.br
http://en.wikibooks.org/wiki/Zoph, the Zoph documentation WikiBook
.SH "HISTORY"
\fBzoph.ini\fR was introduced in Zoph v0.8.2.