README

Qaton App - 由 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，您可以从 https://github.com/aspvirx/qatonapp/archive/refs/heads/master.zip 下载此仓库的 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 来查看 Web 应用程序（如果更改了端口号，请在此处应用更改。例如，https://:9999）

方法 2：使用 Composer 快速安装

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

使用composer创建一个PHP项目

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获取详细文档