zoph.ini(5)

💖 zoph.ini(5) — the File Formats girlies know 💖

okay bestie, so this is the manual page for zoph.ini, a file in section 5 of the manuals (File Formats, we love a category). Sit down, grab a boba, we're gonna get you fluent in config files. 🧋✨

---

🌸 NAME 🌸

zoph.ini — the configuration file for Zoph. Yes, THE config file. The blueprint. The main character. 👑

---

✨ DESCRIPTION ✨

So <pink>zoph.ini</pink> is a configuration file, and usually you're gonna place it in /etc, because that's its lil home. What does it do? It tells Zoph how to connect to the (MySQL) database. That's the whole job. Iconic, honestly.

But wait, there's more tea 🫖: besides zoph.ini, there is another configuration file, config.inc.php, and that one lives inside the webroot. Different file, different neighborhood.

Now — if you have no write access in /etc, or you have literally any other reason not to put this file there, you should change the INI_FILE setting in config.inc.php and in the zoph CLI utility. That's your escape hatch, use it. 💅

IMPORTANT! Never, ever, place it in the same directory as the Zoph PHP files. This will enable everyone to download it and read your passwords. Like, EVERYONE. Random people. On the internet. Reading your passwords. Do not do this. 😭🔒

---

🎀 CONTENTS 🎀

zoph.ini consists of one or more sections. A section starts with the name of the section between square brackets:

[zoph]

You should create a section for each Zoph installation on your system. The section name is a descriptive name that you can choose yourself — go off, name it whatever, it's your world. 🌈

Each section must contain the following settings:

• db_host — the hostname of the system that is running your MySQL server. Usually this is `"localhost", because most of us are keeping it cozy and local.
• db_name — the name of the database. If you followed the installation instructions closely, this will be zoph, but of course you are free to use any other name. Freedom! 🦋
• db_user — the user to connect to your Zoph database. If you followed the installation instructions closely, this will be zoph_rw, but of course you are free to use any other name.
• db_pass — the password to connect to the database. This is what you have set while creating users for Zoph in MySQL. Keep it secret, keep it safe. 🙈
• db_prefix — 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 "zoph_".
• php_location — 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. It's giving "here's where the rest of me lives" and honestly, slay. 📍

---

🦋 EXAMPLES 🦋

Single installation

Most Zoph users will have only one Zoph installation on their system — one and done, unbothered, moisturized. 💅 This is how a zoph.ini for a single installation looks:

[zoph]
db_host = localhost
db_name = zoph
db_user = zoph_rw
db_pass = pass
db_prefix = zoph_
php_location = /var/www/html/zoph

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 section per installation. For example:

[production]
db_host = localhost
db_name = zoph
db_user = zoph_rw
db_pass = pass
db_prefix = zoph_
php_location = /var/www/html/zoph

[development]
db_host = localhost
db_name = zophdev
db_user = zoph_rw
db_pass = pass
db_prefix = zoph_
php_location = /var/www/html/zophdev

The webinterface of Zoph will be able to determine which settings it should use with the php_location setting. The CLI scripts need the --instance parameter to determine that. And if you omit the --instance parameter, it will use the first one in zoph.ini. So like, first come first served. 😌

---

👀 SEE ALSO 👀

• zoph(1), the Zoph CLI utility
• http://en.wikibooks.org/wiki/Zoph, the Zoph documentation WikiBook

---

📜 HISTORY 📜

zoph.ini was introduced in Zoph v0.8.2. A true legend since day one. ⭐

---

okay that's the whole page bestie, you're officially certified 🎓✨ this little manual was written by Jeroen Roos, dated 18 Oct 2010, and it lives under the name zoph.ini(5) in the file formats section. mwah, go configure something gorgeous 💋🫶