部署升级

咖啡壶（Chemex）是一个轻量的、现代设计风格的 ICT 资产管理系统。得益于 Laravel 框架以及 Dcat Admin 开发平台，使其具备了优雅、简洁的优秀体验。 咖啡壶（Chemex） 是完全免费且开源的，任何人都可以无限制的修改代码以及部署服务，这对于很多想要对ICT资产做信息化管理的中小型企业来说，是一个很好的选择：低廉的成本换回的是高效的管理方案，同时又有健康的生态提供支持。。

特点

经典的 LNMP 环境即可运行。

使用先进的 Web 框架进行开发。

简洁优雅的使用体验。

版本

咖啡壶（Chemex）将会以咖啡豆品种作为 major 版本的命名，例如 1.x 版本称为 肯亚（Kenya），旨在为 ICT 运维人员提供管理能力的同时，普及咖啡知识，静下心喝一杯属于当前版本的冲煮咖啡。

环境要求

git，用于管理版本，部署和升级必要工具。

PHP 7.3 + ，已经支持 PHP8 。

MariaDB 10.2 +，数据库引擎，理论上 MySQL 5.6+ 兼容支持。

ext-zip 扩展，注意和 PHP 版本相同。

ext-json 扩展，注意和 PHP 版本相同。

ext-fileinfo 扩展，注意和 PHP 版本相同。

ext-ldap 扩展，注意和 PHP 版本相同。

ext-bcmath 扩展，注意和 PHP 版本相同。

部署

生产环境下为遵守安全策略，非常建议在服务器本地进行部署，暂时不提供相关线上初始化安装的功能。因此，虽然前期部署的步骤较多，但已经为大家自动化处理了很大部分的流程，只需要跟着下面的命令一步步执行，一般是不会有部署问题的。

1：为你的计算机安装 git，Windows 环境请安装 Git for Windows ，Linux 环境一般都会自带，如果没有就执行 yum install git 或者 apt install git 命令来安装即可。

2：为你的计算机安装 PHP 环境，参考：PHP官方 。

3：为你的计算机安装 mariaDB。

4：创建一个数据库，命名任意，但记得之后填写配置时需要对应正确，并且数据库字符集为 utf8-general-ci。

5：在你想要的目录中，执行 git clone https://gitee.com/celaraze/chemex.git 完成下载。

6：在项目根目录中，复制 .env.example 文件为一份新的，并重命名为 .env。

7：在 .env 中配置数据库信息。

8：进入项目根目录，执行 php artisan chemex:install 进行安装。

9：你可能使用的web服务器为 nginx 以及 apache，无论怎样，应用的起始路径在 /public 目录，请确保指向正确，同时程序的根目录权限应该调整为：拥有者和你的 Web 服务器运行用户一致，且根目录权限为 755。

10：修改web服务器的伪静态规则为：try_files $uri $uri/ /index.php?$args;。

11：此时可以通过访问 http://your_domain 来使用 咖啡壶。管理员账号密码为：admin / admin。

更新（通过Git Pull方式）

随时随地保持更新可以在项目根目录中执行 sudo git checkout main && git reset --hard && git pull --force 命令，将会同步分支的最新修改内容。

接着，执行 php artisan chemex:update 来进行升级。