🛠 ZTeraDB Troubleshooting Guide

If you see errors like:

Connection failed
Invalid configuration
FilterCondition error
PHP Fatal error: Class not found
Could not connect to host

This guide will help you fix them quickly.

---

🔑 1. Configuration Errors

❌ Error:

Missing or invalid client_key / access_key / secret_key

✔ Fix:

Make sure your .env contains all required fields:

CLIENT_KEY=your-client-key
ACCESS_KEY=your-access-key
SECRET_KEY=your-secret-key
DATABASE_ID=your-database-id

ZTERADB_HOST=db1.zteradb.com
ZTERADB_PORT=7777

And load them correctly:

getenv('CLIENT_KEY');

---

❌ Error:

Invalid value for env

✔ Allowed values:

dev
staging
qa
prod

---

🌍 2. Connection Errors

❌ Error:

Connection refused

✔ Fix:

• Check host
  Should be something like:
  db1.zteradb.com
• Check port
  Usually: 7777
• Ensure WiFi / VPN / Firewall is not blocking outbound TCP

---

❌ Error:

Connection timeout (ETIMEDOUT)

✔ Fix:

• Retry
• Ensure server is reachable
• Try simple curl test

  curl http://db1.zteradb.com:7777

---

📦 3. Class / Import Errors

❌ Error:

PHP Fatal error: Class "ZTeraDB\Config\ZTeraDBConfig" not found

✔ Fix:

Run:

composer dump-autoload

Ensure autoload is included:

require_once "vendor/autoload.php";

---

🧱 4. Query Errors

❌ Error:

Missing query type: select / insert / update / delete

✔ Fix:

(new ZTeraDBQuery("user"))->select();

---

❌ Error:

Fields are required for INSERT or UPDATE

✔ Fix:

$query->insert()->fields(['email' => 'test@test.com']);

---

🔍 5. FilterCondition Errors

❌ Error:

Invalid parameters passed to ZTMUL

✔ Fix: Always pass arrays:

ZTMUL(['price', 'quantity']);

---

❌ Error:

Invalid filter: expected array

✔ Fix:

ZTAND([$condition1, $condition2]);

---

🧪 7. Debugging Tips

✔ Tip 1 — Print Raw Query

echo $query->generate();

✔ Tip 2 — Try a Simple Query

(new ZTeraDBQuery("user"))->select();

✔ Tip 3 — Re-check Keys

Most errors come from wrong credentials.

---

🆘 If Still Not Working

Share the error message, and We’ll fix it immediately.

---