安装过程
实例安装
ICEPOS系统可单机安装也可以云服务器安装部署,下面我们来参考单机部署过程( WAMPSERVER 3.3.0-64位 + 收银系统客户端)
第一步:安装WAMPSERVER3.3.0 64位,推荐官网下载链接:sourceforge.net下载
- 下载.exe安装包后,双击安装,选择好安装目录即可
- 安装后,测试环境是否运行正常,点击程序图标
- 运行后,系统图标托盘中会见到绿色图标,表示所有服务运行正常
- 点击图标,在弹出的菜单中检查PHP运行版本是否 7.4.33,Thinkphp 5.1 版本不支持 PHP8及以上。
第二步:安装ICEPOS管理后台:请从官网推荐链接 Gitee/Github 下载
- 下载源码包后,解压源文件,放于wampserver的www目录下
-
配置本地主机可以通过 127.0.0.1访问ICEPOS管理后台
- 依次打开wampserver的安装目录,并按路径: \bin\apache\apache2.4.54.2\conf\extra\ 查找并打开 httpd-vhosts.conf 文件(可右键选择"记事本" 打开)
- 在 httpd-vhosts.conf 内添加虚拟主机,绑定 127.0.0.1 指向后台的 "public" 目录,例如后台源码的文件夹名称是"icepos":
******* 后台文件夹中的 "public" 文件夹 :
******* httpd-vhosts.conf 文件配置截图 :
<VirtualHost *:80> DocumentRoot "E:\wampserver\www\icepos\public" ServerName 127.0.0.1 <Directory "E:\wampserver\www\icepos\public"> Options +Indexes +Includes +FollowSymLinks +MultiViews AllowOverride All Require all granted </Directory> </VirtualHost>
-
管理后台开发框架是Thinkphp 5.1,默认开启路由重写,需要开启Apache或nginx的rewrite_module。如果没有开启,会出现访问页面404的错误。Wampserver可以非常方便的开启该模块,只需要点击托盘小图标,按下图检查是否已勾选上rewrite_module即可
重启"Wampserver"的服务,使Apache的配置生效,再次点击系统托盘中的绿色图标,点击 "Restart All Services" 菜单,进行重启服务
- 服务顺利重启成功后,在浏览器输入 127.0.0.1 即可访问后台,不过在这是发现会有报错,提示数据库链接出错,不要慌,数据库导入简单,使用wampserver自带的phpmyadmin导入即可
- 打开wampserver的安装目录,打开 "apps" 文件夹,下面看到有 phpmyadmin5.2.0 ,假如你的wampserver是其他最新版本,phpmyadmin文件夹名称有些少变化,复制这个文件夹到后台程序的public目录下即可
- 访问phpmyadmin,创建icepos数据库,并且导入数据库文件
- 1) 浏览器输入: http://127.0.0.1/phpmyadmin 访问phpmyadmin,一般wampserver安装后的数据库账户是 root ,密码是空,按"登录"按钮即可
- 2) 创建一个名叫 icepos的数据库
- 3) 导入后台源码包中的icepos.sql文件即可,点击页面最下面的"导入"按钮执行操作,稍等一会就完成了
- 4) 假如导入时候提示文件大小超过PHP环境限制的2M!可以手动调整post_max_size 和 upload_max_size 两个参数的值到 256M
- 1) 浏览器输入: http://127.0.0.1/phpmyadmin 访问phpmyadmin,一般wampserver安装后的数据库账户是 root ,密码是空,按"登录"按钮即可
- 数据库导入成功后,修改一下后台源码目录下的 config\database.php 中的数据库账户密码
- 该管理后台可以本地部署或者远程服务器部署,因此可根据实际需要修改后台绑定的域名地址或IP。需要修改的地方包括根目录下的config目录下的app.php,参数名称是:app_host 和 url_domain_root 可以是域名也可以是ip地址(本地IP一般是 127.0.0.1)。还有根目录下 application/api/config 目录下的app.php,参数名:api_server,这个参数必须带http:// 或 https:// 协议,POS客户端例如C#客户端广告图片通过http方式访问。
- 最后浏览器输入 http://127.0.0.1 即可访问后台。假如您需要部署在云服务器上记得删除phpmyadmin目录,或者修改名称
- 假如后台在添加/编辑操作商品或其他信息出现错误/报错,一般是由于数据库Mysql设置了严格模式,必填字段输入数据为空或者日期格式错误导致保存失败或报错。可以通过修改my.ini 中的sql_mode 去除STRICT_ALL_TABLES / NO_ZERO_DATE / NO_ZERO_IN_DATE 这三项。如图:
修改后如图: 保存后重启Wampserver 或mysql即可 - 管理后台安装完之后,可以开始部署C#端 收银前台,推荐到Gitee码云仓库下载源码或者直接运行包:https://gitee.com/xmosnewone。如图:
注意:源码包和直接运行包默认使用的是ICEPOS官方案例后台地址demo.icepos.cn。如果您已经部署好了自己的后台,请修改源码或者直接运行包的配置文件,改成您自己后台的ip地址或者是域名!!新手请注意https和http协议!!!
(一)使用源码编译的收银前端,需要修改ICE.POS项目下面的app.config文件,如下图修改完地址后,请按图示,重新生成ICE.POS项目即可!
(二)使用直接运行的收银前端,需要修改ICE POS.exe.config(可用记事本打开编辑),如下图修改完地址后,双击ICE POS.exe即可运行!
运行exe,请按步骤 "链接"->"选择门店和绑定POS机"->"更新数据"->"输入营业员账号密码"->即刻收银
如果运行时候,提醒安装运行时刻库:可以到微软官方下载VC++ 和 .NET FramwWork4.6等
VC下载地址: VC++ 2015
.NET FramwWork4.6下载地址: .NET FramwWork4.6