创建项目

在本指南中，我们将提供 Docker 和本地安装所有内容的内置开发服务器的命令。

NOTE

如果你想使用其他 Web 服务器， 请参阅 "配置 Web 服务器"。

我们建议从项目模板开始，这是一个实现了一些基本功能的最小可工作的 Yii 项目。它可以作为你项目的良好起点。

你可以使用 Composer 包管理器从模板创建一个新项目：

composer create-project yiisoft/app your_project

Docker 用户可以运行以下命令：

docker run --rm -it -v "$(pwd):/app" --user $(id -u):$(id -g) composer/composer create-project yiisoft/app your_project
sudo chown -R $(id -u):$(id -g) your_project
cd your_project
make composer update

如果你想要开发版本而不是发布版本：

git clone https://github.com/yiisoft/app.git --depth 1 your_project && \
cd your_project && \
rm -rf .git && \
make composer update

这将在名为 your_project 的目录中安装最新稳定版本的 Yii 项目模板。如果你愿意，可以选择不同的目录名称。

TIP

如果你想安装最新的 Yii 开发版本，可以在命令中添加 --stability=dev。 不要在生产环境中使用 Yii 的开发版本，因为它可能会破坏你正在运行的代码。

进入新创建的目录并运行：

APP_ENV=dev ./yii serve --port=80

对于 Windows 命令提示符用户，运行：

set APP_ENV=dev
yii serve --port=80

对于 Windows PowerShell 用户，运行：

$env:APP_ENV = "dev"
.\yii serve --port=80

对于 Docker 用户，运行：

make up

在浏览器中打开 URL http://localhost/。

NOTE

HTTP 服务器监听 80 端口。如果该端口已被占用，请通过 --port 指定端口，或者在 Docker 的情况下， 在 docker/.env 文件中设置 DEV_PORT。