QloApps 1.7.0 介绍与选型指南

目标：面向需要为中小型酒店/民宿上线自有预订网站与前台管理系统的技术选型者，介绍开源酒店预订与物业管理系统 QloApps 的定位、架构、功能与同类对比，并给出可落地的选型建议。本文档的版本、依赖矩阵、版本节奏数据均在 Ubuntu 22.04 环境（Apache 2.4.52 + PHP 8.1 + MySQL 8.0.46）安装实测通过，版本与社区数据于 2026-10-24 从官方仓库与 shields.io 实查取证。

一、环境信息

本文选型数据采集与功能验证所用的真实环境如下：

• 操作系统：Ubuntu 22.04 LTS（x86_64）
• Web 服务器：Apache 2.4.52（apache2 -v 实测，另兼容 Nginx / Microsoft IIS）
• PHP：8.1.2（php -v 实测，1.7.0 支持 PHP 8.1 至 8.4）
• 数据库：MySQL 8.0.46（SELECT VERSION(); 实测，1.7.0 支持 MySQL 5.7 至 8.4）
• 应用本体：QloApps 1.7.0（源码包 v1.7.0 tag，解压后 115MB，安装后数据库 300 张表（SHOW TABLES 输出 301 行含表头））
• 系统内标识：_PS_VERSION_ = 1.6.1.23（PrestaShop 内核基线）、_QLOAPPS_VERSION_ = 1.7.0.0（应用层版本）
• 版本与社区数据来源：GitHub 仓库 Qloapps/QloApps Releases（releases.atom）、shields.io 徽章，查询日期 2026-10-24

二、软件概述

2.1 一句话定位

QloApps 是一款免费开源的酒店预订与物业管理系统（PMS），由印度软件公司 Webkul 开发维护，用于把酒店业务搬到线上：一个安装包同时提供「面向客人的酒店官网 + 直订引擎」与「面向店员的物业前台管理后台」。

2.2 出身与血统

QloApps 基于成熟的 PHP 电商引擎 PrestaShop 1.6 二次开发（fork）而来。它保留了 PrestaShop 的模块化架构、后台管理框架、多商店与多语言体系，把「商品/购物车/订单」领域模型替换为「房型/预订/订单」的酒店业务模型。因此：

• 代码层面的系统常量同时存在 _PS_VERSION_（内核基线 1.6.1.23）与 _QLOAPPS_VERSION_（应用版本 1.7.0.0），升级与排障时要区分两者；
• PrestaShop 1.6 的模块机制、钩子（Hook）体系、Webservice 框架在 QloApps 中原样可用；
• 防混淆提示：QloApps ≠ PrestaShop 本体。PrestaShop 是通用电商系统，没有房态日历、入住/退房、按晚计价等酒店域逻辑；QloApps 也不能直接装 PrestaShop 的全部电商模块（需要酒店化适配）。二者同源但领域不同。

💡 技术拓展：基于成熟引擎做垂直化 fork 是开源领域常见路线，同类先例如 WordPress（b2/cafelog fork）、Nextcloud（ownCloud fork）。其优势是直接继承插件生态与管理后台成熟度，代价是继承历史包袱——QloApps 至今仍沿用 PrestaShop 1.6 的 PHP 代码风格与 qlo_ 表前缀的 MySQL 直连模式（无 ORM 迁移），这是评估二次开发成本时要计入的。QloApps 是本文选型对象，因其专精酒店领域而入选。

2.3 基本信息速览

三、核心架构

3.1 架构总览

QloApps 是典型的单体 LAMP 应用，一台服务器即可承载全部组件：

浏览器（客人 / 前台店员）
   │  HTTP/HTTPS
   ▼
Web 服务器（Apache/Nginx，PHP 模块）
   ▼
QloApps 应用层（PrestaShop 1.6 内核 + 酒店域模块）
   ├── 前台（Front Office）：酒店官网、房态搜索、预订下单、支付
   ├── 后台（Back Office）：PMS 前台、房态管理、订单、报表
   ├── 模块体系（Hook 钩子 + 模块目录 modules/）
   └── Webservice 框架（/api REST 端点，XML/JSON 输出）
   ▼
MySQL（qlo_ 前缀，301 张表，InnoDB）

3.2 领域模型要点

从安装后的数据库结构（实测 SHOW TABLES 输出 301 行，即 300 张表）可见其酒店域建模：

• 房型（room type）与房间（room）分离：一个房型（如「标准大床房」）下挂多间实体房间，价格、限制规则挂在房型上，实际入住占用落到具体房间；
• 预订（booking）继承 PrestaShop 的订单（order/cart）管线：客人下单走 cart → order，酒店域在其上叠加 checkin_date/checkout_date、占用天数与房态校验；
• 多酒店（multi-hotel）：后台可维护多家物业（hotels 表），每家物业有独立房型、房间与前台设置，适合连锁/民宿集群；
• 模块化扩展：渠道管理、支付网关、语言包等以 modules/ 目录下的模块形式挂接，官方 Addons 市场提供付费扩展。

3.3 技术栈与兼容矩阵（1.7.0，官方 README 实查 + 实机验证）

⚠️ 1.7.0 是首个同时支持 PHP 8.1–8.4 与 MySQL 8 的版本（官方 PR #1464）。1.6.x 及更早版本运行在 PHP 7.x 时代内核上，若服务器是 PHP 8.x，必须选 1.7.0。

四、功能特性

以下是 1.7.0 自带能力（官方文档 + 后台实测归纳）：

1. 酒店官网与预订引擎：房态日历、按晚计价、季节/节假日高级价格规则、最少/最晚入住限制、促销与优惠券；
2. 物业前台管理（PMS）：入住/退房办理、房态看板（空房/占用/维修）、超订保护、押金与额外服务计费；
3. 多物业与多语言：连锁多酒店集中管理；官网多语言（内置语言包体系，中文界面可通过后台语言管理安装）；
4. 订单与财务：订单管线（含取消/退款流程）、发票、税规则、报表仪表盘；
5. 客人体系：注册客户、历史订单、地址簿，支持邮件模板定制；
6. REST Webservice API：内置 /api 端点，覆盖客户、房型、预订（bookings）等资源，可用 XML/JSON 输出，便于对接 OTA/渠道管理工具（详见《QloApps 1.7.0 API 使用详解》）；
7. 模块扩展：Addons 市场付费模块（渠道管理、动态定价等）+ 开源模块机制。

1.7.0 相对 1.6.1 的主要新增（官方 Release Notes 实查）：PHP 8.1–8.4 与 MySQL 8 兼容（#1464）、房型床型配置（#1492/#1412）、单房型多条高级价格限制（#1488）、多房型批量价格规则（#1346）、房型批量加房间（#1374）、前台 properties 页面与物业详情流程（#1411）、标准产品流（#1399）、订单创建时可选不发确认邮件（#1354）等。

五、快速开始（最小可用示例）

本节给出「从下载到可登录后台」的最短路径，验证 QloApps 的真实可用性（以下命令与回显均在 Ubuntu 22.04 + Apache + PHP 8.1 + MySQL 8.0.46 环境实测）。完整分步安装（含系统准备、Apache 虚拟主机、排障）见《QloApps 1.7.0 Ubuntu 22.04 安装指南》。

5.1 准备运行环境

# 安装 LAMP 组件与必需 PHP 扩展（Ubuntu 22.04 仓库源）
sudo apt-get install -y apache2 libapache2-mod-php php8.1 php8.1-mysql \
  php8.1-curl php8.1-gd php8.1-soap php8.1-xml php8.1-zip \
  php8.1-mbstring php8.1-intl mysql-server

创建数据库与专用账号（示例账号 admin 语义的数据库用户，密码为演示口令）：

CREATE DATABASE qloapps DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER "qloapps"@"localhost" IDENTIFIED BY "q1w2e3r4";
GRANT ALL PRIVILEGES ON qloapps.* TO "qloapps"@"localhost";
FLUSH PRIVILEGES;

5.2 下载源码并部署

# 从官方 GitHub 下载 1.7.0 源码包（约 60MB）
wget https://github.com/Qloapps/QloApps/archive/refs/tags/v1.7.0.zip -O qloapps-1.7.0.zip
unzip qloapps-1.7.0.zip
sudo mkdir -p /var/www/qloapps
sudo cp -a QloApps-1.7.0/. /var/www/qloapps/
sudo chown -R www-data:www-data /var/www/qloapps

配置 Apache 虚拟主机（DocumentRoot 指向源码根目录，AllowOverride All 开启伪静态）：

<VirtualHost *:80>
    ServerName hotel.example.com
    DocumentRoot /var/www/qloapps
    <Directory /var/www/qloapps>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

sudo a2enmod rewrite && sudo systemctl reload apache2
# 验证安装器可访问（实测回显）
curl -sI http://127.0.0.1/install/ | head -3

实测输出：

HTTP/1.1 200 OK
Date: Sat, 24 Oct 2026 03:05:12 GMT
Server: Apache/2.4.52 (Ubuntu)

5.3 运行安装向导

浏览器打开 http://<服务器IP>/install/，跟随向导完成五步：欢迎页 → 许可协议（勾选同意） → 系统兼容性检查（全绿通过） → 数据库连接（服务器 127.0.0.1、库名 qloapps、账号 qloapps、前缀 qlo_） → 店铺与管理员信息（店铺名、时区、管理员邮箱与密码）。向导自动建表（301 张）、写入配置文件 config/settings.inc.php。

安装完成后按向导提示删除 install 目录，管理后台地址会被自动改名为随机目录（如 admin022z5qwsy/，这是内置安全特性，安装完成页会显示实际路径）：

sudo rm -rf /var/www/qloapps/install

5.4 验证

# 前台首页（实测）
curl -s -L http://127.0.0.1/ | grep -oE "<title>[^<]*</title>" | head -1

实测输出：

<title>Hotel Prime - QloDemo Hotel</title>

浏览器进入 http://<服务器IP>/admin022z5qwsy/（以安装完成页显示的目录为准），用管理员邮箱与密码登录，出现 Dashboard • QloDemo Hotel 仪表盘即安装成功。后台默认语言可在 Administration →Translations 或员工资料中调整。

六、适用场景与限制

6.1 适用场景

• 中小型独立酒店/民宿/旅馆：需要自有品牌官网直订（摆脱 OTA 高佣金）+ 简单前台管理，QloApps 单机即可承载；
• 小型连锁（多物业集中管理）：多酒店模型支持一家公司管理多家门店的房型与订单；
• 需要数据自有与二次开发：OSL-3.0 开源、代码可自托管，可基于模块机制对接自建 ERP/财务系统；
• 对接渠道管理场景：通过 Webservice API 或 Addons 渠道模块与 OTA/渠道管理平台交换房态与订单。

6.2 限制与注意事项

• 规模边界：单体 LAMP 架构，适合中小型物业；大型连锁的高并发库存分发、集团级收益管理不在其默认能力内；
• 支付通道：内置 PayPal 标准支付模块，国内主流支付（微信/支付宝）需自研或采购第三方模块；
• 中文生态：核心为英文项目，中文语言包覆盖后台主界面，但部分官方文档与社区支持以英文为主（论坛 forums.qloapps.com）；
• 升级依赖官方节奏：版本发布节奏约每年 1 次（见下节），安全补丁需关注官方公告；内核停留在 PrestaShop 1.6 基线，需要 PHP 8.1+ 运行环境；
• 移动端：官网前台响应式适配移动浏览器，但无官方原生 App（可基于 Webservice API 自建）。

七、同类选型对比

酒店/住宿场景下的开源软件分为两类：酒店 PMS+预订引擎（QloApps）与通用预约/资源调度系统（Easy!Appointments、LibreBooking）。二者解决的问题不同：前者卖「过夜房晚」、要房态日历与按晚计价；后者卖「时间段服务」、按时段排班。以下对比数据均于 2026-10-24 实查（shields.io 徽章 + GitHub Releases）。

7.1 量化对比表

7.2 与 PrestaShop 本体的关系（防混淆）

💡 选型解读：如果业务是「卖房晚 + 管前台」，PrestaShop 本体即使装满插件也补不齐房态与入住逻辑，应直接选 QloApps 这类酒店垂直系统；如果业务是「卖时间段的预约」（诊所、美发、咨询），酒店模型反而不合身，选通用预约系统更合适。

7.3 同类预约系统对比（按需选型）

• 选 QloApps：业务是住宿业（酒店/民宿/公寓/青旅），需要官网直订 + 房态 + 前台 PMS 一体，且看重社区规模（14k stars 在同类中最大）与官方商业支持；
• 选 《Easy!Appointments 1.6.1 介绍与选型指南》：业务是「客户约服务者」的通用预约（如诊所、SPA、家教），不涉及房晚库存；Easy!Appointments 安装轻量、对并发要求低，站内已有从选型到 API 的系列文档可参考；
• 选 LibreBooking：业务是「资源按时段占用」（会议室、设备、场地），无需面向公众的营销型官网；
• 商业 SaaS（Cloudbeds、SiteMinder 等）：物业规模大、需要全渠道分销与 7×24 商业支持时考虑，代价是按月订阅与数据托管。

八、参考链接

• 官网与下载：https://qloapps.com/download/
• 官方文档：https://docs.qloapps.com/
• GitHub 仓库：https://github.com/Qloapps/QloApps
• Releases（版本节奏取证）：https://github.com/Qloapps/QloApps/releases
• 官方论坛：https://forums.qloapps.com/
• 在线演示：https://demo.qloapps.com （demo@demo.com / demodemo）
• 官方 Docker 镜像：https://hub.docker.com/r/webkul/qloapps_docker
• OSL-3.0 许可：https://opensource.org/licenses/OSL-3.0
• 站内相关：《QloApps 1.7.0 Ubuntu 22.04 安装指南》（部署实操）、《QloApps 1.7.0 配置参数详解》（settings.inc.php 与 defines 详解）、《QloApps 1.7.0 API 使用详解》（Webservice REST API 实测）