feat: implement user guide documentation in multiple languages and add IPC infrastructure for UI components

2026-04-02 17:16:52 +03:00
parent baf1739f6d
commit 0a67fda211
32 changed files with 1594 additions and 9 deletions
@@ -0,0 +1,46 @@
+# Troubleshooting & Frequently Asked Questions
+
+Common issues you might encounter while using Multi-PHP and how to fix them.
+
+---
+
+## 🚫 Service Fails to Start
+
+This is often caused by **port conflicts** with other software.
+
+- **Nginx & Apache (Port 80/443)**: Check if Skype, IIS, or another XAMPP/WAMP environment is running and using Port 80.
+- **MariaDB (Port 3306)**: Check if you have an existing MySQL or MariaDB installation running.
+- **Solution**: Go to `Settings > General` and change the conflicting port to something else (e.g., Change Nginx to 8080 or MariaDB to 3307).
+
+---
+
+## ❌ PHP Error: "No input file specified"
+
+This usually means Nginx or Apache cannot find your project's PHP files.
+
+- **Verify Project Path**: Check if the project path in "My Projects" is correct.
+- **Trailing Slash**: Ensure your project path doesn't end with an extra trailing slash unless necessary.
+- **Restart Services**: Try stopping all services and starting them again.
+
+---
+
+## 🔒 403 Forbidden Access
+
+Permissions or configuration issues can block access to your local site.
+
+- **Index File Missing**: Ensure your project folder contains an `index.php` or `index.html`.
+- **Nginx Config**: If using Nginx, check the project-specific configuration for any manual `deny` rules.
+- **Directory Indexing**: By default, Multi-PHP allows directory indexing. If it's blocked, you must have an index file.
+
+---
+
+## 💻 CLI Commands (php, mysql) Not Working
+
+- **PATH Not Updated**: You must click "Sync Commands" in the CLI settings.
+- **Terminal Window**: Close and reopen your terminal (CMD, PowerShell) for the changes to take effect.
+- **Check Integration**: Ensure the "System PATH Integration" toggle is ON.
+
+---
+
+> [!TIP]
+> If you're still having trouble, check the **"Service Logs"** for detailed error messages from the PHP, Nginx, or MariaDB binaries.