使用Devilbox创建你的第一个项目：详细指南

前言

Devilbox是一个功能强大的Docker化开发环境，它集成了PHP、MySQL、Nginx/Apache等常用开发工具。本文将详细介绍如何在Devilbox中创建并配置你的第一个项目。

准备工作

在开始之前，请确保你已经：

1. 成功安装并启动了Devilbox环境
2. 熟悉Devilbox的基本目录结构
3. 了解如何访问Devilbox的内网管理界面

第一步：访问虚拟主机管理页面

首先打开浏览器，访问Devilbox的内网管理界面中的虚拟主机页面：

http://localhost/vhosts.php

或者

http://127.0.0.1/vhosts.php

这个页面会显示当前所有的项目配置状态，初始状态下应该是空的。

第二步：创建项目目录

1. 进入你的Devilbox项目目录
2. 导航到./data/www路径下
3. 创建一个新的项目目录（例如project-1）

# 进入Devilbox目录
cd path/to/devilbox

# 进入www目录
cd data/www

# 创建项目目录
mkdir project-1

重要提示：目录名称将成为项目URL的一部分，因此请谨慎选择。

第三步：创建文档根目录

每个项目都需要一个htdocs目录作为文档根目录：

# 进入刚创建的项目目录
cd project-1

# 创建htdocs目录
mkdir htdocs

此时刷新虚拟主机管理页面，你会看到系统已经检测到了新项目，但提示缺少DNS记录。

第四步：配置本地DNS记录

为了使项目URL可访问，需要在本地DNS配置文件中添加记录：

1. 打开系统hosts文件（Linux/Mac在/etc/hosts，Windows在C:\Windows\System32\drivers\etc\hosts）
2. 添加以下内容：

127.0.0.1 project-1.loc

注意：project-1应替换为你实际使用的项目目录名。

第五步：访问你的项目

现在你可以通过以下URL访问你的项目：

http://project-1.loc

首次访问时，你会看到一个空白页面或404错误，这是因为我们还没有添加任何内容。

第六步：创建示例文件

在项目的htdocs目录下创建一个简单的PHP文件：

# 进入项目文档根目录
cd path/to/devilbox/data/www/project-1/htdocs

# 创建index.php文件
echo "<?php echo 'hello world';" > index.php

或者手动创建index.php文件，内容为：

<?php echo 'hello world';

刷新浏览器，现在你应该能看到"hello world"的输出。

项目配置检查清单

完成项目创建后，请确认以下内容：

1. 项目目录已创建（data/www/project-1）
2. 文档根目录已创建（data/www/project-1/htdocs）
3. 本地DNS配置文件已添加记录
4. 项目文件已放入文档根目录

高级应用

Devilbox支持各种PHP框架和CMS系统，包括但不限于：

• Laravel
• Symfony
• WordPress
• Drupal
• Magento
• Yii
• Zend Framework

每个框架在Devilbox中都有特定的配置方式，但基本流程与上述步骤类似。

常见问题解决

如果遇到问题，可以检查以下方面：

1. Docker容器是否正常运行
2. 项目目录结构是否正确
3. DNS配置修改是否生效
4. 文件权限是否正确

通过以上步骤，你应该已经成功在Devilbox中创建并运行了第一个项目。Devilbox的强大之处在于它为开发者提供了一个标准化、可复制的开发环境，大大简化了项目配置和环境搭建的过程。