aaPanel、宝塔及其他面板
在由 aaPanel(宝塔 / BaoTa)、cPanel 或 Plesk 等 Web 控制面板管理的服务器上安装 HWD POS。
可以在由控制面板管理的服务器上安装,但这不是推荐方式。面板会按自己的方式管理 Web 服务器和 PHP,而且两个后台服务需要单独安装。条件允许的话,请在全新服务器上使用网络安装。
基本要求(适用于任何面板)
无论使用哪种面板,都需要满足以下要求:
-
创建站点,并将其文档根目录设为
public/文件夹。 -
使用 PHP 8.2+,并启用系统要求中列出的扩展。
-
在面板中创建数据库及其用户。
-
将文件夹交给 Web 服务器用户,并允许写入
storage/和public/uploads/。 -
安装两个后台服务(打印和插件):
sudo bash install-workers.sh /path/to/site web-userinstall-workers.sh不包含在.zip软件包中;请向供应商获取,或从获取安装程序的同一位置下载。 -
打开
http://…/install处的安装向导。
aaPanel / 宝塔(BaoTa)
aaPanel 是宝塔(BaoTa)的国际版。两者的操作方式相同。
安装面板
在 Ubuntu 上:
wget -O install.sh https://www.aapanel.com/script/install_6.0_en.sh && sudo bash install.sh安装 LNMP 环境
在面板中安装 Nginx、PHP 8.2 和 MySQL/MariaDB。
配置 PHP
在 PHP 8.2 → Extensions(扩展)中,启用 pdo_mysql、mbstring、curl、zip、gd、xml、sodium、fileinfo 和 opcache。
在该 PHP 的 Configuration(配置)中,禁用 open_basedir,或者将项目路径加入其中(系统需要写入 storage/)。
添加站点
添加一个站点(域名或 IP)。然后在站点设置 → Site directory(运行目录)中,将运行目录改为 /public。
URL 重写
在站点 → URL rewrite(伪静态)中粘贴:
location / { try_files $uri $uri/ /index.php?$query_string; }也可以使用 Web 服务器中给出的参考配置。
创建数据库
在面板中创建数据库,并记下其用户名和密码。安装向导中会用到。
权限
为 PHP 用户(通常是 www)授予 storage/ 和 public/uploads/ 的写入权限。
打印进程
在面板的 Supervisor(进程守护)中,添加一个运行以下命令的进程:
php /www/wwwroot/HWDPOS/scripts/print_worker.php --daemon如果需要打印,请通过 SSH 安装 cups 和 chromium。
在由面板管理的服务器上,hwdpanel 命令和 check.sh 的修复功能是针对标准安装程序的布局(/var/www/HWDPOS、systemd 服务)设计的,其中部分选项可能不适用。