[Laravel](https://laravel.com/) ，优雅的 PHP Web 框架。
[Dcat Admin](https://dcatadmin.com) ，高颜值、高效率的后台开发框架。
`Dr. Peter Schlumbohm`，感谢发明了 Chemex 冲煮咖啡。
## 简介
咖啡壶（Chemex）是一个轻量的、现代设计风格的 ICT 资产管理系统。得益于 [Laravel](https://laravel.com/) 框架以及 [Dcat Admin](https://dcatadmin.com)
开发平台，使其具备了优雅、简洁的优秀体验。 咖啡壶（Chemex）
是完全免费且开源的，任何人都可以无限制的修改代码以及部署服务，这对于很多想要对ICT资产做信息化管理的中小型企业来说，是一个很好的选择：低廉的成本换回的是高效的管理方案，同时又有健康的生态提供支持。
## 特点
使用先进的 Web 框架进行开发。
简洁优雅的使用体验。
灵活可配置的自定义字段。
高性能 Web 服务解决方案（Octane）。
## 环境要求
`git`，用于管理版本，部署和升级必要工具。
`PHP 8+` ，仅支持 PHP8。
`MySQL 5.7+`，数据库引擎，理论上 `MariaDB 10.2 +` 兼容支持。
`ext-zip` 扩展。
`ext-json` 扩展。
`ext-fileinfo` 扩展。
`ext-ldap` 扩展。
`ext-bcmath` 扩展。
`ext-mysqli` 扩展。
`ext-xml` 扩展。
`ext-xmlrpc` 扩展。
以上扩展安装过程注意版本必须与 PHP 版本一致。
## 部署
### 经典 Nginx & PHP-fpm
生产环境下为遵守安全策略，非常建议在服务器本地进行部署，暂时不提供相关线上初始化安装的功能。因此，虽然前期部署的步骤较多，但已经为大家自动化处理了很大部分的流程，只需要跟着下面的命令一步步执行，一般是不会有部署问题的。
1：为你的计算机安装 `PHP8` 环境，参考：[PHP官方](https://www.php.net/downloads) 。
2：为你的计算机安装 `MySQL` 或者 `mariadb`。
3：在你想要的目录中，执行 `git clone https://gitee.com/celaraze/chemex.git` 完成下载。
4：在项目根目录中，复制 `.env.example` 文件为一份新的，并重命名为 `.env`。
5：根据 `.env` 文件中注释的指引进行配置。
6：你可能使用的web服务器为 `nginx` 以及 `apache`，无论怎样，应用的起始路径在 `/public` 目录，请确保指向正确，同时程序的根目录权限应该调整为：拥有者和你的 Web 服务器运行用户一致，例如 www
用户，且根目录权限为 `755`。`/storage` 目录设置为 `777` 权限。
7：修改web服务器的伪静态规则为：`try_files $uri $uri/ /index.php?$args;`。
8：此时可以通过访问 `http://your_domain` 来使用咖啡壶。管理员账号密码为：`admin / admin`。
### OVF
> 此部署方式版本暂停在 3.0.1，近期将会恢复更新
考虑到部署复杂性，我们也提供了基于 Ubuntu 20.04 Server 制作的 OVF 包。OVF 支持 VMware ESXi 6.5+ 或 VMware Workstation 14.x+ 或 VMware Fusion
10.x+。
下载地址：[https://pan.baidu.com/s/1AuTv5UMxzzMkTdP9Ca5J_A](https://pan.baidu.com/s/1AuTv5UMxzzMkTdP9Ca5J_A)，提取码：`8mok`。
OVF 中包含以下组件：Nginx MySQL PHP7.4，网络通过 NAT 实现。
> 此 OVF 中的 chemex 版本为支持 PHP7.4 的版本，但 chemex 从 3.0.4 开始将仅支持 PHP8.0 。
Ubuntu 账密：chemex/chemex
Web 程序主目录：/var/www/html
MySQL 账密：chemex/chemex
部署完成后，LNMP 服务会自启，先查看此虚拟机 IP，然后在其它主机直接通过 IP 访问 Web 服务即可。
## 版本更新
随时随地保持更新可以在项目根目录中执行 `sudo git fetch --all && git reset --hard origin/main && git pull` 命令，将会同步分支的最新修改内容。
接着，执行 `php artisan chemex:update` 来进行升级。
> 注意，如果提示 permission denied 错误，需要通过 sudo 身份执行。
## 反馈问题
请随时牢记，这是一个开源项目，作者有自己的生活、自己的工作，QQ群建立的目的是提供一个场所供用户们互相交流，作者不会提供1对1的服务。
最好的反馈方式即是在本代码仓库中提交 Issue，我们在空余时间检查并解决。
## 截图
## 咖啡壶没有满足我的需求，我想要咖啡壶成为我想要的样子
咖啡壶是开源的，程序本体及其衍生工具的源码都在你的手中，你可以自行修改成为你想要的样子。
`Fork` 本仓库，修改代码，成为你的。
## 开源协议
咖啡壶（Chemex）遵循 [GPL3.0](https://www.gnu.org/licenses/gpl-3.0.html) 开源协议。