# Virtual Hosts & Project Management

Managing your local PHP projects in Multi-PHP is simple and effective. Our platform automatically handles virtual host configuration for you.

---

## 🏗️ Adding Your First Project

To add a new project, navigate to the **"My Projects"** tab and click on the **"Add New Project"** button.

### Fields to Fill:
- **Project Name**: A descriptive name for your local project.
- **Project Path**: The absolute path to your project folder.
- **Host / Domain**: The local domain to use (e.g., `test-site.local`).
- **PHP Version**: Choose which PHP-FPM version will run this project.
- **MariaDB Version**: Choose the MariaDB version to use (Default: Latest).
- **Server Type**: Decide between **Nginx** (Modern, High-performance) or **Apache** (Supports `.htaccess`).

---

## 🛠️ Managing Projects

Each project in your list has a set of actions:
1. **Browse File System**: Quickly open your project folder.
2. **Open in Browser**: Open your local domain in your default browser.
3. **Configure Server**: Edit specific Nginx/Apache configs just for this project.
4. **Edit Project Settings**: Change PHP version, server type, or project paths.
5. **Delete Project**: Remove it from the list (does not delete files).

---

## 🌐 Automatic Virtual Hosts

Multi-PHP's configuration engine automatically generates the necessary virtual host files for Nginx and Apache. When you start the services, they will be aware of all your local domains.

> [!WARNING]
> You may need to edit your system's **`hosts`** file manually if you are using custom domains like `.local` or `.dev`. Multi-PHP tries its best to manage this, but some system permissions may require manual intervention.

### 📖 Next Steps
- [Configure PHP Versions & Extensions](./php.md)
- [Manage MariaDB Databases](./database.md)
- [System Integration](./settings.md)