README

Qaton 应用 - 由 VirX Qaton，Elemental PHP MVC 框架驱动

需求

• PHP7.4+

入门指南（仅限开发使用）

以下是一些快速入门的方法，但请注意，这些方法**不推荐**用于生产环境。请访问 http://qaton.virx.net 获取详细文档。

方法 1：使用 Git 和 Docker 快速开始

如果您经验很少，并且没有配置 PHP 或服务器的开发环境，请使用此方法。

• 使用 git clone https://github.com/virxnet/qatonapp.git 或您喜欢的 Git 管理工具克隆 qatonapp 仓库。或者，如果您未安装 Git，可以下载此仓库的 ZIP 文件 https://github.com/aspvirx/qatonapp/archive/refs/heads/master.zip 并将其提取到您的计算机上的某个位置。

• 进入项目目录（例如：cd qatonapp）。

• 如果您计划为该项目使用自己的版本控制仓库，建议删除 .git 目录。建议学习更多关于 Git 的知识。

• 为您的操作系统安装 Docker Desktop/Engine。安装后，通过启动桌面或命令行应用程序确保其正在运行。

注意：如果您有其他解决方案或更喜欢直接从主机环境使用 PHP，则无需使用 Docker。在这种情况下，方法 2 可能更适合您。

• 为位于项目根目录的 qaton 文件提供可执行权限。该文件期望使用 BASH 执行。如果您在 Linux 或 Mac 上，只要您已授予其执行权限，它将运行得很好。为此，打开终端，确保您处于同一目录，然后运行

chmod +x qaton

注意：如果您使用的是 Microsoft Windows，则需要设置 Microsoft WSL2。同时，请检查 Docker WSL2 文档 以了解 Docker 的要求。

• 使用 BASH 终端，执行 Qaton 开发助手以在默认端口 8888 上安装和启动容器

./qaton start

或者，如果您希望指定不同的端口，请编辑 qaton.env 文件或运行 qaton（将 [PortNumber] 替换为所需的端口号）

./qaton serve [PortNumber]

示例

./qaton serve 9999

注意：如果上述命令失败，请尝试运行 bash qaton。

• 如果成功，设置过程完成后，您应该会进入开发环境。现在您可以在任何时候键入 qpm 以访问 Qaton 项目管理工具并运行开发命令。

• 在您的主机计算机上，您应该能够通过互联网浏览器（如 Firefox、Google Chrome 等）访问 https://:8888 来查看网络应用程序（如果您更改了端口号，请在这里应用。例如，https://:9999）

方法 2：使用 Composer 快速安装

如果您的开发环境已经安装并满足最低要求，请使用此方法。本质上，需要配置正确的Web服务器（例如Apache2/nginx），并启用URL重写（Apache2的mod_rewrite），使所有请求都指向public/index.php。正确的PHP版本（包含所需扩展）、Packgist的composer等，系统上也应该都可用。

使用PHP composer 创建项目

composer create-project virx/qatonapp:"dev-master" [项目目录] --remove-vcs

设置正确的权限

cd [ProjectDir]
chmod +x qaton
chmod +x qpm

开始开发

有两种快速开始开发的方法。最快的方法是使用 Docker Desktop/Engine。如果您使用composer（方法2）开始项目但仍想使用Docker，可以按照方法1中的说明进行操作，只需跳过第一步（git clone/zip下载）。否则，如果您的环境已经正确设置，那么您现在应该已经可以开始开发了。如果遇到任何问题，请考虑以下故障排除提示

• 您的Web服务器的文档根已经正确指向public目录
• 您已启用URL重写，使所有内容都指向index.php文件
• PHP是正确的版本且已正确配置
• 您已为qpm和qaton设置了正确的权限

Qaton项目管理器 qpm

在您的BASH终端窗口中输入qpm以查看您的开发选项。

了解更多

请访问http://qaton.virx.net以获取详细文档